CATALOG

这是一份面向开发或集成人员的解决方案指南。我们用比较直白的方式,聊聊怎么把芯步那款吸顶红外版传感器接到你的系统里,专门用来做人移动探测。

1. 准备工作:这个硬件能干什么?

咱们先看看手里这块“砖头”到底有啥能耐。这款吸顶红外版传感器,你可以把它理解为一个会说话的红外眼睛

  • 它能看见啥? 主要靠红外技术探测人体移动(注意,是移动。如果你静坐不动,红外可能觉得你“消失”了,这是红外原理决定的,想要探测静坐得用雷达版)。

  • 它长啥样? 吸顶安装,像个小小的白饼,嵌在天花板里不占地方。

  • 它自带开关? 这玩意儿牛在它带一路AC交流电输出。意思是,它能直接控制 lights、排风扇这些小功率电器。比如“有人开灯,没人关灯”,它自己就干了,不经过服务器也行。

  • 它怎么说话?WiFi 2.4G,直接联网,不需要买网关。它主要通过 HTTP协议 跟你服务器“唠嗑”。

2. 核心思路:怎么抓到“有人”和“无人”?

你要做的核心就是一件事:接收传感器的“主动上报”

这不是你服务器去问“有人吗?”,而是传感器探测到变化后,直接给你的服务器发消息:“哎,有人进来了!”或者“人都走光了,锁门吧!”

流程图大概是这样:

传感器探测 -> 状态变化 -> HTTP推送 -> 你的服务器接收 -> 你的业务逻辑处理(如开灯、弹窗、计数)

3. 详细步骤:从0到1接通数据

第一步:配网(让设备上网)

拿到设备后,需要让它连上你的WiFi。

  1. 下载“芯步”App或者通过他们控制台的配网指引。

  2. 给设备通电,一般会听到“滴滴”声或者灯闪。

  3. 按说明书操作,把WiFi密码告诉它。

  4. 在控制后台,你会看到一个“在线”的设备ID(比如 12345678),记住这个ID,后面有用。

第二步:配置推送地址(告诉设备往哪发数据)

这是最关键的一步。设备探测到人,数据发到哪里去?你需要在你自己的服务器上准备一个公网可访问的API接口(也就是一个URL,比如 http://yourdomain.com/api/sensor/report)。然后,在芯步的控制台里,把这个URL填到“消息推送”设置里。注意: 如果你是本地测试,可以用内网穿透工具(比如Ngrok)把本地的IP映射出去,否则设备找不到你的电脑。

第三步:监听“有人/无人”事件(代码实战)

当有人移动时,传感器会往你刚才配置的URL发送一个 HTTP POST 请求。你需要解析这个请求。

根据官方文档,这个传感器的核心物模型很简单:

属性名标识符值含义触发场景
红外感应infrared_target1 = 有人0 = 无人有人移动人离开(超时后)
线路控制power1 = 通0 = 断你可以下发命令控制
红外开关infrared_enable1 = 开0 = 关远程禁用感应

接收到数据的格式大概是这样的(JSON):

你收到的请求 Body 里,重点是看 infrared_target 这个字段。

你服务器要做的逻辑(伪代码):

注意防抖: 红外传感器有时候会“抽风”或者秒变。你可以自己写程序做个延时判断,比如连续2秒都是“无人”状态,才执行关灯动作,防止人在那站着不动被误判关灯(因为红外只认移动)。

4. 进阶玩法:反向控制(远程开关/手动复位)

作为开发者,你可能不仅想收数据,还想远程控制这个传感器——比如远程关掉它的输出负载,或者远程重启一下。

芯步的接口也很简单,只需要向它的HTTP接口发个命令就行

请求示例(关掉接在传感器上的灯):

  • URL:http(s)://api.thingboot.com/{你的AppId}/device/control/?sign=签名&ts=时间戳

  • Method: POST

  • Body:

关于签名(Sign):官方要求对AppSecret做MD5再拼接时间戳再做MD5,稍微有点绕,直接用官方的SDK或者抄一下示例代码里的加密函数,别自己手搓容易错。开发调试的时候,可以在控制台开“调试模式”暂时忽略签名验证

5. 给你几个避坑(血泪经验)

1. 吸顶安装位置很重要这个设备是吸顶的,探测范围是以它为中心的扇形或圆形。尽量装在房间中央,离空调出风口远一点(热风或冷风可能会干扰红外探测,虽然它有人体过滤,但温差大风速快也会误报)。

2. 关于“存在”与“移动”如果你要做的场景是智能办公,人坐着不动,红外版可能会判断“无人”从而导致关灯。这种场景必须选雷达版(能探测微动呼吸)。红外版更适合楼道、卫生间、安防警戒这种场景——只要人动就有信号。

3. 安全性接收推送的接口加上Token验证,只信任芯步服务器的IP段(可以查官方文档获取固定IP),防止别人伪造“有人”数据来骚扰你的系统。

4. 响应速度这款设备走WiFi直连,实测响应在毫秒级。如果你发现消息有延迟,检查一下设备端的WiFi信号强度(指令可以查询信号值)。信号不好时,数据包会排队。

总结

接入这款吸顶红外传感器,本质上就是个 “Webhook” ——设备主动推,你被动收。你不需要关心底层的WiFi配网细节,只需要搭好一个HTTP接口,盯着 infrared_target 这个字段值的变化去写业务代码就可以了。

搞定数据收发大概也就半小时的事,剩下的时间就去琢磨——拿到“有人”这个信号后,怎么把你的业务场景玩出花来。