共享场所最头疼的就是“人走了空调还开着”、“会议室没人灯还亮着”。芯步这款壁挂式红外雷达双模探测器,核心价值就是解决“精准存在检测”的问题——它不是普通的红外感应器,雷达能探测微动甚至呼吸,人不动也不会误判为无人。
下面我结合它的开放接口,跟你聊聊怎么把它快速接入到自己的项目里。
一、 为什么选这个“铁疙瘩”?聊聊它的硬实力
在动手写代码之前,咱们得先搞清楚这设备能干啥,不然接进去也没意义。这款传感器最牛的地方在于它是 “红外+雷达”双模 的。
红外的局限:普通PIR红外传感器只能感应移动,你坐在工位上敲键盘没问题,但如果你在共享休息室的沙发上午休,呼吸均匀没大动,红外就会判断“无人”,然后“啪”一下把空调关了。这体验很糟糕。
雷达的加持:这款设备加上了雷达模块。雷达能探测到微动,也就是人的呼吸、心跳带来的身体起伏。只要房间里有人,不管动没动,它都认定“有人”。
应用场景很明确:共享办公室、自习室、棋牌室、民宿、甚至公共厕所隔间。你要的就是“人在通电,人走断电”。
二、 核心玩法:设备是怎么跟你“聊天”的?
这款设备不依赖那些复杂的网关或私有协议,它用的是最通用的HTTP协议。这意味着,不管你的后端是Java、Python、Go还是PHP,甚至你用前端Node.js或者Shell脚本,都能轻松“拿捏”它。
整个对接逻辑分为两条线:
设备 -> 你的服务器(数据上报):当传感器检测到“有人”变成“无人”,或者“无人”变成“有人”时,它会主动发一个HTTP请求到你的服务器,告诉你当前状态。
你的服务器 -> 设备(指令下发):你想远程关掉它接的灯,或者查一下现在的状态,你发个HTTP请求过去就行。
下面,我们分三步走,把这两条线跑通。
三、 实操接入:分三步搞定
第一步:准备工作(10分钟搞定)
先去芯步的官网注册一个开发者账号,登录控制台。
创建设备:在控制台里找到“产品/设备”管理,把你的设备SN码添加进来。
配网:给设备通上电(它直接接220V市电)。按照说明书,用微信小程序或者App给设备配网,连上你现场的2.4G WiFi。
获取密钥:这是最关键的一步。在控制台的“开发设置”里,拿到你的
AppID和AppSecret(开发者密码)。AppID相当于你的用户名。AppSecret相当于你的密码,千万别写在客户端代码里。
第二步:设备数据上报(让设备认识你的服务器)
默认情况下,设备检测到状态变化会把数据发到芯步的云平台。但你要自己做项目,肯定希望数据发到你自己的服务器地址。
你需要通过API接口,把设备的数据上报地址(Callback URL)改成你服务器的公网地址(例如 https://yourdomain.com/api/sensor/callback)。
当设备触发时,你的服务器会收到这样的POST数据:
你的后端只需要写一个接口解析这个数据:如果你用的是Python Flask框架,代码大概长这样:
第三步:远程控制与联动(你的服务器操控设备)
光接收数据不够,你还得控制它。比如检测到无人时,你不仅要记录,还要命令它切断输出电源(它自带一路继电器输出,可以直接控制照明或插座)。
接口调用地址:https://api.thingboot.com/{你的AppID}/device/control/?sign={签名}&ts={时间戳}
请求Body:
小提示:cmd 的具体参数(比如 radar_enable、power)在产品的《产品手册》里都有详细说明。
这里有个稍微烧脑但必须搞定的事:签名计算为了安全,芯步的接口要求签名 sign。计算规则是:sign = md5( md5(AppSecret) + ts )
下面是一个JavaScript(Node.js)的示例,帮助理解:
四、 给你的“避坑”指南
关于双模的判断逻辑设备判定“无人”的条件比较严格,是 红外无人 AND 雷达无人 才会报无人。这意味着只要雷达还能感知到呼吸,设备就是“有人”状态。这是好事,因为解决了传统红外“人走灯灭”的痛点,但如果你测试时发现“人怎么一直不走?”,别慌,可能是雷达太灵敏了,可以在控制台调低灵敏度。
网络稳定性这款设备走的是WiFi直连,不需要网关。虽然省事,但你的共享场所WiFi信号不能太差。如果WiFi断了,设备会按照最后接收的指令执行(或者保持本地继电器状态),但没法实时上报数据了。在项目中增加一个“设备心跳检测”,如果设备离线,及时告警。
调试模式在开发阶段,强烈你去控制台打开“调试模式”。开启后,系统会忽略签名校验,你可以直接用Postman测试接口,等逻辑跑通了再把签名算法加上,能省不少事。
私有化部署如果项目涉及数据安全(比如是政府的共享会议室),芯步支持私有化部署。你可以把数据完全存在你自己的服务器上,甚至让设备在纯局域网内运行,不经过外网。
总结
接入芯步的这款双模探测器,本质上就是对接两个API接口。
接收:设备主动告诉你的后端,人来人走。
发送:你的后端根据业务逻辑,发指令让设备通电/断电。
把这个流程跑通,你的共享场所就能实现真正的“无感节能”:人进来,灯亮、空调开;人走(哪怕是躺着不动),灯灭、电断。你的项目用电成本能直接降低一大截,用户体验也更智能。