壁挂式人体感应开关本身自带一路继电器输出，可以直接控制照明回路，这是最简方案；但如果要实现多路控制、定时联动或数据上报，就需要通过开放接口对接。以下方案覆盖了直接控制和API对接两种模式，你可根据实际场景选择。

1. 概述

本方案的目标是指导开发者或集成商如何利用芯步开放的 HTTP API 接口，对接 智能人体存在传感器（壁挂式） 与 智能照明设备（如智能墙壁开关、智能控制器），实现基于人体存在感知的自动照明控制。

通过该方案，您可以实现：

• 人来灯亮，人走灯灭：在卫生间、走廊、办公室等区域实现自动化照明。

• 双模检测，避免误判：利用红外+雷达双模技术，解决传统红外传感器对人静止不动时误判无人导致的灯光熄灭问题。

• 远程管理与数据分析：通过服务器接收传感器状态，记录人流量或照明使用时长。

2. 硬件产品

3. 对接架构与流程

本方案采用标准的物联网架构，通过 HTTP 接口实现数据流转。

• 架构核心：设备 ——> 云端 API ——> 您的业务服务器 ——> 云端 API ——> 执行设备。

• 通讯协议：HTTP/HTTPS。

• 数据格式：JSON。

联动图

[壁挂传感器] --[上报有人事件]--> [芯步云平台] --[HTTP推送]--> [您的业务服务器] --[逻辑判断(如光照/时段)]--> [调用设备控制API] --> [芯步云平台] --[下发指令]--> [智能开关/控制器]

4. 详细对接步骤

4.1. 基础准备与鉴权

在开始对接前，您需要在芯步控制台完成以下准备：

1. 获取 AppId：您的应用唯一标识。

2. 设置开发密码：用于生成接口调用签名 sign。

3. 获取设备 ID (device)：将传感器和开关设备绑定到平台后获取。

鉴权机制所有 API 请求需携带签名和时间戳。签名生成规则如下：sign = md5(md5(开发者密码) + "." + 时间戳{ts})请求地址格式：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

4.2. 步骤一：接收传感器上报数据

芯步传感器在检测到有人/无人状态变化时，会主动推送数据到您指定的服务器地址。

• 触发事件：当红外模块 (infrared_target) 或雷达模块状态变化时。

• 接收示例（您的服务器需解析此 JSON）：

逻辑：由于该传感器支持 红外+雷达双模，在业务逻辑中采用“与”逻辑：仅当两者均上报为 0（无人）时，才判定为无人，以减少因人体静坐/趴伏导致的误关灯。

4.3. 步骤二：下发照明控制指令

当服务器收到“有人”或“无人”的事件后，即可向智能开关下发指令。

• 请求方式：POST

• 请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求 Body

场景示例

• 探测到有人 -> 下发 {"power1": 1} 开灯。

• 持续无人（如5分钟） -> 下发 {"power1": 0} 关灯。

4.4. 步骤三：高级配置（本地直连方案优化）

为了减少网络延迟或在无公网环境下的可靠性，您还可以利用传感器自带的硬件功能进行本地控制。

硬件直连方案该壁挂传感器除了网络功能外，还内置了 1路 AC 电源输出（继电器）。

1. 接线方式：将传感器的输出端串联在照明灯具的回路上。

2. 效果：无需任何编程和云端交互。当传感器检测到有人，内部继电器吸合，灯亮；人走后，继电器断开，灯灭。

3. 局限性：此方式仅控制单一路灯，无法实现多路控制或复杂的场景联动（如渐亮、定时关）。

5. 关键配置与优化

为了达到最佳的照明体验，在设备配置项中对传感器进行微调：

• 无人延时设置 (infrared_change_0)默认情况下，人离开可能会立即关灯。在会议室或卫生间设置为 1-5 分钟，避免短暂离开时灯光熄灭。通过 API 或控制台设置配置项 infrared_change_0 为 60（即 60 秒）。

• 状态同步 (LED灯状态配置)可将传感器自带的 LED 指示灯配置为“与存在同步”，方便现场测试人员了解当前探测状态。

• 负载注意传感器自带的继电器负载限制为 2200W (阻性) / 350W (感性)。如果接 LED 灯，属于感性负载，需确认总功率不要超过 350W，否则请外接交流接触器。

• 双重逻辑防误判在服务器端代码中，不仅依赖红外，还要结合雷达数据。当 infrared_target == 0且radar_target == 0 时才判定无人，可以有效解决静坐办公场景下的误判问题。

6. 总结

通过对接芯步的开放接口，集成壁挂式人体感应开关实现照明控制主要分为三步：

1. 接收：配置回调地址，订阅传感器的状态变化。

2. 逻辑：在业务服务器端解析双模数据（红外+雷达），判断真实的人体存在状态。

3. 执行：调用设备控制 API，向智能开关下发通断电指令。

该方案具有高度的灵活性，既支持简单的“人走灯灭”节能模式，也能结合服务器逻辑实现复杂的工作流联动。