怎样接入2路照明开关以实现远程控制照明与设备_解决方案

CATALOG

芯步的智能开关开放HTTP接口，只需POST请求即可实现远程控制，响应速度80-120ms。以下方案涵盖设备选型、安装接线、接口调用及延时/保持等高级功能配置。

1. 概述

本方案基于芯步智能触摸墙壁开关2路硬件，利用其开放的HTTP API接口，实现对照明设备（两路独立控制）及通过开关扩展的其他电器设备的远程通断控制。

该方案具备以下核心优势：

该设备是方案的核心，外观与普通墙壁开关一致，内部集成了WiFi模组与继电器模块。

物理参数：标准86型底盒安装。
负载能力：适用于照明灯具、排风扇等阻性/感性负载。
接口定义
- L（火线）、N（零线） ：若家中为单火布线，无需接入N线。
- L1（出线1）：控制第一路照明/设备。
- L2（出线2）：控制第二路照明/设备。

注意：接线前请请一定要切断总闸断路器电源，使用电笔确认无电后方可操作。

拆除旧开关：卸下需要更换的传统双开墙壁开关，露出底盒内的电线。
区分线路
- 确认火线（通常为红色/棕色）与照明控制线（通常为黄色/白色或其它颜色）。
- 确认底盒内是否有零线（蓝色/黑色）。如有，则为零火布线；如无，则为单火布线。
设备接线
- 将进线（火线）接入开关的 L 端口。
- 将第一路灯具的控制线接入 L1 端口。
- 将第二路灯具的控制线接入 L2 端口。
- 若为零火布线，将零线接入 N 端口。单火布线则悬空N口（无需短接）。
固定安装：理顺电线，将开关推入底盒，用螺丝固定面板。通电测试本地触摸是否灵敏。

设备上电后，需要将其连接至现场Wi-Fi网络。

准备工作

操作步骤

获取AppID：登录芯步官网，进入控制台，获取系统生成的 AppId。
配置Wi-Fi
- 在控制台的“物联网控制台”模块，点击“网络配置”。
- 点击“登记网络”，输入现场实际的Wi-Fi名称和密码（必须是2.4G），保存。
设备配网
- 长按开关面板上的任意按键（或按照说明书操作），直到指示灯进入快闪状态（配网模式）。
- 在控制台中点击“为设备配置此网络”，根据页面提示（可能需要模拟手机热点），等待设备连接成功。
- 成功后，页面列表会显示该设备的唯一ID（例如 820720），请记录此Device ID，后续API调用需要用到。

芯步的智能开关开放了全功能的HTTP API，AppId、Device ID、签名（sign）和时间戳（ts）是调用的核心要素。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方式POST
数据格式Content-Type: application/json

针对“2路照明”，主要使用 power1 和 power2 参数来分别控制第一路和第二路的通断。

命令结构示例：

场景：开启第1路，同时关闭第2路

编程调用示例（Python）

除了简单的开/关，该接口还支持丰富的工业及商业控制逻辑，非常适合需要自动化管理的场景。

适用场景：楼道灯、排气扇，开启后希望自动关闭。

适用场景：场景模式切换，关闭当前设备，延时重启路由器等。

参考命令数值说明

适用场景：公共场所（如酒店、会议室、教室）的空调或无人售货机供电。管理员远程设定后，防止现场人员手动关闭。

注：若 keep 设置为 0，则代表保持关闭，用户手动开启后也会被强制拉回关闭状态。

为了构建真正的智能照明系统，可以利用芯步生态中的传感器数据。

例如：“人来灯亮，人走灯灭”。

设备准备：在走廊安装“智能人体存在雷达传感器”。
逻辑设定
- 搭建后台服务接收传感器的消息推送（如雷达检测到有人：radar_enable 状态变更为 1）。
- 服务端根据推送逻辑，自动调用本文第4节中的API命令：
  - 收到“有人”信号 $\rightarrow$ 调用开关API，{"power1":"1"} 开灯。
  - 持续一段时间未收到“有人”信号 $\rightarrow$ 调用开关API，{"power1":"0"} 关灯。

设备不在线：检查Wi-Fi密码是否正确（设备不支持5G频段），或按照配网流程重试。
控制失效（返回签名错误）
- 检查 {AppId} 路径是否替换正确。
- 严格核对 sign 的生成算法（拼接顺序、MD5大小写）是否与官方文档一致。
本地手动按压无效：检查开关L1/L2端子的螺丝是否拧紧，接触是否良好。