芯步的壁挂人体存在传感器采用WiFi直连、开放HTTP接口，无需网关即可接入各类软件项目。以下从硬件准备、接口协议、签名算法到代码实现，梳理完整的接入方案。

解决方案：创客工坊人体活动监测——壁挂人体存在传感器HTTP接口接入指南

1. 硬件与协议概述

设备型号： UNI-CGQ-RT-BG-HL （红外+雷达融合）核心优势

• “双模”技术：红外（捕捉移动）+ 雷达（微动感知），可检测静坐、睡眠等静态人体。

• 零网关依赖：支持WiFi 2.4G直连路由器，无需购买额外网关。

• 开放协议：提供标准的RESTful API，支持公网或纯局域网私有化部署。

2. 接入流程（4步快速对接）

2.1 设备配网在“芯步控制台”或小程序中，为设备配置现场2.4G WiFi。设备成功联网后，会在云端显示为“在线”状态，并获得唯一标识符DeviceID。

2.2 准备密钥在平台控制台获取凭证：

• AppID：应用唯一标识。

• AppSecret：开发者密码，用于接口签名加密。

2.3 接口交互模式该传感器属于上行消息设备，通常无需主动轮询。

• 数据流向：传感器探测到“有人/无人”状态变化时，自动通过HTTP 推送到你指定的服务器（需在控制台配置回调URL）。

• 下行控制：若需调整雷达灵敏度或LED灯，则通过HTTP接口下发命令。

2.4 签名算法所有API请求需携带sign和ts，算法规则为：

（注：+为字符串拼接，ts为Unix时间戳秒）

3. 核心解决方案：接收人体存在数据（Server端）

你需要搭建一个公网可访问的Webhook端点（如http(s)://yourdomain.com/api/sensor/callback）。

3.1 配置消息接收地址：在控制台设置消息推送URL。3.2 接收数据示例当设备状态变更时，芯步平台会向你配置的地址发送POST请求。Body示例（推测结构）：

3.3 代码示例（Python Flask） ：你需要编写代码解析上述JSON，并触发业务逻辑。

4. 进阶：主动查询与配置

如果你需要主动查询设备状态（例如在App打开时刷新），或调整设备参数（如关闭LED指示灯），需发起主动请求。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求方法POST请求Body

实战：Java实现请求签名与下发命令

代码参考自芯步对接实践

5. 架构与常见问题

• 局域网纯内网运行：如果你不希望数据上公网，可以将设备与你的服务器置于同一局域网。平台支持私有化部署，API地址可改为设备本地的IP（需设备支持自定义Host）。

• 关于“静坐”监测：传统的红外传感器在人体静止时会误判为“无人”。该设备融合了雷达技术，能探测呼吸引起的胸腔起伏，哪怕人坐着不动玩手机，也能稳定输出“有人”信号，这是该方案的核心亮点。

• 数据可视化：收到occupancy数据后，存入时序数据库（如InfluxDB），并利用Grafana制作“活动热力图”，直观展示空间使用率。

总结

通过上述步骤，一个壁挂人体存在传感器就被转变为了一个“HTTPS API数据源”。你不再需要关心底层射频或蓝牙协议，只需通过简单的POST请求或Webhook接收，即可将物理空间的人体活动转化为程序中的true/false变量，快速集成到HomeAssistant、Node-RED或自研的工坊管理系统中。