智慧教室人体存在监测：如何把HTTP接口壁挂人体存在检测设备对接到软件项目中_解决方案

CATALOG

这期我们来聊聊怎么把芯步的壁挂人体存在传感器，无缝对接到你自己的软件项目里。作为开发者，拿到一个新硬件时最头疼的往往是：接口文档看不懂、协议不兼容、还得折腾各种中间件。但芯步这套方案比较清爽——就是标准的HTTP接口，不管你后端用Java、Python还是Node.js，只要会发HTTP请求就能搞定。

一、硬件选型与核心能力

首先，咱们得选对硬件。对于“壁挂”场景，芯步有两款主力型号：

智能人体存在雷达传感器2[壁挂]：这款用的是雷达技术，探测距离可达4米内微动、6米内运动感应。相比传统红外，雷达的好处是不受环境温度影响，而且能探测到“微动”——哪怕人坐在那里只是手指在打字，它也知道你还在。
智能人体存在红外传感器[壁挂]：用的是被动红外技术，成本更低，但容易被热源干扰，且对静止人体不敏感。

开放接口概况：这两款设备都开放了标准的HTTP接口。这意味着它们可以直接把数据通过WiFi（仅支持2.4G）扔给你的服务器，完全不需要网关。

二、对接流程：设备端准备

在写代码之前，需要让设备知道“该往哪发数据”。

配网：下载“芯步”的官方App（或者用微信小程序），通过声波或AP模式把设备连上WiFi。
设置回调地址：这一步是核心。在App的控制台里（或者在开发者后台），找到设备设置，将 “设备状态上报地址” 修改为你自己的服务器公网URL（或者是局域网IP，如果你们做私有化部署的话）。
小提示：他们支持5组WiFi热备，信号不好的地方会自动切换，这个设计很贴心。

三、数据交互的两种场景

对接并不是“单向”的，它包含上报和下发两个维度。

第一种场景：设备主动上报（接收有人/无人数据）

这是最核心的部分。当设备探测到“有人”或“无人”状态变化时，它会通过平台（注意：是设备→平台→你的服务器）推送给你的后台。

根据官方文档，你需要搭建一个HTTP/HTTPS接口（比如 /api/yoyo/callback），来接收平台POST过来的JSON包。

推送的消息格式如下

技术点解析：当你收到这个请求时：

校验：校验一下来源IP或者Header，防止伪造数据。
业务逻辑：如果你拿到 "infrared_target": "1"，就在数据库里更新“教室301状态为有人”，或者直接触发后续动作（比如开灯）。

第二种场景：软件主动下发（控制继电器/修改配置）

很多时候你需要远程关掉传感器，或者调整灵敏度（虽然大部分配置在网页控制台做），但如果是需要实时控制，比如教室里的传感器带着一个AC输出（有的型号带一路继电器），你可以直接通过API关掉它。

这时你需要主动调用芯步的API。这是一个标准的POST请求

URLhttp(s)://api.thingboot.com/{你的AppId}/device/control/?sign={签名}&ts={时间戳}
HeaderContent-Type: application/json
Body
{ "device": "820720", // 目标设备ID "order": { "power": 0 // 0表示断开线路，1表示接通 } }

四、核心难点：鉴权与签名

很多同学第一次调不通，多半是卡在了 sign（签名） 上。芯步的安全机制是这样的

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

AppSecret：你账户的秘钥，千万别写死在客户端。
ts：Unix时间戳（秒）。注意，这个时间戳一定要和实际时间同步，服务器会校验时间差，防止重放攻击。

举个例子假设你的 AppSecret 是 abc123，当前时间戳 ts 是 1700000000。

先算 step1 = md5("abc123")，假设得到 e99a18c428cb38d5f22e03...
再拼接 step2 = step1 + "1700000000"。
最后 sign = md5(step2)。

避坑指南

时间戳一定要用秒，不是毫秒（即 int(time.time()) 而不是 int(time.time()*1000)）。
URL里的参数必须严格按照 ?sign=...&ts=... 顺序，有的语言库排序会乱，手拼字符串。

五、实战：用Python实现一个简易接收端

假设你正在做一个自习室管理系统，需要用Python (Flask) 接收数据，并写入数据库。

from flask import Flask, request, jsonify
import json

app = Flask(__name__)

# 假设这是你的回调路由，需要在芯步控制台配置这个地址
@app.route('/api/sensor/callback', methods=['POST'])
def sensor_callback():
    # 1. 接收JSON数据
    data = request.get_json()
    if not data:
        return "Bad Request", 400
        
    # 2. 解析核心数据
    device_id = data.get('device')
    # 获取消息列表，这里通常取第一个
    sensor_data = data.get('message', {}).get('data', [{}])[0] 
    
    # 3. 判断是否有人
    # 注意:不同产品型号的key可能不一样，有的叫infrared_target，有的叫radar_target
    is_person = False
    if 'infrared_target' in sensor_data:
        is_person = (sensor_data['infrared_target'] == "1")
    elif 'radar_target' in sensor_data:
        is_person = (sensor_data['radar_target'] == "1")
        
    # 4. 业务处理:打印日志/存数据库/控制指令
    print(f"设备 {device_id} 上报状态:{'有人' if is_person else '无人'}")
    
    # 这里可以加一段逻辑:
    # 如果无人且持续了5分钟，调用下行的API去关闭空调或灯
    if not is_person:
        # 这里可以调用 requests.post 去调用芯步的控制接口关空调
        pass
        
    # 5. 必须返回200 OK，否则平台会认为推送失败（重试机制）
    return jsonify({"code": 0, "msg": "success"}), 200

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

六、高阶玩法：私有化部署与联动

如果你不想经过芯步的云平台（比如校园内网数据不能出校），芯步是支持纯局域网通信的。只要设备和你服务器在同一个网段，可以直接通过HTTP请求控制，甚至不需要 sign 鉴权（仅内网IP直连）。

常见应用场景

人走灯灭：收到“无人”信号 -> 软件发指令关灯 -> 实现节能。比传统声控灯更安静（不会突然熄灭吓人），也比定时关灯更智能（有人延时没走就不会关）。
安防联动：下班后检测到“有人” -> 软件触发告警 -> 推送给保安或触发摄像头抓拍。

总结

芯步的壁挂传感器对接其实很简单，总结下来就三步：

配网：让设备连上网，告诉它你的服务器地址在哪。
收数据：写一个Web API，等着收 infrared_target（或者 radar_target）的状态变化。
控设备：如果需要，发个HTTP包把电断了。

这种纯HTTP的对接方式，对任何做Web开发的同学来说几乎都是零门槛。稍微注意一下签名算法里的md5嵌套顺序，基本半小时就能调通。如果遇到搞不定的，据说他们提供全程技术指导，可以直接找工程师问问。