一、概述
图书馆自习室作为读者集中学习的场所,既需要舒适的照明环境,也需要可靠的安全保障。传统管理中,照明常开造成能源浪费,烟雾报警器孤立运行无法联动应急。芯步智能传感器方案通过开放HTTP接口,实现人体存在检测联动照明控制与烟雾报警联动应急响应的自动化管理。
核心能力
双传感器二合一:可选配同时检测人体存在与烟雾的二合一传感器,单设备覆盖安全与节能两大需求
实时状态上报:有人/无人状态变化、烟雾报警状态,毫秒级推送至您的服务器
开放HTTP API:适用于任何支持HTTP请求的编程语言,10分钟完成对接
私有化部署:支持局域网运行,数据不出图书馆内网
无网关设计:WiFi直连,可设定5组WiFi自动切换
图书馆自习室联动场景
| 场景 | 感应设备 | 执行设备 | 联动逻辑 |
|---|---|---|---|
| 人走灯灭 | 人体存在传感器 | 智能墙壁开关 | 检测到无人后延时自动关灯 |
| 烟雾报警联动 | 烟雾传感器 | 智能PDU/排风扇 | 报警时自动切断电源并排烟 |
| 报警语音播报 | 烟雾传感器 | 智能语音音箱 | 报警时自动播报疏散提示 |
| 管理员告警 | 烟雾传感器 | 短信/APP推送 | 报警信息实时推送至后勤 |
二、核心产品选型
2.1 产品选型方案
根据图书馆自习室的具体需求,可选择以下产品组合:
| 方案 | 推荐产品 | 适用场景 | 核心能力 |
|---|---|---|---|
| 方案一:分体部署 | 人体存在传感器 + 烟雾传感器 | 大型自习室,可分别部署 | 各传感器独立安装,灵活覆盖 |
| 方案二:二合一(推荐) | 智能人体存在雷达和烟雾传感器[壁挂] | 中型自习室,单设备满足需求 | 雷达人体感应+烟雾检测二合一 |
| 执行设备 | 智能墙壁开关 / 智能墙壁插座 / 智能语音音箱 | 联动控制照明、电源、语音 | 接收指令执行断电/播报 |
2.2 智能人体存在雷达和烟雾传感器[壁挂] 核心参数
| 特性 | 参数 |
|---|---|
| 产品型号 | UNI-CGQ-RT-L-YW-BG |
| 传感器类型 | 雷达人体存在 + 烟雾探测(二合一) |
| 探测距离 | 雷达:4米内人体存在微动,6米内运动感应 |
| 安装方式 | 壁挂式 |
| 工作电压 | AC 100-250V / DC 12V |
| 无线连接 | WiFi 2.4GHz |
| 控制接口 | HTTP API |
| 私有化部署 | 支持局域网直连 |
| 网络配置 | 可设定5组WiFi,自动连接信号最强的网络 |
2.3 支持的命令与状态上报
下行控制命令(API下发)
| 命令 | 格式 | 说明 |
|---|---|---|
| 雷达模块开关 | {"radar_enable":"1"} / {"radar_enable":"0"} | 开启/关闭雷达探测 |
| 烟感模块开关 | {"mq_enable":"1"} / {"mq_enable":"0"} | 开启/关闭烟雾检测 |
| 蜂鸣器控制 | {"buzzer":"1"} / {"buzzer":"0"} | 开启/关闭本地蜂鸣器 |
上行消息推送(状态上报)
传感器上报状态变化时,平台实时推送至您的服务器:
雷达有人/无人状态变化
参考来源:
烟雾报警状态变化
参考来源:
三、整体架构
3.1 系统架构图
┌─────────────────────────────────────────────────────────────────┐
│ 图书馆管理系统 / 运维平台 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 节能看板 │ │ 告警中心 │ │ 联动规则 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────┘
▲
│ 消息推送(状态实时上报)
│ 命令下发(控制开关/音箱)
▼
┌─────────────────────────────────────────────────────────────────┐
│ 芯步云平台 / 私有化服务器 │
└─────────────────────────────────────────────────────────────────┘
▲
│ WiFi 2.4GHz
┌───────────────────┼───────────────────┐
│ │ │
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ 人体传感器 │ │ 烟雾传感器 │ │ 执行设备 │
│(进桌区域) │ │(自习区域) │ │ 开关/插座 │
└──────────────┘ └──────────────┘ └──────────────┘
│
▼
┌──────────────┐
│ 语音音箱 │
│(紧急播报) │
└──────────────┘3.2 两种接入方式
| 方式 | 说明 | 适用场景 |
|---|---|---|
| 消息推送(推荐) | 设备状态变化时平台主动推送至您的服务器 | 实时告警、人走断电联动 |
| 主动查询 | 通过API定时轮询设备状态 | 非实时监控、数据统计 |
消息推送是联动的核心:传感器每次状态变化都会实时推送,您的服务器接收后即可触发对应的联动逻辑。
四、API接口接入详解
4.1 接口地址与签名计算
请求地址
https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}参数说明
| 参数 | 说明 | 示例 |
|---|---|---|
| {AppId} | 应用ID(控制台获取) | qtyVWcgeMq |
| {ts} | 当前Unix时间戳(秒) | 1747212640 |
| {sign} | 签名 | c484eb97... |
签名计算公式(两次MD5加密):
sign = md5( md5(AppSecret) + ts )
将开发者密码(AppSecret)进行一次MD5
将这个结果拼接上时间戳
ts对整个拼接后的字符串再做一次MD5计算公式来源:
签名计算示例
4.2 消息推送配置(核心)
传感器是上行设备,主要工作是上报状态变化。您需要在芯步控制台配置接收地址,设备状态变化时平台会实时推送。
配置步骤
登录芯步控制台
进入「开发设置」→「消息推送」
配置您的服务器接收URL(如
https://your-library.com/api/sensor/callback)选择需要接收的消息类型
状态上报数据格式(有人/无人变化时):
数据格式参考:
烟雾报警数据格式
数据格式参考:
4.3 执行设备控制命令
向智能开关/插座/音箱下发命令时,使用相同的HTTP API接口
控制智能墙壁开关(关灯)
控制智能语音音箱(紧急播报)
命令格式参考:
4.4 多语言代码示例
Python(完整联动服务)
JavaScript/Node.js
五、图书馆自习室场景实战
5.1 第一种场景:自习室人走灯灭(节能联动)
需求:自习室区域检测到无人时自动关灯,有人时自动开灯,实现“灯随人走”的节能效果。
设备配置
智能人体存在传感器 ×1(壁挂安装于自习室墙面)
智能墙壁开关(2路)×1(控制照明回路)
联动逻辑
5.2 第二种场景:烟雾报警自动应急(安全联动)
需求:自习室检测到烟雾时,自动触发语音播报、切断电源、推送告警。
设备配置
烟雾传感器 ×1(吸顶安装)
智能PDU/断路器 ×1(控制自习室总电源)
智能语音音箱 ×1(安装于自习室区域)
联动逻辑
5.3 第三种场景:二合一传感器一体部署(推荐)
需求:单个设备同时满足人体感应和烟雾检测,简化部署。
设备配置
智能人体存在雷达和烟雾传感器[壁挂] ×1
智能墙壁开关 ×1
智能语音音箱 ×1
优势
一个设备同时提供雷达人体感应和烟雾探测功能
减少设备数量,简化安装布线
可通过API分别控制雷达模块和烟感模块的开关
命令参考:
5.4 场景四:自习室用电安全联动
需求:检测到自习室无人时,自动切断插座电源,消除电器安全隐患。
设备配置
人体存在传感器 ×1
智能墙壁插座 ×N(控制充电插座、饮水机等)
5.5 场景五:自习室状态看板
需求:管理员远程查看各区域自习室的人员占用状态和设备状态。
实现的方式是:通过消息推送接收传感器状态,实时更新看板
六、私有化部署方案
图书馆对数据安全和网络独立性要求较高,芯步传感器支持纯局域网运行。
部署模式对比
| 特性 | 公有云模式 | 私有化模式 |
|---|---|---|
| 设备联网 | WiFi连接互联网 | 连接图书馆内网WiFi |
| API地址 | api.thingboot.com | 自建服务器IP |
| 数据流向 | 经过芯步云端 | 内网直连,数据不出图书馆 |
| 网络依赖 | 需要互联网 | 仅需局域网 |
私有化配置要点
设备支持配置5组WiFi网络,自动连接信号最强的网络
需自建HTTP服务,所有API调用在内网完成
支持自建消息服务器,接收设备状态回调
七、设备安装部署指南
7.1 安装要求
| 项目 | 要求 |
|---|---|
| 传感器安装方式 | 壁挂式(距地面2-2.5米) |
| 传感器安装禁忌 | 避免直对空调出风口、排风扇 |
| 探测范围 | 雷达:4米内人体微动,6米内运动 |
| 网络要求 | WiFi 2.4GHz信号覆盖良好 |
7.2 自习室部署
| 自习室类型 | 传感器数量 | 型号 | 执行设备 |
|---|---|---|---|
| 小型自习室(20-40㎡) | 1台 | 二合一传感器 | 1个墙壁开关 |
| 中型自习室(40-80㎡) | 2-3台 | 人体传感器+烟雾传感器 | 2-3个开关 |
| 大型阅览室(80+㎡) | 4-6台 | 分区部署 | 分区独立控制 |
7.3 二合一传感器接线
智能人体存在雷达和烟雾传感器[壁挂]
安装于墙面,高度距地面2-2.5米
连接AC 220V电源
通过手机APP配置WiFi网络
在控制台获取设备ID,开始API对接
注意事项
传感器应避免朝向窗户或空调出风口,防止误触发
探测范围内的绿植、大幅摆动物品可能影响雷达检测
多个传感器间距应大于3米,避免相互干扰
八、常见问题与排障
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 设备不在线 | WiFi信号弱 | 检查2.4GHz WiFi覆盖,设备支持5组WiFi自动切换 |
| 收不到消息推送 | 回调地址不可达 | 检查服务器是否可访问,需5秒内返回200 |
| 误判无人 | 安装位置不当/探测距离不足 | 确保传感器覆盖主要活动区域,雷达微动探测距离4米内 |
| 人走后灯不关 | 延时未到/持续被触发 | 检查延时配置,查看日志确认状态变化 |
| 烟雾误报警 | 灰尘/蒸汽触发 | 清洁传感器,或调整安装位置远离蒸汽源 |
| 签名验证失败 | 参数错误 | 确认ts为秒级时间戳,公式为md5(md5(AppSecret)+ts) |
九、总结
本方案基于芯步智能传感器,实现了图书馆自习室的节能控制与安全联动一体化管理:
| 能力 | 实现的方式是 |
|---|---|
| 人走灯灭 | 人体传感器实时上报,服务器延时关灯 |
| 烟雾报警联动 | 报警触发语音播报+电源切断+告警推送 |
| 二合一传感器 | 单设备同时满足安全与节能需求 |
| 用电安全控制 | 无人时自动切断插座电源 |
| 实时状态监控 | 消息推送机制,状态变化毫秒级上报 |
集成核心步骤
获取AppID/AppSecret,实现MD5签名计算
配置消息推送URL,接收传感器状态
开发联动逻辑服务(参考第四章代码示例)
根据自习室布局选择传感器和执行设备
物理安装设备,进行联动测试
方案优势
✅ 二合一可选:雷达+烟雾传感器单设备覆盖安全与节能
✅ 实时上报:状态变化毫秒级推送,响应迅速
✅ 开放接口:标准HTTP API,任意编程语言可接入
✅ 部署灵活:WiFi直连无需网关,支持私有化部署
✅ 联动丰富:可与开关、插座、音箱等多设备联动
✅ 安全可靠:烟雾报警触发断电+语音播报+告警推送三重响应
如需详细的产品手册和API文档,请访问查阅或联系技术支持团队获取。