芯步的壁挂式红外雷达存在感应器通过开放的HTTP接口,支持远程参数配置和状态获取。以下方案涵盖接口鉴权、核心命令、代码实现及配网流程,帮助快速完成集成开发。
解决方案:基于芯步开放接口的壁挂式红外雷达存在感应器远程配置系统
1. 背景与概述
在现代智能楼宇、节能办公和家居自动化场景中,普通的人体传感器往往无法检测静坐或微动状态,导致频繁误判“无人”而关灯或关空调。芯步推出的壁挂式红外雷达存在感应器(如UNI-CGQ-RT-BG-HL及雷达传感器2代)结合了红外与毫米波雷达技术,能够探测人体的微动甚至呼吸。
本方案的目标是指导开发者如何利用芯步开放的 HTTP API接口,对该硬件进行远程参数配置(如雷达灵敏度、无人延时时间等),实现更精准的存在检测逻辑,以适应不同场景(如办公室、卫生间、会议室)的需求。
2. 核心接口与鉴权机制
所有操作均基于HTTP协议,无需网关,设备直连Wi-Fi 2.4G网络。接口调用采用双重MD5签名机制保证安全性。
请求地址
http(s)://api.thingboot.com/{AppID}/device/control/请求方法:POST(Content-Type: application/json)
鉴权参数
ts:当前10位时间戳(秒级)。
sign:签名值。
计算公式
sign = MD5( MD5(AppSecret) + ts )。注意:先将开发者密码进行一次MD5加密,得到32位小写字符串,再拼接时间戳,最后整体计算一次MD5。
必需Header/Body字段
device:目标设备的唯一ID(可在控制台查看或通过设备列表接口获取)。order:要下发的具体命令(JSON对象)。
3. 远程配置操作指南
针对存在感应器,核心需求是修改雷达的探测灵敏度和触发逻辑。以下是关键配置命令的详细说明。
3.1 第一种场景:启用/关闭雷达感应模块
默认情况下设备雷达模块是开启的。如果需要远程重启或策略性关闭,使用以下命令:
命令功能
radar_enable下发值
1:开启雷达感应(探测有人/无人)0:关闭雷达感应
请求示例
3.2 第二种场景:调整“无人”判定延时
在智能控制中,为了避免人短暂离开(如起身倒水)导致设备立即断电,通常需要配置“无人判定延时”。
说明:虽然基础产品手册常列出
radar_enable,但对于壁挂雷达存在传感器,order对象中通常支持delay参数(具体取决于固件版本,通用做法是控制radar_enable的开关逻辑,或直接配置上报间隔)。配置逻辑:利用红外和雷达双重确认,通常可以通过修改设备上报频率来间接实现。如果硬件支持“存在检测延时”,下发命令结构如下(逻辑推导):
注:具体参数名请参考设备对应的产品手册“雷达模块”高级设置部分。
3.3 第三种场景:查询当前状态与数据接收
虽然主题是“配置”,但配置的前提是了解当前状态或接收告警。
数据上报:设备不支持轮询拉取数据,而是采用主动推送机制。当人体存在状态发生变化(从有人变无人,或无人变有人),设备会通过HTTP/MQTT向预设的服务器地址推送数据。
接收示例:你的服务器需提供一个公网接口或内网穿透地址,接收如下格式的POST数据包,从而解析出“有人/无人”状态来决定是否需要调整灵敏度参数。
4. 开发实战(代码示例)
以下使用Python与Bash示例,演示如何通过代码下发radar_enable指令开启雷达感应。
步骤 1:准备凭证
AppID:yP8sFk3d (示例)
AppSecret:a1b2c3d4e5f6g7h8i9j0 (示例)
Device ID:820720 (示例)
步骤 2:计算签名(Python)
步骤 3:Bash(Curl)快速调试
代码参考来源:芯步通用设备控制命令格式
5. 配置与实施流程
要完成远程配置,硬件必须处于在线状态。实施步骤如下:
设备配网
使用“芯步”微信小程序或电脑控制台。
在“网络配置”中添加现场的2.4G WiFi名称和密码。
通过手机热点辅助模式将传感器加入网络。
私有化部署(可选)
如果数据安全要求高,可在控制台设置私有化消息服务器。
将API接口地址指向自己的服务器IP,设备数据将直接发送至你的后端,不经过芯步云。
联动测试
配置完成后,观察设备指示灯。当雷达探测到微动(如手指晃动)时,应有信号输出。
检查接收服务器是否收到“存在”事件的HTTP POST请求。
6. 总结
通过芯步的开放接口,对接壁挂式红外雷达传感器主要集中于签名鉴权与指令下发两个环节。开发者可以利用任意支持HTTP的编程语言,在获取AppID和Device ID后,通过简单的POST请求即可动态调整雷达的开关状态及侦测灵敏度,实现真正的“无感”节能控制。