芯步的壁挂式红外雷达联动控制器支持HTTP接口直接调用，无需网关即可接入各类项目。以下方案涵盖设备选型、接口签名计算、数据接收与命令下发等关键环节，可帮助快速实现“有人/无人”状态驱动的智能控制闭环。

解决方案：基于芯步壁挂式红外雷达联动控制器的项目集成方案

1. 设备选型与核心优势

在集成之前，首先需要明确所选硬件的能力。针对你的需求，推荐使用芯步【智能人体存在红外和雷达传感器[壁挂]（型号：UNI-CGQ-RT-BG-HL）或其他同类壁挂雷达传感器。

该设备的核心技术优势在于红外+雷达双重探测机制

• 传统红外（PIR） ：只能探测移动的物体，如果人静坐不动，红外传感器会判定为“无人”，导致灯光熄灭。

• 毫米波雷达（Radar） ：能够探测呼吸、心跳等胸腔微动，即使人体静止不动，也能判定为“有人”。

• 融合逻辑：通过算法融合，解决了传统感应灯在卫生间、办公室“频繁关灯”的痛点。

集成层面的优势

• 无网关直连：设备直接通过WiFi 2.4G连接路由器，不需要购买额外的zigbee网关，降低了项目硬件成本。

• 高开放性：提供全平台通用的 HTTP API接口，无论是Web后端、手机APP还是小程序，只要支持HTTP协议即可对接。

• 私有化部署：支持自建消息服务器（Push Server），数据可以不经过芯步公有云，直接推送到你自己的服务器内网，保障数据隐私。

2. 整体设计

在项目中集成此传感器，采用 “设备上报-服务端处理-场景联动” 的经典物联网架构：

1. 感知层（设备端） ：壁挂传感器安装在区域（如走廊、卫生间、办公室）顶部或墙面。当检测到“有人/无人”状态变化时，立即将数据上报。

2. 传输层（云/内网） ：

   • 方式A（公有云） ：数据上报至芯步云平台，云平台通过HTTP回调推送给你的业务服务器。

   • 方式B（私有化） ：如果你部署了自建服务器，设备直接将数据发到你指定的IP地址。

3. 应用层（你的项目） ：你的后端接收数据，更新设备状态。根据业务逻辑（例如：保持3分钟无人），向传感器或其他执行设备（如开关、插座、空调）下发控制指令。

3. 集成步骤详解

3.1 设备配网与注册

在芯步工作台或物联网控制台中进行设备初始化

1. 将设备通电。

2. 使用配网工具（或小程序）将设备连接到项目所在地的2.4GHz WiFi网络。

3. 设备上线后，在控制台获取该设备的唯一标识：Device ID（例如：820720）。此ID是后续API操作的核心凭证。

3.2 核心接口对接：接收“有人/无人”事件

这是集成最关键的一步。你需要让项目知道“什么时候有人进来了”。

配置消息接收地址

• 在你的服务器上准备一个公网可访问（或局域网可访问，取决于部署模式）的API接口，例如：https://yourdomain.com/api/sensor/callback。

• 在芯步控制台中，将该URL填入“消息推送”设置中。

数据格式解析当传感器探测到状态变化时，芯步云平台会自动构造一个HTTP POST请求发送到你的服务器。你需要解析收到的JSON包：

业务逻辑实现在你的代码中（以伪代码为例）：

3.3 核心接口对接：下发控制指令

如果除了接收数据，你还需要通过项目主动查询设备状态或控制联动其他设备，需要使用HTTP接口进行下行通信。

签名算法芯步的接口安全性基于动态签名。构造请求前必须生成sign参数

1. 准备参数：AppSecret（从控制台获取）、ts（当前Unix时间戳）。

2. 计算第一层：step1 = md5(AppSecret)。

3. 计算最终签名：sign = md5(step1 + ts)。

请求示例假设你的项目需要强制关闭某传感器或查询状态（以下为通用命令示例，具体需对照产品手册）：

• URLhttps://api.thingboot.com/{YourAppId}/device/control/?sign={sign}&ts={ts}

• Method：POST

• HeaderContent-Type: application/json

• Body (JSON) ：

4. 场景实战：卫生间/办公室智能照明联动

以“壁挂雷达控制器”联动“单路灯控开关”为例，演示完整的闭环流程：

1. 安装位置：将传感器安装在门框上方墙壁（壁挂），朝向主要活动区域。

2. 参数设置：设置传感器的灵敏度和无人延时时间（例如设置10秒）。由于雷达能探测微动，设置较短延时以保证“人动灯亮，人停不灭，人走灯熄”的体验。

3. 联动逻辑（在你的项目中实现） ：

   • 你的项目接收到设备上报的 radar_status: "detected"。

   • 你的项目调用芯步开关设备接口，发送 {"power1": 1} 给ID为xxxx的墙壁开关，打开灯光。

   • 当用户离开，设备上报 radar_status: "clear"。

   • 你的项目在判定无人的情况下，调用开关接口发送 {"power1": 0} 关闭灯光。

   • 进阶功能：结合光照传感器，如果自然光足够亮（>100lux），则不执行开灯指令，达到节能目的。

5. 私有化部署方案

对于工业或政府项目，数据不出内网是硬性要求

1. 自建MQTT/HTTP Broker：芯步支持配置自定义服务器地址。

2. 修改设备配置：通过API将设备的推送目标地址指向你内网的服务器（如 http://192.168.1.100:8080/event）。

3. 内网闭环：所有传感器数据和控制指令仅在局域网内流转，断外网依然可用。

6. 常见问题与解决

• 误报/漏报：雷达信号可能穿透玻璃或薄墙壁。在项目配置中开启 “融合模式” ，即必须红外和雷达同时感应到才判定有人，减少隔壁走动干扰。

• 掉线重连：设备支持设定5组WiFi，会自动切换信号最好的网络。项目开发时，应通过API监听设备的 online/offline 状态事件，在管理后台提醒用户设备离线。

• 代码开发：官方提供C、Python等语言的签名计算Demo，也可以直接在curl或Postman中测试。

总结

通过芯步的标准HTTP接口，你可以像调用普通Web API一样完成物联网硬件的集成。核心仅需三步：注册设备拿ID、配置接口收数据、编写代码发命令。其灵活的私有化部署方案和强大的毫米波雷达感知能力，能显著提升你的项目在智能家居或智慧办公场景中的竞争力。