芯步的2路智能墙壁开关通过标准HTTP接口开放控制能力，支持任何编程语言调用。以下方案将从接口对接、签名计算、命令下发到场景的完整流程展开。
解决方案：基于芯步开放接口对接2路智能墙壁开关实现远程照明控制
1. 概述
本方案的目标是指导开发者/集成商利用芯步提供的标准HTTP开放接口，完成对 “2路86型智能墙壁开关” 的对接开发。
通过调用该接口，用户或第三方系统（如ERP、酒店管理系统、共享空间SaaS）可以实现对连接在该开关上的两路照明设备的独立远程控制（开/关）、定时任务以及场景联动。
适用产品：芯步 智能墙壁开关2路 （型号：UNI-KG-2）
接口特点：基于HTTP协议，支持POST方法，接口简单清晰，兼容任何支持HTTP请求的编程语言（JS/Java/Python/PHP/Go等）及平台（如微信小程序、Web应用、iOS/Android App）。
核心参数
安装标准：86型底盒（可直接替换传统墙壁开关）。
负载：单路支持300-1200W（LED节能灯<300W/路）。
电压：100-240V AC（交流市电）。
注意：本方案基于公有云API讲解；芯步亦支持局域网和私有化部署，若需局域网内低延迟控制，可参考局域网API文档。
2. 对接准备
在编写代码前，需完成以下硬件与软件配置：
硬件准备
芯步2路智能墙壁开关 *1台。
220V交流电线路及两路照明负载。
确保设备通电且处于WiFi覆盖范围（仅支持2.4GHz WiFi）。
平台账号准备
注册[芯步官网]账号。
登录控制台，创建“工作台”，进入“物联网控制台”模块。
获取凭证（关键数据）
AppID：应用的唯一标识。
AppSecret：开发者密钥（用于加密签名）。
Device ID：设备的唯一ID（可在控制台查看或通过接口拉取）。
3. 接口鉴权与签名算法
为了防止接口被恶意篡改，所有API请求均需携带动态签名。
签名生成规则如下：sign = md5( md5(AppSecret) + ts )
ts：当前时间的秒级时间戳（Unix Timestamp）。
注意：此处是外层MD5括号内拼接
md5(AppSecret)和ts字符串，而非数值相加。
鉴权参数传递示例：所有请求需携带在URL Query参数中：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
4. 核心对接流程：远程控制两路照明
本章节以最常见的 “远程开灯/关灯” 场景为例，展示具体的API调用细节。
4.1 请求地址与方法
URL
https://api.thingboot.com/{AppID}/device/control/Method
POSTContent-Type
application/json
4.2 请求体参数
在Body中需包含device和order两个字段：
| 字段 | 类型 | 描述 |
|---|---|---|
device | String | 你要控制的设备ID（支持多设备，逗号分隔） |
order | JSON String | 核心指令。指定控制哪个线路及动作 |
4.3 命令集详解（2路开关专用）
针对2路墙壁开关，order字段支持以下标准指令
1. 基本开关控制
| 功能 | order 值 | 说明 |
|---|---|---|
| 打开第1路 | {"power1":1} | 开启照明1 |
| 关闭第1路 | {"power1":0} | 关闭照明1 |
| 打开第2路 | {"power2":1} | 开启照明2 |
| 关闭第2路 | {"power2":0} | 关闭照明2 |
2. 高级场景——状态保持（防误触）特性：用户按了物理按键改变了状态，X秒后自动恢复设定状态。
| 功能 | order 值 | 说明 |
|---|---|---|
| 1路锁定开 | {"power1":{"keep":"1","revert":"3"}} | 用户手动关闭后，3秒自动恢复打开 |
| 2路锁定关 | {"power2":{"keep":"0","revert":"5"}} | 用户手动开启后，5秒自动恢复关闭 |
3. 高级场景——脉冲模式（点动）特性：开启后保持一段时间自动关闭，适用于“门铃”、“排气扇延时关”等场景。
| 功能 | order 值 | 说明 |
|---|---|---|
| 1路先通后断 | {"point1":"2000"} | 1路打开，保持2秒后自动关闭 |
| 2路先断后通 | {"reset2":"1000"} | 1路关闭，1秒后重新打开（复位） |
5. 实战代码示例
以下是使用 Bash (Curl) 和 Python 实现远程关闭第1路照明、开启第2路照明的完整示例。
步骤解析
获取当前时间戳
ts。计算签名
sign。拼接URL并发起POST请求。
示例1：Bash (Curl)
示例2：Python
6. 硬件安装指南
为了保证控制成功，物理接线是基础。针对2路86型开关，接线示意如下
接线柱说明
L / 火线进：接入AC220V 火线（输入）。
L1 / 1路出：接第一路照明灯的火线。
L2 / 2路出：接第二路照明灯的火线。
N / 零线：智能开关需要待机供电，必须接入零线。
注意事项
更换前请一定要断电。
如果是老旧小区只有火线没有零线，需要在底盒中布置零线，或确认是否支持单火取电（该型号为零火版，必须接零线）。
LED灯具功率较低，若出现鬼火（闪烁）现象，可并联产品附带的电容在灯座两端。
7. 常见问题与排障 (FAQ)
报错“签名错误”怎么办？
检查时间戳是否为秒级（10位数字）。
核对拼接顺序：是
md5(md5(Secret) + ts)，不是md5(Secret + ts)。检查AppSecret前后是否有空格。
设备离线无法控制
该设备仅支持2.4G WiFi，检查是否连接了5G信号。
检查设备供电是否正常（指示灯是否亮）。
查看设备所处位置WiFi信号强度，若信号弱需增设AP。
如何获取设备当前状态？
除了主动查询设备状态接口外，芯步支持状态主动推送。在控制台设置“上游消息接收地址”，当设备状态变化（按键按动或远程控制）时，平台会将最新状态POST到你指定的服务器地址，保证数据同步。
8. 总结
通过以上步骤，开发者可以在10分钟内完成对芯步2路智能墙壁开关的HTTP接口对接。该方案利用开放的API，实现了照明系统的远程化、定时化和智能化管理，适用于智慧家庭、共享茶室/棋牌室（计时通断电）、智慧办公等多种商业场景。