芯步的开放接口核心在于HTTP API的“双向性”——传感器主动上报数据,平台下发控制指令。以下方案围绕“安全监测触发断电”和“人走逻辑判定”两条主线展开,涵盖设备选型、接口对接逻辑、联动策略及异常处理机制。
一、 背景与需求分析
在当前的零售店铺、办公场所及餐饮门店运营中,安全隐患与能源浪费往往源于“人的疏忽”。常见痛点包括:
人走未断电:下班或长时间无人时,空调、照明、招牌等设备未关闭,造成巨额电费浪费并引发电气火灾风险。
动态监测缺失:无法实时感知店内是否有人活动,导致安防系统(如声光报警)无法智能布防/撤防。
电气火灾隐患:老旧电器持续通电,缺乏过载及异常发热监控。
管理滞后:店长需每日手动巡检,缺乏数字化手段进行远程确认。
本方案的目标是利用芯步的智能WiFi人体存在传感器、智能WiFi插座/开关及智能语音音柱,通过其开放的HTTP API接口,搭建一套“感知-分析-执行-提醒”的闭环联动系统。
二、 硬件选型与接口能力
本方案的落地依赖于以下三款硬件及其开放的API特性:
1. 感知层:智能WiFi人体存在传感器
核心功能:探测区域内是否有人体存在(微动/呼吸检测),区别于传统红外,能防止“人静坐不动时误判为无人”。
关键API能力
状态上报:实时通过HTTP POST向指定服务器上报
occupied(有人) 或unoccupied(无人) 状态。心跳维持:定时发送心跳包,确保设备在线。
2. 执行层:智能WiFi墙壁插座/墙壁开关
核心功能:控制通断电、计量功耗。
关键API能力
远程通断控制:服务端通过API下发
{"power": 0}(断开) 或{"power": 1}(闭合) 指令。功率/电量计量:实时上报电压、电流、功率因数,支持超限自动断电(过载保护)。
定时与延时:支持通过API设置
rest参数,实现“通电1小时后自动断开”,无需服务器持续维持长连接任务。
3. 告警层:智能语音音柱 Pro60W
核心功能:接收文本转语音(TTS)播报,声光报警。
关键API能力
语音合成播报:支持HTTP请求直接下发文本内容,音柱即时合成语音。
音量/灯控:可远程控制音量大小及警报灯开关。
三、 技术对接架构
本方案采用边缘计算网关(本地服务器/云服务器)+ 设备直连的混合架构。
数据流:传感器探测到环境变化 向服务器推送状态 服务器执行逻辑判断 向插座/音柱下发指令。
协议:所有设备均支持WiFi 2.4G直连,无需额外网关,通过HTTP API进行通信。
私有化部署:所有API支持局域网本地调用,极大降低了指令延迟(实测80-120ms)并保障了断外网时的联动可用性。
四、 场景联动策略详解
第一种场景:打烊后的“人走断电”与安防联动
目标:解决员工离店时忘记关闭电源的安全隐患。
逻辑流程
布防启动:店长在后台(或小程序)点击“打烊模式”,系统向服务器发送布防指令,设定一个 “延时周期” (例如10分钟)。
状态监测:系统订阅指定区域(如营业大厅)的人体存在传感器数据。
判定机制
情况A:如果在10分钟内,传感器持续上报
unoccupied。 判定为无人。情况B:如果10分钟内传感器触发
occupied。 重置计时器,重新开始10分钟倒计时。
执行动作:一旦判定无人,服务器调用智能插座API
POST /device/control携带{"power":0},切断非必需设备(展示柜、灯带、音响)。保留设备:收银台冰箱、监控路由器等插在特定标识的“常电”插座上,不参与断电。
反馈确认:执行成功后,调用语音音柱API 播报:“打烊断电已完成,安防已布防”。
第二种场景:营业中的安全监测与应急响应
目标:解决大功率设备发热、无人时设备空转引发火灾的风险。
逻辑流程
过载预保护:在厨房区域的智能插座API中设置阈值(例如
max_power": 2200W)。实时掐断:若员工接入超过限定功率的设备(如违规使用超大功率烧水器),智能插座硬件端自动执行物理断流,并上报
overload事件至服务器。“人走阀关”:针对后厨燃气/水阀(通过智能插座控制电磁阀):
人体传感器探测到后厨无人超过
15分钟。服务器自动触发API切断“总闸插座”,连带关闭气阀。
防止因“烧干锅”引发火灾。
第三种场景:远程巡检与告警闭环
目标:解决店长在家中无法确认店铺状态的焦虑。
逻辑流程
状态查询:店长通过手机APP调用API
GET /device/status/{id},查看店内当前电流、电压及传感器状态。远程补救:发现某处空调未关,直接调用控制API
{"power":0}强行断电。故障推送:若插座检测到“异常发热”或“电流突变”,系统自动推送告警至多人(店长、安保),触发音柱发出“设备过热,请迅速检查”的警报声。
五、 接口对接开发实战细节
在基于芯步开放平台开发时,具体的代码逻辑实现重点如下:
1. 接收设备消息(Webhook配置)
需要在后台配置消息推送URL。
数据格式:服务器会收到标准的JSON报文。
示例(人体传感器)
服务端处理:接收到
unoccupied后,不要立即断电,而是写入Redis缓存,并设置一个Delay_Job(延迟任务)。如果10分钟内没有收到occupied,则执行断电逻辑。
2. 下发控制指令(签名与鉴权)
芯步的API采用URL签名验证,需要在代码中动态生成sign。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求Body
进阶用法:利用
reset参数实现智能延时。例如下达指令:“开启插座,30分钟后自动关闭”,无需服务器维护定时器列表
3. 联动逻辑的防抖动设计
多传感器融合:单一传感器可能误报,逻辑代码中设置“或”逻辑。如果大厅传感器 且 仓库传感器 同时上报
unoccupied,再执行断电,避免屏蔽死角。
六、 方案实施收益
节能(降低30%-50%)
杜绝了夜间照明、空调、电脑等设备的待机电耗。根据同类连锁门店案例,通过此类精细化能源管理,综合能耗预计可下降15%-30%。
本质提升安全
实现了从“人防”到“技防”的转变。电气故障(过载、超温)可在0.4秒内自动响应切断,消除火灾隐患。
运营灵活性与可扩展性
基于HTTP API,该解决方案可轻松集成进现有的ERP或钉钉/飞书系统,实现店长每日在审批流中即可完成“远程巡检”。
通过以上配置,店铺不仅实现了“人走灯灭”的基础节能,更构建了一套基于实时状态监测的主动安全防御体系。