CATALOG

一、为什么你需要关注这个小小的86开关?

做过共享茶室或棋牌室的朋友都知道,顾客体验的“最后一米”往往就卡在细节上。顾客线上下单后,走到包间门口,最顺滑的体验是什么?当然是扫码后门锁自动打开、灯光同时亮起。如果还得摸黑找开关,或者门开了还要自己开灯,体验感瞬间就打折扣了。

今天聊的就是怎么把芯步这款86型单路门禁照明开关,干净利落地集成到你现有的软件项目里。别看它小,用好了,门禁和照明的联动问题一次性解决。

二、这玩意儿是啥?先认识一下硬件

芯步的这款智能墙壁开关,型号是 UNI-KG-1。说人话就是:

  • 长得像普通开关:标准86型,跟家里墙上的一模一样,可以直接替换,不需要单独布线或者挂个奇怪的盒子在墙上。

  • 能接灯,也能接锁:它是一个10A继电器,理论上一路可以带1200W的负载。LED灯肯定没问题,如果是直流电磁锁,也可以通过一个12V变压器转接(开关控制变压器通断,变压器给锁供电)。

  • 联网靠WiFi:只支持2.4G WiFi。联网配网后,你的服务器就能在云端找到它。

痛点解决:通常做共享空间,门禁锁要一个网关(往往是弱电12V),照明要一个控制器(强电220V)。这个开关如果是装在门边,直接控制门锁的电源适配器,或者如果是玻璃门用磁力锁,它也能直接控制锁的通断电。一个设备,既控制了锁,又控制了灯

三、对接思路:软件是怎么“摸”到这台开关的?

我们要把开关集成到你的后台系统(比如Java后端、PHP后端,甚至是Node.js),核心逻辑就是发HTTP请求

整个流程其实很简单,大概分三步走:

  1. 设备配网:安装师傅装好开关后,用芯步的配网APP/小程序,把开关连上店里的WiFi。这时候,这个开关就在云端“活”过来了,有了唯一的设备ID(比如一串数字:10086742)。

  2. 获取凭证:在芯步的开发者后台,拿到你的 AppIDAppSecret。这相当于你软件系统的“身份证”。

  3. 代码发指令:在你的代码里,照着API文档构造一个HTTP请求,发出去,开关就动作了。

四、动手干:具体的接口调用步骤

别看官方文档里签名算法(MD5嵌套)写得挺复杂,其实就是把参数拼对就行。我们直接说怎么调用。

1. 地址和签名

  • 请求地址https://api.thingboot.com/{你的AppID}/device/control/

  • 关键参数

    • device:就是上面提到的设备ID。

    • order:这是指令,比如开灯是 {"power1":1},关灯是 {"power1":0}

  • 签名 (Sign):这是最坑小白的地方,千万别搞错。官方规则是:Sign = md5( md5(AppSecret) + ts )

    • 先把你的 AppSecret 做一次MD5,得到字符串A。

    • 把字符串A 拼上当前的时间戳(秒级,比如 1713571200)。

    • 把拼起来的结果再算一次MD5,这就是Sign。

2. 实战代码片段(这里用Python举个栗子,比较直观)

假设你的包间被顾客预定了,系统需要开门开灯,你可以写这样一个函数:

如果你是Java后端,逻辑完全一样,就是用HttpClient发个POST,只是MD5的工具类写法不同。

3. 特别功能:那个很实用的“状态保持”

共享茶室里有个头疼的问题:顾客走了,灯还亮着;或者顾客手贱按了物理开关,把系统搞乱了

芯步这个开关有个很贴心的功能——点动模式状态锁定

假设你的场景是:顾客下单后,门通电开锁(灯亮);顾客离开订单结束,系统直接断电关灯关锁。但万一顾客在房间里手痒,按了一下墙上的物理开关,把灯关了怎么办?

这时候,你可以在后台设置一个定时任务,或者用这个开关的 “先断后通”指令。其实更简单的是,你的系统可以每隔几分钟读取一次设备状态,或者循环下发“开启”指令,确保只要订单有效,这个开关就强制保持“ON”状态。这就叫软件防呆。

五、集成到你的软件项目中的具体场景

把这个开关放到你的项目架构里,它通常扮演两个角色:

第一种场景:独立包间控制(小成本方案)如果你只有一个单间,或者你是做办公室的独立门禁。

  • 连线方式:开关接220V进线,出线接一个12V变压器,变压器再接磁力锁。同时,出线并联一路接到照明灯。

  • 逻辑power1:1 -> 锁通电吸合(开门),灯亮;power1:0 -> 锁断电(闭门),灯灭。

  • 项目集成:在你的预约小程序后台,点击“开门”按钮,就调这个接口。

第二种场景:多路控制器下的补充(配合8路控制器)对于棋牌室这种有空调、麻将机、灯光的复杂场景,通常你会用芯步的那个8路包间控制器(专业的事交给专业的做)

  • 那个8路控制器负责灯光、插座、空调。

  • 门禁这一路,有些控制器是弱电信号输出。但如果你离门比较远,或者为了布线方便,完全可以在门边单独装这个86型开关,只控制门锁。

  • 项目集成:当顾客下单,系统发指令给8路控制器(开灯开空调),同时也发指令给这个86开关(开门)。

六、一点实用的避坑指南

  1. 关于WiFi信号:这个开关用的是2.4G WiFi。千万不要连5G信号,不然离线了别怪设备。在茶室包间里,如果信号弱,可能需要一个信号中继。

  2. 关于接门锁:这个开关输出的是220V强电。而普通电插锁或者磁力锁是12V直流千万不要直接把220V接到门锁上! 中间必须加一个“220V转12V”的电源适配器。开关控制220V的通断,适配器输出12V给锁。

  3. 离线应急:如果WiFi断了,顾客是不是就进不去了?这个物理开关还能按,但如果是远程控制,你就得考虑本地局域网控制了。还好芯步支持局域网HTTP控制(只要手机连同一个WiFi,直接调局域网IP也行),如果你们的商米或者前台电脑在同一个网络,可以用局域网IP当备用方案。

七、总结

把“86型单路门禁照明开关”集成到项目中,本质上就是一次顺畅的HTTP调用

  • 对开发者:不用纠结复杂的硬件协议,就当它是你后端的一个普通API接口。

  • 对老板:成本低(一个86开关几十块),安装方便(不用改线路),还能实现“开门即亮灯”的仪式感。

把这玩意儿跟你的订单系统一结合,顾客线上付款成功 -> 服务器发指令 -> 灯亮了,锁开了。整个体验就很流畅了。如果你们用的是现成的共享茶室SaaS系统,通常他们也已经在后台做好了对接,你只需要在硬件配置里输入设备ID即可。