店铺人体感应照明：怎么把壁挂式双模人体活动监测器对接到自己的项目中_解决方案

CATALOG

店铺照明智能化是提升体验、降低能耗的有效手段，而“有人亮灯、无人关灯”的自动感应需求非常普遍。芯步的壁挂式双模人体活动监测器（红外+雷达）开放了HTTP接口，可以灵活集成到自有项目中，实现精准的照明控制。

以下是具体的解决方案：

1. 产品选型与核心优势

在芯步的产品线中，推荐选用 智能人体存在传感器[壁挂] （型号：UNI-CGQ-RT-H-BG）。

该传感器具备以下核心优势：

双模检测（红外+雷达） ：不同于传统的纯红外传感器（只能探测移动），这款产品融合了 红外探测 和 雷达微动探测。雷达技术可以探测到人体呼吸等微小动作，避免传统感应灯在人体静止（如玩手机、蹲厕所）时误判为无人而熄灯的尴尬。
自带强电输出（AC Output） ：该设备自带一路继电器输出，可以直接控制灯光的电源通断（AC 100-250V），无需额外的继电器模块，接线方便。
开放API接口：支持HTTP接口控制与数据上报，适合集成到Web、APP或小程序中。

为了实现将硬件集成到您的自有项目中，采用“设备直连云端+业务系统订阅”的架构最为轻量。

芯步的接口签名规则较为简单，核心是动态生成Sign签名。

签名计算公式

Sign = md5（ md5（AppSecret） + ts ）

逻辑说明

根据您的项目场景，可以通过以下两种或结合的方式实现照明控制。

设备本身内置了逻辑规则。您无需编写代码，只需在对接时调用API修改配置项，让传感器自己控制灯光。

目标：无人超过3分钟，关闭接在传感器上的灯；有人立即开灯。
API调用示例您需要下发命令修改传感器的配置参数。
// 请求地址:https://api.thingboot.com/{AppId}/device/control/ // 请求体 Body (JSON) { "device": "1878"， // 替换为您的设备ID "order": { "relay_change_1": 1， // 发现有人时，接通线路（开灯） "relay_change_0": 0， // 发现无人时，关闭线路（关灯） "infrared_change_0": 180 // 无人触发持续时间设置为180秒（3分钟） } }
注：上述命令配置后，设备将脱离您的服务器独立运行，即使断网也会根据传感器状态控制灯光。

如果您需要在“开灯”的同时，执行其他业务逻辑（如记录客流、发送欢迎语到收银台），则需搭建自己的消息接收服务器。

第1步：配置消息推送在芯步控制台，将您的服务器地址填入“消息推送”URL。当传感器状态变化时，平台会主动推送数据。

第2步：接收设备上报设备状态变化时，您的服务器会收到如下格式的POST数据：

第3步：下发控制指令您的服务器处理完业务逻辑后，可反向调用API控制灯光或其它设备。

目标：当检测到有人，且当前时间是晚上（18：00-次日8：00），开灯。
代码逻辑（伪代码） ：
# 1. 接收云平台发来的数据 if request.json[‘infrared_target’] == 1: current_hour = datetime.now().hour # 2. 判断业务条件（是否是晚上） if current_hour >= 18 or current_hour <= 8: # 3. 下发开灯指令 call_yoyo_api(device_id="1878"， order={"power": 1})

为了便于开发，以下是该传感器常用的Order命令列表

接线安全：该设备直接接入220V强电。接线前请一定要断开总闸。负载端（灯光）功率不要超过继电器的额定负载（阻性2200W / 感性350W）。
避坑指南
- Wi-Fi频段：仅支持2.4G Wi-Fi，请确保店铺路由器开启了2.4G频段。
- 时间戳同步：生成Sign时，请确保服务器时间与标准时间误差不宜过大，否则会鉴权失败。
- 双模逻辑：默认逻辑是红外和雷达都探测到无人，才判定无人。这非常灵敏，但也请注意探测范围，避免感应到店铺外路过的行人。
调试模式：在开发初期，可以在控制台开启“调试模式”，此时系统会忽略Sign签名校验，方便您用Postman等工具快速调试接口连通性。上线前关闭即可。