芯步的雷达传感器采用“设备主动推送+HTTP接口控制”的机制——传感器检测到有人/无人时会主动向你的服务器推送数据，你也可随时下发指令查询状态或联动其他设备。以下方案涵盖从硬件选型到业务落地的完整路径。

一、 核心架构原理

在对接过程中，数据流向主要分为“上行”和“下行”。芯步的接口设计非常标准，主要分为以下两种模式：

1. 上行消息（设备 -> 服务器）： 这是无人值守场景的核心。当雷达传感器检测到“有人出现”、“长时间静止（睡觉/昏迷）”、“无人离开”等状态变化时，它会主动向你的服务器发送HTTP请求。

2. 下行指令（服务器 -> 设备）： 你的服务器需要查询设备当前状态或远程控制传感器灵敏度（如屏蔽宠物干扰）时，向设备发起HTTP请求。

核心机制： 采用的是 “设备主动推送 + 接口控制” 的模式，而不是传统的“服务器轮询”，这在实时性和服务器资源消耗上是最优解 。

二、 环境与硬件准备

1. 硬件设备： 选型为 智能人体存在雷达传感器2[壁挂] 或 智能人体存在雷达和烟雾传感器[壁挂] 。这两款均支持WiFi直连，无需网关 。

2. 网络环境：

   • 私有化部署方案（推荐）： 如果你的无人值守空间（如机房、档案室）不允许连接外网，芯步支持私有化部署。你可以设置“自建消息服务器”地址，让数据只在局域网内传输 。

   • 云端方案： 如果使用公有云，设备数据经过芯步API转发或直接推送到你的公网服务器。

3. 开发账号： 注册并登录芯步控制台，获取 AppId 和 AppSecret（开发者密码），这是后续所有接口调用的凭证 。

三、 详细对接步骤

步骤 1：设置消息接收服务器（最关键的一步）

雷达传感器检测到人体存在变化后，需要知道往哪里发送数据。你需要在物联网控制台配置 “API回调地址” 或 “消息推送URL”。

• 你需要做的是： 搭建一个公网可访问（或局域网可访问）的HTTP/HTTPS接口。

• 接收逻辑： 编写代码接收POST请求，解析Body中的JSON数据。

• 数据格式参考： 当有人进入雷达探测范围时，你的服务器会收到类似如下的数据包（根据通用物模型推测，具体字段以最新手册为准）：

  { "device_id": "8787987", "type": "human_sensor", "status": "occupancy", "value": 1, // 1代表有人，0代表无人 "timestamp": 1699324800 }

代码实现伪代码（Node.js示例）：

步骤 2：获取签名（Sign）与下发控制指令

除了接收数据，你可能需要主动查询雷达是否在线，或者校准传感器。

1. 签名算法（Authentication）所有HTTP接口调用都需要携带签名 。公式：sign = md5( md5(AppSecret) + ts )

• ts：当前Unix时间戳（秒）。

• AppSecret：你的开发者密码。

2. 查询传感器状态（下行指令）如果你想在软件界面上手动刷新某一个壁挂雷达的状态，或者开启/关闭雷达探测功能。

• 请求地址：https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方法： POST

• 请求Body：

  { "device": "设备ID", "order": {"radar_enable": 1} // 1为开启雷达模块，0为关闭 }

  参考命令来源于雷达传感器的产品手册中关于radar_enable的定义 。

步骤 3：场景联动逻辑设计（业务层）

以一个“共享自习室/茶室”的无人值守空间为例，你需要利用接收到的“有人/无人”数据来驱动其他设备或软件状态变更。

场景 A：空闲节能模式

• 触发： 传感器上报 value: 0（无人）持续超过 5 分钟（逻辑在你服务器端实现，避免瞬断误报）。

• 动作：

  • 调用芯步接口控制电源控制器：{"power":0} 切断插座供电，防止未关电器。

  • 软件系统将该房间状态修改为“空闲”，释放订单锁。

场景 B：预约自动识别（防占座）

• 触发： 传感器上报 value: 1（有人），但当前该房间在软件中的订单状态是“空闲/未付费”。

• 动作：

  • 软件系统发出“非法占用告警”给管理员。

  • 联动语音播报器（如果是集成环境）提醒：“请扫描桌上二维码开灯”。

场景 C：离开现场时遗留物/遗忘检测

• 触发： 顾客付款离开现场时后，数据应变为无人，但传感器持续上报有人。

• 动作： 服务器判定为“遗留物或人员昏迷/滞留”，推送紧急消息给保洁或安保人员。

四、 常见问题与优化

1. 如何保证数据不丢失？芯步的开放接口机制支持消息重试。如果你的服务器因维护重启未返回200状态码，平台会重发几次消息。此外，它也支持你主动调用/device/status接口拉取当前状态作为兜底 。

2. 如何处理“无人”误报？（针对静止人体）红外传感器对静止人体不敏感，但芯步的雷达传感器（毫米波） 即使人体静坐、静卧，只要微动（呼吸起伏）都能检测到 。

• 在软件层设置 “防误报阈值” 。例如：连续收到3次“无人”信号（间隔几秒一次），才判定为真正无人，避免因人在沙发上睡着翻身不及时导致误判断电。

3. 局域网纯内网环境怎么玩？该系列产品支持私有化部署。你不需要把数据传到芯步的公有云，直接在内网搭建一个接收服务，配置好WiFi名称和密码，设备连上网关后，直接将数据发给你指定的内网IP地址（如 http://192.168.1.100:8080/report）。

4. 核心API参考清单在开发过程中，主要用到以下几个接口模块

• URL Key：api.thingboot.com

• 全局错误码： 重点关注 5006（签名错误）和 5003（时间戳错误）。

• 设备命令：radar_enable（雷达使能）、power（电源通断，取决于具体硬件型号）。

五、 方案总结

通过对接芯步的壁挂式智能人体存在雷达传感器，你可以实现从 “物理世界感知” 到 “软件业务逻辑” 的闭环。整个过程不需要理解复杂的嵌入式协议，只需处理好 HTTP回调接收 和 双向签名认证 即可。这套方案非常适合自习室、智慧公厕、办公室节能、展厅接待等无人值守场景。