怎么接入吸顶式智能红外感应开关以实现远程人体存在状态监测_解决方案

CATALOG

吸顶式红外感应开关的接入核心在于理解其物模型——状态主动上报、指令远程下发。以下方案涵盖设备配网、HTTP接口对接、签名计算及典型场景配置，可直接用于私有化平台或SaaS系统集成。

本方案的目标是指导开发者或系统集成商，利用芯步提供的开放API接口，将吸顶式智能红外感应开关无缝对接到用户自有的软件系统（如智能楼宇管理系统、能源管理系统、SaaS平台等）中。

通过该方案，系统可以实现：

芯步的设备采用标准 HTTP/HTTPS 协议进行通信，架构模式为“设备-云-应用”。

在编写代码前，需要进行基础的环境配置（参考开发对接指南）：

注册与登录：在芯步官网注册企业/个人账号。
获取密钥：进入控制台的“开发设置”页面。
- AppID：开发者身份标识。
- AppSecret：开发者密码（用于签名计算，保障接口安全）。
- ：在开发测试阶段，可开启“调试模式”暂时忽略签名校验，以加快对接速度；生产环境必须关闭调试模式并严格校验签名。
设备配网：将吸顶式红外感应开关通电，参照产品手册通过热点配网或智能配网方式，将设备连接到WiFi（仅支持2.4GHz），确保设备在控制台显示为“在线”状态。
设置回调URL：在控制台配置消息推送地址（http://your-domain.com/api/device/callback），这是系统接收“有人/无人”数据的核心接口。

以“智能人体存在传感器[吸顶][红外版]”为例，其核心功能定义如下

4.1 状态属性这是设备上报的核心数据字段：

属性标识符	名称	数据类型	值说明
`infrared_target`	红外感应	枚举	`1`=有人， `0`=无人
`power`	线路状态	枚举	`1`=接通， `0`=断开
`infrared_enable`	红外模块开关	枚举	`1`=打开， `0`=关闭

4.2 核心事件当红外状态发生变化时，设备会触发infrared_detect事件，并上报。

4.3 下行控制指令（API调用）业务系统控制设备线路通断的接口规范

请求地址https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={timestamp}
请求方法： POST
请求体 (Body)
{ "device": "设备ID", "order": { "power": 1 // 1为开启，0为关闭 } }

步骤一：计算接口签名为了保证接口调用的安全性，每次调用API都需要计算签名 sign。算法逻辑如下sign = md5( md5(AppSecret) + ts )注：ts为Unix时间戳（秒），+ 代表字符串拼接。

步骤二：配置设备参数云端写入为了让传感器适配具体环境（例如避免灯光频繁闪烁），在接入初期通过API或控制台修改配置项

红外无人触发持续时间：设置 infrared_change_0=10m。
- 场景：在会议室中，若人员短暂静坐（如看书、开会微动少），红外可能检测不到。设置持续时间为10分钟，意味着“无人”状态需在连续10分钟无红外信号后才触发，避免人员静坐时灯光的误关闭。
红外有人触发持续时间：设置 infrared_change_1=2s。
- 场景：保证人员进入瞬间即刻触发，减少延迟。

步骤三：接收实时状态数据（核心）系统需要开发一个公网可访问的接口来接收设备推送的数据。

接收方式：HTTP POST。
数据格式：Application/JSON。
解析示例假设系统收到设备推送的报文，解析后得到
{ "device_id": "110752", "infrared_target": 1, // 1 = 有人 "power": 1, "timestamp": 1704067200 }
系统逻辑：当检测到 infrared_target 为 1 时，业务系统可记录“该空间有人”，并更新UI状态。

步骤四：远程联动控制当系统接收到“无人”状态（infrared_target: 0）且持续时间超过设定阈值时，系统可主动调用API下发电令，关闭电源以节能。

请求示例 (通过 cURL 或代码实现)
# 伪代码逻辑 POST https://api.thingboot.com/AppID/device/control/?sign=xxxx&ts=1711111111 { "device": "110752", "order": {"power": 0} // 关闭电源 }

需求：某公司需要在非工作时间监测办公区人员活动，若10分钟内无人，自动关闭照明和插座电源，并在管理后台记录日志。

实施方案

硬件安装：在办公区天花板上部署吸顶式红外传感器，串联或通过继电器控制照明电路。
参数配置：将“无人触发持续时间”配置项修改为 10分钟。
软件逻辑
- 后台接收传感器上报的数据。
- 当 infrared_target = 0 时，启动计时器（10分钟）。
- 若10分钟内无新的 1 信号，后台调用 device/control 接口，发送 {"power": 0}。
- 同时，调用内部API记录一条日志：“202X-XX-XX 10:30:00 办公区无人，已自动断电”。