怎样接入吸顶式红外存在感应器以实现远程感应参数配置_解决方案

CATALOG

芯步的红外传感器采用标准HTTP接口，支持远程参数配置。以下方案涵盖接口协议、物模型字段和具体代码示例，帮助你快速实现感应参数的远程调整。

芯步的智能人体存在红外传感器（型号：UNI-CGQ-RT-XD-H）支持通过标准的HTTP接口进行远程控制与配置。本方案的目标是指导开发者如何绕过本地物理操作，利用API接口对安装在吊顶内的传感器进行“感应参数”的远程调整，如修改触发延时、开关机状态等。

在开始配置前，请确保具备以下条件：

芯步接口采用动态签名验证，每次请求需计算签名并在URL中携带。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={timestamp}
请求方法： POST
请求头： Content-Type: application/json
核心参数说明
- ts：当前Unix时间戳（秒），用于防重放攻击。
- sign：签名，计算方式通常为 md5(AppSecret + ts) 或其他约定的哈希算法（具体参考平台生成规则）。
- Body：包含 device 和 order 字段。

要实现“远程感应参数配置”，主要操作对象是物模型中的 配置项 和 状态属性。以下是根据产品手册整理的关键参数

参数/命令	字段标识	可选值	功能说明
红外模块开关	`infrared_enable`	1(打开) / 0(关闭)	远程启用或禁用人体感应功能。
LED指示灯	`led`	1(长亮) / 0(长灭) / blink(闪烁)	控制设备面板指示灯状态，便于检修时定位设备。
无人触发延时	`infrared_change_0`	0(马上) / 30(30s) / 60(1m) ...	核心参数：当检测到无人后，多久上报“无人”状态。防止人静止时误报无人。
有人触发延时	`infrared_change_1`	0(马上) / 1(1s) ...	核心参数：检测到人移动后，多久确认“有人”状态。
线路/继电器	`power`	1(通) / 0(断)	直接控制传感器的输出线路通断（如控制灯具）。
发现无人动作	`relay_change_0`	1(打开) / 0(关闭) / no(无动作)	自动化联动：当无人时，继电器自动执行的动作。

以下以一个典型场景为例：将“无人判定延时”从默认的30秒修改为5分钟（300秒），以防止因人员短暂静止而导致灯光误灭。

步骤 1：构造请求Body我们需要下发修改配置的命令。根据物模型，目标字段是 infrared_change_0。

步骤 2：处理签名并发起请求生成时间戳和签名，向平台发起HTTP POST请求。以下为伪代码示例（Python风格）：

步骤 3：配置生效验证

同步回调：配置命令下发成功后，如果设备在线，服务器会返回成功状态（HTTP 200）。
状态上报：设备端的Flash存储了新的配置值。当环境状态变化时（如人离开现场超过5分钟），设备会上报新的状态消息到您的服务器，此时日志中可核对无人状态的上报时间是否真正延迟了5分钟。

在实际SaaS应用中，参数配置往往并非静态。结合芯步的实时状态上报机制，你可以构建动态调整逻辑：

场景：根据环境光照或时间段调整灵敏度

数据上行：传感器上报 infrared_target (有人/无人) 和 lux (若支持光照度) 至你的服务器。
业务判断：服务器逻辑判断——若当前处于“中午12点-14点”且“光照度 > 500”，判定为工作时间。
命令下行
- 自动下发命令设置 infrared_change_0 为 30 (30秒延时)，实现快速响应关灯节能。
- 若判断为深夜或周末（无人值守），下发命令设置 infrared_change_0 为 600 (10分钟延时) 或设置 infrared_enable 为 0 (关闭感应功能)。

Flash擦写寿命：官方文档提醒，配置项保存在Flash中，有擦写次数限制，平台未开放批量修改接口。因此，请避免在循环中高频下发配置命令（如每秒钟修改一次延时），这会损害硬件寿命。仅应在业务逻辑确实需要变更（如用户手动调整策略）时调用。
红外 vs 雷达：本文主要针对红外版。若使用雷达版传感器，字段标识可能变为 radar_enable，但调用逻辑完全相同。
设备在线状态：配置命令只有在设备在线（WiFi连接正常）时才能下发成功。在调用接口前，先通过设备心跳或状态查询接口确认设备状态。

通过上述方案，开发者可以轻松将芯步的吸顶式红外传感器集成到智慧办公、智能家居或节能管理中，实现远程、精准的感应策略调整。