芯步的吸顶式红外探测器开放了标准的HTTP接口，支持远程参数配置和实时状态上报。以下方案从接口协议、关键参数说明、调用流程到代码示例，完整呈现集成方法。
解决方案：基于芯步开放接口的吸顶式红外探测器远程配置与集成
1. 概述
芯步的智能人体存在红外传感器（吸顶式，型号：UNI-CGQ-RT-XD-H）不仅具备高精度的人体移动探测能力，还开放了标准的 HTTP API 接口。通过该接口，开发者可以无需接触物理设备，远程下发指令以实现感应参数的动态调整（如红外开关、触发延时等）以及实时状态的获取。
本方案的目标是指导开发者如何利用芯步的开放能力，在 Web 端或移动端后台实现对吸顶式红外探测器的深度集成。
2. 接口与物模型定义
该设备采用 Wi-Fi 直连方式，无需网关，数据交互基于 HTTP 协议。在配置参数前，需理解设备的核心“物模型”属性。
| 功能分类 | 参数/指令 | 数据类型 | 取值说明 |
|---|---|---|---|
| 核心感应控制 | infrared_enable | 布尔 | 1 (开启红外感应) / 0 (关闭红外感应) |
| 状态读取 | infrared_target | 布尔 | 1 (有人) / 0 (无人) |
| 触发延时配置 | infrared_change_1 | 枚举 | 有人触发持续时间：0(马上),1,2,3,5(秒) |
| 触发延时配置 | infrared_change_0 | 枚举 | 无人触发持续时间：0(马上),30,60,120,180,300,600(秒) |
| 联动控制 | power | 布尔 | 1 (接通线路) / 0 (断开线路，控制被控设备) |
| 指示配置 | led | 枚举 | 1(长亮), 0(长灭), blink(闪烁), rl_s(与线路同步) |
| 系统维护 | system | 指令 | restart(软重启), network(查看网络信息) |
表1：吸顶式红外探测器关键配置参数表
3. 远程参数配置核心流程
要实现“远程感应参数配置”，主要分为指令下发和状态反馈两个通道。
3.1 鉴权与请求构造芯步的接口采用动态签名鉴权，所有配置指令需通过 POST 请求发送至 http(s)://api.thingboot.com/{AppId}/device/control/。
关键参数：需在 URL 中携带
sign（签名）和ts（时间戳）。Header
Content-Type: application/json
3.2 下发配置指令（以配置触发延时为例）假设需要将“无人”状态的触发延迟调整为 5 分钟（300秒），以解决因人员短暂静止导致灯光误关闭的问题。
请求Body示例
注：参数值直接填写对应的枚举数值（如300代表5分钟），设备收到指令后写入 Flash 并立即生效，无需重启。
3.3 实时状态上报与事件监听参数配置是否生效，以及现场是否有人，依赖于设备的上行推送。
机制：设备探测到状态变化（如
infrared_target从 1 变 0，或有人持续时长达到设定的infrared_change_1阈值）时，会主动推送消息至开发者预设的服务器地址。推送事件
infrared_detect：红外状态变化事件。btn1：设备按钮按下事件（可用于现场调试与远程巡检）。
4. 典型应用场景方案设计
场景名称：办公室节能模式自适应调整需求：上班时间（高精度探测，快速响应关灯）；下班时间（降低灵敏度，避免空调/灯光频繁开关）。
具体接入方案步骤
初始化配置：设备上电后，通过接口查询当前配置，或下发默认配置。
指令示例：关闭 LED 指示灯（避免光污染），设置
led为0。
动态参数调整（核心） ：
通过您的后台系统（如定时任务）判断当前属于“工作时间”还是“深夜时段”。
工作时间下发
"infrared_change_0":30（无人30秒即上报关闭，响应快）
深夜时段下发
"infrared_change_0":600（无人10分钟才上报，避免因员工久坐不动导致断电）
数据联动
后台接收到
infrared_target为0（无人）的事件后，自动向该设备下发{"power": 0}指令，切断连接的电源（如插座或灯控模块），实现节能。
5. 关键注意事项
Flash 擦写寿命：虽然接口支持随时下发，但配置参数保存在 Flash 中，有擦写次数限制。：将频繁变化的数据（如开关灯动作
power）与不常变化的配置参数（如infrared_change_0延时时间）分离处理。仅在用户需求变更或场景模式切换时调用配置接口，不要每次有人/无人事件都重新写入配置。私有化部署支持：如果对数据安全要求比较高，该系列产品支持私有化部署。在纯局域网环境下，您可以自建消息服务器接收设备事件，控制指令仅在局域网内闭环，不经过外网。
响应：从云端下发指令到设备执行动作，实测延时约 80-120ms。对于吸顶式红外探测器这类非实时控制类设备，此响应速度完全满足场景切换需求。
通过以上方案，您可以仅通过简单的 HTTP POST 请求，将芯步的吸顶式红外探测器深度集成到现有的智慧办公、智能家居或安防系统中，实现灵活、远程的感应策略配置。