芯步的壁挂式智能“双模”感应开关（红外+雷达）提供了开放的HTTP接口，通过标准的RESTful API调用即可完成设备控制与数据接收。以下方案涵盖从准备工作、接口对接到业务集成的完整流程。

解决方案：培训教室人体存在监测系统对接芯步“双模”感应开关

1. 概述与选型依据

在培训教室场景中，精准的人体存在监测是实现智能控制（如灯光、空调自动调节）的基础。传统红外传感器容易在人员静止（如长时间看书、看屏幕）时产生误判。

本方案采用芯步壁挂式智能“双模”感应开关（红外+雷达双模）。该设备结合了红外对移动的敏感性和雷达对微动（呼吸、心跳引起的胸腔起伏）的探测能力，能有效解决“坐着一动不动就关灯”的痛点。

核心对接逻辑：

• 上行（数据上报）： 当设备检测到“有人”或“无人”状态变化时，主动通过HTTP协议向你的服务器推送状态数据。

• 下行（远程控制）： 你的服务器通过调用芯步的开放API，可以对设备进行远程配置（如灵敏度调节、开/关负载）或获取设备当前快照。

2. 对接准备与开发环境配置

在编写代码前，需在芯步IoT平台完成应用创建，获取身份凭证。

步骤一：准备工作

1. 设备加电与配网： 将壁挂式“双模”感应开关安装在教室墙面（离地1.4-1.7米，避开空调出风口），接通220V交流电或POE供电（视型号而定）。参考产品手册，通过设备热点或智能配网将其连接至办公室Wi-Fi。

2. 平台注册： 登录芯步官网，进入“物联网控制台”。

步骤二：开发设置在控制台左侧导航栏点击“开发设置”：

1. 记录 AppID（开发者ID）和 AppSecret（开发者密码）。

2. 回调地址设置： 配置“消息推送URL”（即你的公网服务器地址，例如 https://yourdomain.com/api/yoyo/callback）。这是系统接收设备上报数据的核心通道。

初次对接可开启“调试模式”暂时忽略签名校验和IP白名单，确保通信链路畅通后再开启生产模式。

3. 核心技术实现：接口对接与数据流转

3.1 设备数据上报（接收“有人/无人”事件）

当教室人员状态发生变化时，设备会向平台上报数据，平台会将其转发到你预设的URL。

• 请求方式： POST

• Content-Type： application/json

• 请求体示例（模拟）：

  { "device_id": "12345678", // 设备唯一ID "device_type": "PIR_RADAR_SWITCH", // "双模"开关 "report_time": 1704067200, // 时间戳 "status": { "occupancy": true, // true:有人存在; false:无人 "illuminance": 320, // 可选:光照度(lux) "radar_sensitivity": 80 // 当前雷达灵敏度(%) } }

编程实现（Python Flask示例）：

你需要编写一个Web服务来处理芯步的POST请求。

3.2 远程API调用（下发命令）

如果你需要主动查询设备状态（例如管理员在后台查看教室情况），可以调用芯步的开放API。

• 请求地址：https://api.yoyoiot.com/ordercontrol

• 签名算法： 将 AppSecret、时间戳等参数按字典序排序后MD5加密（详见官方文档）。

流程示意：

1. 你的后台服务器发起HTTP请求。

2. 芯步云平台校验身份。

3. 平台将指令推送给教室内的壁挂感应开关。

常见命令示例：

4. 业务场景深度集成

4.1 与中央空调/新风系统联动

• 痛点： 培训教室常出现下课了空调忘关的情况。

• 逻辑： 系统接收 "occupancy": false 事件后，启动30分钟倒计时。若30分钟内无新“有人”事件，则通过Modbus协议或空调网关发送关机指令。

4.2 课件与板书辅助

• 逻辑： 当老师进入讲台区域（如果安装位置区分前后排），系统检测到存在，自动通过API触发投影幕布降下或智慧大屏点亮。

4.3 数据统计报表

• 逻辑： 利用上报的数据，统计每间教室的利用率。

  • SQL统计逻辑：计算一天中 occupancy 为 true 的总时长。

  • 输出报表：《培训教室单日/周使用率分析》，帮助培训机构优化排课。

5. 安装与调试注意事项

为了确保对接数据的准确性，请请一定要关注物理安装环节：

1. 避免探测盲区： 壁挂式“双模”传感器探测角度通常为120°，探测距离最远6米。对于大教室，可能需要对角安装2个设备，通过逻辑“或”来判断全域是否有人。

2. 安装高度： 严格按照产品手册要求（通常1.4m - 1.7m）。装太高会导致雷达波覆盖地面面积过大，可能探测到隔壁教室的动静；装太低容易产生探测死角。

3. 规避干扰： “双模”开关中的雷达模块（如24GHz）会穿透石膏板、玻璃。

   • 注意： 不要对着走廊，否则窗外/门外有人走动会误判为教室内有人。

   • 注意： 避开空调挂机（风机震动可能被雷达捕获）。

4. 调试流程： 在芯步控制台的“设备详情”页 -> “日志服务”中查看原始上报数据。如果发现 occupancy 频繁跳动，说明灵敏度过高，可通过API下发降低雷达增益值。

6. 总结

通过对接芯步“双模”感应开关的开放接口，你可以在自己的教务管理系统中低成本实现高精度的人体存在感知。技术路径整理如下：

1. 协议层： 简单HTTP请求，不依赖特定的物联网网关直连，适合IT人员快速集成。

2. 逻辑层： 利用“红外+雷达”的双重确认机制，彻底解决传统红外传感器在静止场景下的误报问题。

3. 应用层： 除了基本的照明/空调节能，更有价值的是形成了 “教室利用率数据资产” ，为社会培训机构优化场地资源配置提供了量化依据。