CATALOG

芯步的智能墙壁开关通过标准HTTP接口实现远程控制,很适合无人值守场景的照明自动化。以下方案以UNI-KG-CM-1型号为例,涵盖接口调用、签名算法、联动逻辑及完整的落地流程。

解决方案:基于芯步开放接口的无人值守门店照明控制

1. 背景与选型

在无人值守门店(如共享自习室、健身房、自动售货机点位等)场景中,照明控制是用户体验与节能管理的核心环节。传统的照明方案无法远程干预,常导致“长明灯”浪费或用户摸黑体验差。

核心产品选型:芯步 智能墙壁触摸控制开关(1路)

  • 型号: UNI-KG-CM-1

  • 核心优势: 该设备采用标准86型面板,可直接替换现有墙壁开关,无需重新布线。其关键特性在于支持直接连接WiFi 2.4G,无需额外购买网关,降低了无人值守点位的前期硬件成本

2. 技术设计

为了实现“项目中控制开关”,我们将采用HTTP协议进行集成。这是芯步开放接口中最通用、适配性最强的方案,无论你的项目后端是Python、Java、PHP还是Node.js,或是前端小程序,均可无缝对接。

架构流程:你的业务系统 -> HTTP POST/GET -> 芯步云端 API -> WiFi网络 -> 墙壁开关(执行通断)

3. 接入前的准备工作

在编写代码前,需要从芯步物联网控制台获取以下三个关键凭证:

  1. AppID(应用ID): 用于标识你的应用/项目。

  2. AppSecret(开发者密码): 用于计算签名,保障接口安全,请勿泄露

  3. Device ID(设备ID): 即“智能墙壁触摸开关1路”的唯一标识(通常在设备外壳标签上或控制台设备列表中找到)

4. 接入步骤:接口调试与控制

我们需要在项目中编写逻辑来调用他们的/device/control/接口。该接口支持GET和POST方式,这里以更安全的POST JSON格式为例。

接口地址:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}

签名算法(鉴权):为了安全,所有API请求都需要携带签名。芯步的签名规则如下,你需要在你代码中实现此函数

  1. 将你的 AppSecret 进行一次 MD5 加密,得到 Secret_MD5

  2. Secret_MD5 与当前Unix时间戳(秒,即ts)拼接成字符串。

  3. 将拼接后的字符串再进行一次 MD5 加密,得到最终的 sign

  • 公式:sign = MD5( MD5(AppSecret) + ts )

请求体示例(控制灯打开):当你需要控制用户所在区域的灯光时,向设备ID下发power1命令。

核心代码示意(伪代码):

注意: 接口返回200仅代表云端收到了指令,如果设备当时离线(如WiFi断了),设备不会动作。对于无人值守场景,在项目中加入设备心跳检测机制或异步回调通知

5. 场景联动与无人值守逻辑落地

单纯的远程开关不够“智能”,无人值守的核心在于自动化规则。你需要将“开关”与“传感器”或“业务事件”做结合。

第一种场景:用户订单一键授权(共享空间如自习室/茶室)用户在小程序下单支付后,系统自动触发:

  1. 业务逻辑: 订单状态变更为“进行中”。

  2. API动作: 你的后端调用上述接口,控制对应房号/座位的开关 {"power1": 1},灯亮起。

  3. 服务联动(进阶): 配合芯步的“智能人体存在传感器”,检测到室内无人15分钟后,自动调用API关灯;防止用户离开现场时未手动关灯

第二种场景:远程运维与定时消杀(无人便利店/健身房)针对需要定时开启排风扇或紫外线消毒灯的场景:

  1. 设备接入: 将消毒灯或排风扇接入该智能开关。

  2. 定时任务: 在你的项目服务中启用定时任务(Cron Job)。

  3. 代码实现: 设定凌晨2点执行脚本,调用API {"power1": 1} 开启消毒灯,凌晨2:30调用API {"power1": 0} 关闭。全程无需人工干预。

第三种场景:异常状态自恢复无人值守最怕设备离线。该硬件支持设定5组WiFi网络,会自动寻找信号最强的连接。如果你的项目部署在局域网且要求高稳定性,该产品也支持私有化部署局域网纯环境运行,命令可直接发送至本地路由器,无需经过外网云端

6. 高级功能:状态保持与点动模式

在无人值守项目中,你可以利用该产品手册中提到的“特殊命令”来优化体验

  • 状态保持: 有些门店不希望用户随意乱按物理按键改变设置。你可以下发锁定的指令,使得用户物理按下开关后,系统在几秒内自动恢复原状。

  • 点动模式(先通后断): 用于控制门禁电磁锁或警报器。例如发送 {"point1":"3000"},线路将接通3秒后自动断开,非常适合“远程开门”或“短暂警示”场景。

7. 总结

通过将芯步智能墙壁触摸开关(1路) 接入你的项目,你可以获得:

  1. 极速集成: 无需理解复杂的物联网底层协议(如CoAP或MQTT),仅需调用HTTP API,熟悉MD5签名即可在2小时内完成功能开发

  2. 低成本无人化: 利用WiFi直连特性,省去网关成本,实现基于订单或传感器的自动化照明管理。

  3. 灵活部署: 支持公有云和纯局域网两种模式,适应各类网络环境要求

你按照上述“准备-AppID/Secret-计算签名-下发指令”的流程,先用Postman工具手动测试一遍接口通断,再集成到你的业务系统中。