CATALOG

芯步这款壁挂式双模传感器,最大的特点就是把“红外”和“雷达”两种检测技术结合在了一起——红外负责看有没有“大动静”,雷达负责感知呼吸、心跳这类“微动”,两者互为补充,基本杜绝了“人还在灯却灭了”的尴尬

下面这份对接指南,基于它的 HTTP 开放接口 来写,偏实战向,可以参考一下。

1. 先搞清楚硬件怎么“装”与“看”

拿到设备(型号参考:UNI-CGQ-RT-BG)后,我们得先了解它的脾气

  • 安装位置:因为是壁挂式,装在离地 2米左右 的高度。如果装低了,雷达波打在地面上可能会有干扰。

  • 双模逻辑:这款设备内部的红外(PIR)和雷达(毫米波)是“与”的关系。也就是说,只有两个传感器都判定没人,它才会告诉你“无人”;只要有一个检测到,就是“有人”。这比市面上单纯的红外感应靠谱得多,人坐着不动敲键盘,雷达也能捕捉到

  • 供电:接 AC 100-250V(交流/市电),也就是直接接家里的零火线,它内置了继电器,可以直接串到灯里。

2. 对接前的“准备工作”

在写代码之前,我们需要在芯步的后台把“管道”打通。

  1. 注册与创建:去芯步官网注册账号,进入“工作台”,找到“物联网控制台”

  2. 配网:给传感器通电。这时候你需要用手机App或者通过后台的配网指引,把设备的WiFi连上你的路由器。注意:这款只支持2.4G WiFi,这一点要留心

  3. 拿到关键的钥匙:在控制台的“开发设置”里,你会看到两个非常重要的字符串:

    • 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. 总结

对接这款“壁挂式双模人体活动监测器”其实就三步:

  1. 硬件配网:让它连上网。

  2. 接收数据:搭好 HTTP 接口,等着收“有人/无人”的消息。

  3. 下发指令:用“签名算法”调接口,控制它的开关或查状态。

相比单一红外传感器,双模最大的优势就是稳定。只要把这套 HTTP 对接流程跑通,用在智能办公室、卫生间、甚至安防防拆检测上,体验都会好不少。如果在签名计算或者数据解析上卡住了,可以直接联系芯步的技术支持,他们提供免费的指导

人体存在传感器产品方案:
共享自习室人走断电与安全监测:如何把共享空间安全节能传感器接入到软件项目中
查看 >>
怎样在设备机房人体存在与火灾预警中集成智能设备来实现远程火灾预警监测
查看 >>
培训机构教室人体感应:如何把壁挂式双鉴人体存在传感器集成到项目中
查看 >>
共享充电场所人体感应:怎样把吸顶式高精度红外传感器接入到项目中
查看 >>
民宿房间安全监测与节能控制:如何将双鉴式人体雷达烟感接入到软件项目中
查看 >>
检测场景方案:
智能办公人体存在检测:怎么将壁挂式人体移动探测器对接到项目中
查看 >>
如何在共享自习室人体存在检测中集成智能硬件以实现多设备联动控制
查看 >>
怎么接入壁挂式商用雷达烟雾监测器以实现烟雾浓度检测
查看 >>
怎样对接智能家居烟雾传感器以实现烟雾浓度检测
查看 >>
如何在弱电间安全联动中接入智能设备以实现红外/雷达双检测
查看 >>
雷达用途方案:
怎么在设备机房人体感应管理中接入智能硬件以实现雷达人体微动探测
查看 >>
怎样在民宿房间人体感应照明中对接智能设备来实现雷达人体微动探测
查看 >>
怎样在实验室人体存在监测中接入智能设备来实现红外/雷达双检测
查看 >>
怎样二次开发智能人体存在雷达传感器2[壁挂]来实现雷达人体微动探测
查看 >>
如何对接壁挂式人体活动监测器以实现雷达人体微动探测
查看 >>