壁挂式“双模”人体存在传感器是智能空间管理的核心设备，通过红外与雷达双重检测机制，可精准识别人体微动状态。本文详细阐述如何通过芯步开放的HTTP API接口，快速接入传感器并实现远程人体存在状态监测，包括签名认证、API调用、消息推送接收及典型应用场景。

1. 概述

在智能办公、居家养老、节能管理等场景中，远程监测特定区域是否有人存在是一项核心需求。芯步提供的壁挂式“双模”人体存在传感器（红外+雷达）凭借其高精度探测能力和开放的API接口，能够快速集成到各类第三方系统（如Web应用、APP、微信小程序、SaaS平台）中。

本方案的目标是指导开发者如何利用芯步的HTTP API接口，实现从设备配网、数据上报到远程状态监测的全流程接入。

2. 硬件选型与核心优势

芯步提供多款壁挂式人体存在传感器，针对“远程人体存在监测”这一主题，使用“双模”（红外+雷达）版本，以解决普通红外传感器在人体静止（如办公、睡眠）时误判为“无人”的痛点。

推荐设备特性

• 探测机制：采用PIR红外+毫米波雷达双重检测。只有当红外和雷达均判定为“无人”时，状态才切换为无人，确保高可靠性。

• 探测范围：通常可探测4-5米内的人体微动（如呼吸、心跳引起的胸腔起伏）及6米内的运动。

• 控制输出：部分型号自带AC电源输出（继电器），可实现“有人通电，无人断电”的本地自动化控制（如控制灯光、排风扇）。

• 接口支持：全系标配HTTP API接口，支持局域网纯私有化部署和公网远程访问。

3. API接入流程与技术实现

传感器通过WiFi 2.4GHz联网，采用“设备主动上报 + 云端API下发/查询”的交互模式。

3.1 准备工作与环境配置

在开始代码开发前，请完成以下账户与设备准备：

1. 注册/登录：访问芯步官网注册开发者账号。

2. 获取密钥：登录工作台 -> 进入“物联网控制台” -> “开发设置”，获取 AppID 和 AppSecret。这两个凭证将用于后续所有API请求的身份验证。

3. 设备配网：将壁挂传感器通电。通过“芯步控制台”或官方配网小程序，将设备连接到本地2.4G WiFi网络。

3.2 核心技术：签名计算

所有API请求均需携带签名（Sign）以防止篡改。芯步采用双层MD5加密策略，这是一种轻量级且安全性较高的校验方式。

签名算法步骤如下：

1. 将获取的 AppSecret 进行一次MD5加密，得到 Secret_MD5。

2. 获取当前的Unix时间戳（秒级），记为 ts。

3. 将 Secret_MD5 与 字符串 ts 进行拼接，形成一个新字符串。

4. 将拼接后的字符串再次进行MD5加密，得到最终的 Sign。

算法公式：Sign = md5( md5(AppSecret) + ts )

3.3 获取设备状态（API调用示例）

由于传感器通常是被动上报数据，但在系统初始化或定时巡检时，也可以主动向设备下发查询指令（如果产品手册支持，一般也可以通过物模型查询）。但更常见的监测方式是接收消息推送（见3.4）。

以下是一个典型的HTTP API调用示例，用于控制传感器（如校准雷达灵敏度或查询状态），展示了签名计算的实际应用：

3.4 数据接收：实现“远程监测”的核心

对于“监测”场景，不需要频繁轮询API，而是配置HTTP推送。当传感器探测到有人/无人状态变化时，它会主动将数据发送到您的服务器。

配置步骤：

1. 在芯步控制台中，找到“项目设置” -> “消息推送”。

2. 设置您的服务器接收URL（例如：http(s)://yourdomain.com/api/sensor/callback）。

3. 选择推送类型：勾选“设备状态变化”或特定事件。

数据格式解析：

当有人进入探测区域时，芯步平台会向您的URL发送如下格式的POST数据：

后端业务逻辑：您的服务器接收到此JSON后，解析 infrared_target 或综合判断雷达数据，即可实时更新数据库中的“该区域状态”字段，供前端界面展示。

4. 典型应用场景联动

接入API后，不仅仅是看数据，还可以做自动化联动。利用芯步的 “设备控制” 接口，结合上报的状态数据，您可以实现以下逻辑

1. 人来灯亮，人走延时关

   • 逻辑：服务器收到“有人”状态 -> 调用控制接口向 DeviceID 发送 {'power':1}（开启接在传感器上的照明设备）。

   • 注意：此方案也可完全由传感器内置逻辑实现（AC输出直连），但通过API可实现更复杂的跨设备联动（如开空调、开电视）。

2. 安防布控

   • 逻辑：在非工作时间（如晚上10点后），如果服务器收到“有人”状态 -> 调用接口向“智能语音喇叭”发送 {'play:gbk:16':'监测到非法闯入'} 进行告警，并同时向管理员微信推送通知。

5. 高级特性和需要注意的点

1. 私有化部署（局域网） ：如果您的项目对数据安全要求比较高，或者运行在纯内网环境（无外网），芯步支持局域网API。只要您的服务器与传感器在同一网段，可以不经过云端直接通讯，延迟极低。

2. 探测灵敏度与盲区

   • 壁挂式传感器安装高度为 1.4m - 2m，探测角度约120度。

   • 雷达波可穿透薄木板或玻璃，但无法穿透墙体，安装时需避免探测到不需要关注的隔壁区域。

3. 错误处理

   • 在调用API时，需要正确处理返回的HTTP状态码（如 401 签名错误，404 设备不在线）。

   • 实现随机间隔（或逐次增大间隔）重试机制，应对网络波动。

6. 总结

通过芯步开放的HTTP接口，开发者仅需掌握简单的MD5签名算法和标准的POST请求处理，即可在 30分钟 内完成壁挂式“双模”人体存在传感器的初步接入。

这一方案解决了传统物联网开发中协议栈复杂（如MQTT长连接管理）的难题，让不具备深厚嵌入式背景的后端开发人员也能轻松实现“人在传感”的智能化改造。无论是集成到已有的楼宇自控系统，还是开发新的节能管理APP，芯步的硬件与API设计都能提供标准、可靠的底层支持。