这份解决方案将围绕芯步壁挂式智能人体感应器（型号 UNI-CGQ-RT-BG-HL）及其开放 API，详细阐述如何将其无缝接入你的项目。

1. 总览与背景

在现代智能办公场景中，精准的人体存在监测是实现节能（如自动关灯、关空调）和空间利用率分析的基础。不同于传统红外传感器只能检测大幅度移动，毫米波雷达传感器能够检测微动甚至静坐的人体呼吸。

芯步提供的壁挂式智能人体存在传感器（基于毫米波雷达技术）具备 WiFi 直连和开放 HTTP 接口的特点，使得开发者无需复杂的嵌入式固件开发，仅通过标准的 Web 技术栈即可完成对接。

2. 硬件选型与核心优势

在开始编码前，我们选型的硬件为：智能人体存在红外和雷达传感器[壁挂]。

• 免网关直连：设备支持 WiFi 2.4GHz 网络，可直接连接路由器，无需额外购买网关，降低了项目架构复杂度。

• 极简开放接口：芯步的设备接口基于 HTTP 协议，这意味着无论是 Python、Java、Go、Node.js 还是 PHP，只要支持发送 HTTP 请求，都能轻松集成。

• 雷匠结合：配合红外的辅助，既能检测大范围移动（雷达），又能通过 PIR 减少误报，最重要的是支持静态存在检测（人在但没动也不会误判为无人）。

• 私有化部署：平台支持私有化部署，数据可完全闭环在局域网内，保障企业数据安全。

3. 接口对接流程

要将设备接入你的项目（无论是 Web 后台、移动端 App 还是桌面软件），核心流程分为三步：获取凭证 -> 设备配网 -> 调用 API 获取/下发数据。

3.1 准备工作：获取 AppID 与 AppSecret

首先需要在芯步开放平台进行注册，并创建工作台。

1. 注册账号并登录控制台。

2. 进入“开发设置”页面。

3. 获取系统生成的 AppID（应用唯一标识）和 AppSecret（应用密钥）。这两个字符串将在后续所有 API 调用中用于身份认证。

3.2 设备端配置与信号强度

• 上电配网：设备通电后，通常处于 AP 模式（或通过 SmartConfig 配网）。你需要编写或使用官方提供的配网工具，将办公区的 SSID（WiFi 名称） 和 密码 发送给设备。

• 信号保障：设备支持设定 5 组 WiFi 网络，会优先连接信号最强的网络。在部署时，确保安装点位信号强度在 -70dBm 以上以保证响应速度。

3.3 核心 API 调用机制

芯步的 API 签名规则是保障接口安全的关键。标准请求地址为：https://api.thingboot.com/{AppID}/device/control/

签名算法详解：所有请求都需要携带 sign（签名）和 ts（时间戳）参数。计算公式为：Sign = md5( md5(AppSecret) + ts )

代码示例（伪代码/Python 风格）：

注：具体语言实现请参考官方 SDK 或最新文档。

3.4 数据读取方式

针对“人体存在监测”场景，数据流的处理通常有两种模式：

1. 主动查询模式（拉取）你的业务服务器定时（如每 5 秒）通过设备管理接口查询设备的最新状态。这种方式实现简单，适合实时性要求不高的能耗统计场景。

2. 消息推送模式（推送 - 推荐）在控制台配置“回调 URL”。当传感器检测到有人/无人状态变化时，芯步平台会主动向你的服务器地址发送 POST 请求。这种方式延迟最低，能瞬间触发“人来开灯”操作。

命令下发示例：假设需要远程校准传感器灵敏度或控制联动设备（如控制灯光），你需要下发 JSON 命令。根据设备手册，控制指令通常包含在 order 参数中

4. 实战落地：项目实施步骤

第一步：硬件部署（壁挂安装）

• 位置：在办公区角落或墙壁安装，高度离地 2米 左右，雷达探测角度通常为 ±60°。

• 视角：避免探头正对空调出风口、窗帘或大型移动机器（如空气净化器），虽然现代雷达算法有底噪自适应能力，但物理安装的优化能显著提升信噪比。

第二步：编写业务逻辑适配器

在你的项目中创建一个“设备服务层”，封装芯步的 API。

• 接口getDeviceStatus(deviceId) 和 sendCommand(deviceId, command)。

• 数据处理：传感器返回的数据通常是多维度的能量值（运动能量、微动能量、静止能量）。你需要编写逻辑判断：如果静止能量值 > 阈值 AND 微动能量值 < 阈值，则判定为“静坐办公状态”，此时不应关灯。

第三步：场景联动规则配置

利用获取到的数据，结合办公系统逻辑：

1. 人来灯亮：当状态从 无人 变为 有人 触发回调，调用照明控制接口（如控制智能墙壁开关）开灯。

2. 节能策略：当检测到 无人 状态持续 15分钟（延时判定，防止短暂离开误关），触发关灯/关空调指令。

3. 工位占用看板：将每个工位上方的传感器数据汇总，在前端大屏上可视化展示当前办公区实时 occupancy 热力图。

5. 故障处理与优化

• 网络稳定性：设备采用 WiFi 连接，若办公区网络复杂，在路由器中为传感器绑定静态 IP，避免 IP 租约到期导致的短暂断连。

• 算法调优：如果出现“误报”或“漏报”，可能需要调整雷达模块的灵敏度。你可以通过 HTTP 接口下发配置命令，调整各个距离门（Range Gate）的能量阈值，或者开启“工程模式”进行可视化调试。

• 延迟优化：由于采用 HTTP 通信，相比 Zigbee 局域网通信会有毫秒级延迟，对于非工业级控制（如照明），这个延迟完全在接受范围内。

6. 总结

通过芯步的开放 HTTP 接口，将壁挂式智能人体感应器接入项目变得如同调用一个普通的第三方天气 API 一样简单。你无需关注底层雷达信号处理的复杂性，只需专注于业务逻辑：

1. 搞定签名：利用 AppSecret 生成安全的动态签名。

2. 接收推送：设置好回调地址，等待设备主动“说话”。

3. 执行业务：拿到“有人/无人”的布尔值或具体的人员距离数据后，去控制中央空调、灯光或更新数据库。

以上方案基于通用接口逻辑，具体参数（如具体命令字、雷达配置寄存器地址）请参考具体的产品手册。