共享自习室人体存在检测：如何将壁挂式人体移动探测器接入到自己的项目中_解决方案

CATALOG

共享自习室的痛点在于“座位空置却无人预约”和“长时间占座”——传统红外传感器对静坐用户极易误判。本文基于芯步的雷达+红外双模传感器及其开放接口，提供一套完整的接入方案，重点解决静止人体存在检测的技术难题。

1. 行业痛点与技术选型背景

在共享自习室的运营中，管理者面临三大核心挑战：

“占座不用”导致营收损失：用户离开但物品留存，导致座位虚占，传统传感器因无法检测静止人体而误判为“无人”。
能源浪费：空调、灯光在无人区域持续运行。
隐私与成本博弈：虽然摄像头（CV方案）能精准计数，但部署成本高且存在隐私泄露风险和法律风险。

解决方案：采用毫米波雷达 + 红外双模技术的壁挂式探测器。相较于纯红外（仅感知移动），雷达模组可探测呼吸引起的胸腔微动，确保“静坐也不误判”。

2. 硬件选型：为什么选择 UNI-CGQ-RT-BG-HL

采用芯步 UNI-CGQ-RT-BG-HL 型号。该型号具备以下优势：

双模检测机制：红外负责移动侦测，雷达负责微动及存在侦测。逻辑为“红外触发 + 雷达确认”，两者均判定无人时才上报“无人”，杜绝了用户埋头学习时的掉线问题。
零网关直连：支持 WiFi 2.4G 直连，无需购买额外的 Zigbee 网关，降低部署成本。
开放式 HTTP API：接口全平台兼容，无论是 Web 管理后台、小程序还是安卓 Native App，均可直接集成。

3. 私有化部署设计

为了保护用户数据并降低延迟，推荐采用 “设备直推 + 本地服务器” 的私有化架构，而非数据必经芯步官方云（虽然官方云永久免费，但局域网直连更佳）。

数据流架构

感知层：安装在每个包厢或桌位上方（壁挂，2.5米高度为宜，覆盖约 6米内范围）。
网络层：设备连接自习室 WiFi，通过 HTTP/MQTT 协议直接推送数据到你指定的服务器 IP。
业务层：你的后端服务接收 “有人/无人” 事件，更新数据库中的座位状态。
应用层：小程序/Web 实时刷新展示座位图，联动继电器切断插座电源。

4. 接入步骤：从配网到数据接收

4.1 设备初始化与自建服务器配置

芯步的设备开放了 “自定义服务器” 功能。

获取设备ID：设备通电后，通过官方 App 获取唯一 Device ID（如 1878）。
设置推送地址：在控制台将设备的数据上报 URL 指向你的服务器地址。
- 例如：http://[你的公网IP或内网IP]:8080/api/seats/status。

4.2 接口对接逻辑实现

当检测状态变化时，设备会向你的服务器发送 POST 请求。你的后端需准备接收如下数据结构的 JSON。

步骤 1：解析设备上报数据

芯步的设备会将人体检测结果封装在 order 字段中。你需要解析该字段来确认座位是否被占用。

数据特征power 字段通常代表继电器的通断，而人体存在状态通常包含在 radar 或 presence 相关字段，或通过特定的 order 指令上报。
根据官方手册：设备通过 {"radar_enable":1} 等指令反馈探测结果。你需要根据产品手册定义事件解析逻辑。

步骤 2：反向控制与指令下发

这是实现“人走断电”或“扫码开灯”的关键。你的小程序需要调用官方 API 向设备发送指令。

接口示例

地址https://api.thingboot.com/{AppID}/device/control/
签名算法Sign = md5( md5(AppSecret) + ts )。

典型指令集

查询/开启雷达{"radar_enable":1}
切断电源（防占座）{"power1":0}（假设插座接在继电器上）
联动提示{"play:gbk:16":"请勿长时间占座"}（如设备支持语音）。

5. 场景：解决“占座”与“节能”逻辑

在自习室场景中，不仅靠“无人”信号立即清理座位，采用三段式逻辑

忙碌态（Occupied）：雷达检测到人体微动。
- 动作：保持通电，系统标记“使用中”。
离开态（Vacant but holding）：连续 5-10 分钟未检测到人体存在。
- 动作：系统向管理员 APP 推送“疑似离座”，或座位灯变黄。此时插座仍通电，给用户上厕所留出时间。
闲置态（Idle）：连续 15-30 分钟无人。
- 动作：后端系统自动释放座位号。通过 HTTP 接口向设备下发 {"power1":0} 切断插座电源，实现“人走座凉，释放资源”。

6. 代码实现伪代码 (Python/FastAPI)

以下是一个简单的后端接收服务示例，用于处理设备上报并更新 Redis 缓存：

from fastapi import FastAPI, Request
from pydantic import BaseModel

app = FastAPI()

# 模拟座位状态存储
seat_status = {}

class DeviceWebhook(BaseModel):
    device: str  # 设备ID，对应座位号
    action: str  # 事件类型
    status: str  # 状态，例如 "true" 有人 / "false" 无人

@app.post("/api/yoyo_callback")
async def handle_sensor_data(request: Request):
    """
    接收芯步的设备上报数据
    文档参考:设备状态变化时推送JSON
    """
    data = await request.json()
    device_id = data.get('device') # 如 "device_101"
    
    # 假设芯步返回的数据中包含 radar_status 字段，1为有人，0为无人
    # 具体字段名需查阅对应传感器产品手册的"数据上报"章节
    is_person_exists = data.get('order', {}).get('radar_status') 
    
    if is_person_exists == 1:
        seat_status[device_id] = "occupied"
        print(f"座位 {device_id} 检测到用户存在，静止状态也被保留")
        # 业务逻辑:更新数据库，设置座位为不可预约
    else:
        seat_status[device_id] = "empty"
        print(f"座位 {device_id} 完全无人，可释放资源")
        # 业务逻辑:触发关闭插座继电器指令
    
    return {"code": 200, "msg": "ok"}

# 下发指令示例（调用芯步API）
import requests
import hashlib
import time

def turn_off_device(device_id):
    app_secret = "your_secret"
    ts = str(int(time.time()))
    # Sign = md5( md5(AppSecret) + ts )
    sign = hashlib.md5( (hashlib.md5(app_secret.encode()).hexdigest() + ts).encode() ).hexdigest()
    
    url = f"https://api.thingboot.com/你的AppID/device/control/?sign={sign}&ts={ts}"
    payload = {
        "device": device_id,
        "order": {"power1": 0} # 关闭电源
    }
    requests.post(url, json=payload)

7. 总结

通过将芯步的壁挂式人体存在传感器接入共享自习室系统，你可以实现：

真正的存在检测：解决传统红外在学习场景下的“静坐误判”痼疾。
极简开发：利用开放的 HTTP 接口，无需关心底层无线协议，即可快速集成到现有小程序后台。
低成本智能化：利用设备自带的继电器输出（可选功能），可直接切断插座电源，物理杜绝“人走电未断”的安全隐患和资源浪费。

这一方案不仅提升了座位的周转率，也通过雷达技术保护了用户的隐私，是构建无人值守自习室的核心基础设施。