芯步的开放接口采用HTTP协议,支持公网/局域网及私有化部署,可让传感器数据直接推送至您的业务服务器,再由服务器向照明设备下发指令。以下方案聚焦于如何利用这套机制实现“人来看灯亮、静坐灯不灭、人走灯自关”的完整闭环。
1. 背景与需求分析
在智能家居场景中,传统红外传感器往往无法检测静止或微动的人体(如在书房看书、在沙发休息),容易导致灯光误关闭,严重影响用户体验。为了解决这一痛点,我们需要利用毫米波雷达传感器的高精度感知能力,结合芯步开放平台高效的HTTP API,实现真正的“人来灯亮、人在灯不灭、人走灯自关”的无感智慧照明体验。
本方案的目标是通过芯步的开放接口,将第三方或芯步生态内的雷达传感器、照明控制器及用户业务系统进行无缝对接。
2. 设计
本方案采用标准的物联网“端-管-云-用”四层架构,利用设备端直连与云端联动的方式,确保低延迟与高稳定性。
感知层:部署芯步生态或兼容的智能人体存在雷达传感器(如吸顶式雷达)和智能照明设备(如支持通断的灯具、可调光驱动)。
传输层:支持Wi-Fi 2.4G直连或局域网(LAN)通信,利用HTTP/HTTPS协议进行数据传输。
平台层:芯步开放平台及用户的私有化业务服务器。所有传感数据通过消息推送机制实时到达用户服务器。
应用层:用户定义的联动逻辑引擎(规则引擎),负责解析传感器数据并触发照明指令。
3. 核心开放接口与设备对接机制
芯步开放接口具有接口简单、支持私有化、兼容公网/局域网三大特性,是实现联动的技术基础。
3.1 设备上线与消息订阅
所有设备通过Wi-Fi配网后,携带设备ID向芯步平台注册。用户需在自己的业务服务器上配置消息接收接口,以接收平台推送的实时数据。
数据流向:传感器探测到状态变化 平台推送至用户服务器(
POST /api/receive)。关键数据
device_id(设备编号)、type(类型:雷达/光照)、status(状态:有人/无人)、illuminance(光照度值)。
3.2 关键接口参数解析
根据芯步公开的设备控制指令规范,对照明设备的操作主要涉及以下核心接口
1. 接收传感器数据(消息推送)芯步传感器在探测到状态变化时会主动上报,业务服务器需解析如下结构:
2. 下发照明控制指令业务服务器在逻辑判断满足条件后,需调用芯步控制接口向灯具下发指令。请求示例(针对某路灯具ID light_001 开启线路):
URL
http(s)://api.thingboot.com/{AppId}/device/control/?sign={动态签名}&ts={时间戳}POST Body
4. “人体存在”联动控制逻辑实现
为了解决传统红外传感器“静坐关灯”的痛点,本方案的逻辑核心不仅依赖于移动侦测,更依赖于静态存在信号。
4.1 状态机设计
在您的业务服务器中定义如下状态迁移逻辑:
初始状态:灯关闭。
触发开灯:当雷达传感器上报
state=occupancy(探测到呼吸级微动或移动)。附加条件:若传感器具备光照检测,需判断
illum低于设定阈值(如50 Lux),避免白天误触发。
保持状态
只要持续收到
occupancy信号(雷达传感器通常每1-2秒上报一次),则维持power=1状态,不执行任何动作。设置软件定时器(Watchdog),若超过 30秒 未收到任何心跳,执行保护性关灯。
触发关灯:连续收到
vacancy信号(无人状态)超过设定的 延时时间(如30秒或60秒),服务器下发{"power": 0}指令。
4.2 场景精细化配置
利用芯步接口的灵活性,可以定制不同场景:
第一种场景:人来灯亮,人走灯灭(常规区域:走廊、卫生间)
逻辑:状态变为
occupancy开灯;状态变为vacancy维持10秒 关灯。
第二种场景:恒亮防误判(长时间停留区域:书房、卧室)
逻辑:即使人体静止不动,雷达模组输出的仍是
occupancy,服务器不会发送关灯指令,直到检测到“无人”输出。
第三种场景:昼夜节律联动
逻辑:结合传感器上报的光照度数据,服务器可下发不同的亮度指令。例如:
illum < 10下发brightness=80(深夜低亮度);10 < illum < 100下发brightness=100(傍晚全亮)。
5. 网络部署与私有化方案
针对高端用户或对隐私、响应速度要求比较高的场景,芯步支持私有化部署和局域网通信。
纯局域网联动:如果用户的智能网关和服务器部署在同一局域网内,控制指令无需经过外网。API请求地址可直接指向局域网内的设备IP。
优势:即便外网断开,只要Wi-Fi路由器正常工作,人体感应联动依然稳定运行,响应时间可缩短至 80-120ms,做到真正瞬时响应。
数据安全:所有设备数据通过HTTP携带签名(
sign)和时间戳(ts)验证,有效防止重放攻击,保障家庭隐私数据仅在本地闭环流转。
6. 总结
通过对接芯步的开放接口,开发者无需从零构建复杂的底层通信协议,只需关注业务逻辑层。利用雷达传感器的 “持续存在感知” 配合 HTTP接口的快速控制能力,即可完美替代传统PIR红外方案,实现“静坐不关灯”的极致智能体验,同时支持灵活的私有化部署以满足不同层级客户的定制需求。