CATALOG

吸顶式红外传感器是智能办公、节能改造中最常用的设备之一——但传统红外传感器有个通病:人坐着不动就“掉线”,灯灭了、空调关了,体验很糟。芯步这款产品的价值在于它的存在感应和可调触发延时,能解决这个问题。下面把接入步骤和几个关键配置讲清楚。

解决方案:怎么接入芯步吸顶式人体感应模块,实现精准的“存在监测”

大家好,今天咱们来聊点实际的。很多人问我,想做一个智能办公室或者回家灯自动开关的场景,用普通的红外传感器老是“误报”或者“漏报”——人坐在工位上不动,灯就灭了,手得跟跳舞似的晃才能亮,体验太差了。

其实,这不光是因为硬件灵敏度,更多是因为没把产品的“接口”和“逻辑”用好。今天我们就拿芯步的 “智能人体存在红外传感器[吸顶]” 为例,手把手教你怎么通过它的开放接口,把它变成一个真正懂你的“存在感应器”。

这里说的“开放接口”,其实就是芯步给开发者提供的 HTTP API设备事件上报机制。不管你是用 Python、Java,还是 Node.js,甚至是用低代码平台,只要你能发 HTTP 请求,就能把它接进来。

下面分三步走,咱们把这事儿说透。

第一步:先认识你的硬件“词库”——物模型

在写代码之前,我们得先看懂这个设备“说什么语言”。在芯步的平台里,这叫物模型。你不用管这词多高深,你就把它当作一个字典。

对于我们这款吸顶式红外传感器,核心就两个属性

  1. 红外感应 (infrared_target)

    • 1 代表 有人

    • 0 代表 无人

    • 注意:普通红外传感器容易在人体微动时误判为无人,但这款通过算法优化,配合下面的“持续时间”设置,能极大缓解这个问题。

  2. 线路控制 (power)

    • 这是一个非常实用的功能。这款传感器带了一路继电器输出,你可以把它理解为里面有一个“开关”。

    • 1 代表 闭合/通电(比如把灯打开)。

    • 0 代表 断开/断电(把灯关了)。

    • 这一点很关键:它不只是一个传感器,它还可以直接控制灯或者喇叭。

第二步:核心配置——“防误报”的秘诀在哪里?

很多人在接入时,只关注怎么拿数据,忽略了配置项。其实,想让这个传感器好用,得先把配置参数写好再接入。这就像给传感器先“定规矩”。

在芯步的控制台或者通过下发配置命令,你可以调整这两个防抖/延时参数

  • 红外有人触发持续时间 (infrared_change_1)

    • 意思是:检测到人之后,保持“有人”状态的时长。

    • :如果你做办公自动化,设置为 01(秒)。这样人一进来,立马触发。

  • 红外无人触发持续时间 (infrared_change_0)

    • 意思是:检测到人离开后,要等多久才把状态改为“无人”。

    • 这是解决“人不动灯灭”问题的核心!

    • 如果你想要比较丝滑的存在感应,可以把这里设置成 60 秒或 120 秒。

    • 逻辑是这样的:人走进去,灯亮了;即使人坐着一动不动,红外没捕捉到信号,因为“持续时间”没到,系统依然判定为“有人”,灯不会灭。这就变相实现了“存在感应”。

第三步:实战对接流程

好了,理论说完了,咱们看看代码和逻辑怎么跑通。

1. 设备怎么“主动说话”(事件上报)

这款传感器是主动型的,它不习惯被人一直问“有人吗?”,而是环境变了它才喊一嗓子。

你需要先在芯步后台设置一个接收数据的URL(比如:http://你的服务器ip/api/infrared)。

当有人进出时,设备会发一个HTTP POST请求过来,数据大概长这样

你的后端要做的:接收这个请求,解析 infrared_target 字段。如果拿到 1,就知道该开空调、开灯、或者记录考勤了。

2. 我怎么“反向控制”设备(下发指令)

有时候,你可能想远程关掉这玩意(比如下班后强制节能),或者手动控制它带的那个“线路”接口。

这就用到 HTTP 接口控制

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

  • 请求方式:POST

  • 鉴权:需要带上签名(Sign),具体算法官方的文档很详细,其实就是把时间戳和你的密钥混一下做MD5加密,防止别人乱控制你的设备。

实战案例:远程关闭红外感应功能如果你想说“传感器你先别报有人了,我要省电”,下发命令如下:

实战案例:手动控制那一路“电源输出”如果你想实现一个场景:按下手机按钮,强制开灯(即使没检测到人)。

这个功能很强大,意味着你省掉了一个继电器或PLC,直接用传感器带220V的灯

总结一下这个方案的“套路”

如果你想做一个稳定、不尴尬的人体感应方案,不要只盯着“1”和“0”这两个数。

  1. 用好 infrared_change_0 这个配置:通过API把“无人确认时间”调长(比如30秒到2分钟),物理层面过滤掉“人微动”造成的误判。

  2. 监听事件,不要轮询:设备是主动报的,你写个接口等着收数据就行,这样服务器压力小,响应也快。

  3. 利用内置输出:如果只是为了联动开关灯,甚至不需要写复杂的逻辑代码,直接用设备自带的 power 命令或者配置 relay_change_1(发现有人时线路动作),让它自己管自己,断网都能用。

只要把这几个接口参数调优一下,这个小小的吸顶传感器,就能让你所在的办公空间变得非常智能。如果还有什么不懂的,可以去芯步官网看具体的手册,他们的文档写得还算详细,而且有在线调试的Demo