一、为啥要写这个？
做培训教室智能化的时候，我们经常遇到一个问题：怎么知道教室里到底有没有人？
你可能想说，这不简单吗？买个人体感应器不就行了？
但实际用起来就发现问题了——传统的红外感应器，人坐在那儿不动（比如学生在刷手机、在做题），它就以为没人了，啪一下把灯关了、空调停了。学员一脸懵。
芯步这款壁挂式双模感应器（红外+雷达）就是解决这个痛点的。雷达能检测到微动（呼吸、心跳引起的胸腔起伏），哪怕人静坐着也能感应到。这篇文章就聊聊怎么把它集成到你的软件项目里。
二、先认识一下这个硬件
这个设备长啥样？
壁挂式安装，尺寸是88mm×69mm×64.4mm，比一个手机充电器大不了多少。白色PC防火外壳，直接接220V市电（交流100-250V都能用），不用单独配电源。
核心参数速览
红外模块 + 雷达模块（双模检测）
雷达探测距离：4米内人体存在（微动），6米内运动感应
探测角度：约120°
无线连接：WiFi 2.4GHz
待机功耗：1.2-1.7W
它多带了一个实用功能：内置继电器，可以控制一路交流输出，接照明灯、排风扇之类的。也就是说，它检测到没人可以直接断电，不用再经服务器绕一圈——本地就能干，响应快。
双模是怎么工作的？
简单讲就是“红外+雷达”双保险：
红外（PIR）：检测人体移动，人一走就感应变化
雷达：检测微动，人坐着不动也能感应到
判断逻辑是：红外和雷达都探测到无人时，才认定无人。这比单红外靠谱太多了。
三、怎么跟软件对接？
芯步的设备走的HTTP接口，说白了就是：设备把数据发到你指定的服务器，你通过API控制设备。这对接方式对开发者非常友好。
1. 数据上报（设备 → 你的服务器）
这是最核心的功能。当环境状态变化时，设备会主动上报消息到你的服务器。
上报的事件包括
红外状态变化（有人/无人）
雷达状态变化（有人/无人）
线路状态变化（继电器通断）
按钮被按下
上报的HTTP请求到你配置的服务器地址，消息体是JSON格式，包含设备ID、当前状态、事件类型等信息。
2. 下发控制（你的服务器 → 设备）
想远程开关设备？用HTTP接口就行。
请求地址格式
必带参数
AppId：你的应用ID（芯步控制台生成）sign：签名，用来验证权限（用AppSecret计算）ts：时间戳，防重放攻击
请求方式：POST，Body是JSON格式
支持的指令
| 命令 | 作用 | 值说明 |
|---|---|---|
radar_enable | 开关雷达模块 | 1=开，0=关 |
infrared_enable | 开关红外模块 | 1=开，0=关 |
power | 控制继电器输出 | 1=通，0=断 |
这个接口设计比较友好——任何支持HTTP请求的编程语言都能用，不管你是写Web后端、APP接口，还是桌面软件，调用方式都一样。
3. 开发步骤
官方的说法是“10分钟完成对接”，我捋一下核心步骤：
Step 1：准备工作
登录芯步控制台（手机号注册就行）
给设备配网（设备通电后用APP配网，按产品手册操作）
Step 2：开发设置
找到AppID和AppSecret（在控制台的“开发设置”里）
先打开“调试模式”测试，这个模式下不校验签名和时间戳，方便调试
Step 3：写代码
你的服务器要提供一个接收设备上报的接口
封装一个HTTP请求函数，用来给设备下发命令
具体的请求地址和参数格式，看产品手册就行
四、实战代码思路（伪代码风格）
核心就是封装两个函数：一个接收上报，一个下发命令。伪代码逻辑如下：
五、业务场景怎么做？
场景1：培训教室节能
需求：没人时自动关灯、关空调；有人时恢复正常。
实现：设备上报红外/雷达状态，服务器收到“无人”状态后，向教室中控系统发指令。但要注意，双模的好处是避免误判——只有两个模块都报无人，才触发关闭。
进阶：设备自带的继电器可以直接接灯，通过配置relay_change_0（发现无人时线路动作）和relay_change_1（发现有人时线路动作）实现本地联动，不经过服务器也能自动开关。
场景2：考勤/签到
需求：记录学员进入教室的时间。
实现：把设备装在门口，检测到有人进入时上报，服务器记录时间戳。可以精确到秒。相比刷卡签到，这个“无感”体验更好。
场景3：自习室座位管理
需求：实时显示哪些座位有人。
实现：每个座位上方装一个感应器，数据汇总后前端渲染热力图或座位图。
场景4：设备联动
检测到有人时，自动：
开启空气净化器
播报欢迎语音（通过其他设备）
打开教学大屏（通过中控）
检测到无人时，自动：
关闭所有非必要电源
触发保洁通知
场景5：数据统计
需求：了解教室使用率，优化排课。
实现：记录每天的有人时间段，汇总成报表。可以统计：平均每间教室每天使用X小时，闲置时段集中在下午3-5点，在这个时段加排课程。
六、配置小技巧
设备有不少可配置项，按需调整
触发持续时间（infrared_change_1和infrared_change_0）：设置“有人”和“无人”状态的确认时间。默认是“马上”，但设1-2秒的持续时间，避免快速晃过的人（比如走廊路过）触发误判。
LED指示灯（led）：默认开关灯时指示灯会闪。如果装在教学区域，学员觉得刺眼，可以配置成“长灭”。
上电默认状态infrared和relay1决定设备通电后红外和继电器是开是关。培训教室场景保持默认打开。
发现有人/无人时的动作（relay_change_1/relay_change_0）：配置继电器自动响应，不用经过服务器也能本地控制电器。
七、避坑指南
1. 安装位置
壁挂安装高度1.8-2米，探头向下倾斜15-30度
避免正对空调出风口（温差大影响红外）、避免正对风扇（叶片转动影响雷达）
2. 网络要求
只支持2.4G WiFi，5G不行
如果场地大，确保WiFi信号覆盖到每个安装点
3. 调试技巧
先用“调试模式”开发，省去签名计算麻烦，调通了再切正式模式
控制台可以看到设备上报的历史数据，方便排查
4. 误判处理
如果教室临走廊，设置有人触发持续时间为1-2秒，避免走廊的人一闪而过触发
双模已经大幅降低误判了，但安装位置不当还是会出问题
5. 私有化部署支持私有化部署，数据可以完全走内网，适合对数据安全要求较高的培训场景。
八、写在最后
芯步这款双模感应器的核心优势就是“双模+HTTP接口”：
双模解决了“人静坐感应不到”的痛点
开放的HTTP接口让集成非常丝滑
对接门槛不高，一个后端开发半天就能跑通完整流程。希望这篇能帮到你，有问题欢迎交流～