园区公共区域人体感应：怎样把人走断电雷达传感器对接到项目中_解决方案

CATALOG

一、概述

园区公共区域（走廊、卫生间、会议室、楼梯间、茶水间等）照明管理是节能降耗的重要环节。传统照明开关需要人工操作，经常出现"长明灯"造成能源浪费。芯步智能人体存在雷达传感器[壁挂]通过双模检测技术（红外+雷达），实时探测区域内是否有人，并通过开放HTTP接口将状态上报至您的系统，实现人走断电的自动化节能管理。

核心能力

双模检测：红外+雷达双重确认，只有当两者都检测到无人时，才判定为无人状态，避免误判
高精度探测：4米内可探测人体微动（呼吸等微小动作），6米内可探测运动感应
实时状态上报：环境状态变化时，毫秒级推送消息到您的服务器
开放HTTP API：适用于任何支持HTTP请求的编程语言，支持Web、APP/小程序、SaaS/低代码等平台
私有化部署：支持局域网运行，数据不出园区

园区公共区域典型应用场景

场景	控制对象	联动逻辑
走廊/通道照明	LED灯带	有人经过时开灯，无人后延时2分钟自动关灯
公共卫生间照明	排风扇+照明	有人进入开灯开排风，无人后自动关闭
会议室/洽谈室	灯光+空调	会议进行时设备工作，无人值守自动断电
楼梯间照明	感应灯	上下楼时提前亮灯，无人后自动熄灭
茶水间节能	照明+饮水机	有人使用时供电，无人时切断电源

二、产品核心特性

2.1 产品规格

芯步智能人体存在雷达传感器2[壁挂]（型号：UNI-CGQ-RT-L-BG2）具备以下技术特性

特性	参数
产品型号	UNI-CGQ-RT-L-BG2
检测方式	红外感应 + 雷达感应（双模）
探测距离	4米内人体存在（微动探测），6米内运动感应
探测角度	约120°
安装方式	壁挂式
联网方式	WiFi 2.4GHz，无需网关
网络配置	可设定5组WiFi，自动连接信号最强的网络
控制接口	HTTP API
私有化部署	支持局域网直连
开放接口	适用于任何支持HTTP请求的编程语言

[continuation]...

2.2 支持的命令与功能

该设备支持以下核心命令

命令类型	命令格式	说明	应用场景
雷达模块开关	`{"radar_enable":"1"}` / `{"radar_enable":"0"}`	开启/关闭雷达探测	维护/调试时临时关闭
LED指示灯	`{"led":"1"}` / `{"led":"0"}`	开启/关闭LED指示灯	调试辅助
线路控制	`{"power":"1"}` / `{"power":"0"}`	控制输出线路通断	直接驱动照明设备

2.3 状态上报数据格式

传感器检测到有人/无人状态变化时，通过消息推送实时上报

三、软件集成架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    园区节能管理平台                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  能耗看板   │  │  联动规则   │  │  告警中心   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP消息推送（状态变化）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
│                  （配置消息推送URL，接收传感器数据）                │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz（状态上报 & 命令下发）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                 园区公共区域（走廊/卫生间/会议室）                  │
│  ┌─────────────────────────────────────────────────────────┐    │
│  │  人体存在雷达传感器  ←→  智能PDU/墙壁开关                │    │
│  │  （检测有人/无人）       （控制照明回路）                 │    │
│  └─────────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────────┘

3.2 两种接入方式对比

方式	说明	适用场景
消息推送（推荐）	设备状态变化时平台主动推送至您的服务器	实时监控、人走断电联动
主动查询	通过API定时查询设备状态	非实时场景、备用方案

本方案重点介绍消息推送方式，实现人走断电的实时响应。

四、API接口接入详解

4.1 消息推送配置（核心）

传感器是上行设备，主要工作是上报状态变化（有人/无人变化）。您需要在芯步控制台配置接收地址，设备状态变化时平台会实时推送。

配置步骤

登录芯步控制台
进入「开发设置」→「消息推送」
配置您的服务器接收URL（如 https://your-domain.com/api/sensor/callback）
选择需要接收的消息类型（选择state状态消息）

4.2 下行控制接口（可选）

如需向传感器下发命令（如开关雷达模块），可通过HTTP API调用

请求地址

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名计算公式

sign = md5( md5(AppSecret) + ts )

签名计算示例

4.3 多语言代码示例

Python（消息接收服务 + 自主联动）

from flask import Flask, request, jsonify
import requests
import time
import hashlib
import logging

app = Flask(__name__)
logging.basicConfig(level=logging.INFO)

# 配置参数
APP_ID = "your_app_id"
APP_SECRET = "your_app_secret"

# 联动设备配置（根据实际部署填写）
LIGHT_CONTROL_DEVICES = {
    "corridor_floor1": "pdu_corridor_01",   # 1楼走廊照明控制设备ID
    "bathroom_floor1": "switch_bathroom_01", # 1楼卫生间照明控制设备ID
    "meeting_room_a": "pdu_meeting_a_01"     # A会议室设备电源控制ID
}

# 延时关灯时间配置（毫秒）
DELAY_CONFIG = {
    "corridor": 120000,   # 走廊:2分钟
    "bathroom": 180000,   # 卫生间:3分钟
    "meeting": 300000     # 会议室:5分钟
}

# 存储延时任务信息
delay_timers = {}

def generate_sign():
    """生成API签名"""
    ts = int(time.time())
    md5_secret = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign = hashlib.md5((md5_secret + str(ts)).encode()).hexdigest()
    return sign, ts

def control_device(device_id, power_on):
    """发送控制命令到联动设备"""
    sign, ts = generate_sign()
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    order = {"power": "1"} if power_on else {"power": "0"}
    payload = {"device": device_id, "order": order}
    
    try:
        response = requests.post(url, json=payload, timeout=5)
        logging.info(f"设备 {device_id} 控制结果: {response.json()}")
        return response.json()
    except Exception as e:
        logging.error(f"控制设备 {device_id} 失败: {e}")
        return None

def turn_off_device_delayed(device_id, delay_ms, sensor_id):
    """延时关灯（使用简单延时，生产环境使用任务队列）"""
    import threading
    
    # 取消该传感器已有的延时任务
    if sensor_id in delay_timers:
        delay_timers[sensor_id].cancel()
    
    # 创建新延时任务
    timer = threading.Timer(delay_ms / 1000, control_device, args=[device_id, False])
    delay_timers[sensor_id] = timer
    timer.start()
    logging.info(f"传感器 {sensor_id} 已设置延时关灯 {delay_ms/1000} 秒")

@app.route('/api/sensor/callback', methods=['POST'])
def sensor_callback():
    """接收传感器消息推送"""
    try:
        data = request.get_json()
        logging.info(f"收到传感器消息: {data}")
        
        device_id = data.get('device')
        msg_type = data.get('type')
        message = data.get('message', {})
        msg_data = message.get('data', [{}])[0]
        
        # 解析人体存在状态
        radar_detected = msg_data.get('radar_detected')
        
        if radar_detected == "1":
            # 有人:立即开灯
            logging.info(f"传感器 {device_id} 检测到有人，正在开灯...")
            
            # 根据传感器区域确定要控制的设备和延时策略
            if "corridor" in device_id:
                control_device(LIGHT_CONTROL_DEVICES["corridor_floor1"], True)
                turn_off_device_delayed(LIGHT_CONTROL_DEVICES["corridor_floor1"], 
                                        DELAY_CONFIG["corridor"], device_id)
            elif "bathroom" in device_id:
                control_device(LIGHT_CONTROL_DEVICES["bathroom_floor1"], True)
                turn_off_device_delayed(LIGHT_CONTROL_DEVICES["bathroom_floor1"], 
                                        DELAY_CONFIG["bathroom"], device_id)
            elif "meeting" in device_id:
                control_device(LIGHT_CONTROL_DEVICES["meeting_room_a"], True)
                # 会议室采用更长的延时，且不自动关灯，由预约系统控制
        
        elif radar_detected == "0":
            logging.info(f"传感器 {device_id} 检测到无人，已设置延时关灯")
            # 无人时，延时任务会在上面由turn_off_device_delayed执行
            # 无额外操作
        
        # 必须返回200 OK，否则平台会重试
        return jsonify({"code": 200}), 200
        
    except Exception as e:
        logging.error(f"处理消息异常: {str(e)}")
        return jsonify({"code": 500}), 500

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080)

Python（传感器命令下发示例）

JavaScript/Node.js（消息接收服务）

Shell（curl）- 传感器命令下发示例

五、园区场景实战

5.1 第一种场景：走廊过人即亮、人走即灭

需求：员工经过走廊时自动开灯，离开后延时2分钟自动关灯，实现"灯随人走"的节能效果。

设备配置

走廊每30-40米部署1台雷达传感器（壁挂安装）
走廊照明接入智能PDU或智能开关，通过API控制

联动逻辑

5.2 第二种场景：公共卫生间自动排风

需求：有人进入卫生间时自动开灯并启动排风扇，无人后延时关闭。

设备配置

每个卫生间部署1台雷达传感器
照明和排风扇接入同一智能PDU或分别接入不同回路

联动逻辑

5.3 第三种场景：会议室智能节能

需求：结合预约系统和人体感应，实现会议室设备的智能管理。

联动逻辑

预约时间段内：保持设备开启
预约时间段外：无人时自动断电
会议临时延长：感应到有人时自动续时

5.4 场景四：园区能耗看板集成

需求：集中展示各区域照明实时状态和能耗数据。

实现的方式是

传感器状态通过消息推送实时入库
前端通过WebSocket获取实时状态

数据库表结构

六、双模检测的优势

芯步人体存在传感器采用红外+雷达双模检测技术，核心优势在于

检测方式	原理	优势	不足
红外感应	检测人体温度变化	省电、成本低	对静止人体可能漏判
雷达感应	检测微动（呼吸等）	可检测静止人体	对非生物移动也可能触发
双模融合	两者同时确认	准确率高、无漏判	-

判断逻辑：只有当红外和雷达同时检测到无人状态时，才判定为"无人"，极大降低了误判概率。

七、部署安装指南

7.1 安装要求

项目	要求
安装方式	壁挂式安装
安装高度	距地面2-2.5米
探测范围	4米内微动，6米内运动
电源	220V AC电源（需接线）
网络	WiFi 2.4GHz信号覆盖良好
安装禁忌	避免直接对着空调出风口、大幅摆动的绿植

7.2 园区部署

场景类型	部署间距	安装位置
走廊（直线型）	每30-40米1台	末端或中央壁挂
卫生间	每间1台	门口或天花板
会议室	每间1-2台	对角安装覆盖全室
楼梯间	每层1台	楼梯转角处

7.3 联动设备接线示意

传感器输出

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
收不到消息推送	回调地址不可达	检查服务器是否可访问，需5秒内返回200
频繁误判有人	安装位置不当	检查是否对着空调出风口或绿植
检测不到静止人体	探测距离不足	确保人距传感器4米以内
人走后灯不关	延时未到或二次触发	检查延时配置，查看日志确认状态变化
手动开灯后自动关灯冲突	规则重叠	配置时需考虑手动控制的优先级

九、总结

本方案基于芯步智能人体存在雷达传感器，实现了园区公共区域的人走断电自动化

能力	实现的方式是
有人/无人实时检测	双模传感器实时上报状态变化
人走延时关灯	服务器接收消息后启动延时任务
跨设备联动	消息推送后调用PDU/开关API控制照明
集中监控看板	传感器数据入库，前端实时展示
节能报表分析	记录开关灯日志，统计分析节能效果

集成核心步骤

获取AppID/AppSecret
在控制台配置消息推送URL，接收传感器状态
开发HTTP服务，解析有人/无人状态
实现延时关灯逻辑和PDU控制集成

方案优势

✅ 双模检测：红外+雷达双重确认，准确率高
✅ 实时上报：状态变化毫秒级推送
✅ 开放接口：标准HTTP API，任意编程语言可接入
✅ 部署灵活：WiFi直连无需网关，支持私有化部署
✅ 高性价比：单传感器覆盖40㎡区域

如需详细的产品手册和API文档，请访问查阅或联系技术支持团队获取。