如何对接智能人体存在传感器吸顶雷达版来实现照明设备电源控制_解决方案

CATALOG

这款吸顶雷达版传感器的特点是自带一路继电器输出，可直接控制照明电路，无需额外控制器。以下方案围绕“设备直接带载”和“HTTP接口联动”两种模式展开，你可根据现场是否已有照明配电线路来选择。

1. 项目概述与选型背景

在智能楼宇、节能办公或智慧家庭场景中，实现“人来灯亮、人走灯灭”是照明节能的基础需求。传统的红外传感器容易因人体静坐、睡觉等微动状态产生误判，导致灯光意外熄灭。

本方案选用芯步智能人体存在传感器 [吸顶] [雷达版]（型号：UNI-CGQ-RT-XD-L） 。该设备采用毫米波雷达技术，能够探测呼吸、心跳等微动，可精准判断人体存在，解决了静坐误报的痛点。

核心优势：

双模控制能力：设备自带一路大功率继电器输出（AC 100-250V），可以直接控制灯光电路，也可通过开放接口联动远端控制器。
开放接口（HTTP API） ：设备支持标准HTTP协议对接，可无缝接入现有的第三方管理后台、APP或SaaS平台。

2. 整体设计

为了实现照明控制，我们设计两种可选的对接架构，以适应不同改造场景：

2.1 架构A：直连负载模式（最简方案，推荐用于本地改造）

传感器直接串联在照明灯具的回路中。利用雷达传感器的本地逻辑判断，当检测到“有人”时，传感器内置继电器吸合，灯具通电；检测到“无人”时，继电器断开。

适用场景：单一路灯控制、卫生间、会议室，无需云平台介入，即装即用。

2.2 架构B：API接口联动模式（系统集成方案）

传感器通过WiFi连接网络，将“有人/无人”状态实时推送到您的私有云服务器。您的业务系统根据接收到的状态，通过HTTP API接口向传感器（或其他指定受控设备如智能墙壁开关）下发“开/关”指令。

核心流程如下

sequenceDiagram
    participant Radar as 雷达传感器(吸顶版)
    participant Cloud as 用户私有云/服务器
    participant Light as 照明设备/开关
    Note over Radar: 探测区域内有人/无人
    Radar->>Cloud: HTTP POST 上报状态 ({"radar_target":1})
    activate Cloud
    Cloud->>Cloud: 逻辑判断 (防抖/计时/权限)
    alt 直接控制 (传感器自带输出)
        Cloud->>Radar: HTTP POST 下发指令 ({"power":0})
        Radar->>Light: 继电器执行 断电
    else 控制第三方设备
        Cloud->>Light: 控制第三方智能开关
    end
    deactivate Cloud

3. 设备能力与接口详解（基础对接）

在对接前，请明确 UNI-CGQ-RT-XD-L 的核心物模型参数：

3.1 上行数据：状态上报

当雷达探测到环境状态改变时，设备会向您预设的服务器地址推送数据。您需要接收并解析这些数据来判断环境状态。

参数 Key	类型	值说明	业务含义
`radar_target`	Int	0 或 1	雷达探测结果。1=有人(存在)，0=无人(空置)。这是控制照明的核心触发点。
`power`	Int	0 或 1	当前继电器状态。指示传感器当前是否给照明线路供电。
`radar_enable`	Int	0 或 1	雷达模块开关状态。

3.2 下行数据：设备指令控制

您可以通过向该设备发送HTTP POST请求，直接控制其内置继电器的通断，或配置传感器参数。

接口地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

核心指令集

控制照明开关（核心指令） ：
- 开灯{"device":"设备ID","order":{"power":1}}
- 关灯{"device":"设备ID","order":{"power":0}}
配置传感器（可选） ：
- 启用/关闭雷达{"device":"设备ID","order":{"radar_enable":1}} （1开启，0关闭）

4. 具体的对接实施步骤

4.1 物理安装与接线（基础准备）

强电接线：设备支持 AC 100-250V 市电输入。请将火线接入“L”端，零线接入“N”端。灯具的火线从传感器“L_OUT”引出，零线直连市电零线。
- 注意：该设备最大阻性负载为2200W，感性负载为350W，可直接驱动大部分照明回路。
网络配置：设备仅支持 2.4G WiFi。通过芯步控制台或配网工具，将设备配置入网，确保设备能够访问您的服务器地址。

4.2 服务端对接开发（关键逻辑）

为了实现“智能控制”，您需要在您的服务器上实现以下两个核心功能：

功能一：接收设备上报的消息

在芯步工作台配置“消息推送”URL。当有人进入时，您的服务器会收到如下JSON数据包（示例）：

您的业务逻辑：根据 radar_target 的值进行判断。

功能二：下发控制指令（代码示例）

当您的业务系统决定关灯时（例如触发无人计时器），需要调用芯步的API接口下发指令。

签名加密机制签名算法为：sign = md5(md5(AppSecret) + ts)。(注：AppSecret是您在控制台获取的开发者密码，ts为Unix时间戳)

示例：使用Python实现关灯指令

4.3 延时与防抖逻辑（业务最佳实践）

雷达传感器虽然灵敏，但在临界区域（如门口）可能会产生快速闪变（有人/无人状态频繁切换）。在您的云平台逻辑中加入：

“无人计时”机制：收到 radar_target:0 时，不要立刻关灯。启动一个60-300秒的计时器，期间若反复检测到有人，则重置计时器。这防止了人在室内静坐看书时灯光熄灭。
“开灯屏蔽”机制：执行关灯指令后的短时间内（如5秒），忽略传感器上报的“有人”信号，以避免设备刚关灯，人还没走出房间又触发开灯。

5. 高级应用场景与故障排查

5.1 场景联动：本地直连 vs 云端联动

场景A（本地直连） ：仅需接线即可工作，不依赖服务器，响应速度最快（约80-120ms）。
场景B（多设备联动） ：如果您想实现“探测到人时，不仅开这个灯，还要打开走廊的另一盏灯”，则必须使用API模式。您的服务器收到雷达信号后，同时向两个设备下发power:1指令。

5.2 常见对接问题排查

设备离线：检查WiFi信号强度。该设备支持设定5组WiFi，确保网络稳定。
指令下发成功但灯不亮
- 检查负载功率：如果是LED节能灯，总功率需小于300W，否则启动冲击可能导致继电器粘连或损坏。
- 检查返回码：API返回200仅代表平台收到指令，若设备离线会执行失败。
数据收不到：检查您的公网服务器是否具备公网可访问的IP，或者私有化部署时，设备是否与服务器处于同一局域网段。

6. 总结

通过对接芯步 UNI-CGQ-RT-XD-L 雷达传感器，您可以实现高可靠性的照明控制。方案的核心在于利用雷达的“存在探测”替代“移动探测”，结合开放的HTTP API，无论是采用设备内置继电器直接控制，还是通过云端脚本联动控制，都能达到工业级的稳定体验。开发时需重点关注签名鉴权算法与“无人延时”的业务逻辑优化。