CATALOG

芯步的2路墙壁开关采用标准86型安装,支持通过HTTP接口进行远程控制。以下方案涵盖设备选型、接口对接逻辑和状态同步处理,可快速集成到现有项目中。

解决方案:基于芯步开放接口的2路墙壁开关集成指南

1. 背景与选型

在智能照明或智慧办公/家居项目中,将传统的本地墙壁开关升级为远程可控的智能设备,是实现环境智能化的基础。芯步提供的 “智能触摸墙壁开关2路” 是此类需求的标准化硬件。

  • 硬件规格:标准86型底盒,支持零火线接法,单路最大负载可达10A(约2200W阻性负载),适用于绝大多数的照明回路和排气扇控制

  • 接口优势:该设备开放标准的HTTP API接口,无论你的项目后端是Java、Python、Node.js还是PHP,均可通过通用的HTTP协议进行控制

  • 支持场景:支持局域网(LAN)和公网(SaaS)两种模式,也支持私有化部署,保障数据安全

2. 集成架构流程

要将设备集成到你的项目中,通常只需要三个步骤:

  1. 设备配网与注册:硬件安装后,通过“芯步”小程序或控制台将设备加入Wi-Fi(仅支持2.4GHz),获取唯一的设备ID(Device ID)。

  2. 获取API凭证:在芯步开放平台创建工作台,获取AppID、AppSecret,并设置IP白名单(可选)。

  3. 业务系统对接:你的业务系统(如APP、小程序、SaaS后台)通过调用芯步的API接口,向指定设备ID发送控制指令。

3. 核心技术指令

芯步的接口设计遵循无状态原则,核心在于构造正确的HTTP请求。所有控制逻辑均封装在 order 参数中。

接口地址https://api.thingboot.com/{AppID}/device/control/

认证方式请求需携带签名(Sign)和时间戳(Ts)。签名算法通常为 md5(md5(AppSecret) + ts),用于验证请求合法性

核心指令表(针对2路开关)以下是你需要集成的几个关键JSON指令:

功能描述指令JSON(order参数)适用场景
控制第一路开启{"power1": 1}打开第一盏灯/电器
控制第一路关闭{"power1": 0}关闭第一盏灯/电器
控制第二路开启{"power2": 1}打开第二盏灯/电器
控制第二路关闭{"power2": 0}关闭第二盏灯/电器
全开/全关{"power1":1,"power2":1}{"batch":{"relay":[1,2],"power":1}}一键全开或全关
互锁控制{"power1":1,"power2":0}确保同一时间只有一路通电(如电机正反转)
状态保持{"power1":{"keep":"1","revert":"3"}}强制锁定开关状态,用户手动关闭3秒后自动恢复开启
点动/脉冲{"point1":"2000"}先通后断,模拟按键按下2秒

调用示例(cURL)以下是一个典型的关闭第一路照明的请求示例:

4. 状态同步与异步处理

在商业化项目中,状态同步至关重要,主要有两种处理方式:

  1. 同步反馈(仅代表指令送达)

    • 调用API后,返回{"code":200}仅代表芯步云端已接收指令并下发给设备。此时设备可能因网络延迟尚未执行

  2. 异步推送(确保状态执行)

    • 为确保业务数据库与设备状态一致,在你的服务器设置一个“消息接收地址”(Webhook)。

    • 当设备真正执行指令(如继电器吸合)后,芯步平台会主动向该地址推送设备的最新状态(如 power1:1)。你的系统需监听该POST请求并更新数据库中的设备状态。

5. 典型业务逻辑代码示例(伪代码)

假设你需要开发一个“一键离家模式”功能,关闭所有灯光:

6. 高级应用场景

利用芯步的接口,你可以实现超越传统开关的联动逻辑:

  • 传感器联动:结合该平台的人体传感器接口,当检测到无人移动时,向2路开关下发关闭指令,实现“人走灯灭”

  • 定时/倒计时:利用point命令实现楼梯灯延时关闭,或在你的业务层利用定时任务调用控制接口。

  • 物理锁定:在共享场景(如共享自习室、棋牌室)中,通过keep命令锁定开关状态,防止用户手动关闭空调或灯光,直到订单结束才解锁

7. 注意事项

  • 网络环境:设备仅支持 2.4GHz Wi-Fi,若现场存在5GHz同名热点可能导致配网失败。

  • 负载类型:虽然额定10A,但如果是LED灯或节能灯,需注意其启动电流较大,单路控制在300W以内以延长寿命

  • 零火线:该类86型智能开关通常需要 零线 。在老旧项目中若只有火线(单火),需选择专门的单火版开关,请确认硬件型号。