怎样接入吸顶式智能感应控制器来实现自定义人体感应联动逻辑_解决方案

CATALOG

一、概述

在办公场所、酒店走廊、园区公共区域、家居空间等场景，传统照明控制依赖人工操作，常出现“长明灯”造成能源浪费。芯步吸顶式智能感应控制器(红外/雷达版)通过开放HTTP接口，实时上报有人/无人状态，让您基于服务器实现完全自定义的联动逻辑。

核心能力

双版本可选：红外版(5米探测)和雷达版(4米微动/6米运动)，适配不同场景
实时状态上报：有人/无人状态变化时，毫秒级推送消息到您的服务器
本地AC输出：自带一路电源输出，可直连照明等电器，支持本地快速联动
开放HTTP API：适用于任何支持HTTP请求的编程语言
私有化部署：支持局域网运行，数据不出园区
无网关设计：WiFi直连，可设定5组WiFi自动切换

核心工作流程

传感器检测到人体存在状态变化(有人/无人)
平台通过消息推送向您的服务器上报状态
您的服务器执行自定义联动规则(控制其他设备)
最终实现完整的场景联动

典型应用场景

场景	感应设备	执行设备	联动逻辑
走廊人走灯灭	吸顶红外传感器	智能墙壁开关	有人亮灯，无人延时2分钟自动关灯
会议室节能	吸顶雷达传感器	智能PDU+空调控制器	无人30分钟后自动关闭所有设备电源
卫生间自动排风	吸顶红外传感器	智能墙壁插座(排风扇)	有人启动排风，无人延时5分钟关闭
安防联动语音告警	吸顶雷达传感器	智能语音音箱	非工作时间探测到有人，触发告警播报

二、产品核心特性

2.1 产品选型

芯步提供两款吸顶式智能感应控制器，可根据场景需求选择：

特性	智能人体存在传感器[吸顶][红外版]	智能人体存在传感器[吸顶][雷达版]
产品型号	UNI-CGQ-RT-XD-H	UNI-CGQ-RT-XD-L
检测方式	红外感应	雷达感应
探测距离	5米	4米内人体存在微动，6米内运动感应
探测角度	约120°	约120°
工作电压	AC 100-250V	AC 100-250V
负载功率	MAX 2200W(阻性)/350W(感性)	MAX 2200W(阻性)/350W(感性)
产品尺寸	61×61×48.1mm	61×61×38mm
安装方式	吸顶式	吸顶式
无线连接	WiFi 2.4GHz	WiFi 2.4GHz
控制接口	HTTP API	HTTP API
私有化部署	支持	支持

提示：红外版成本较低，适合走廊、卫生间等常规场景；雷达版可检测静止人体(呼吸微动)，适合会议室、办公室等人员可能长时间静止的场景。

2.2 核心物模型

吸顶式智能感应控制器具备以下核心属性，理解这些属性是二次开发的基础

属性	字段	值	说明
红外/雷达模块开关	`infrared_enable` / `radar_enable`	1=开启，0=关闭	远程控制探测模块
人体存在状态	`infrared_target` / `radar_detected`	1=有人，0=无人	核心上报字段
线路输出	`power`	1=接通，0=断开	控制AC输出通断
LED指示灯	`led`	1=亮，0=灭	调试辅助

2.3 核心触发事件

设备在以下情况会主动上报消息：

事件名称	触发条件	说明
`infrared_detect`	红外状态变化	有人/无人切换时触发
`relay1`	线路状态变化	AC输出接通/断开时触发
`boot`	设备开机	设备上电时触发，上报当前状态

2.4 本地联动配置(无需服务器)

吸顶式控制器自带一路AC输出，支持本地联动规则配置，无需开发即可实现基础的“人走灯灭”功能

配置项	可选值	说明
红外开机状态(`infrared`)	1/0	设备启动时红外模块状态
线路开机状态(`relay1`)	1/0	设备启动时线路输出状态
发现有人时线路动作(`relay_change_1`)	1/0/no	可选：打开/关闭/无动作
发现无人时线路动作(`relay_change_0`)	1/0/no	可选：打开/关闭/无动作
红外有人触发持续时间(`infrared_change_1`)	0-5秒	有人状态确认时间，防误触发
红外无人触发持续时间(`infrared_change_0`)	0-600秒	无人延时时间，可配置30秒~10分钟

例如：将发现有人时线路动作设为1(打开)、发现无人时线路动作设为0(关闭)、红外无人触发持续时间设为120秒，即可实现“人走2分钟后自动关灯”的本地联动，无需任何代码开发。

三、二次开发架构

3.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│                    业务系统(节能平台/物业系统)                     │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  规则引擎   │  │  状态看板   │  │  告警中心   │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ HTTP消息推送(状态变化)
                              │ HTTP API调用(下发控制命令)
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                     芯步云平台 / 私有化服务器                  │
└─────────────────────────────────────────────────────────────────┘
                              ▲
                              │ WiFi 2.4GHz
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                  吸顶式智能感应控制器                            │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐               │
│  │  红外/雷达   │  │   AC输出    │  │   LED指示灯  │               │
│  │   探测模块   │  │   (本地)    │  │   (调试)     │               │
│  └─────────────┘  └─────────────┘  └─────────────┘               │
└─────────────────────────────────────────────────────────────────┘

3.2 两种开发模式对比

模式	说明	适用场景
本地联动(配置型)	通过设备配置项实现基础联动，无需开发	人走灯灭、定时断电等基础场景
云端联动(开发型)	通过消息推送接收状态，自定义业务逻辑	复杂联动、跨设备协同、数据统计

本方案重点介绍云端联动开发模式，实现完全自定义的联动逻辑。

四、API接口接入详解

4.1 上行消息推送(接收传感器状态)——核心功能

传感器是上行设备，主要工作是上报状态变化。您需要在芯步控制台配置接收地址，设备状态变化时平台会实时推送。这是整个联动的核心——您的业务逻辑由此触发。

配置步骤

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

状态上报数据格式(有人/无人变化时触发)：

4.2 下行控制接口(控制传感器模块/线路)

如需远程控制传感器模块开关或AC输出，可通过HTTP API下发命令

请求地址

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

参数说明

参数	说明
{AppId}	应用ID(控制台获取)
{ts}	当前Unix时间戳(秒)
{sign}	签名：`md5(md5(AppSecret) + ts)`

签名计算示例

核心控制命令

命令	格式	说明
控制AC输出	`{"power":"1"}` / `{"power":"0"}`	接通/断开本地输出线路
开启/关闭探测模块	`{"infrared_enable":"1"}`	红外版
开启/关闭探测模块	`{"radar_enable":"1"}`	雷达版
控制LED指示灯	`{"led":"1"}` / `{"led":"0"}`	调试辅助
查询设备信息	`{"system":"network"}`	查询网络状态

4.3 完整代码示例

Python(完整联动服务)

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

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

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

# 设备映射:传感器ID -> {联动目标设备, 延时配置, 联动规则}
SENSOR_MAPPING = {
    "sensor_hallway_01": {
        "target_device": "light_hallway_01",   # 控制的照明设备ID
        "delay_seconds": 120,                   # 无人120秒后关灯
        "off_hours": (22, 6),                  # 夜间时段(22:00-06:00)特殊处理
        "description": "一楼东走廊"
    },
    "sensor_meeting_a": {
        "target_device": "pdu_meeting_a",
        "delay_seconds": 1800,                  # 无人30分钟后断电
        "off_hours": None,
        "description": "A会议室"
    }
}

# 存储延时定时器
power_off_timers = {}

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

def control_device(device_id, power_on):
    """
    控制执行设备(如智能开关、智能插座、语音音箱等)
    :param device_id: 设备ID
    :param power_on: True=接通，False=断开
    """
    ts = int(time.time())
    sign = generate_sign(ts)
    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} {'接通' if power_on else '断开'} 成功")
        return response.json()
    except Exception as e:
        logging.error(f"控制设备 {device_id} 失败: {e}")
        return None

def schedule_power_off(sensor_id, target_device, delay_seconds):
    """延时断电"""
    if sensor_id in power_off_timers:
        power_off_timers[sensor_id].cancel()
    
    timer = threading.Timer(delay_seconds, control_device, args=[target_device, False])
    power_off_timers[sensor_id] = timer
    timer.start()
    logging.info(f"传感器 {sensor_id} 已设置 {delay_seconds} 秒后断电")

def is_night_time():
    """判断是否为夜间时段"""
    current_hour = datetime.now().hour
    return current_hour >= 22 or current_hour < 6

@app.route('/api/sensor/callback', methods=['POST'])
def sensor_callback():
    """接收吸顶传感器消息推送 - 核心联动入口"""
    try:
        data = request.get_json()
        logging.info(f"收到传感器消息: {data}")
        
        sensor_id = data.get('device')
        msg_data = data.get('message', {}).get('data', [{}])[0]
        
        # 根据传感器类型获取状态(雷达版或红外版)
        radar_detected = msg_data.get('radar_detected')
        infrared_target = msg_data.get('infrared_target')
        occupied = radar_detected == "1" or infrared_target == "1"
        
        config = SENSOR_MAPPING.get(sensor_id)
        if not config:
            logging.warning(f"传感器 {sensor_id} 未配置联动规则")
            return jsonify({"code": 200}), 200
        
        target_device = config["target_device"]
        delay_seconds = config["delay_seconds"]
        
        if occupied:
            # 有人:立即接通电源
            logging.info(f"{config['description']} 检测到有人，立即接通电源")
            control_device(target_device, True)
            
            # 取消断电定时
            if sensor_id in power_off_timers:
                power_off_timers[sensor_id].cancel()
        else:
            # 无人:启动延时断电
            logging.info(f"{config['description']} 检测到无人，{delay_seconds}秒后将断电")
            schedule_power_off(sensor_id, target_device, delay_seconds)
        
        return jsonify({"code": 200}), 200
        
    except Exception as e:
        logging.error(f"处理消息异常: {e}")
        return jsonify({"code": 500}), 500

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

JavaScript/Node.js

const express = require('express');
const axios = require('axios');
const crypto = require('crypto');

const app = express();
app.use(express.json());

const APP_ID = 'your_app_id';
const APP_SECRET = 'your_app_secret';

const sensorMapping = {
    'sensor_hallway_01': {
        targetDevice: 'light_hallway_01',
        delaySeconds: 120,
        description: '一楼东走廊'
    }
};

const timers = {};

function generateSign(ts) {
    const md5Secret = crypto.createHash('md5').update(APP_SECRET).digest('hex');
    const signStr = md5Secret + ts;
    return crypto.createHash('md5').update(signStr).digest('hex');
}

async function controlDevice(deviceId, powerOn) {
    const ts = Math.floor(Date.now() / 1000);
    const sign = generateSign(ts);
    const url = `https://api.thingboot.com/${APP_ID}/device/control/?sign=${sign}&ts=${ts}`;
    
    const payload = { device: deviceId, order: { power: powerOn ? '1' : '0' } };
    const response = await axios.post(url, payload);
    return response.data;
}

app.post('/api/sensor/callback', async (req, res) => {
    const data = req.body;
    const msgData = data.message?.data?.[0] || {};
    const occupied = msgData.radar_detected === '1' || msgData.infrared_target === '1';
    const sensorId = data.device;
    
    const config = sensorMapping[sensorId];
    if (!config) return res.status(200).send('ok');
    
    if (occupied) {
        await controlDevice(config.targetDevice, true);
        if (timers[sensorId]) clearTimeout(timers[sensorId]);
    } else {
        if (timers[sensorId]) clearTimeout(timers[sensorId]);
        timers[sensorId] = setTimeout(() => {
            controlDevice(config.targetDevice, false);
        }, config.delaySeconds * 1000);
    }
    
    res.status(200).send('ok');
});

app.listen(8080, () => console.log('服务运行在 8080 端口'));

五、自定义联动场景实战

5.1 第一种场景：走廊/过道人走灯灭

需求：有人经过时自动亮灯，离开后延时2分钟自动关灯。

设备配置

吸顶红外传感器 ×1(安装于走廊中央)
智能墙壁开关 ×1(控制走廊照明)

本地联动配置(无需服务器，直接在设备配置项中设置)：

红外无人触发持续时间 = 120(秒)
发现有人时线路动作 = 打开
发现无人时线路动作 = 关闭

保存配置后即可实现完整功能。

云端联动代码(如需更复杂逻辑)：

5.2 第二种场景：会议室节能管理

需求：会议进行时设备正常工作，无人30分钟后自动关闭所有设备电源(照明、投影、空调等)。

设备配置

吸顶雷达传感器 ×1(可检测静止人员，防误判)
智能PDU ×1(控制多路设备电源)

5.3 第三种场景：卫生间自动排风+照明

需求：有人进入自动开灯和排风，离开后延时5分钟关闭。

5.4 场景四：安防联动语音告警

需求：非工作时间(22:00-06:00)探测到有人，触发语音音箱告警。

设备配置

吸顶雷达传感器 ×1
智能语音音箱 ×1

5.5 场景五：与照明系统协同控制

需求：传感器检测到有人时，自动调整照明亮度(需配合调光设备)。

5.6 场景六：吸顶式传感器配置项管理(高级)

通过API可远程修改传感器配置项，例如动态调整延时时间

六、设备安装部署指南

6.1 安装要求

项目	要求
安装方式	吸顶式安装(天花板开孔)
安装高度	2.5-3.5米
探测范围	红外版5米 / 雷达版4米微动、6米运动
探测角度	约120°
电源	AC 100-250V(需接线)
网络	WiFi 2.4GHz信号覆盖良好
安装禁忌	避免直对空调出风口、排风扇、大幅摆动绿植

6.2 部署间距

场景类型	产品选型	部署间距	安装位置
走廊(直线型)	红外版	每8-10米1台	天花板中央
办公室(40-60㎡)	雷达版	1台/区	房间中央
会议室(30-50㎡)	雷达版	1台/间	房间中央
卫生间	红外版	每间1台	天花板中央

注意：雷达版可探测静止人体(呼吸微动)，适合会议室、办公室等人员可能长时间静止的场景，有效避免人员静止时误判为无人。

七、红外版与雷达版选择指南

对比维度	红外版	雷达版
探测原理	检测人体温度变化	检测微动(呼吸等)
探测距离	5米	4米微动/6米运动
静止人体检测	可能漏判	可检测
功耗	较低	略高
成本	较低	略高
适用场景	走廊、卫生间、仓库	会议室、办公室、书房

选择

走廊、卫生间：人员流动频繁，红外版即可满足，成本更低
会议室、办公室：人员可能长时间静止(开会、办公)，推荐雷达版，避免误判为无人

八、常见问题与排障

问题	可能原因	解决方案
设备不在线	WiFi信号弱	检查2.4GHz WiFi覆盖，设备支持5组WiFi自动切换
收不到消息推送	回调地址不可达	检查服务器是否可访问，需5秒内返回200
误判无人	安装位置不当/探测距离不足	确保传感器覆盖主要活动区域，雷达版探测静止人体距离4米内
人走后灯不关	延时未到/持续被触发	检查延时配置，查看日志确认状态变化
本地联动不生效	配置项未保存	配置项保存在Flash中，确认设备在线时保存成功
AC输出无反应	负载超限	检查负载功率，阻性负载不超过2200W，感性负载不超过350W

九、总结

本方案基于芯步吸顶式智能感应控制器，实现了完全自定义的人体感应联动逻辑

能力	实现的方式是
有人/无人实时检测	双版本可选(红外/雷达)，毫秒级状态上报
本地快速联动	设备自带AC输出，通过配置项实现基础联动，无需服务器
云端自定义联动	HTTP消息推送接收状态，自由定义业务逻辑
跨设备协同	可与开关、插座、音箱等多种设备联动
时段差异化策略	可编程实现工作/非工作时段不同响应
远程配置管理	支持远程修改设备配置项

集成核心步骤

选择合适版本(红外版成本低，雷达版可检测静止人体)
物理安装传感器(吸顶安装，注意覆盖范围)
根据需求选择：基础联动用本地配置，复杂联动用云端开发
配置消息推送URL，接收传感器状态
开发业务逻辑(可参考第五章代码示例)

方案优势

✅ 双版本可选：红外版成本低，雷达版可检测静止人体
✅ 本地快速联动：自带AC输出，配置项实现基础人走灯灭
✅ 实时上报：状态变化毫秒级推送
✅ 开放接口：标准HTTP API，任意编程语言可接入
✅ 部署灵活：WiFi直连无需网关，支持私有化部署
✅ 多场景适配：走廊节能、会议室管理、安防联动全覆盖

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

一、概述

二、产品核心特性

2.1 产品选型

2.2 核心物模型

2.3 核心触发事件

2.4 本地联动配置(无需服务器)

三、二次开发架构

3.1 整体架构图

3.2 两种开发模式对比

四、API接口接入详解

4.1 上行消息推送(接收传感器状态)——核心功能

4.2 下行控制接口(控制传感器模块/线路)

4.3 完整代码示例

Python(完整联动服务)

JavaScript/Node.js

五、自定义联动场景实战

5.1 第一种场景：走廊/过道人走灯灭

5.2 第二种场景：会议室节能管理

5.3 第三种场景：卫生间自动排风+照明

5.4 场景四：安防联动语音告警

5.5 场景五：与照明系统协同控制

5.6 场景六：吸顶式传感器配置项管理(高级)

六、设备安装部署指南

6.1 安装要求

6.2 部署间距

七、红外版与雷达版选择指南

八、常见问题与排障

九、总结

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

展会现场人体感应照明：怎么将壁挂式双鉴人体存在传感器接入到软件项目中

弱电间人体感应联动：怎样把吸顶式高精度红外传感器对接到项目中

怎样在培训教室人体存在监测中集成智能硬件来实现远程人体存在状态监测

办公设备人体感应与安全监测：怎么将壁挂式双鉴雷达烟雾报警器集成到自己的项目中

智能家居人体感应控制：怎么将带电源输出人体存在传感器集成到自己的项目中

联动场景方案：

怎么在智能家居人体感应照明中集成智能设备以实现场景联动控制

怎么二次开发50A带计量数显物联网断路器来实现场景联动控制

如何接入8路包间综合管理控制器以实现包间消费时长电源联动

弱电间人体感应联动：怎样把吸顶式高精度红外传感器对接到项目中

怎么二次开发双路智能墙壁控制开关以实现门禁与照明联动控制

人体用途方案：

怎样在共享健身房人体存在监测中接入智能硬件以实现红外人体存在探测

如何在园区公共区域安全联动中对接智能硬件来实现人体存在联动控制

怎么接入智能人体存在传感器[吸顶][雷达版]来实现人体微动探测

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

如何接入智能人体存在传感器[吸顶][红外版]以实现人体移动探测