芯步这款壁挂式双模传感器,最大的特点就是把“红外”和“雷达”两种检测技术结合在了一起——红外负责看有没有“大动静”,雷达负责感知呼吸、心跳这类“微动”,两者互为补充,基本杜绝了“人还在灯却灭了”的尴尬。
下面这份对接指南,基于它的 HTTP 开放接口 来写,偏实战向,可以参考一下。
1. 先搞清楚硬件怎么“装”与“看”
拿到设备(型号参考:UNI-CGQ-RT-BG)后,我们得先了解它的脾气。
安装位置:因为是壁挂式,装在离地 2米左右 的高度。如果装低了,雷达波打在地面上可能会有干扰。
双模逻辑:这款设备内部的红外(PIR)和雷达(毫米波)是“与”的关系。也就是说,只有两个传感器都判定没人,它才会告诉你“无人”;只要有一个检测到,就是“有人”。这比市面上单纯的红外感应靠谱得多,人坐着不动敲键盘,雷达也能捕捉到。
供电:接 AC 100-250V(交流/市电),也就是直接接家里的零火线,它内置了继电器,可以直接串到灯里。
2. 对接前的“准备工作”
在写代码之前,我们需要在芯步的后台把“管道”打通。
注册与创建:去芯步官网注册账号,进入“工作台”,找到“物联网控制台”。
配网:给传感器通电。这时候你需要用手机App或者通过后台的配网指引,把设备的WiFi连上你的路由器。注意:这款只支持2.4G WiFi,这一点要留心。
拿到关键的钥匙:在控制台的“开发设置”里,你会看到两个非常重要的字符串:
AppID:相当于你的账号ID。
AppSecret:相当于你的密码,千万不要泄露。
3. 核心逻辑:数据上报(设备 -> 服务器)
芯步的这套接口是HTTP 协议的,非常简单,不用折腾复杂的MQTT Broker。
设备一旦检测到状态变化(比如从无人变成有人,或者从有人变成无人),它会主动往你的服务器“扔”数据。
你需要做的是:
提供一个公网可访问的 API URL(例如:https://yourdomain.com/api/yoyo/callback),然后在后台把这个地址配置给设备。
当有人进入房间时,你的服务器会收到类似这样的数据包:
这时候,你的业务系统就可以干活了:
开灯/关空调:收到“有人”,马上去调用芯步的控制接口(或者通过你别的系统)把灯打开。
安防联动:如果是下班时间检测到“有人”,立马给你的App发一条告警。
4. 主动控制与调参(服务器 -> 设备)
有时候,我们想远程关掉这个传感器(比如会议室不需要检测时),或者调整灵敏度。这就要用到主动控制接口了。
接口地址
双模开关控制
如果你想暂时关掉雷达模块(比如为了省电,或者怕雷达穿墙误报):
请求方法:POST
Body
同理,控制红外模块的命令是 "infrared_enable": 0。
获取实时状态
你也可以主动问一下设备:“现在到底有没有人?”
设备会马上返回当前的红外和雷达状态。
5. 避坑经验分享
在实际对接中,有几个小地方需要注意:
签名计算(Sign):很多人在第一步就被卡住了。芯步的签名规则是
md5(md5(AppSecret) + ts)。意思是:先把你的 AppSecret 做一次 MD5,得到一个字符串,然后在这个字符串后面拼接上当前的时间戳(ts),再把拼接后的新字符串做一次 MD5。
小:开发调试时,可以在后台打开“调试模式”,先关掉签名验证,逻辑调通后再加上,不然容易因为各种编码问题导致 401 认证失败。
“幽灵”误报:双模传感器虽然准,但雷达波有穿透性(能穿透玻璃、薄木板)。如果装在走廊,外面有人路过,雷达可能会感应到。
对策:在后台或者通过命令调低雷达的灵敏度参数,或者调整安装角度,让它对着房间内部。
状态去抖:传感器上报“无人”通常会有 延时(一般默认 30-60 秒)。这是为了防止人出门倒个垃圾,灯马上就灭了。在对接逻辑里,如果你的系统用来控制贵重设备,做个 5-10 秒的“二次确认” ,避免瞬间误判。
6. 总结
对接这款“壁挂式双模人体活动监测器”其实就三步:
硬件配网:让它连上网。
接收数据:搭好 HTTP 接口,等着收“有人/无人”的消息。
下发指令:用“签名算法”调接口,控制它的开关或查状态。
相比单一红外传感器,双模最大的优势就是稳定。只要把这套 HTTP 对接流程跑通,用在智能办公室、卫生间、甚至安防防拆检测上,体验都会好不少。如果在签名计算或者数据解析上卡住了,可以直接联系芯步的技术支持,他们提供免费的指导。