壁挂式存在感应控制器的核心价值在于“持续存在检测”——不同于传统PIR传感器只对动态敏感,它能在人静止时(如办公、阅读)也保持“有人”状态。以下方案基于芯步的开放接口,说明如何从数据接收到联动逻辑落地。
解决方案:基于芯步开放接口的壁挂式存在感应控制器自定义联动逻辑实现
1. 背景与概述
在智能办公、智慧家居或节能楼宇场景中,普通人体感应灯控往往因人静止不动(如办公、阅读)而出现“误判无人导致熄灯”的糟糕体验。壁挂式存在感应控制器(通常采用毫米波雷达技术)能够探测细微的呼吸和心跳,实现真正的“存在”检测。
本方案基于芯步的开放平台能力,通过其提供的标准 HTTP 接口,指导开发者如何快速对接壁挂式存在感应传感器,并利用上报的数据(有人/无人状态)对接第三方系统或芯步生态内的其他执行设备(如插座、灯光、音柱),实现完全自定义的联动逻辑。
2. 核心对接架构
芯步采用设备直连云端+业务系统对接的标准架构,无需网关中转,简化了开发流程。
数据上行(感知层) :壁挂式存在感应器监测到环境状态变化(从无人到有人,或从有人到无人)时,主动向芯步云平台推送状态数据。
数据下行(联动层) :您的业务服务器在接收到芯步云推送的状态后,根据您设定的逻辑(如:无人超过5分钟),向芯步云 API 发起请求,控制其他设备(如关灯、断电)。
3. 准备工作
在开始编码前,请完成以下基础配置:
硬件准备:确认已采购芯步生态内的“壁挂式存在感应控制器”并完成通电配网。
获取凭证:登录[芯步控制台],在“开发设置”中获取
AppID和AppSecret。开发调试阶段可开启“调试模式”暂时忽略签名校验,生产环境需严格计算签名 。查阅指令集:在设备详情页查阅《产品手册》,确认存在感应器的具体上报字段(通常为
occupancy或特定寄存器值)以及受控设备(如智能开关)的order指令格式 。
4. 技术实现步骤:自定义联动逻辑
步骤一:配置消息接收服务器
由于传感器属于“上行消息”设备(主动上报数据),你需要一个公网可访问的服务器地址来接收数据。
设置回调 URL:在芯步控制台配置您的服务器接收地址(例如:
http(s)://yourdomain.com/api/sensor/callback)。接收数据样例:当有人进入感应区时,芯步云会向你的服务器发送如下格式的 POST 请求:
步骤二:定义联动逻辑
通过代码解析接收到的 JSON 数据后,你可以编写任意复杂的业务逻辑。以下是两个典型的自定义场景:
场景 A:节能模式(无人延时断电/关灯)*需求:人离开工位/会议室3分钟后,自动关闭照明和插座电源。*
逻辑实现:当接收到
"presence": "false"时,不立即执行关灯,而是启动一个定时器(例如180秒)。防跳变处理:如果在180秒内再次接收到
"presence": "true"(人只是出去拿快递回来了),则取消定时器。执行动作:定时器到期后,调用芯步的下发接口,向指定的智能插座或开关发送
power:0命令。
场景 B:安防警戒模式(深夜触发告警/联动音柱)需求:晚上10点后检测到有人存在,触发语音驱离。
逻辑实现:服务器接收到状态后,判断当前系统时间是否在
22:00之后,且presence为true。执行动作:调用“智能语音音柱”的控制接口,播放指定的告警音频或发出声光报警 。
步骤三:下发控制指令(执行动作)
当你的服务器逻辑判定需要执行动作时,需反向调用芯步平台的 设备控制接口 以控制其他设备。
请求地址
http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}请求方法:POST
请求示例:关闭某个灯光设备
效果:此命令发出后,约 80-120ms 内,执行设备(如灯)会做出物理反应 。
5. 高级联动逻辑设计
为了提升最终用户的体验,仅靠简单的“有人/无人”是不够的,利用接口特性开发以下“自定义逻辑”:
动静结合的判断:利用接口上报频率的可配置性。如果业务场景是“无人关灯”,设置传感器在“无人”状态上报延迟(例如连续5秒无人确认上报),避免人短暂微动导致的误报。
照度联动:如果传感器支持光照采集,可以配置逻辑:“仅当光照低于300 Lux 且 有人存在时,才开灯”。这能充分利用自然光,最大程度节能。
多设备群组控制:在服务器端将多个设备(如:灯带 + 射灯 + 窗帘)绑定为一个虚拟房间。当收到有人信号时,依次向这些设备发送指令(
power:1),实现“离家模式”或“回家模式”的一键场景。
6. 私有化部署与局域网控制
对于数据安全要求比较高的场景(如政府办公室或医疗病房),芯步支持私有化部署方案
消息流转闭环:无需经过芯步公有云,设备数据直接推送到你指定的局域网服务器。
实施要点:仅需在配网时将设备指向本地服务器的 IP 地址和端口,API 调用方式与云端完全一致,无需额外开发 。
7. 总结
通过对接芯步的壁挂式存在感应控制器,开发者可以在10分钟内完成基础的 “数据接收-逻辑判断-指令下发” 闭环 。相比于传统的红外感应,壁挂式存在感应带来的“静态存在检测”能力,结合上述自定义的服务端脚本逻辑,可以彻底解决办公空间、卫生间的灯控失明问题,并实现多达80%以上的精细化节能。