CATALOG

共享场所最头疼的就是“人走了空调还开着”、“会议室没人灯还亮着”。芯步这款壁挂式红外雷达双模探测器,核心价值就是解决“精准存在检测”的问题——它不是普通的红外感应器,雷达能探测微动甚至呼吸,人不动也不会误判为无人。

下面我结合它的开放接口,跟你聊聊怎么把它快速接入到自己的项目里。

一、 为什么选这个“铁疙瘩”?聊聊它的硬实力

在动手写代码之前,咱们得先搞清楚这设备能干啥,不然接进去也没意义。这款传感器最牛的地方在于它是 “红外+雷达”双模

  • 红外的局限:普通PIR红外传感器只能感应移动,你坐在工位上敲键盘没问题,但如果你在共享休息室的沙发上午休,呼吸均匀没大动,红外就会判断“无人”,然后“啪”一下把空调关了。这体验很糟糕。

  • 雷达的加持:这款设备加上了雷达模块。雷达能探测到微动,也就是人的呼吸、心跳带来的身体起伏。只要房间里有人,不管动没动,它都认定“有人”。

应用场景很明确:共享办公室、自习室、棋牌室、民宿、甚至公共厕所隔间。你要的就是“人在通电,人走断电”。

二、 核心玩法:设备是怎么跟你“聊天”的?

这款设备不依赖那些复杂的网关或私有协议,它用的是最通用的HTTP协议。这意味着,不管你的后端是Java、Python、Go还是PHP,甚至你用前端Node.js或者Shell脚本,都能轻松“拿捏”它

整个对接逻辑分为两条线:

  1. 设备 -> 你的服务器(数据上报):当传感器检测到“有人”变成“无人”,或者“无人”变成“有人”时,它会主动发一个HTTP请求到你的服务器,告诉你当前状态。

  2. 你的服务器 -> 设备(指令下发):你想远程关掉它接的灯,或者查一下现在的状态,你发个HTTP请求过去就行。

下面,我们分三步走,把这两条线跑通。

三、 实操接入:分三步搞定

第一步:准备工作(10分钟搞定)

先去芯步的官网注册一个开发者账号,登录控制台。

  1. 创建设备:在控制台里找到“产品/设备”管理,把你的设备SN码添加进来。

  2. 配网:给设备通上电(它直接接220V市电)。按照说明书,用微信小程序或者App给设备配网,连上你现场的2.4G WiFi

  3. 获取密钥:这是最关键的一步。在控制台的“开发设置”里,拿到你的 AppIDAppSecret(开发者密码)

    • 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_enablepower)在产品的《产品手册》里都有详细说明

这里有个稍微烧脑但必须搞定的事:签名计算为了安全,芯步的接口要求签名 sign。计算规则是:sign = md5( md5(AppSecret) + ts )

下面是一个JavaScript(Node.js)的示例,帮助理解:

四、 给你的“避坑”指南

  1. 关于双模的判断逻辑设备判定“无人”的条件比较严格,是 红外无人 AND 雷达无人 才会报无人。这意味着只要雷达还能感知到呼吸,设备就是“有人”状态。这是好事,因为解决了传统红外“人走灯灭”的痛点,但如果你测试时发现“人怎么一直不走?”,别慌,可能是雷达太灵敏了,可以在控制台调低灵敏度。

  2. 网络稳定性这款设备走的是WiFi直连,不需要网关。虽然省事,但你的共享场所WiFi信号不能太差。如果WiFi断了,设备会按照最后接收的指令执行(或者保持本地继电器状态),但没法实时上报数据了。在项目中增加一个“设备心跳检测”,如果设备离线,及时告警。

  3. 调试模式在开发阶段,强烈你去控制台打开“调试模式”。开启后,系统会忽略签名校验,你可以直接用Postman测试接口,等逻辑跑通了再把签名算法加上,能省不少事。

  4. 私有化部署如果项目涉及数据安全(比如是政府的共享会议室),芯步支持私有化部署。你可以把数据完全存在你自己的服务器上,甚至让设备在纯局域网内运行,不经过外网

总结

接入芯步的这款双模探测器,本质上就是对接两个API接口

  1. 接收:设备主动告诉你的后端,人来人走。

  2. 发送:你的后端根据业务逻辑,发指令让设备通电/断电。

把这个流程跑通,你的共享场所就能实现真正的“无感节能”:人进来,灯亮、空调开;人走(哪怕是躺着不动),灯灭、电断。你的项目用电成本能直接降低一大截,用户体验也更智能。