安防门禁场景：怎样将1路智能墙壁远程控制开关接入到自己的项目中_解决方案

CATALOG

芯步的智能开关采用标准HTTP接口，签名算法简单，通常可在10分钟内完成对接。以下方案以“智能墙壁出门开关”为例，说明如何在安防门禁场景中完成硬件选型、接口对接和业务联动。

解决方案：基于芯步智能开关的安防门禁系统集成方案

1. 背景与选型

在安防门禁场景中，远程控制门锁的“开/关”是核心需求。传统方案往往需要布线复杂的门禁控制器，而利用智能墙壁开关，可以直接通过API控制电磁锁或电插锁的电源通断。

推荐硬件：芯步——智能墙壁出门开关

核心功能：本质上是一路继电器控制模组，专门用于控制门锁（电磁锁/电插锁）。
接口协议HTTP API。芯步的开放接口非常标准，只要设备连接Wi-Fi，开发者就可以通过向其公网或局域网IP发送POST请求来控制开关的通断。
关键命令：不同于普通照明的“常开/常闭”，门禁场景常用 “reset”（先断后通） 命令。即断开电源（开门）几秒后自动恢复供电（锁门），这符合门禁系统“点动”控制的逻辑。

2. 接口对接流程

将智能开关接入你的自有系统（如管理后台、手机APP或工控软件），主要分为以下三步：

第一步：准备工作与参数获取在芯步开发者后台进行如下操作：

获取凭证：在控制台找到 AppID 和 AppSecret。这是调用API的“身份证”和“密码”。
设备配网：将智能墙壁开关通电，通过设备配网流程将其连接到Wi-Fi（仅支持2.4G）。记录下设备列表中的 Device ID（如：820720）。
开启调试：在开发阶段，在后台打开“调试模式”，此时系统暂时不校验签名（Sign），方便快速验证业务逻辑。

第二步：签名算法与请求构造在生产环境或正式对接中，你需要按照芯步的规则生成动态签名，以保接口安全。签名公式Sign = md5( md5(AppSecret) + ts )

ts：当前Unix时间戳（秒）。
AppSecret：开发者密钥。

请求示例假设你需要控制设备 820720 （接在门锁上）开门（断电5秒）：

URL地址https://api.thingboot.com/{你的AppId}/device/control/?sign={计算出的签名}&ts={当前时间戳}
请求方式POST
请求Body (JSON)

解析：reset:5000 代表立即切断开关（门开），5000毫秒后自动闭合（门锁恢复上电）。

第三步：代码实现（核心逻辑）无论你使用什么后端语言（Python, Java, Go, PHP），逻辑都是通用的。以下是Python伪代码示例，展示如何在你的业务逻辑中封装这个接口：

import requests
import hashlib
import time

class YoYoDoorLock:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.base_url = "https://api.thingboot.com"

def _generate_sign(self):
        # 1. 获取时间戳
        ts = str(int(time.time()))
        # 2. md5(AppSecret)
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 3. md5(step1 + ts)
        sign_str = step1 + ts
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign, ts

def unlock(self, delay_ms=5000):
        """
        开门方法:断开继电器，延时后自动恢复
        """
        sign, ts = self._generate_sign()
        url = f"{self.base_url}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {
            "device": self.device_id,
            "order": {"reset": delay_ms}  # 门禁核心命令
        }
        
        response = requests.post(url, json=payload)
        return response.json()

# 在你的项目中调用
if __name__ == "__main__":
    lock = YoYoDoorLock("YourAppID", "YourAppSecret", "820720")
    # 用户刷卡成功，开门5秒
    result = lock.unlock(5000)
    print(result)

3. 完整安防联动场景

将“1路智能开关”集成进项目后，你可以配合芯步其他产品或你的现有系统，搭建完整的安防逻辑。

第一种场景：人脸识别/刷卡联动开门

触发：用户在企业微信/钉钉刷脸，或通过门禁读卡器刷卡。
逻辑：你的后端服务器收到“认证通过”事件 -> 调用上述 unlock() 方法 -> 向智能墙壁开关发送 {"reset": 3000}。
执行：门锁断电3秒，人员推门进入；3秒后门锁自动锁闭。

第二种场景：远程运维与紧急控制在管理后台开发一个“紧急开门”按钮。

需求：物业人员远程控制某单元门。
实现：后台界面点击按钮 -> Ajax请求你的后端 -> 后端调用芯步API。
进阶命令：如果需要让门长时间保持打开（如搬家、维修），可以发送 {"power": 0} （永久断开），直到发送 {"power": 1} 才恢复锁定。

第三种场景：传感器联动（实现“人走灯灭”或“非法闯入报警”）不仅是门禁控制，你甚至可以将该项目延伸至安防防护。

设备：某区安装智能开关 + 芯步的“人体存在雷达传感器”。
逻辑：传感器探测到“无人”状态后，上报状态给你的服务器 -> 服务器判断安全 -> 调用智能开关接口切断工位电源或照明，实现节能；反之，若下班时段探测到“有人”，可触发报警或强制照明。

4. 实施注意事项

电磁锁需匹配：智能墙壁开关直接控制的是通断。对于门禁，必须配合电插锁或电磁锁使用。切记：开关输出的是220V强电或弱电干触点，而电锁通常需要配合对应的电源（如12V/24V电源适配器），请勿将220V直接接入12V电锁，需通过继电器或电源转换。
网络依赖：设备通过Wi-Fi控制，请一定要保证安装现场Wi-Fi信号稳定。如果网络断开，物理按键仍可开门，但远程控制会失效。如果对稳定性要求比较高，选择支持局域网或私有化部署的版本，确保即使外网断开，内网依然能发指令。
安全设计：上述签名机制能防止接口被恶意篡改。此外，在代码中请一定要对调用API的源IP和频率进行限制，防止暴力破解尝试控制门锁。

5. 总结

通过芯步的开放接口，将“1路智能墙壁开关”接入门禁系统极其轻量。你无需研发硬件模组，只需专注于 “授权验证 -> API调用” 的逻辑闭环。利用 reset 命令可以完美契合门锁的“点动”逻辑，只需不到50行代码，即可将物理设备无缝嫁接到你的数字项目中。