商场店铺的照明需求往往很具体——既要节能、又要给顾客良好的体验,传统定时开关很难两全。芯步的红外+雷达双模传感器配合开放接口,可以通过“本地感知+云端决策”的方式,实现人来灯亮、人走延时关闭的智能控制。以下是具体的对接方案:
——基于芯步双模传感器开放接口的实践
1. 背景与选型依据
在现代商场店铺装修中,照明设计不仅要营造购物氛围,还要兼顾节能降耗。传统的人体感应灯往往存在“感应延时固定”、“容易误灭”或“受温度干扰”的痛点。芯步提供的壁挂式红外和雷达双模块传感器,结合了被动红外(PIR)对静态人体热源的敏感性和微波雷达对微动探测的穿透力,能够有效过滤环境干扰。
为了实现此类硬件与店铺现有管理系统(如中控大屏、小程序或本地服务器)的深度整合,本方案基于芯步开放的 HTTP API 接口体系进行设计。
2. 对接设计
整个对接方案采用 “端-云-管-用” 的四层架构,确保数据流和控制流的通畅:
感知层:部署壁挂式双模传感器及智能照明回路(继电器/调光模块)。
网络层:利用设备内置的 WiFi 2.4G 无线网络直连,无需额外网关。
平台层:芯步开放平台(支持私有化部署,确保商场数据安全)。
应用层:商场的ERP系统、手机端运维APP或楼宇自控大屏。
3. 核心对接步骤与接口实施
本阶段将指导开发团队如何通过代码将传感器“接”入项目。
3.1 设备接入与注册
首先需要完成设备的网络配置与平台绑定。
配网:设备通电后,通过芯步提供的配网协议(如SmartConfig或AP配网)将商场WiFi凭证写入设备。
注册:设备连接云端成功后,会主动上报设备ID(
device)和应用ID(AppId) 。开发者需在后端数据库中记录这两个字段,作为后续控制的唯一标识。
3.2 核心接口调用逻辑
芯步的接口采用标准的 HTTP POST 请求方式进行控制,签名机制保障了API调用的安全性。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方式
POST数据格式
JSON
场景示例:当感应到人时,开启照明线路项目后端接收到传感器的“有人”信号后,需主动调用接口下发开灯命令:
命令调用关键参数说明根据芯步的设备功能定义,双模传感器通常支持以下控制字段
power(线路):控制照明灯具的开关。radar_enable(雷达模块):动态开启或关闭雷达感应功能,适应商场清扫/营业不同时段。infrared_enable(红外模块):动态开启或关闭红外感应。
响应处理接口调用成功后的响应时间通常在 80-120ms 内。项目需建立重试机制,若调用失败(如网络抖动),应记录日志并尝试重发。
3.3 数据上行与事件处理(消息推送)
传感器不仅仅是“被控制”,更重要的是“主动上报”。
机制:当传感器检测到“有人进入”、“有人离开”或“环境照度变化”时,设备会主动向开发者预设的 消息接收服务器(Callback URL) 推送数据。
对接动作:开发者需搭建一个公网或内网可访问的Web Service,用于接收并解析芯步推送的JSON数据包。
解析逻辑
解析
device_id确认是哪个位置的传感器。解析
sensor_data中的radar_status或pir_status字段。业务触发:如果收到“有人”信号,后端逻辑判断当前时间段,下发开灯指令;如果收到“无人”持续信号(如持续5分钟无数据),下发关灯指令。
4. 双模融合的业务逻辑优化
为了解决单一传感器误判问题(例如:红外对静态人体不敏感,雷达可能穿墙误判),本方案利用双模数据在应用层做逻辑融合,类似业界采用的“双重验证”机制
数据清洗:项目后端接收到上行消息后,不立即执行命令,而是做一个短暂的“状态窗口”(例如0.5秒)。
融合判断
若 仅红外触发 且 雷达未触发:可能是热源干扰(如咖啡机热气),不执行开灯。
若 红外未触发 但 雷达触发微动:说明人在静止状态(如玩手机),保持灯光常亮,避免误灭。
若 双模均触发:确认为正常行走顾客,立即开灯。
执行决策:通过上述逻辑后再调用
power命令,可以极大提升用户体验。
5. 项目实施关键配置
在实际部署壁挂式设备时,需结合接口调试进行以下配置:
感应距离与灵敏度适配商场过道通常较宽。芯步的接口支持下发
sensitivity参数。对于宽阔区域,可将雷达灵敏度调高;对于柜台内部,调低灵敏度避免穿透玻璃误报。延时策略(去抖处理)在API对接中,项目方将延时逻辑放在云端或本地服务器处理,而非单纯依赖硬件。
硬件上报:有人(即时)。
云端逻辑:收到“有人”信号后,立即开灯;如果收到“无人”信号,启动倒计时(如60秒)。
二次校验:倒计时期间若再次收到“有人”,取消倒计时。这样可以适应商场复杂的人流节奏。
本地联动(断网容灾)虽然本方案侧重接口对接,但利用芯步设备的特性,可预设 “本地规则” 。即在WiFi断网时,设备依然能依据内置逻辑(红外或雷达直接驱动继电器)保持基础照明功能,防止系统瘫痪。
6. 总结
通过本方案,项目团队无需关注底层射频通信,只需聚焦于 HTTP接口调用 和 消息接收解析。利用芯步开放平台的双模传感器,结合应用层的二次判定逻辑,商场店铺不仅实现了“人来灯亮、人走灯灭”的基础节能,更解决了传统感应灯对静止人员“熄灯”的糟糕体验,实现了照明系统的高度智能化和精细化运营。