CATALOG

这是一个比较硬核的实战对接方案。芯步的86型WiFi出门开关其实就是一个通过继电器控制门锁的智能开关。既然要写方案,我会从硬件选型、API签名算法、核心接口调用、以及如何嵌入到你的业务系统这几个方面来讲。

一、先说痛点:为什么你需要把开关对接软件?

很多公司在做智能化改造时,都会遇到这样的场景:员工希望用小程序预约会议室、管理员想远程开门、或者新同事入职需要授权,结果发现装的门禁开关是独立的,只能手按,根本连不上系统。

这个时候,芯步的86型WiFi出门开关就派上用场了。它本质上是一个“长在墙上的物联网设备”,只要给它通上电、连上网,我们就可以通过它提供的开放接口,直接用代码控制它“吸合”或“断开”,从而达到开门/关门的效果

下面我会手把手过一遍怎么把这个物理开关,变成你代码里的一行指令。

二、硬件准备与选型:别买错了

在动手写代码之前,硬件得先备齐。这里有两个关键点要注意:

  1. 核心设备:智能墙壁出门开关

    • 认准芯步的这款产品。它支持标准的86型底盒(也就是我们家里墙上那种方形暗盒),安装起来很方便。

    • 关键特性:它开放HTTP接口,支持远程控制,而且响应速度快。出门按按钮是“点动”(按一下接通一下),通过接口控制也是这种逻辑

  2. 配套锁具:电插锁或电磁锁

    • 注意:你直接买这个开关,它是不带锁的。需要自行购买电插锁(适合玻璃门、木门)或电磁锁(适合铁门/防火门)。

    • 接线警告:千万不要把电插锁直接接在开关上!虽然开关里面有继电器,但一般控制器只负责输出弱电信号,锁具通常需要独立的12V电源。正确做法是:开关控制继电器,继电器控制电源的通断,电源再给锁供电

三、核心技术:怎么用HTTP接口发指令

这是对接的核心。芯步提供了一套标准的API,不管你的后端是Java、Python还是PHP,只要支持HTTP协议,都能调。

1. 先搞定签名(Sign)

调用它的接口首先要过鉴权这一关。挺多物联网平台在这一步会搞得人一头雾水,但芯步的逻辑其实就是 “双MD5加密”

简单来说,签名的计算公式是:sign = md5( md5(你的AppSecret) + 当前时间戳 )

流程如下:

  • 第一步:把你在芯步控制台拿到的 AppSecret 做一次MD5加密。

  • 第二步:把上一步得到的结果,拼接上当前的时间戳(比如 1704067200)。

  • 第三步:把拼接后的字符串再做一次MD5。

  • 最终:把这个值作为 sign 参数,和 ts(时间戳)一起放到URL里。

用Python举个栗子:

2. 下发开门指令

签名有了,我们就可以开门了。芯步提供了两种方式,用 POST + JSON 的方式,容错率高一点

接口地址:https://api.thingboot.com/{你的AppID}/device/control/

请求参数(Body):你需要传三个东西:设备ID、命令、签名。

实际体验:你向这个接口发一个请求,正常情况下,云平台会返回一个 {"code":200}。虽然这个200只代表“指令下发成功了”,不代表设备真的执行了,但只要设备在线,这时候那个86开关的继电器就会“咔哒”一声响,门锁电源接通,门就开了

3. 怎么知道我有没有“按”下开关?

这是做门禁系统的一个关键需求。比如:有人出门按了墙上的物理按钮,你的软件系统需要知道“有人出去了”,并记录一条日志。

这个功能叫做 “设备上行消息”“事件推送”

实现原理:芯步的平台支持消息推送。你需要在自己的服务器上提供一个公网可访问的URL(或者用MQTT)。

当有人按下那个86开关