这是一个帮你把“5米红外人体存在探测器”接入项目里的实操方案。
我尽量说得直白一点，不讲太多废话，直接从选硬件、看接口、写代码到做联动，一步步来。
背景与目标
现在很多所谓的“智能感应”，其实是“人体移动感应”。你坐在工位上码代码，稍微一动不动，灯就给灭了，还得赶紧招个手——这种体验很烦。
所以我们这次要做的不是那种几十块钱的普通红外，而是特指的、能探测静态人体的 5米红外存在探测器。它能检测到人哪怕微小的呼吸动作，确保人只要还在房间里，灯就不会灭。
我们的目标是把这款硬件，通过芯步的开放接口，快速集成到你现有的管理后台或者智慧楼宇系统里去。
第一步：硬件选型与准备（别买错了）
首先，硬件别买错。市面上普通的红外探头只能感应“移动”，我们要找的是支持 “存在感应”或 “微动检测” 的型号。虽然叫“红外”，但很多这种级别的设备实际上是 “红外 + 毫米波雷达”双模 的，红外负责快速响应，雷达负责检测微动和静态存在。
针对5米这个距离，比较合适的参数大概是这样：
探测距离：5-6米（适合办公室、卫生间、会议室）。
探测角度：大角度或可调。
通信方式：Wi-Fi（为了直连，省去买网关的钱和配置麻烦）。
核心能力：支持 “无人”与 “有人” 状态上报，且能区分“有人移动”和“有人静止”。
第二步：理解芯步的接口逻辑
芯步的平台做得比较简洁，核心逻辑就是：设备上报数据 -> 云端处理 -> 你通过API拿数据/下发指令。
主要会用到两个动作：
设备状态上报（接收数据）当探测器检测到“有人”或“无人”时，设备会主动向芯步云推送数据。你的服务器需要接收这些异步消息（Webhook/MQTT）。这是最关键的，你得拿到
occupancy_status（占用状态）这个字段。向设备下发指令（控制设备）有时候你需要远程修改灵敏度，或者直接关掉探测（比如仓库下班时间懒得探测），就需要用到设备控制接口。
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}主要参数
device：那一长串设备ID（贴在硬件背后的那个）。order：也就是你要下发的命令，比如{"sensitivity":"high"}。
第三步：实战接入流程（手把手）
假设你的场景是：办公室照明控制。人进来灯亮，人走（且5米范围内都没人了）延时2分钟灭灯。
1. 设备配网与注册
设备通电后，用芯步的App或者小程序，给它配上你场地的Wi-Fi（注意只能是2.4GHz频段）。
配网成功后，在芯步的开放平台后台会看到这个设备上线，记下那串重要的 device_id。
2. 对接“有人/无人”事件
你需要在你的服务器端写一个接收消息的接口。
当有人进入5米范围时，设备会发来大概这样一串数据：
你的业务逻辑
收到
occupancy为present→ 调用照明系统API → 开灯。收到
occupancy为absent（需要持续几分钟没信号才会发）→ 调用照明系统API → 关灯。
3. 远程调试与指令下发
如果这货太灵敏，对着窗户老误报，你得远程调低灵敏度。不需要去现场按按钮，直接用芯步的HTTP接口发送指令：
请求示例（用POST方式，简单点）：
芯步平台会返回 code:200，代表指令平台收到了，下发给了设备。
第四步：踩坑与避坑指南
5米是理论值，实际要打7折官方标的5米，在室内有隔断、玻璃、或者角落安装时，实际稳定探测距离大概在3.5-4米。如果房间比较大，适当增加设备数量，或者把安装位置放在人员主要活动的区域上方。
区分“移动”和“存在”如果这款探测器是纯红外的（PIR），它本质上检测的是Δ温度（温差变化）。一个人坐在5米外一动不动玩手机，红外看着跟桌子没区别，会误判为“无人”。结论：一定要确认你买的是“存在式”（一般带雷达），否则这个方案就失败了。
接口签名的坑芯步的接口要求
sign和ts（时间戳）。如果你直接用浏览器访问，或者忘了加动态时间戳，会报错5005或5006。写代码时封装一个公共函数专门算签名：md5(md5(你的密钥) + ts)。
总结一下
把5米红外存在探测器接入项目，其实就三步：
买对硬件（必须是存在式，Wi-Fi版）。
在芯步后台拿设备ID。
写几行代码，接住
occupancy字段，然后去控制你的灯或者喇叭。
这样一来，你的项目就拥有了一个“人走茶不凉、人在灯不灭”的智能化场景体验了。