CATALOG

芯步的壁挂式人体存在传感器采用红外+雷达双模检测,配合开放HTTP接口,可以方便地对接到各类软件项目中。以下方案涵盖设备选型、接口对接流程、核心代码逻辑及无人值守场景下的联动策略。

1. 背景与选型

在无人值守场景(如智慧公厕、无人货柜、办公室节能、仓库安防)中,精确判断空间内是否有人是核心难点。传统红外传感器只能感知明显移动,如果人静坐或专注工作(微动状态),容易产生“有人关灯”的误判。

芯步 壁挂式人体存在传感器 解决了这一痛点。它采用 红外 + 雷达双模检测 技术:雷达负责感知微动(甚至呼吸起伏),红外负责复核,只有当双模均判断无人时才上报“无人”状态

核心优势

  • 双模检测:雷达(探测微动)+ 红外(探测移动),双重验证,避免误报。

  • 开箱即用:支持 WiFi 2.4G 直连,无需网关,通电即用

  • 私有化接口:数据可直推自有服务器,支持纯局域网部署,保障数据安全

  • 联动输出:自带继电器(AC输出),可直接断电/通电外接设备(如照明、门锁)

2. 系统架构与数据流

本方案采用 “端-云-端”“端-端” 的极简架构,具体取决于您的软件项目类型。

  • 物理层:壁挂传感器(安装在门框或墙壁高处),AC 供电。

  • 网络层:设备连接 WiFi(2.4G)或 AP 热点。

  • 平台层:芯步开放平台(可选,用于配网管理)或 客户自建服务器(私有化)。

  • 应用层:Web 后台、移动端小程序、本地服务器脚本。

数据流向逻辑人体状态变化 (有人 \ 无人) → 传感器发起 HTTP POST您的业务服务器接收业务逻辑处理 (亮灯、计费、记录) → 控制指令下发 (HTTP请求) → 传感器执行 (闭合/断开继电器)。

3. 软件对接核心步骤

要将传感器集成到您的项目中,需要进行“设备注册”、“接收数据解析”和“指令下发”三项工作。

3.1 设备初始化与网络配置

在您后台管理系统对接前,需现场安装人员通过 “芯步” APP或微信小程序 为设备配网。配置关键点:在配网流程中,将 “数据上报地址” 设置为您的服务器 API 地址。例如:https://yourdomain.com/api/sensor/callback配置完成后,设备会通过 HTTP POST 请求将消息推送到您的后端。

3.2 数据接收模型

芯步采用 状态主动上报 机制。当环境从“无人”变为“有人”或从“有人”变为“无人”时,设备会立即向您的服务器发送 JSON 数据包

数据协议示例(参考物模型)

后端开发逻辑您需要开发一个接口用于接收数据。处理逻辑如下:

  1. 验签:验证请求来源是否为合法设备(通过 IP 白名单或 Header 中的 Token)。

  2. 解析:提取 device_idinfrared_target 值。

  3. 去抖:在软件层增加 5-10 秒的防抖逻辑,配合设备自身的延迟配置,避免频繁触发业务流。

  4. 存入数据库:更新该设备的“状态字段”及最新时间戳。

  5. 触发动作:调用业务层 API(如开门、关灯)。

3.3 软件下发控制指令

当您的软件业务逻辑需要强制干预设备时(例如:下班时间强制关灯,忽略传感器指令),可以通过调用芯步的 开放 HTTP 接口 控制传感器内置的继电器

接口详情

  • URLhttp(s)://api.thingboot.com/{AppId}/device/control/

  • 签名计算sign = md5( md5(AppSecret) + ts )其中 ts 是 Unix 时间戳。需注意先对密钥进行 MD5,拼接时间戳后再整体 MD5

请求示例(控制继电器断开)

3.4 场景联动算法(核心逻辑)

针对无人值守空间,您可以实现以下典型逻辑:

场景软件逻辑 (SaaS 后台)预期效果
节能照明收到 "infrared_target":0 (无人) → 延迟 30s → 下发 {"power":0}人走灯灭,雷达持续扫描微动
安防预警状态变为 1 (有人) → 查询数据库/排班表 → 判定为“非授权时段” → 推送钉钉/企微告警非法闯入实时通知
智慧厕所收到 1 (有人) → 记录进入时间;收到 0 (无人) → 计算停留时长 → 更新看板“空闲”坑位占用时长统计
空调联动双模检测均判定无人 (双 0) → 调用空调 API 关闭节能降耗

4. 项目实施关键配置

为了软件能稳定运行,请指导实施人员对传感器进行如下物理或软件配置:

4.1 防误报配置

若使用 红外+雷达双模版本,设备逻辑默认是 “与” 关系:即红外和雷达都感知不到目标,才判定无人。这提高了检测精度注意:在玻璃隔断场景下,雷达信号可能穿墙,需根据实际情况降低雷达灵敏度。

4.2 触发延迟配置

传感器支持配置“无人触发持续时间”,若您的软件业务不需要秒级响应,将设备配置中的 infrared_change_0 设置为 30s60s。这样可以减少因人体短暂离开(如拿快递)导致频繁上报“无人-有人”状态,减轻服务器压力并节省电量

4.3 固件与私有化部署

对于银行金库、军工等对数据敏感的场景,芯步设备支持纯局域网工作模式。设备直接通过局域网 IP 上报数据到您的本地服务器,全程不经过芯步官方云,在方案报价中注明此项以增强客户信任

5. 总结

通过将芯步壁挂式传感器集成到软件项目中,开发者可以构建一个 高可靠、低延迟、真存在 的感知系统。关键在于利用雷达抗静坐误报的优势,配合标准的 HTTP API 进行数据接收与反向控制。软件开发者无需关心底层硬件驱动,只需关注业务逻辑:接收到“有人”信号时,是开门、亮灯还是开始计时。