芯步的壁挂式人体存在传感器采用毫米波雷达技术，支持对运动、微动、静止人体的精准检测。其核心价值在于开放了HTTP接口，使得开发者可以绕过厂商云平台，将传感器参数配置能力直接集成到自己的软件系统中。以下是具体的技术对接方案。

解决方案：基于芯步开放接口的壁挂人体存在传感器远程参数配置

1. 概述

本方案的目标是指导开发者如何利用芯步提供的开放式HTTP API，对 UNI-CGQ-RT-L-BG2 型号的壁挂式人体存在传感器进行远程参数配置。

适用场景：

• SaaS平台集成： 你有一个物业管理平台，需要远程为不同房间的传感器调整灵敏度，以适应不同的办公/居家环境。

• 智慧场景联动： 在APP或自动化规则中，允许用户根据季节变化（如夏季空调干扰大）远程调整雷达的“无人延迟时间”或“静止检测灵敏度”。

• 规模化运维： 无需人工到场通过蓝牙或串口工具调试，直接通过云端批量修改传感器的探测范围门限。

2. 技术原理与接口基础

该传感器采用 WiFi直连 模式（无需网关），支持私有化部署。这意味着配置指令可以不经过芯步官方云，而是直接发送到设备或通过你自己的私有服务器转发。

核心接口特征：

• 协议： HTTP/HTTPS

• 传输方式： POST/GET

• 鉴权方式： 签名校验（携带签名及Device ID）。

3. 关键可配置参数解析

要实现“远程感应参数配置”，首先需明确“智能人体存在传感器”区别于普通红外传感器的核心参数。基于同类毫米波雷达传感器（如Rd-03L、LD2410）的技术逻辑，可配置参数通常包括

• 检测距离门限：

  • 运动门限： 针对大幅度动作（如行走）的触发灵敏度。

  • 静止/微动门限： 针对呼吸、心跳等微小动作的保持灵敏度。这是实现“人在灯不灭”的关键。

• 无人上报延迟：

  • 即“无人超时时间”。当传感器判定无人后，延迟多久将状态切换为“无人”。范围通常为10-600秒。

• 距离范围设置：

  • 设置最大探测距离（如0.5米至6米），屏蔽墙外或远处的干扰源。

• 安装高度/工作模式：

  • 明确告知传感器当前是壁挂安装（通常1.5m-2m高度），以便内部算法优化探测区域。

4. 对接开发实施步骤

第一步：获取设备凭证在芯步IoT平台注册设备，获取唯一的 Device ID 和 API Key。确保传感器已配网并在线。

第二步：构建配置指令（API调用）芯步硬件接口支持下发命令。你可以通过后端服务调用以下示例接口（需替换为实际API Endpoint）：

• URL:https://api.yoyoiot.com/ordercommand

• Method: POST

• Header:

  • Content-Type: application/json

  • Signature: {encrypted_sign}

• Body:

第三步：处理响应与状态同步

• 同步下发： 接口返回 200 OK 及 {"code":0, "msg":"success"} 通常表示指令已送达设备队列。

• 异步回调： 设备执行完参数修改后，会上报一条“参数变更确认”消息。你的消息服务器需要监听这个Topic，以确认配置已生效。

第四步：高级进阶——自动化门限配置在复杂的室内环境中（如存在空调或窗帘晃动），手动设置门限较难。利用开放接口可集成“自学习算法”：

1. 调用接口让传感器进入 “环境静默学习模式”。

2. 传感器在该模式下运行120秒，收集当前环境的底噪数据。

3. 接口返回 “门限值”（通常为底噪值的 1.5-2 倍）。

4. 系统自动将计算出的门限值写入参数中。

5. 不同协议版本的对接说明

选择：若你的目标是开发纯软件平台进行远程配置，请请一定要选用标准WiFi版，并确认其固件已开启HTTP Server功能。Zigbee版虽然也能实现远程，但受限于网关协议，配置参数映射可能不完全。

6. 注意事项与最佳实践

1. 壁挂安装校准： 发出配置指令前，确保传感器物理安装高度符合要求（推荐1.5m）。配置指令中的参数需与此高度匹配，否则探测区域会偏移。

2. 防误报配置： 在配置接口中，使能 “光敏传感器” 数据联动。例如：只有当“光照度 < 10 Lux”且“无人状态”时，才允许执行关灯指令，避免白天误判。

3. 网络稳定性： 由于该传感器依赖WiFi进行指令接收，请一定要确保其信号强度。在调用配置接口前，先调用 ping 或 get_status 接口确认设备在线。