芯步的1路开关配合“先断后通”(reset)命令,刚好能实现门禁触发时照明自动亮起、延时后关闭的效果。下面从硬件选型到接口调用一步步说清楚。
一、 背景与实现思路
在很多场景下(比如入户玄关、配电室、机房),我们希望实现:当人员合法开门(刷卡/刷脸/按出门按钮)进入时,门边的照明灯自动亮起,方便查看环境;在人员离开或门关闭一段时间后,灯自动熄灭,避免费电。
传统的做法需要布很多控制线,还要加延时继电器,改线很麻烦。而利用芯步的智能硬件和接口,我们可以用软件逻辑取代复杂的电路。
硬件:芯步 1路智能通断器/智能墙壁开关。核心命令:reset1。
为什么要用
reset1?因为门禁控制开门时,通常是给门锁一个瞬间的“断电”信号(门禁系统输出常闭信号居多,开门时继电器动作,断开一下)。我们不希望“开门”的时候灯一直常亮,也不希望“关灯”命令把门锁给关了。所以我们利用
reset1(先断后通)的特性:开关瞬间断开(触发灯具点亮),延时一段时间后自动恢复接通(灯具熄灭),这就实现了一个完美的“人来灯亮,人走灯灭”的效果。
二、 硬件选型与接线
根据你的现场环境,选一个合适的设备即可:
智能1路墙壁开关:适合装在标准86底盒里,替换原有开关,直接控制灯的零火线。
智能1路通断器:适合藏在灯里面或者设备柜里,体积小。
接线逻辑
输入端:接入220V电源。
输出端(负载):接你的照明灯。
门禁对接:严格来说,智能开关不要直接去切门禁的电源(以免影响门禁稳定性)。我们要做的是 “信号联动”。
推荐做法:你的门禁控制器(或门禁电源)通常有一个“门磁信号”输出或者“开锁按钮”的信号输出。将这个信号(如NO/COM干接点)接到一个传感器上(如果门禁系统支持,可以直接触发HTTP请求;如果不支持,可以把出门按钮并联接入一个小型的“PLC/单片机”或利用门禁的继电器输出)。
最简单的联动逻辑门禁控制器在刷卡成功的瞬间,会触发一个继电器吸合。利用这个吸合的瞬间,向芯步的云端或者局域网API发送一条 reset1 指令。
三、 对接开发步骤
芯步的开放平台是免费的,接口文档很清晰。你可以用任何编程语言(Python, PHP, Go, Node-RED, 甚至是用HTTP测试工具)来实现。
第一步:准备工作
登录芯步控制台,你需要拿到三个关键凭证:
AppID:你的应用ID。AppSecret:开发者密码(注意保管)。Device ID:你买的那台1路开关的设备ID。
第二步:核心接口签名算法
芯步的接口需要鉴权。签名规则比较常见,是 md5(md5(AppSecret) + ts)。这里为了方便理解,我给一个伪代码逻辑:
第三步:下发指令(重点:reset1 命令)
这是解决方案的核心。我们需要让开关在开门瞬间“断开一下”(灯亮),然后自动复位(灯灭)。
接口地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方式POSTContent-Typeapplication/json
请求Body
参数解析
reset1:代表操作第1路线路,执行“先断后通”动作。"5000":单位是毫秒。表示:立即断开线路(灯亮)-> 保持5000毫秒(灯亮5秒)-> 自动接通线路(灯灭)。
这就完美实现了:用户刷卡 -> 门禁控制器触发(发指令) -> 灯亮 -> 5秒后自动熄灭。整个过程不需要额外的定时器硬件。
第四步:实际代码示例(Python + Requests)
假设你门禁控制的服务器或脚本能监听门禁事件,加入下面这段代码:
四、 进阶玩法:局域网本地控制(更快更稳)
如果你担心外网断了灯就亮不了,或者对响应速度要求比较高(门开了灯要秒亮),芯步的硬件也支持局域网和私有化部署。
如果你的服务器和智能开关在同一个局域网(比如公司机房内),可以调用局域网API接口(通常是设备IP或特定的内网域名),这样延时可以控制在50ms以内,不受外网波动影响。
这种方案下,代码逻辑完全一样,只需要修改请求的Base URL即可。
五、 应用场景总结
利用这套方案,你能做的不只是“门禁照明”。利用这一个 reset1 接口,你可以衍生出很多玩法:
第一种场景(配电房):人员进入巡检 -> 感应触发 -> 1路开关接通排气扇 -> 延时关闭(保障通风换气且节能)。
第二种场景(酒店取电):插入房卡 -> 触发
power1: 1(常用模式)接通总电源;拔出房卡 -> 触发power1: 0全屋断电。第三种场景(设备复位):用于远程重启路由器或工控机。发现死机了,远程调用
reset1: 10000,路由器断电10秒后恢复,相当于物理重启。
一些小
注意安全:强电操作一定要断电进行,如果是控制大功率灯具,确认一下开关的安培数是否足够。
关于复位时间
reset1里面的时间单位是毫秒,设置3000到5000(即3-5秒)。太短了人还没走过去灯就灭了,太长了浪费电。免费门槛:芯步的开放平台确实是永久免费的,连API调用次数都不限制(只是1次/秒),这对做集成方案非常友好,不用担心后期开发商突然收费。
如果有不懂的签名算法细节,可以直接看官方给的Curl示例,复制过去改改参数就能跑通。