CATALOG

芯步的智能硬件开放接口很友好,用HTTP请求就能直接控制设备。对于“远程重置包间状态”这个需求,其实就是给控制器发一条指令,把所有继电器断开一下再重新上电。下面我按实际对接流程来写,偏口语化一些,方便你直接拿去用。

解决方案:利用芯步开放接口,实现远程一键“重置”包间状态

适用设备:4路共享空间智能控制器Mini(UNI-KZQ-BJ-MINI)核心需求:顾客离开后,管理员无需进店,远程将包间内的所有设备(灯光、插座、幕布等)恢复到默认关闭状态。

第一步:搞懂“重置”的逻辑

所谓的“重置包间设备状态”,在硬件层面其实就是两步:

  1. 断开所有线路:把连接在控制器4个接口上的所有设备电源切断(关灯、关空调、关插座)。

  2. 重新上电(可选):有时候像路由器、机顶盒这类设备,需要断一下电等几秒再开,才能彻底清缓存。这时就需要用到“先断后通”功能。

包间控制器Mini提供了4路继电器输出,每一路都可以单独控制。我们可以利用它的 reset(先断后通) 命令,来实现一键重置。

第二步:准备工作(拿到关键的钥匙)

在写代码之前,你需要先在芯步的后台拿到三个东西:

  1. AppID:你的应用ID,相当于你在平台的“用户名”。

  2. Device ID:贴在控制器外壳上的那一串数字,或者去控制台设备列表里看,这就是你要控制的那个包间的“身份证”。

  3. Sign & Token:签名和密钥,这是为了防止别人乱发指令的安全锁。

小提示:注册登录后,这些信息通常在“物联网控制台” -> “设备列表”或者“开发设置”里能找到

第三步:核心代码实现(怎么发指令)

芯步的接口非常标准,只要能发HTTP请求(比如用后端Java/PHP/Node.js,或者前端小程序),都能搞定。我们用最直观的 curl 或者 Python 来演示。

接口地址(官方文档给的)http://api.thingboot.com/{你的AppID}/device/control/?sign={你的签名}&ts={当前时间戳}

关键点:必须用 POST 方式发送,数据格式可以是表单也可以是JSON。

方案 A:简单粗暴的“全关”模式(适合退单清扫)

这是最常用的场景:顾客走了,直接把这4路全断了就行。

发送的指令数据

只要把这串数据POST到上面的接口地址,控制器上的4个继电器就会瞬间断开,灯和插座就都没电了

方案 B:真正意义上的“重启”模式(适合清缓存)

如果你的包间里有WiFi路由器或者机顶盒,直接断电再马上来电,它们可能来不及重启。更科学的“重置”应该是:断电 -> 等几秒 -> 重新上电

包间控制器Mini支持这种自动化命令,非常贴心

发送的指令数据

解释:这个 reset 命令的意思是:把第1、2、3、4路继电器先断开,然后等待 5000毫秒(即5秒),然后再自动把它们全部接通这样一来,路由器等设备就会经历一次完整的冷启动,系统状态焕然一新。

第四步:接入你的管理后台(做成按钮)

拿到代码后,怎么用在日常运营里?

  1. 嵌入后台:把你预置好设备ID的代码,写在你门店管理系统的后台里。

  2. 制作UI:在订单结束页面或者房间控制页面,加一个大大的按钮,叫 [一键重置包间]

  3. 联动逻辑:甚至可以设置自动触发。比如当系统检测到“包间订单已结束”时,后台自动调用这个 reset 接口。

总结一下

接芯步的硬件,不需要去折腾复杂的嵌入式开发。只要看懂他们文档里的 order 参数,用 power1:0 来单控,用 reset 来做重置,十几行代码就能把实体设备的控制逻辑搬到你的云端系统里。甚至以后想实现“预定成功自动通电”,也是同样的道理,改改命令参数就行。