CATALOG

芯步的开放接口采用HTTP协议,支持公网/局域网及私有化部署,可让传感器数据直接推送至您的业务服务器,再由服务器向照明设备下发指令。以下方案聚焦于如何利用这套机制实现“人来看灯亮、静坐灯不灭、人走灯自关”的完整闭环。

1. 背景与需求分析

在智能家居场景中,传统红外传感器往往无法检测静止或微动的人体(如在书房看书、在沙发休息),容易导致灯光误关闭,严重影响用户体验。为了解决这一痛点,我们需要利用毫米波雷达传感器的高精度感知能力,结合芯步开放平台高效的HTTP API,实现真正的“人来灯亮、人在灯不灭、人走灯自关”的无感智慧照明体验。

本方案的目标是通过芯步的开放接口,将第三方或芯步生态内的雷达传感器、照明控制器及用户业务系统进行无缝对接。

2. 设计

本方案采用标准的物联网“端-管-云-用”四层架构,利用设备端直连云端联动的方式,确保低延迟与高稳定性。

  • 感知层:部署芯步生态或兼容的智能人体存在雷达传感器(如吸顶式雷达)和智能照明设备(如支持通断的灯具、可调光驱动)。

  • 传输层:支持Wi-Fi 2.4G直连或局域网(LAN)通信,利用HTTP/HTTPS协议进行数据传输。

  • 平台层:芯步开放平台及用户的私有化业务服务器。所有传感数据通过消息推送机制实时到达用户服务器。

  • 应用层:用户定义的联动逻辑引擎(规则引擎),负责解析传感器数据并触发照明指令。

3. 核心开放接口与设备对接机制

芯步开放接口具有接口简单、支持私有化、兼容公网/局域网三大特性,是实现联动的技术基础

3.1 设备上线与消息订阅

所有设备通过Wi-Fi配网后,携带设备ID向芯步平台注册。用户需在自己的业务服务器上配置消息接收接口,以接收平台推送的实时数据。

  • 数据流向:传感器探测到状态变化 \rightarrow 平台推送至用户服务器(POST /api/receive)。

  • 关键数据device_id(设备编号)、type(类型:雷达/光照)、status(状态:有人/无人)、illuminance(光照度值)。

3.2 关键接口参数解析

根据芯步公开的设备控制指令规范,对照明设备的操作主要涉及以下核心接口

1. 接收传感器数据(消息推送)芯步传感器在探测到状态变化时会主动上报,业务服务器需解析如下结构:

2. 下发照明控制指令业务服务器在逻辑判断满足条件后,需调用芯步控制接口向灯具下发指令。请求示例(针对某路灯具ID light_001 开启线路):

  • URLhttp(s)://api.thingboot.com/{AppId}/device/control/?sign={动态签名}&ts={时间戳}

  • POST Body

4. “人体存在”联动控制逻辑实现

为了解决传统红外传感器“静坐关灯”的痛点,本方案的逻辑核心不仅依赖于移动侦测,更依赖于静态存在信号

4.1 状态机设计

在您的业务服务器中定义如下状态迁移逻辑:

  1. 初始状态:灯关闭。

  2. 触发开灯:当雷达传感器上报 state=occupancy(探测到呼吸级微动或移动)。

    • 附加条件:若传感器具备光照检测,需判断 illum 低于设定阈值(如50 Lux),避免白天误触发。

  3. 保持状态

    • 只要持续收到 occupancy 信号(雷达传感器通常每1-2秒上报一次),则维持 power=1 状态,不执行任何动作。

    • 设置软件定时器(Watchdog),若超过 30秒 未收到任何心跳,执行保护性关灯。

  4. 触发关灯:连续收到 vacancy 信号(无人状态)超过设定的 延时时间(如30秒或60秒),服务器下发 {"power": 0} 指令。

4.2 场景精细化配置

利用芯步接口的灵活性,可以定制不同场景:

  • 第一种场景:人来灯亮,人走灯灭(常规区域:走廊、卫生间)

    • 逻辑:状态变为occupancy\rightarrow 开灯;状态变为vacancy维持10秒 \rightarrow 关灯。

  • 第二种场景:恒亮防误判(长时间停留区域:书房、卧室)

    • 逻辑:即使人体静止不动,雷达模组输出的仍是occupancy,服务器不会发送关灯指令,直到检测到“无人”输出。

  • 第三种场景:昼夜节律联动

    • 逻辑:结合传感器上报的光照度数据,服务器可下发不同的亮度指令。例如:illum < 10 下发 brightness=80(深夜低亮度);10 < illum < 100 下发 brightness=100(傍晚全亮)。

5. 网络部署与私有化方案

针对高端用户或对隐私、响应速度要求比较高的场景,芯步支持私有化部署局域网通信

  • 纯局域网联动:如果用户的智能网关和服务器部署在同一局域网内,控制指令无需经过外网。API请求地址可直接指向局域网内的设备IP。

    • 优势:即便外网断开,只要Wi-Fi路由器正常工作,人体感应联动依然稳定运行,响应时间可缩短至 80-120ms,做到真正瞬时响应

  • 数据安全:所有设备数据通过HTTP携带签名(sign)和时间戳(ts)验证,有效防止重放攻击,保障家庭隐私数据仅在本地闭环流转

6. 总结

通过对接芯步的开放接口,开发者无需从零构建复杂的底层通信协议,只需关注业务逻辑层。利用雷达传感器的 “持续存在感知” 配合 HTTP接口的快速控制能力,即可完美替代传统PIR红外方案,实现“静坐不关灯”的极致智能体验,同时支持灵活的私有化部署以满足不同层级客户的定制需求。

人体存在传感器产品方案:
智能家居人体感应照明:怎样将壁挂安装雷达人体感应器接入到自己的项目中
查看 >>
如何接入智能人体存在传感器[壁挂]来实现设备电源开关控制
查看 >>
怎么在共享台球厅人体感应联动中集成智能设备以实现故障告警通知
查看 >>
便利店人体感应照明:怎么将HTTP接口壁挂人体存在检测设备接入到自己的项目中
查看 >>
如何在园区公共区域安全联动中对接智能硬件来实现人体存在联动控制
查看 >>
家居场景方案:
智能家居电路保护:怎么把40A大功率智能断路器对接到自己的项目中
查看 >>
智能家居人体感应照明:怎么把壁挂式存在感应控制器对接到自己的项目中
查看 >>
智能家居低压设备控制:怎么把2路直流电压版控制器集成到软件项目中
查看 >>
怎样在智能家居多路电器控制中接入智能设备来实现远程控制8路线路
查看 >>
怎样在智能家居电器控制中对接智能设备来实现设备分组控制
查看 >>
存在用途方案:
怎样对接壁挂式双功能传感器以实现人体存在感应监测
查看 >>
怎样在共享台球厅人体感应联动中对接智能设备以实现存在感应数据上报
查看 >>
如何接入智能人体存在雷达和烟雾传感器来实现远程人体存在监测
查看 >>
怎么在共享台球厅人体感应与火灾预警中对接智能硬件来实现远程人体存在监测
查看 >>
如何在图书馆自习室人体存在感应中接入智能设备来实现远程人体存在状态监测
查看 >>