CATALOG

芯步这款壁挂式双模传感器很有意思——它自带一路继电器输出,可以直接接灯,但真正的价值是把数据对接到你的软件里,实现“有人开灯、无人关灯、还能统计入住”的完整闭环。下面说说怎么对接。

民宿灯光升级:让壁挂式双模传感器“活”起来的对接方案

痛点:很多民宿房东其实已经用上了这种感应灯,但大多只是让传感器物理上直接控制灯。这其实是个“信息孤岛” —— 灯亮了,你知道有人;灯灭了,你知道没人。但如果客人退房后忘了关走廊灯,或者保洁阿姨在打扫时你需要临时远程送电,物理直连就没辙了。

解决方案思路:我们要做的,就是把传感器当作“眼睛”,把我们的软件项目(小程序、App或管理后台)当作“大脑”,让传感器负责看,大脑负责决定灯怎么亮。

以下是具体的“手把手”对接教程:

1. 先搞清楚硬件底子:它不仅是传感器,还是个“开关”

在动手写代码前,我们先看下墙上这个设备(型号:UNI-CGQ-RT-H-BG)的底细。它其实集成了三个核心功能:

  • 红外传感器:捕捉明显的肢体动作。

  • 雷达传感器:能穿透薄木板、玻璃,感知呼吸这种微动(这个在民宿卫生间特别管用,防止客人蹲坑时灯灭了)。

  • 继电器输出:这是最关键的一点!设备背后有接线柱,直接把照明灯的零火线接上去。

所以,你有两种玩法

  1. 硬逻辑(传统模式): 设备自己判断,有人就接通继电器点灯,没人就断电。这样即使断网,灯也是智能的。

  2. 软逻辑(我们的主题): 断开物理直连(或者并联),把传感器的数据上报到你的服务器,由你的软件发指令控制灯。

我们要做的显然是后者。

2. 对接第一步:接管“眼睛”(配置API回调)

传感器不能说话,你得告诉它“往哪喊”。在芯步的后台,你需要设置数据上报的URL

你的任务:在你的后端(比如Java Spring Boot、Node.js或Python Flask)写一个接收接口。 收到这个请求先别急着关灯。给个5-10秒的延迟。因为雷达有时会因为微动误判,或者客人只是翻个身。延迟判断能大幅减少“灯突然灭了”的投诉。

3. 对接第二步:掌控“手脚”(下发控制指令)

大脑(你的服务器)收到了“有人”的信号,怎么让灯亮呢?芯步的接口非常“友好”,标准的HTTP API,不需要复杂的SDK,直接用你熟悉的语言发POST请求就行

关键代码逻辑(伪代码版):

当你服务端收到传感器上报的 occupied 状态时,立刻调用这个接口:

  • 接口地址https://api.thingboot.com/{你的AppId}/device/control/

  • 核心参数

    • device: 这里填你的灯的ID,而不是传感器的ID。

    • order: {"power": 1} (1代表开,0代表关)

注意: 签名算法看着有点绕(md5(md5(AppSecret)+ts)),封装成一个通用函数,否则容易踩坑

4. 场景:民宿里的“高阶联动玩法”

有了上述对接基础,你可以在软件里实现一些比普通感应灯更聪明的规则:

第一种场景:无人后的“二次确认”单纯的红外经常误判无人(比如客人睡着了没动)。你的后台可以设定:当传感器上报 vacant(无人)时,不立即关灯,而是等待 30秒 再次查询状态。

  • 如果30秒后还是无人 -> 关灯。

  • 如果30秒后变成有人 -> 保持照明,说明刚才客人只是在冥想。

第二种场景:对接PMS系统(房态联动)这是普通物理感应做不到的。

  • 当客人Check-out后:你的软件系统接收到退房指令,无需等待传感器上报,直接主动下发命令 {"power": 0} 强制断电,并把传感器设置为“节能模式”。

  • 当保洁进入时:保洁App打卡,系统临时关闭该房间的感应关灯逻辑,防止保洁阿姨在打扫厕所时灯灭了。

第三种场景:利用雷达做“主动欢迎”普通的红外感应距离短且容易受温度影响。这个雷达能测5米。当客人在走廊还没刷卡开门时,雷达就已经捕捉到了靠近的信号。你的软件可以提前把走廊的灯调到50%亮度,或者联动智能音响播报:“欢迎回来,已为您开启廊灯。”

5. 避坑指南(划重点)

在实际布线写代码时,这几个点请注意:

  1. 接线是关键:此设备是 AC交流电(100-250V) 供电。接线前请一定要断电!如果要实现“传感器只提供信号,软件控制灯”,不要把灯的负载线接在传感器的输出端,应该接在智能墙壁开关,传感器只需接零火线供电即可。

  2. WiFi只支持2.4G:现在很多民宿是混合组网。如果设备连不上网,八成是连了5G信号。记得让配网的手机/后台开放2.4G频段

  3. 雷达的“穿墙”烦恼:雷达灵敏度高,能探测到玻璃和薄木板,也可能探测到门外走廊经过的人。调整安装位置,或者在芯步后台适当降低雷达灵敏度(如果有此配置项),不然可能会因为门外有人路过导致误判有人

总结

通过芯步的HTTP API,把双模传感器对接到你的软件系统,本质上是解耦 —— 让“感知”和“执行”分离。你不需要改动硬件电路,只需要在你的服务器上维护一张简单的映射表: “传感器ID” 对应 “灯具设备ID” ,然后利用API做中转即可。

这样的话,即使远在异地,你也能看到每间房的人体活动热力图(脱敏后),判断客人的作息,从而实现更精细化的能耗管理。