共享茶室人体存在感应：如何把被动红外人体感应器接入到自己的项目中_解决方案

CATALOG

共享茶室的痛点是“真无人”——不仅要检测移动（人走进来），更要检测静止（人静坐喝茶）。普通PIR红外传感器在检测静坐人体时容易误判为“无人”，这是方案选型时需要特别注意的。以下方案以芯步开放平台为基础，阐述完整的接入路径。

1. 背景与选型

1.1 为什么需要人体存在感应？

共享茶室的核心商业模式是“无人值守、按小时计费、自助体验”。这就要求系统必须精准判断三个状态：

有人/无人：控制通电状态（计时开始/结束）。
动静状态：虽然人在，但如果长时间静坐（品茶、办公），系统不能误判为无人而断电。
联动逻辑：有人开灯/开空调，无人断电节能。

1.2 PIR传感器的局限性及应对策略

在接入前，开发者需要清楚被动红外（PIR）传感器的特性：

优点：成本低、功耗低、技术成熟。
致命缺点无法检测静止或微动的人体。如果用户在茶室玩手机或闭目养神，PIR会以为“无人”而导致断电关灯。
解决方案：如果您的场景包含长时间久坐，选用毫米波雷达传感器；如果坚持用PIR且预算有限，必须在逻辑层做“延时补偿”。

（注：芯步同时提供PIR和雷达两种传感器，本文主要以通用API逻辑讲解接入，硬件层面推荐为追求体验选雷达版，为节省成本选PIR版。）

2. 硬件接口与通信机制

芯步的智能硬件体系采用 HTTP API + 设备上报 的双向通信机制。

2.1 设备如何“说话”？（数据上行）

传感器不能直接发HTTP请求给您的服务器吗？不能，它通常通过WiFi网关或内置WiFi模块，将状态推送到芯步的云端，再由芯步云转发给您自己的业务服务器。

触发机制：当PIR传感器检测到人体红外辐射变化时，内部的热释电元件会输出一个电信号，MCU判断后上报状态。

数据流向PIR传感器感应 -> 芯步设备端 -> 芯步云平台 -> HTTP推送/MQTT -> 您的业务服务器

2.2 如何控制设备？（指令下行）

您可以通过调用芯步的开放接口，向设备下发指令（如“开灯”、“开排气扇”）。

请求地址http(s)://api.thingboot.com/{AppId}/device/control/
核心参数（JSON体） ：

鉴权方式：URL中携带 sign（签名）和 ts（时间戳）。

3. 接入实战步骤

第一阶段：环境准备

注册/登录 芯步开放平台（ThingBoot Open），进入控制台。
获取凭证：在控制台获取您的 AppId 和 AppSecret（用于计算签名）。
添加设备：扫描设备机身二维码或手动输入设备ID（如 820720）将传感器绑定到您的账号下。

第二阶段：配置“消息推送”（接收“有人/无人”信号）

这是最重要的一步。您需要让芯步云知道您的服务器地址。

在开放平台中找到 “消息推送” 设置。
配置回调URL
- 填写您的服务器公网接口，例如：https://yourdomain.com/api/yoyo/callback
- 协议：支持HTTP/HTTPS。
接收数据格式当传感器状态变化，芯步云会POST JSON数据到您的URL。示例数据如下：
{ "device_id": "820720"， "msg_type": "sensor_event"， "data": { "occupancy": true， // true=有人， false=无人 "battery": 85， // 电量百分比（若适用） "timestamp": 1708312345 } }

第三阶段：对接代码实现（Python/Flask示例）

您需要在业务服务器上编写接口来处理回调。

from flask import Flask， request， jsonify
import time

app = Flask(__name__)

# 假设这是茶室的订单状态，例如从Redis中读取
current_booking_status = {"820720": {"is_active": True， "end_time": 1708312400}}

@app.route(‘/api/yoyo/callback’， methods=[‘POST’])
def handle_sensor():
    """
    处理芯步推送的人体感应数据
    """
    data = request.get_json()
    device_id = data.get(‘device_id’)
    is_occupied = data.get(‘data’).get(‘occupancy’)  # 是否有人
    # 1. 记录日志
    print(f"设备 {device_id} 检测到 {'有人' if is_occupied else '无人'}")

# 2. 业务逻辑:防误判处理（关键）
    # 如果是PIR传感器，检测到"无人"时，不要立即断电！
    # 延迟5-10分钟，或者二次确认。
    
    if not is_occupied:
        # 方案A:开启一个计时任务，5分钟后再次请求设备状态确认
        # 方案B:直接设置延迟任务关电
        print("准备执行延时关电逻辑...")
        # delay_power_off(device_id， delay_seconds=300) # 5分钟后关电
    else:
        # 检测到有人:立刻开电（如果之前是关的）
        turn_on_device(device_id)
        
    return jsonify({"code": 0， "msg": "ok"})

def turn_on_device(device_id):
    """
    调用芯步API控制设备（如插座、灯）
    """
    # 具体见下一节"下行控制"
    pass

if __name__ == ‘__main__’:
    app.run(port=8080)

4. 闭环控制：联动执行器

只是感应到人还不够，您需要控制茶室内的智能插座（控制茶壶、电脑）、智能灯或空调伴侣。

4.1 获取授权与签名

调用API需要签名，芯步通常使用MD5签名算法：sign = md5(AppId + AppSecret + Timestamp + DeviceId的特定组合)

4.2 示例：联动关灯/断电

当PIR上报”无人“且经过延时确认后，您需要利用/device/control/接口关闭设备：

请求示例

5. PIR特有的逻辑陷阱与优化策略（重要）

由于PIR无法检测静坐，直接接入会导致极度糟糕的用户体验（人在喝茶却被断电）。针对共享茶室场景，采用以下优化策略：

5.1 “静态掩码”时间窗

策略：在服务器端设置变量。PIR第一次上报“无人”时，不执行断电。
做法：启动一个5-10分钟的定时器。在定时器期间，如果再次收到“有人”触发，则取消定时器；如果定时器结束仍未触发，再执行断电。

代码逻辑

if 上报无人:
    if 上一次状态 == 有人:
       启动延迟任务(Timer)
if 上报有人:
    if Timer存在:
       取消Timer (说明人只是没动，还在)
    执行上电或保持上电

5.2 混合部署

如果您的商业模型要求精准判断静坐（例如用户睡着了也在计费），仅靠PIR是不够的。利用芯步的开放接口，您可以混合接入：

低成本方案：PIR + 门磁传感器（若门锁关着，即使PIR报无人也不断电）。
最佳实践更换为60G毫米波雷达传感器。虽然单价略高，但能检测“呼吸”微动，彻底解决静坐误报问题。芯步平台对这两类传感器的API接口是统一的，只需更换硬件，无需改动服务器业务逻辑。

6. 总结与检查清单

通过以上步骤，您已经完成了从物理设备到软件系统的集成。PIR传感器作为最简单的数字开关，接入逻辑并不复杂，难点在于场景化体验的优化。

接入状态检查清单：

设备已入网，在芯步控制台显示在线。
自己的服务器收到了“有人”的HTTP POST请求。
自己的服务器能通过API成功控制茶室内的灯具关闭。
配置了“延时断电”逻辑，解决了静坐误报问题。
（进阶） 将PIR数据接入数据库，绘制茶室使用热力图。