壁挂人体存在探测器的核心价值在于“上报”,而非“下发”——设备主动推送有人/无人状态到你的服务器,这才是对接的重点。以下方案基于芯步开放接口,涵盖配网、消息接收、签名验证等关键环节。
解决方案:基于芯步开放接口接入壁挂人体存在探测器实现数据上报
1. 概述与架构
本方案的目标是指导开发者如何利用芯步提供的开放 API 接口,快速将壁挂人体存在探测器(如型号:UNI-CGQ-RT-H-BG 或雷达系列)集成到自有系统中。
在芯步的体系中,传感器类设备主要采用 “主动上报” 的工作模式。即设备检测到环境变化(有人移动、有人静止存在或无人)时,会通过 WiFi 将消息推送至开发者指定的服务器。
核心流程如下:
设备配网:设备通电后,通过“热点配网”方式写入现场路由器的 WiFi 凭证。
上报配置:在芯步控制台配置“消息推送 URL”(你的服务器公网地址)。
数据流转:探测器探测到人体状态变化
(0变1 或 1变0)-> 设备向云平台上报 -> 云平台加密转发至你的服务器。
2. 环境准备与配置
在编写代码之前,需要在芯步官方平台完成必要的配置工作,这是数据能推送到你服务器的前提。
步骤一:注册与创建
注册[芯步官网]账号,创建一个“工作台”,并进入“物联网控制台”模块。
记录下系统生成的 AppID 和 AppSecret(开发者密码)。这两个参数将用于后续的签名验证,确保数据来源可信。
步骤二:设备配网(WiFi 2.4G)该系列产品支持直接连接 2.4G WiFi,无需网关。
在控制台的“网络配置”中,添加现场路由器的 SSID 和密码。
设备通电后,使用手机打开热点,将热点名称/密码临时改为刚刚配置的网络信息,设备会自动抓取该信息并连接到目标路由器。
观察到设备指示灯常亮或控制台显示设备“在线”,即代表成功。
步骤三:配置数据上报 URL
在控制台的“开发设置”或“消息推送”模块中,找到 HTTP/HTTPS 推送地址。
填入你的服务器接收地址,例如:
https://yourdomain.com/api/yoyo/callback。注:芯步支持私有化部署,若部署在局域网,可填写内网地址。
3. 核心机制:数据上报接收
这是对接过程最关键的一步。设备不会主动调用你的接口,而是芯步的云端在收到设备数据后,向你的服务器发起 HTTP 请求。
1. 推送的数据格式当探测器感测到人体状态变化时,云端会发送如下格式的 JSON 数据到你的服务器:
数据直接引用自设备属性定义。
2. 关键回调样例与处理逻辑你需要编写一个 Web 服务端接口来处理 POST 请求。以下伪代码展示了核心逻辑:
4. 扩展应用:状态查询与控制
虽然是传感器,但它也开放了 HTTP 接口,允许你根据需要查询当前状态或修改配置(例如调整灵敏度或 LED 灯开关)。
如果你需要在业务系统中主动查询设备是否有人,可以使用 API 调用(反向控制)。
请求示例:
地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}方法:POST
Body
注:之前的产品手册提到,传感器类设备主要是上行,若仅需获取状态,更推荐等待其自然上报或使用专门的查询属性接口。
5. 最佳实践和需要注意的点
签名验证(安全性)为了防止恶意攻击,不要完全信任任何到来的 POST 请求。你可以利用
AppSecret对请求头中的sign和ts进行同样算法的校验(MD5(MD5(Secret)+ts)),确认数据确实来自芯步而非伪造。存在探测 vs 移动探测
红外传感器:主要探测移动热源,如果人坐着不动,可能会误报“无人”。
雷达传感器2:该产品支持微动探测,能感知人的呼吸存在,适合办公室、卫生间等需要保持常开的场景。选购时需根据场景决定。
无网关模式的优势由于设备直连 WiFi,响应速度极快。从传感器触发到你的服务器收到数据,端到端延迟通常在 80ms - 120ms 之间,非常适合联动照明等实时性要求高的场景。
6. 总结
通过以上步骤,即可完成壁挂人体存在探测器的接入。硬件安装上只需将设备安装在 2.4G WiFi 信号覆盖的墙壁位置;软件上只需暴露一个 API 接口,监听 infrared_target 或相关人感事件,即可实现人体感应的数据上报与业务联动。