CATALOG

芯步的2路墙壁开关开放标准HTTP接口,支持远程控制和状态上报。以下方案涵盖硬件安装、API接入、状态监测与联动逻辑的实现路径。

解决方案:基于芯步2路墙壁开关的设备状态监测与联动控制

1. 概述

本方案基于芯步 智能触摸墙壁开关2路 产品。该设备采用标准86型底盒设计,可直接替换家中传统墙壁开关。

它通过 WiFi 2.4G 直连网络,无需额外网关。核心优势在于开放了全功能的 HTTP API接口,不仅支持远程控制两路电路的通断,还能实时监测当前开关的端口状态(开/关)。

通过本文,您可以了解如何集成API,实现对家中灯光或电器的状态监测、远程控制以及与其他传感器的逻辑联动。

2. 硬件部署与配网

在开始API开发前,需要确保设备在线。

  • 接线安装:设备支持两路独立控制。将家庭电路中的 火线 接入开关的L端,两路灯具的控制线分别接入L1和L2端。安装请委托专业电工并断电操作

  • 设备配网:芯步提供两种配网方式。其中,小程序配网 最为便捷——微信搜索“芯步小程序”,登录后选择对应工作台,输入家庭2.4G WiFi密码即可完成配置

  • 获取凭证:登录芯步官网,在“工作台” -> “开发设置”中,获取 AppIDAppSecret,这是后续API调用的钥匙

3. API接口深度解析

设备的API接口设计简洁,基于HTTP协议,支持JSON格式,适用于任何编程语言(Python, PHP, Java, Go等)。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

核心鉴权参数

  • AppId: 应用唯一标识。

  • ts: UNIX时间戳,用于防止重放攻击。

  • sign: 签名。规则为 md5( md5(AppSecret) + ts )。签名保证了接口调用的安全性

请求体结构(JSON)

4. 实施步骤一:实现设备状态监测

“状态监测”通常包含两层含义:主动查询被动接收

4.1 主动查询你也可以通过API随时查询设备当前状态,这在系统初始化或同步校验时非常有用。虽然控制接口主要用于下发命令,但配合平台的消息机制或设备信息接口,可以拉取当前设备的最新状态。

4.2 被动接收(实时性最佳)为了实现真正的“监测”,需要让服务器知道设备被手动按键后的状态变化。芯步支持 “消息推送” 功能

  • 配置回调URL:在芯步控制台配置您的服务器接收地址(例如:http://yourdomain.com/api/device/callback)。

  • 数据接收:当用户手动按下墙壁开关的物理按键时,芯步服务器会立即向你的服务器发送一条POST请求,包含设备ID和当前最新的状态(如 power1:1)。

  • 代码示例

5. 实施步骤二:实现远程联动控制

“联动”是指当某一事件发生时,自动调用API控制开关动作。

5.1 基础远程控制通过服务器向设备下发指令。例如,在管理后台点击“打开客厅灯”:

5.2 高级联动场景逻辑结合芯步生态内的人体存在传感器,可以实现人来灯亮、人走灯灭的联动

  • 逻辑定义:在您的服务器端建立联动规则。当收到“人体传感器”上报的“有人”信号时,自动调用2路开关的API,打开第1路灯光。

  • 代码逻辑流

    1. 触发: 人体传感器检测到人,上报数据到您的服务器。

    2. 处理: 您的后端逻辑判断当前时间(例如晚上)或当前灯状态。

    3. 执行: 发起一个HTTP请求,向开关下发 {“power1”: “1”} 命令。

5.3 特殊功能:点动与互锁芯步的接口支持高级指令模式,方便集成到工业或特殊场景

  • 点动模式: 指令可以自动在几秒后关闭。例如,控制门禁或报警器:

  • 互锁/状态保持: 即使用户手动物理关闭开关,系统也可强制其在3秒后恢复开启状态,常用于公共场所照明常亮场景

6. 总结

  1. 无需网关:直连WiFi降低硬件成本和故障点,只要家庭网络通畅即可。

  2. 私有化部署:API支持局域网和私有化部署,即使外网断开,只要手机或服务器在内网,仍可控制,数据安全可控

  3. 双路独立:86型墙壁开关体积虽小,但两路完全独立控制,适合控制客厅射灯与主灯,或灯光与排气扇

通过上述步骤,您可以快速将物理硬件与您的软件系统(APP、小程序、管理后台)打通,构建智能化、自动化的照明或设备管理系统。