芯步的3路智能开关通过标准HTTP接口开放控制能力，可以灵活接入各类业务系统。以下方案以“人体传感器触发灯光”为典型场景，说明从设备接入、接口调用到联动规则配置的完整实现路径。

1. 背景与概述

在智能家居和楼宇自动化场景中，实现对灯光、窗帘、电器等设备的多路独立控制和智能联动是核心需求。芯步推出的3路智能墙壁开关（包括按键版和触摸版）提供3路独立继电器输出，可直接替代传统86型墙壁开关，对三路照明或电器进行通断电控制。

本方案的目标是指导开发者如何利用芯步开放平台及设备HTTP API接口，快速将3路智能开关集成到现有系统中，并结合传感器（如人体雷达、温湿度传感器）或其他业务逻辑（如计时器、外部事件），实现设备间的自动化联动控制。

2. 核心产品与接口能力

2.1 硬件产品规格

• 产品名称：智能墙壁开关3路 / 智能触摸墙壁开关3路

• 控制路数：3路（独立控制）

• 负载能力：阻性负载 300-1200W/路，容性负载（如LED）需控制在300W以内。

• 网络连接：WiFi 2.4GHz 802.11 b/g/n，无需网关，直连路由器。

• 安装方式：标准86型底盒，支持直接替换传统开关。

2.2 开放接口能力

芯步开放平台提供基于 HTTP/HTTPS 的API接口，架构如下：

• 控制端：用户自建服务器/第三方SaaS/移动端应用。

• 被控端：3路智能墙壁开关（自带WiFi模块）。

• 感知层：人体传感器、门磁、温湿度传感器等（作为联动触发器）。

接口核心特性

• 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。

• 认证方式：签名验证（Sign） + 时间戳（Ts），防止接口被恶意篡改。

• 通信协议：POST请求，Body为JSON格式。

• 响应速度：命令下发到设备执行约 80-120ms。

3. 设备联动控制设计

为实现“接入3路开关并实现联动”，采用云平台中央逻辑控制架构，而非设备直连设备（点对点），以便于管理复杂的业务规则。

数据流向

1. 触发源：传感器检测到状态变化（如“有人移动”），上报数据至用户服务器/芯步云。

2. 规则引擎：用户服务器根据预设逻辑判断（如“若当前光照低且有人”），生成开关指令。

3. 指令下发：服务器调用芯步 device/control 接口，向指定3路开关发送JSON指令。

4. 执行动作：开关第1路（照明）闭合，点亮灯光；延时5分钟后，调用接口断开第3路（排风扇）。

4. 详细接入实施步骤

4.1 环境准备与设备配网

1. 注册开发者账号：在芯步开放平台注册账号，获取 AppId 和 AppSecret，用于生成签名。

2. 设备配网：长按开关按键直至指示灯闪烁，通过“芯步”或自研APP配置WiFi密码。设备支持存储5组WiFi，自动选择信号最强的网络连接。

4.2 API接口调用核心逻辑

接口调用主要涉及“单路控制”和“高级时序控制”两种模式。由于开关具备3路，将 power1、power2、power3 分别映射为不同的用电设备。

4.2.1 单路独立控制命令

通过修改 order 参数中的 power1、power2、power3 值来控制对应电路的通断。

• 场景示例：关闭第2路（接电动窗帘），打开第1路（接客厅灯带）。

命令说明：该JSON用于指示开关闭合第1路和第3路，断开第2路。

4.2.2 高级联动：状态保持与脉冲控制

在某些联动场景下，如门禁联动灯光，需要灯光点亮30秒后自动熄灭，避免长亮费电。

• 瞬动/点动（先通后断）：指令接通后，自动延时断开。

• 场景示例：按下门铃或人脸识别成功，联动开关第1路点亮玄关灯，15秒后自动关闭。

命令说明：支持 point1、point2、point3 分别设置三路不同的延时通断逻辑。

4.3 传感器联动逻辑实现（以人体雷达传感器为例）

目标：当有人进入洗手间（人体雷达检测到“有人”），自动开启3路开关中的第1路（照明）和第2路（排风扇）；人员离开2分钟后，自动关闭这两路。

实现流程

1. 订阅消息：在服务器端配置接收传感器的状态变更推送。芯步传感器在检测到“有人”变“无人”时会主动推送数据到指定URL。

2. 逻辑处理（伪代码）

   # 接收传感器上报数据 def on_sensor_data(sensor_id, status): if sensor_id == "雷达_001" and status == "someone_detected": # 调用开关控制接口 control_switch(device_id="开关_客厅", power1="1", power2="1") elif sensor_id == "雷达_001" and status == "no_person": # 延时120秒后再检查状态（通常配合计时器或再次确认） time.sleep(120) control_switch(device_id="开关_客厅", power1="0", power2="0")

3. 指令执行：服务器调用芯步接口，发送如 {"power1":"0", "power2":"0", "power3":"保持不变"} 的命令。

5. 方案关键特性与高级应用

5.1 批量控制与场景模式

当需要一次性控制多个开关或同一开关的多路时，可使用 batch 命令。

• 场景示例：“离家模式”一键关闭全屋所有灯光。

• 接口调用{"batch":{"relay":[1,2,3],"power":"0"}}，这样能一次关闭三路，减少网络请求次数。

5.2 状态保持（场景恢复）

在影音室或会客室场景中，当用户按动机械开关触发场景时，若希望松开后恢复到之前状态，可使用状态保持功能。

• 命令格式{"power1": "2"} 或类似参数（部分高端型号支持），用于实现长按调光或短按切换逻辑。

5.3 私有化部署（局域网直连）

对于工业或强保密要求的场景，芯步设备支持局域网纯内网运行。如果用户的服务器与3路开关处于同一局域网段，可直接通过设备本地的IP地址调用HTTP接口，无需经过外网云平台，降低延迟并增强数据安全。

6. 总结

通过接入芯步3路智能墙壁开关的开放接口，开发者可以实现：

1. 高精度控制：3路独立控制，支持功率高达1200W/路的各类负载。

2. 灵活联动：基于HTTP接口，轻松打通人体传感、温湿度、烟感等各类传感设备，实现“来灯亮、走灯灭”等智能逻辑。

3. 多样化部署：支持公有云API调用和私有化局域网部署，适应不同业务场景。

4. 丰富的业务逻辑：利用 point、reset、batch 等高级指令，实现脉冲控制、互锁控制等复杂工业/家居逻辑。

该方案可广泛应用于智慧办公（工位/会议室管理）、智能家居（灯光/窗帘联动）、以及共享棋牌室/茶室（包间自动化控制） 等场景。