如何二次开发智能人体存在传感器吸顶雷达版来实现人走断电联动控制_解决方案

CATALOG

一、解决概述

在共享茶室、办公区、家庭等无人值守或半值守空间中，一个普遍存在的能耗痛点是：人已离开，灯和空调却依然开着。传统的人体传感器仅能探测大幅运动（如挥手、行走），当人在静坐、小憩时，传感器会误判为“无人”，导致灯光/空调被错误关闭，严重影响用户体验。

本方案利用芯步智能人体存在传感器[吸顶][雷达版]（型号：UNI-CGQ-RT-XD-L）的核心技术——毫米波雷达微动探测，结合标准HTTP接口，实现高可靠的“人走断电”联动控制。

核心价值

精准存在检测：区别于普通红外传感器，雷达技术可探测4米内人体微动（呼吸、心跳引起的胸腔起伏），静坐、小憩、玩手机也不会被误判为“无人”
自带1路电源输出：传感器内置继电器，可直接控制照明等设备，无需额外控制器，降低硬件成本
⏱️ 可编程延时断电：通过自定义软件逻辑，支持“人离开N分钟后断电”，避免短暂离开导致频繁开关
实时状态上报：有人/无人状态变化毫秒级推送至您的服务器，触发自定义联动逻辑
私有化部署：支持纯局域网运行，数据不出内网，响应速度更快

二、核心技术能力分析

2.1 产品规格

智能人体存在传感器[吸顶][雷达版]的核心参数如下

类别	特性说明
产品型号	UNI-CGQ-RT-XD-L
探测技术	毫米波雷达，可探测人体微动（呼吸等，探测距离4米内）/ 大幅运动感应（6米内）
探测角度	约120°
带载能力	自带1路电源输出（MAX 2200W阻性负载 / 350W感性负载）——注意：如果用于LED或节能灯泡，则负载应小于300W
工作电压	AC 100-250V（交流/市电）
待机功耗	1.2W
产品尺寸	宽：61mm；长：61mm；厚：38mm
安装方式	吸顶安装，标准卡扣固定
无线连接	WiFi 2.4GHz IEEE 802.11 b/g/n
控制协议	开放标准HTTP接口，支持私有化部署
上报机制	人体存在状态变化时，实时上报到自定义服务器

2.2 核心数据流（联动关键）

2.2.1 状态上报（上行——传感器 → 服务器）

当有人进入或离开探测区域时，设备会通过芯步平台向您的服务器推送状态消息

2.2.2 设备控制（下行——服务器 → 传感器）

传感器自带1路电源输出，您可直接控制其通断来实现照明/设备的开关

核心优势：传感器自带继电器，可直接控制照明或小功率设备，无需额外购买控制器——传感器既是感知单元，也是执行单元。

2.3 API接口签名规则

芯步API采用动态签名验证机制，保证接口调用的安全性

请求地址:https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
请求方法:POST
Content-Type:application/json

签名算法:
md5_secret = md5(AppSecret)
sign = md5(md5_secret + ts)

参数说明:
- AppId:应用ID（控制台获取）
- AppSecret:应用密钥（控制台获取）
- ts:当前Unix时间戳（秒）

请求Body示例

⚠️ 重要说明：API返回code:200仅表示平台已接收指令，不代表设备执行成功。若设备离线，命令不会生效。关键场景配合消息推送确认执行结果。

三、人走断电联动集成方案

3.1 整体架构

本方案采用“传感器即执行器”的极简架构，无需额外控制器：

┌─────────────────────────────────────────────────────────────────┐
│                        监测现场                                  │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  智能人体存在传感器[吸顶][雷达版]                         │   │
│  │  ┌─────────────┐    ┌─────────────┐                    │   │
│  │  │  雷达模块   │───▶│  继电器输出 │                    │   │
│  │  │  (微动探测) │    │  (1路电源)  │                    │   │
│  │  └─────────────┘    └──────┬──────┘                    │   │
│  │                           │                             │   │
│  │                           ▼                             │   │
│  │                       照明/电器                         │   │
│  │                    （可直接控制）                        │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  状态上报（有人/无人） → HTTP API                                │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTPS / MQTT
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    开发者服务器（联动逻辑层）                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    状态管理                              │   │
│  │  - 记录最后有人时间                                      │   │
│  │  - 无人持续时间计时                                      │   │
│  └─────────────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    决策引擎                              │   │
│  │  规则:无人持续N分钟 → 下发断电指令                       │   │
│  └─────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ 断电指令（HTTP API）
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    执行层（同传感器）                            │
│            传感器接收 {"power": 0} 指令 → 断开输出               │
└─────────────────────────────────────────────────────────────────┘

3.2 硬件安装步骤

步骤1：位置规划

传感器采用吸顶安装，安装在房间中央或人员主要活动区域上方
探测范围：半径约4米（存在探测）/ 6米（运动探测），角度120°扇形

步骤2：传感器安装

使用卡扣将传感器固定在天花板上
接线：输入端接AC 220V市电（L/N），输出端接照明/电器

步骤3：网络配置

确保安装位置WiFi信号覆盖（设备仅支持2.4G频段）
设备支持设定5组WiFi网络，优先连接信号最强的
通过芯步控制台完成配网

步骤4：获取凭证

登录
在「开发设置」中获取 AppId 和 AppSecret
记录传感器的设备ID
配置消息推送URL（接收有人/无人状态上报）

3.3 代码集成示例

以下提供Python和Java两种语言的完整实现。

Python实现（推荐用于后端服务）

import hashlib
import time
import requests
import threading
from flask import Flask, request, jsonify
from typing import Dict, Optional

app = Flask(__name__)

class PresenceController:
    """人体存在传感器联动控制类"""
    
    def __init__(self, app_id: str, app_secret: str):
        self.app_id = app_id
        self.app_secret = app_secret
        self.api_base = "https://api.thingboot.com"
        
        # 每个传感器的状态缓存
        self.last_presence_time = {}      # 最后检测到有人的时间戳
        self.timer_threads = {}            # 延时关设备定时器
    
    def _generate_sign(self, ts: int) -> str:
        """生成API签名:sign = md5(md5(AppSecret) + ts)"""
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()
    
    def _send_command(self, device_id: str, order: Dict) -> Optional[Dict]:
        """向传感器下发控制命令（控制其继电器输出）"""
        ts = int(time.time())
        sign = self._generate_sign(ts)
        url = f"{self.api_base}/{self.app_id}/device/control/?sign={sign}&ts={ts}"
        
        payload = {"device": device_id, "order": order}
        try:
            response = requests.post(url, json=payload, timeout=5)
            return response.json()
        except Exception as e:
            print(f"命令发送失败: {e}")
            return None
    
    # ========== 设备控制方法 ==========
    def turn_on(self, device_id: str) -> Optional[Dict]:
        """接通传感器输出（开灯/设备）"""
        return self._send_command(device_id, {"power": 1})
    
    def turn_off(self, device_id: str) -> Optional[Dict]:
        """断开传感器输出（关灯/设备）"""
        return self._send_command(device_id, {"power": 0})
    
    # ========== 联动核心逻辑 ==========
    def on_presence_change(self, sensor_id: str, presence: str, 
                           controller_id: str, off_delay_seconds: int = 300):
        """
        处理人体存在状态变化
        :param sensor_id: 传感器设备ID
        :param presence: 状态 "present" 或 "absent"
        :param controller_id: 要控制的设备ID（本例中即传感器自身）
        :param off_delay_seconds: 无人后延迟断电时间（秒），默认5分钟
        """
        current_time = time.time()
        
        if presence == "present":
            # 有人进入:更新最后时间，取消之前的关灯定时器
            self.last_presence_time[sensor_id] = current_time
            
            if sensor_id in self.timer_threads:
                self.timer_threads[sensor_id].cancel()
            
            print(f"[传感器 {sensor_id}] 检测到有人进入，确保设备开启")
            # 确保开灯（可选项，也可仅在首次无人后关灯一次）
            # self.turn_on(controller_id)
            
        elif presence == "absent":
            # 无人状态:记录无人开始时间，启动延时关灯定时器
            print(f"[传感器 {sensor_id}] 检测到无人，{off_delay_seconds}秒后将关闭设备")
            
            def delayed_off():
                # 再次检查是否有新的人进入
                last_time = self.last_presence_time.get(sensor_id, 0)
                if last_time < current_time:
                    print(f"[传感器 {sensor_id}] 无人已持续{off_delay_seconds}秒，执行断电")
                    self.turn_off(controller_id)
                else:
                    print(f"[传感器 {sensor_id}] 延迟期间有人进入，取消断电")
            
            timer = threading.Timer(off_delay_seconds, delayed_off)
            self.timer_threads[sensor_id] = timer
            timer.start()
    
    def get_status(self, device_id: str) -> Optional[Dict]:
        """查询传感器当前状态"""
        return self._send_command(device_id, {"status": "1"})

# ========== 消息推送接收接口 ==========
controller = PresenceController("YOUR_APP_ID", "YOUR_APP_SECRET")

@app.route('/api/sensor/callback', methods=['POST'])
def sensor_callback():
    """
    接收人体存在传感器状态上报
    需在芯步控制台配置此URL为消息推送地址
    """
    data = request.get_json()
    device_id = data.get('device')
    msg_type = data.get('type')
    
    if msg_type == 'state':
        message = data.get('message', {})
        state_data_list = message.get('data', [])
        
        for state_data in state_data_list:
            # 解析人体存在状态
            # 注意:字段名可能是 'presence' 或 'radar'，根据实际产品而定
            presence = state_data.get('presence') or state_data.get('radar')
            
            if presence is not None:
                # 触发联动逻辑
                # 本例中传感器自带继电器，所以 controller_id = device_id（自身）
                controller.on_presence_change(
                    sensor_id=device_id,
                    presence=presence,
                    controller_id=device_id,      # 控制自身输出
                    off_delay_seconds=300          # 5分钟无人关门锁断电
                )
    
    return jsonify({"code": 0})

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

Java实现

import okhttp3.*;
import com.google.gson.Gson;
import java.security.MessageDigest;
import java.util.concurrent.*;

public class PresenceController {
    private final String appId;
    private final String appSecret;
    private final OkHttpClient client;
    private final Gson gson = new Gson();
    private final ConcurrentHashMap<String, Long> lastPresenceTime = new ConcurrentHashMap<>();
    private final ConcurrentHashMap<String, ScheduledFuture<?>> timers = new ConcurrentHashMap<>();
    private final ScheduledExecutorService scheduler = Executors.newScheduledThreadPool(10);
    
    private static final String API_BASE = "https://api.thingboot.com";
    
    public PresenceController(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
        this.client = new OkHttpClient();
    }
    
    private String md5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) sb.append(String.format("x", b));
            return sb.toString();
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    private void sendCommand(String deviceId, String orderJson) throws IOException {
        long ts = System.currentTimeMillis() / 1000;
        String md5Secret = md5(appSecret);
        String sign = md5(md5Secret + ts);
        String url = API_BASE + "/" + appId + "/device/control/?sign=" + sign + "&ts=" + ts;
        
        String bodyJson = "{\"device\":\"" + deviceId + "\",\"order\":" + orderJson + "}";
        RequestBody body = RequestBody.create(bodyJson, MediaType.parse("application/json"));
        
        Request request = new Request.Builder().url(url).post(body).build();
        try (Response response = client.newCall(request).execute()) {
            // 200仅表示平台已接收
        }
    }
    
    public void turnOff(String deviceId) throws IOException {
        sendCommand(deviceId, "{\"power\":0}");
    }
    
    public void onPresenceChange(String sensorId, String presence, 
                                  String controllerId, int offDelaySeconds) {
        long currentTime = System.currentTimeMillis();
        
        if ("present".equals(presence)) {
            lastPresenceTime.put(sensorId, currentTime);
            ScheduledFuture<?> timer = timers.remove(sensorId);
            if (timer != null) timer.cancel(false);
            System.out.println("传感器 " + sensorId + " 检测到有人");
            
        } else if ("absent".equals(presence)) {
            System.out.println("传感器 " + sensorId + " 无人，" + offDelaySeconds + "秒后断电");
            
            ScheduledFuture<?> timer = scheduler.schedule(() -> {
                Long lastTime = lastPresenceTime.get(sensorId);
                if (lastTime == null || lastTime < currentTime) {
                    try {
                        turnOff(controllerId);
                        System.out.println("传感器 " + sensorId + " 执行断电");
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            }, offDelaySeconds, TimeUnit.SECONDS);
            
            timers.put(sensorId, timer);
        }
    }
}

四、典型应用场景

4.1 会议室/办公室

配置项	值	说明
安装位置	房间中央吸顶	覆盖会议桌区域
无人断电延迟	10-15分钟	避免会议间隙误关灯
关联设备	照明、空调、投影仪	传感器输出接入总控线路

4.2 共享茶室/棋牌室

配置项	值	说明
安装位置	茶桌/麻将桌正上方	精准覆盖座位区域
无人断电延迟	5分钟	降低能耗，提高翻台率
联动设备	主照明、饮水机	核心用电设备

4.3 私有化部署

对于数据安全要求高的内网环境，传感器支持私有化部署，可直接向设备IP发送命令

五、集成步骤

步骤一：硬件采购与安装

采购智能人体存在传感器[吸顶][雷达版]
选择吸顶位置，确保覆盖主要活动区域
由电工完成电源接线（输入端接市电，输出端接照明/设备）

步骤二：平台配置

登录
在「开发设置」中获取 AppId 和 AppSecret
为传感器配网，记录设备ID
配置消息推送URL为：http(s)://你的服务器地址/api/sensor/callback

步骤三：后端集成

部署上述Flask服务
根据实际场景调整off_delay_seconds参数

步骤四：测试验证

进入探测区域，验证有人状态上报和自动开灯
离开区域，验证延迟指定时间后自动断电
测试静坐/小憩状态是否被正确识别为“有人”

六、总结

优势	说明
精准微动探测	雷达技术可探测呼吸等微动，静坐、小憩也不会误判为“无人”
自带继电器	无需额外控制器，传感器直接控制照明/设备，降低硬件成本
可编程延时	无人后延迟断电时间完全由您自定义，灵活适应不同场景
毫秒级上报	状态变化实时推送到您的服务器，响应速度快
私有化部署	支持纯局域网运行，数据不出内网
零网关	WiFi直连，无需购买额外网关设备

七、注意事项

负载类型 ⚠️：LED灯、节能灯属于感性负载，传感器输出接此类设备时，功率需控制在300W以内
探测范围：存在探测距离4米、运动探测6米、角度120°，请根据房间大小合理安装
WiFi信号：确保安装位置WiFi信号良好（设备仅支持2.4G频段）
延时策略：设置适当的延迟时间（5-15分钟），避免短暂离开导致频繁开关
API响应：返回code:200仅表示平台接收指令，不代表设备执行成功；关键场景配合消息推送确认

通过以上方案，你可以快速将芯步智能人体存在传感器[吸顶][雷达版]集成到管理系统中，实现精准可靠的“人走断电”联动控制，有效降低无人值守空间的能耗。如有疑问，可访问获取详细产品手册和技术支持。

一、解决概述

二、核心技术能力分析

2.1 产品规格

2.2 核心数据流（联动关键）

2.2.1 状态上报（上行——传感器 → 服务器）

2.2.2 设备控制（下行——服务器 → 传感器）

2.3 API接口签名规则

三、人走断电联动集成方案

3.1 整体架构

3.2 硬件安装步骤

3.3 代码集成示例

Python实现（推荐用于后端服务）

Java实现

四、典型应用场景

4.1 会议室/办公室

4.2 共享茶室/棋牌室

4.3 私有化部署

五、集成步骤

步骤一：硬件采购与安装

步骤二：平台配置

步骤三：后端集成

步骤四：测试验证

六、总结

七、注意事项

人体存在传感器产品方案：

如何二次开发壁挂式智能感应控制器来实现语音设备联动警示

怎么在智慧教室人体存在监测中集成智能硬件来实现人体微动探测

智能家居人体感应照明：怎样将壁挂安装雷达人体感应器接入到自己的项目中

银行网点人体存在监测：如何将壁挂式红外雷达双鉴传感器对接到自己的项目中

怎么在智能化改造人体感应场景中集成智能硬件以实现故障告警通知

人走场景方案：

怎么在共享棋牌室安全节能与消防联动中对接智能硬件来实现人走断电联动控制

怎样在共享台球厅人走断电与安全检测中接入智能设备以实现人体存在联动控制

如何在共享茶室人走断电与安全检测中对接智能设备以实现火灾烟雾报警

如何在共享台球厅人体感应联动中接入智能硬件来实现人走断电联动控制

怎么接入壁挂安装雷达人体感应器以实现人走断电联动控制

断电用途方案：

怎么在医院病房空调管理中接入智能设备来实现断电记忆恢复控制

共享棋牌室人走断电控制：怎样将带联动输出壁挂人体存在传感器集成到项目中

如何接入35A大功率智能断路器以实现过流自动断电控制

怎样二次开发35A定时控制断路器以实现过流自动断电控制

怎样在共享自习室人走断电控制中对接智能设备来实现存在感应数据上报