壁挂式高精度“双模”探测器集成了红外与雷达双重探测技术，同时自带一路可控电源输出。以下方案详细说明如何通过芯步开放接口，实现对探测器上电器供电的远程开关控制。
解决方案：基于芯步开放接口对接“双模”探测器实现远程电源控制
1. 概述
壁挂式高精度“双模”探测器（型号：UNI-CGQ-RT-H-BG）不仅具备红外+雷达双重人体感应功能，还内置了一路继电器输出（AC 100-250V输出）。通过芯步开放的HTTP API接口，您可以远程控制这一路输出的通断，从而实现对连接在其上的照明、警示器等设备的电源管理。
适用场景：
办公节能：在下班后或无人时段，远程切断办公室照明/电源。
安防联动：探测到无人时，自动关闭插座或声光报警器。
工业控制：根据系统指令，远程复位或关闭现场某一路电器设备。
2. 准备工作
在开始接口对接前，请完成以下环境准备：
硬件就位
确保探测器已接入AC 220V市电。
关键点：将需要控制的电器（如灯带、蜂鸣器）接入探测器的“负载输出”端（参考设备背面的走线示意）。
网络配置
为设备配置2.4GHz的WiFi网络，确保设备在云端处于“在线”状态。
获取凭证
登录芯步工作台。
在“开发设置”中获取
AppID和AppSecret（开发者密码），这是调用接口的钥匙。
获取设备ID
在控制台设备列表中，查看该探测器的唯一标识
Device ID（如：1878）。
3. 接口对接方案
控制该设备的核心是向芯步平台发送一个HTTP POST请求。平台使用签名机制保证安全性，命令通过JSON格式传输。
3.1 接口基本信息
请求地址
https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法
POSTContent-Type
application/json签名算法
sign = md5( md5(AppSecret) + ts )（其中ts为Unix时间戳）。
3.2 核心命令结构根据该探测器的产品手册，控制继电器 “接通”或 “断开” 使用字段名 power。
| 功能描述 | 命令参数 （order） | 设备返回码 （code） | 物理表现 |
|---|---|---|---|
| 开启电源 | {"power": 1} | 200 （下发成功） | 负载输出端闭合，电器开始工作。 |
| 关闭电源 | {"power": 0} | 200 （下发成功） | 负载输出端断开，电器停止工作。 |
注意
"code":200仅代表指令被云端接收并行至设备，若设备处于离线状态，指令不会生效。
3.3 请求示例 （以关闭电源为例）假设 AppID 为 testApp，Device ID 为 1878，需要关闭设备电源。
1. 计算签名设 AppSecret 为 abc123。
第一步：
md5(abc123)=e99a18c428cb38d5f260853678922e03第二步：取
ts=1714032000第三步：计算
sign=md5(e99a18c428cb38d5f260853678922e031714032000)=xxxxxxxxxxxxxxxxxxxx
2. 发送请求 （Linux Curl为例）
3. 请求参数详细说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| device | String | 是 | 探测器的设备ID，从控制台获取 。 |
| order | Object | 是 | 指令集。 |
| └ power | Int | 是 | 1 = 接通/开启电源；0 = 断开/关闭电源 。 |
4. 成功返回示例
4. 进阶应用：基于“无人状态”的自动控制策略
在实际解决方案中，往往需要根据探测器感知的人体存在状态自动切断电源，而不仅仅是通过手动发送HTTP指令。
由于探测器不仅执行指令，还会上报数据，您可以利用这一特性设置自动化逻辑：
监听设备上报当“红外”和“雷达”均判定无人时，设备会向平台上报状态。您可以通过芯步的消息推送机制接收该状态变更 。
业务逻辑执行您的服务器接收到“无人”事件后，自动拼接上述
/device/control接口的关闭指令，发送给同一台设备的Device ID，即可实现“人走灯灭/电断”的无人值守方案。
5. 常见问题与排错 （FAQ）
为什么发送指令成功 （code=200），但电器没反应？
检查负载：确认电器功率是否超过探测器负载上限（感性负载不超过350W）。
检查接线：确认电器是接在“负载输出”端，而非直接接在零火线上。
检查设备状态：在控制台查看设备当前是否显示“离线”。
控制延迟高怎么办？
芯步接口公网延迟通常在80-120ms左右，若延迟过高，请检查本地网络上行带宽，或考虑使用MQTT协议进行长连接控制。
如何获取更详细的设备状态？
可以通过调用 设备详情接口 获取当前设备的具体属性，例如当前是有人/无人状态、当前的
power值（开/关）等。
6. 总结
通过芯步的标准化HTTP接口，对接壁挂式“双模”探测器的电源控制功能仅需三步：配置网络 -> 获取ID -> 调用 power 指令。该方案复用性强，开发人员即使不接触底层硬件协议，也能在10分钟内完成“远程控制”及“无人自动断电”等智能化场景的搭建。