吸顶式存在感应控制器的二次开发,核心思路是利用设备主动推送的“有人/无人”事件作为触发器,结合你自己的业务逻辑来决定联动行为。芯步的开放接口采用HTTP协议,这意味着你可以使用任何编程语言来接收入侵检测数据,并向设备下发控制指令。
以下是具体的实现方案:
1. 二次开发的基础架构
要实现自定义联动逻辑,你需要构建一个独立的服务端应用。这个应用充当大脑的角色,负责接收传感器的数据、执行你的判断逻辑,并最终下发控制指令。
数据流向:吸顶传感器监测到人体存在状态变化(如从“无人”变为“有人”) -> 芯步平台通过HTTP推送将事件数据发送到你的服务器 -> 你的服务器执行自定义逻辑 -> 根据结果向平台发送控制指令 -> 平台下发指令给传感器或其它设备。
核心接口
消息推送接口:你需要提供一个公网可访问的
URL(或使用内网穿透工具如Ngrok进行测试),并在芯步控制台中配置。平台会将设备状态变化主动POST到此地址。设备控制接口:由你的服务器发起请求,调用芯步的API,向指定设备下发命令。
2. 自定义联动逻辑的开发步骤
第一步:环境准备与配置
获取密钥:登录芯步控制台,在“开发设置”中获取
AppId和AppSecret。后续的API调用需要用到这些信息进行签名认证。配置消息推送:在控制台中,将你服务器的接收地址填入“消息推送”设置中。开发阶段先开启“调试模式”,暂时忽略签名验证,专注于逻辑调试。
第二步:解析设备上报的状态
你的服务端需要开发一个接口来接收平台的推送消息。根据吸顶式存在感应控制器的物模型,重点关注的字段如下
| 关键字段 | 数值示例 | 业务含义 |
|---|---|---|
radar_target 或 infrared_target | 1 | 有人存在 |
0 | 无人存在 | |
device | 820720 | 触发事件的设备ID |
例如,当有人进入房间时,你的服务器会收到如下结构的JSON数据:
第三步:核心编码——实现自定义逻辑
这是二次开发的核心部分。你可以基于时间、设备状态、或任意组合条件来实现联动。
场景A:延时关灯逻辑(无人后保持照明一段时间)默认传感器可能在检测到无人后立即上报“无人”状态。如果你的需求是“无人持续2分钟后再关灯”,不能单纯依赖传感器的上报,而应在你的服务端实现。
逻辑:收到“无人”(0)信号 -> 等待120秒 -> 再次调用API查询设备当前状态(或依赖后续上报) -> 如果确认仍为“无人” -> 发送“关灯”指令。
注意:需处理中间有人重新进入导致的“取消延时”情况。
场景B:基于多设备或时间段的联动例如:“晚上10点后,如果客厅传感器检测到有人,不开大灯,只开启夜灯”。
逻辑:接收传感器信号 -> 检查当前时间(如
hour >= 22) -> 如果是真 -> 不执行通用的开灯命令 -> 执行开启特定夜灯设备的命令。
以下是一个使用Python(Flask框架)编写的简单示例,展示如何处理推送并实现自定义逻辑:
第四步:下发控制指令
你的服务器不仅可以控制传感器本身(如开关雷达模块),更可以通过平台控制同一局域网或场景下的任何其他芯步设备。
指令示例:让ID为
820720的吸顶传感器执行打开电源(power:1)。请求方式:你的服务器向
http(s)://api.thingboot.com/{AppId}/device/control/发送POST请求,携带签名、设备ID和命令参数。
3. 高级自定义配置
除了通过你的服务器编程实现逻辑,该传感器自身也提供了一些可配置的配置项,可以减轻你服务端的一些基础过滤工作。
在不需要复杂逻辑(如固定延时)的场景下,优先通过API修改设备配置,这样即使服务器离线,设备也能保持基础联动能力。
| 配置项 | 可选值 | 效果说明 | 适用场景 |
|---|---|---|---|
| 红外无人触发持续时间 | 30, 60, 120... | 检测到无人后,等待30秒才上报“无人”事件 | 减少服务端消息处理量。如果你的逻辑就是X秒后关灯,用这个配置更高效。 |
| 发现无人时线路动作 | 0(关闭) / 1(打开) | 设备自带继电器直接控制线路通断 | 最简单的本地联动。无需开发,传感器直接断电/通电控制灯光。 |
4. 关键注意事项
签名验证:在生产环境中,请一定要验证
sign和ts,防止伪造请求攻击你的服务器。开发阶段可在控制台开启“调试模式”绕过验证以加快开发速度。消息去重:传感器可能因为环境微扰频繁上报“有人/无人”状态。你的服务端逻辑应具备防抖能力,避免短时间内频繁执行关灯开灯动作。
私有化部署:如果你的项目对数据安全要求比较高(如本地化部署),芯步支持完全私有化方案。届时API接口地址会变成你内网服务器的地址,调用逻辑不变。
通过以上架构,你可以将吸顶式存在感应控制器从单纯的“感应开关”升级为高度定制化的“存在感知大脑”,实现如人来灯亮、人走灯灭、人来预热设备、无人自动安防等复杂场景。