CATALOG

芯步的智能墙壁开关开放标准HTTP接口,支持远程控制和状态监测。针对3路开关的需求,目前2路开关可直接使用,3路场景推荐使用4路控制器并按需配置。以下方案涵盖设备选型、接口调用、状态监测与联动逻辑的完整实现。

1. 解决概述

本方案的目标是利用芯步智能墙壁开关的开放HTTP接口,通过您的业务服务器或云平台,实现对3路电源开关的状态实时监测智能联动控制

适用场景:智能家居、办公室节能改造、机房设备监控、酒店客房控制、老旧厂房智能化改造等。

核心技术优势

  • 接口标准化:基于HTTP协议,支持任何编程语言(Python, Java, Node.js, PHP等)。

  • 部署灵活:支持公有云局域网乃至纯私有化部署,即便断外网也能通过局域网API控制。

  • 双向通信:支持设备状态实时上报(Upward)和云端指令下发(Downward)。

2. 硬件选型

由于芯步目前官网展示的标准品以2路为主,如果需要接入3路设备,采用以下两种方案:

方案推荐型号实现的方式是优势
方案一4路智能控制器支持3路直接满足3路需求,且留有余量,支持更大功率。命令格式需使用 power1power2power3
方案二2路开关 + 1路开关组合使用一个86底盒装不下,需两个设备,通过软件逻辑组合成一个“虚拟3路”

:为了简洁与成本效益,对接时可采用4路智能控制器(或照明控制器),仅在软件端启用其中3路即可。

3. 接口对接准备

在进行开发前,需要准备以下参数:

  1. 注册与登录:访问芯步官网注册开发者账号。

  2. 创建工作台:在用户控制台创建一个“工作台”,相当于创建一个项目空间。

  3. 获取凭证

    • AppID: 应用唯一标识。

    • AppSecret: 开发者密码,用于计算签名。

  4. 设备配网:将智能开关通电,利用“芯步小程序”或“PC控制台”将设备连接至2.4G WiFi,并记录下生成的 DeviceID(设备ID)。

4. API 签名与鉴权机制

芯步的接口安全性基于动态签名,所有API请求需携带 signts(时间戳)。

签名算法核心逻辑:

sign=md5(md5(AppSecret)+ts)sign = md5( md5(AppSecret) + ts )

(注:公式中的 + 代表字符串拼接)

详细步骤如下:

5. 实现“3路设备状态监测”

要实现状态监测,通常有两种模式:

方案 A:主动查询(适用于轮询)

通过HTTP接口查询设备的当前状态。

  • 请求地址https://api.thingboot.com/{AppId}/device/query/

  • 请求方式:POST

  • 请求参数

  • 返回解析:服务器会返回一个JSON,里面包含当前各路开关的 power 状态(如 “power1”:“1” 表示第一路开, “power2”:“0” 表示第二路关)。

方案 B:被动接收(推荐,实时性高)

设备状态改变时(手动触摸或远程控制),芯步服务器会主动向你的服务器推送消息。

  • 设置回调URL:在控制台设置你的服务器接收地址,例如 http://你的域名/api/device/callback

  • 数据格式

  • 逻辑实现:接收该JSON,更新你本地数据库中的对应设备状态。

6. 实现“3路设备远程控制”

基于标准HTTP接口,你可以发送指令独立控制每一路。

  • 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

  • 请求方式:POST

  • Header:Content-Type: application/json

第一种场景:独立控制(控制第1路开,第2路关,第3路开)

针对4路或8路控制器,使用 power1power2 等字段:

第二种场景:批量控制(全开/全关)

第三种场景:脉冲/点动控制(先通后断)

适用于控制闸机、门禁或脉冲式复位设备。以下指令代表“第1路接通3秒后自动断开”:

7. 应用案例:办公室节能联动系统

需求描述会议室里有3组灯(对应3路开关),安装一个人体传感器。当无人时自动关闭3路灯光;当有人进入时,根据时段自动开启部分灯光。

实现逻辑

  1. 设备接入

    • 智能墙壁开关(4路,接3组灯)。

    • 智能人体传感器(用于探测是否有人)。

  2. 联动

    • 监听:服务器监听人体传感器的回调接口。

    • 触发:接收到“无人”状态持续5分钟的信号。

    • 执行:服务器组装控制指令 {“power1”:0, “power2”:0, “power3”:0},调用控制接口,切断3路灯光,节约电能。

    • 反馈:服务器收到开关返回的状态(全为0),更新Web/APP界面显示“已关闭”。

8. 本地局域网控制(低延迟方案)

对于需要高稳定性或不能连接外网的场景,芯步支持局域网控制。在设备配网后,你的服务器可以通过路由器,直接向设备的局域网IP发送指令,无需经过云端,延迟更低(毫秒级)。

9. 常见问题排查

  1. 签名错误:请检查时间戳是否为秒级(10位),以及MD5计算是否正确(注意32位小写)。

  2. 设备不在线:智能开关必须连接至2.4G WiFi,不支持5G频段。检查WiFi密码是否含特殊字符。

  3. 3路控制无效:确认选用的设备是否支持第3路。如果是标准2路开关,power3 会返回参数错误。

10. 总结

通过芯步的开放接口接入3路智能电源开关的技术流程已清晰呈现。您无需开发复杂的底层驱动,只需关注业务逻辑层,通过调用标准的HTTP API,即可实现:

  • 接口管理:初始化AppID、AppSecret和设备ID。

  • 状态监测:实现回调接口以接收实时状态,或定时轮询。

  • 设备控制:构建JSON命令,向指定设备发送控制指令(如 {“power1”:0, “power2”:0, “power3”:0})。

按照上述步骤,即可构建稳定、灵活的智能电源管理系统。