CATALOG

芯步的开放接口走的是标准HTTP协议,对接门槛很低——不需要折腾复杂的MQTT,会调接口就能搞定。下面我结合“进门亮灯、出门灭灯”这个场景,讲讲怎么把门禁和照明联动起来。

一、场景说明 & 选型思路

咱们先明确一下要做什么:当有人刷门禁开门时,过道灯自动亮起;人进去关门后(或延时一段时间),灯自动熄灭

这个场景的核心在于:不是让人去按两次开关,而是让门禁的“开锁信号”去触发灯的“开灯动作”。

要实现这个,需要用到芯步生态里的两类硬件:

  1. 门禁类:可以是智能出门开关,也可以是带远程控制的密码门禁,负责“感应”开门动作;

  2. 照明控制类:这里推荐使用 智能墙壁开关(1路/2路/3路) 或者 智能控制器,接在走廊灯的回路上

为什么不推荐用智能插座接灯?虽然智能插座也能控制通断,但照明线路通常是在墙里埋好的86盒。用 智能墙壁开关 可以直接替换现有的墙面开关,保持墙面美观,不用改线路

核心逻辑:门禁那边一旦检测到“解锁成功”或“门磁打开”这个事件,芯步的后台服务器(或者你自己的服务器)就去给照明开关发一条 {"power1":"1"} 的指令。

二、准备工作:获取关键凭证

在动手写代码之前,先去芯步的控制台拿到三样东西,这相当于你的“身份证”:

  • AppID:你的应用ID,调用接口时写在URL路径里;

  • AppSecret:开发者密码,用来生成签名,千万别泄露

  • Device ID:设备的ID,门禁设备一个ID,照明开关一个ID。在控制台设备列表里就能看到

三、核心技术:如何发命令

芯步的接口非常友好,全是标准的HTTP POST请求,不管是PHP、Python、Java,甚至是小程序的JS,都能轻松对接。设备响应超快,通常在 80-120毫秒 内就执行了,基本感觉不到延迟

1. 地址与签名(照抄就行)

接口地址格式如下,注意要把 {AppId}{sign}{ts} 换成实际的:

这里有个小门槛:签名计算。芯步为了安全,要求这样算:sign = md5( md5(AppSecret) + ts )

  • ts 是当前的时间戳(秒级,10位数字);

  • 先把 AppSecret 取一次MD5(得到32位小写字符串),后面拼接上 ts 这个字符串,再整体取一次MD5

算例(伪代码):

2. 控制照明的指令

这是最简单的一步。假设你的走廊灯接在智能墙壁开关的 第1路,想开灯,就发这个:

关灯则是 {"power1": "0"}

3. 高级玩法:自动关灯(先断后通)

如果想让灯亮5分钟后自动熄灭,不需要在服务器上写定时任务,设备本身就支持。可以在开灯时带上 reset1 参数,比如延时 30秒 后关灯

*(注意:单位是毫秒,30000毫秒=30秒)*

四、实战落地:两种联动方案

下面说点实际的,怎么把门禁和灯接起来,看图说话可能更清楚。

方案A:纯软件联动(最灵活,推荐)

这种方式适合已经有门禁管理后台(比如自己写的APP或小程序)的场景。

  1. 用户操作:用户在手机小程序上点击“远程开门”;

  2. 后台处理:你的后台收到请求,先给门禁发开锁指令 {"power1":"1"}

  3. 联动逻辑:开锁成功后,紧接着调用照明接口,给开关发指令 {"reset1":"60000"}(亮灯1分钟);

  4. 最终效果:门开了,灯也亮了,1分钟后灯自动熄灭

这种方案的优势在于,你可以设置各种复杂逻辑:比如只在晚上18:00-早上6:00才开灯,白天开门不亮灯,省电!

方案B:设备间本地联动(通过云定时/场景)

如果你不想写复杂的后端代码,也可以直接用芯步控制台的“场景联动”功能。

  1. 在控制台创建一个自动化场景:“如果门禁打开,则执行打开走廊灯”;

  2. 云端会帮你监听门禁的状态,一旦变化就自动触发指令;

  3. 适合不需要复杂判断的固定场景。

五、掏代码:具体怎么发请求

下面给一段非常直白的 curl 命令示例,你可以在Linux终端或者直接在Postman里跑一下,看看灯亮不亮:

执行上面这个脚本,灯就会瞬间亮起,3秒后熄灭

六、避坑指南

  1. 注意负载功率:智能墙壁开关虽然标称10A,但如果接的是LED灯,尤其是大功率的,由于LED启动时浪涌电流很大,总功率控制在 300W以内,不然容易烧开关

  2. 门禁类型:如果用的是电磁锁,门禁控制器那边记得要能输出信号。如果是通过HTTP控制门禁,直接连调就行;

  3. 网络稳定性:这种联动依赖WiFi,如果断网了,用面板手动还是能开灯,但联动就失效了。如果要求高稳定性,可以考虑支持局域网控制的设备

七、总结

一路门禁联动一路照明,本质上就是 “一个开关量的变化,触发另一个开关的闭合”。利用芯步的HTTP接口,直接把控制门禁的代码后面加上控制灯的代码就行了。

按照上面的步骤,少则十分钟,你就能跑通第一个“开门亮灯”的场景。