CATALOG

芯步的智能触摸开关支持HTTP接口远程控制,可同时响应本地触摸操作和云端指令。以下方案以1路86型触摸开关为例,涵盖硬件选型、接口对接、状态同步及部署要点。

解决方案:基于芯步开放接口实现1路86型触摸开关的本地触摸与远程双控制

1. 项目概述与选型

在智能家居或工业控制场景中,用户往往既希望通过墙壁开关直接手动控制(本地),又希望通过手机App或中央控制系统远程操作(远程)。为解决此需求,我们选用芯步的智能触摸墙壁开关(1路)

  • 硬件型号:智能触摸墙壁开关1路

  • 核心优势

    • 标准86型:兼容国内标准底盒,可直接替换传统开关,无需重新布线。

    • 独立控制:支持通过HTTP接口独立控制负载(照明、风机等)。

    • 状态反馈:设备物理操作与远程操作互不干扰,且支持状态同步。

2. 硬件安装与接线

物理接线

  • 输入:将市电(220V AC)的火线(L)接入开关的“L”端。

  • 输出:将灯具/负载的控制线接入“L1”端(1路输出)。

  • 零线注意:为确保触摸开关的触摸电路及Wi-Fi模块稳定工作,通常需接入零线(N)。请确保86底盒内有零线

电路示意

断路器(火线) → 智能开关L端断路器(零线) → 智能开关N端智能开关L1端 → 灯具 → 零线回路

3. 设备配网与激活

设备上电后,长按触摸面板进入配网模式(指示灯闪烁)。通过芯步提供的配网工具将设备接入2.4GHz Wi-Fi:

  1. 方式一(小程序):微信搜索“芯步”小程序。

  2. 方式二(控制台):登录芯步官网进入“物联网控制台”

  3. 按照提示配置现场Wi-Fi名称和密码,直到设备指示灯常亮,表示上线成功。

4. 开放接口对接实现(远程控制)

芯步开放标准的HTTP API接口,支持任何后端语言(Java, Python, PHP, Node.js等)调用

4.1 接口核心参数

  • 请求地址http(s)://api.thingboot.com/{AppID}/device/control/

  • 鉴权方式:Sign签名 (MD5加密) + 时间戳ts

  • 请求方式:POST (application/json)

4.2 签名生成逻辑这是对接的关键步骤:

  1. 准备AppSecret(在控制台获取)。

  2. 计算 md5_secret = md5(AppSecret)

  3. 拼接字符串 sign_str = md5_secret + ts(ts为当前Unix时间戳)。

  4. 最终签名 sign = md5(sign_str)

4.3 下发命令示例场景:远程关闭灯光。

  • 关键字段order 中的 power1 对应物理上的“第1路”输出

4.4 代码示例(伪代码/Python)

5. 双控逻辑与并发处理

场景说明

  • 本地控制:用户触摸物理面板 → 开关内部继电器翻转 → 状态改变。

  • 远程控制:服务器下发 {"power1":0} → 开关Wi-Fi模组接收指令 → 继电器动作。

状态同步机制

  • 实时性:无需额外同步代码。设备状态改变时(无论起因),会自动上报状态至云端。

  • 冲突处理:如果在远程命令下发的同时用户触摸了开关,硬件继电器是最终执行者。由于响应速度极快(毫秒级),这种并发冲突通常不会造成实际影响,最终物理触点状态即为实际状态

进阶功能(防误触/逻辑锁)在某些特殊场景(如投影仪散热),需要防止本地误关。可利用接口中的 “状态保持” 功能:

  • 命令示例{"power1":{"keep":"1","revert":"30"}}

  • 逻辑:强制开启灯光,即使用户本地触摸关闭,30秒后开关也会自动恢复开启状态

6. 部署实施

  1. 网络环境:设备仅支持2.4G Wi-Fi(802.11 b/g/n)。请确保路由器开启2.4G频段,若双频合一存在兼容性问题,关闭5G融合或单独设置IoT网络

  2. 负载匹配:虽然1路开关额定电流通常为10A,但针对LED灯有启动冲击电流,单路功率控制在300-1200W以内,避免继电器粘合

  3. 局域网直连(可选):芯步接口支持局域网发现与控制。若云服务器不可用(外网断开),只要手机与设备处于同一局域网,仍可通过本地API进行控制,增强了系统稳定性

7. 总结

通过上述方案,仅需简单的HTTP POST请求即可完成对1路86型触摸开关的集成。该方案利用了芯步成熟的IoT能力,将复杂的网络连接和鉴权封装在简单的order指令中,开发者只需关注业务逻辑(硬件选型、接线、指令调用),即可在短时间内实现“本地顺手可控,远程随时随地控”的智能化改造。