如何对接吸顶式存在感应控制器来实现多设备联动控制_解决方案

CATALOG

吸顶式存在感应控制器的核心价值在于“无人时自动关、有人时提前开”，但要实现多设备联动，关键在于如何通过芯步的开放接口打通传感器与执行设备之间的数据通道。以下方案围绕接口对接流程、联动策略设计和落地注意事项展开。

1. 项目理解与目标

在智能办公、智慧病房、共享棋牌室及高端家居场景中，“人来灯亮、人走灯关” 仅是基础需求。真正的智能化要求实现跨设备、跨场景的复杂联动，例如：当传感器检测到“有人存在”时，不仅开灯，还需开启空调、打开新风系统，甚至联动门锁或安防摄像头。

本方案基于芯步智能硬件产品的 HTTP 开放接口，指导开发者或集成商如何对接 吸顶式存在感应控制器（包含雷达/红外版本），并利用后端服务器或云平台作为“大脑”，实现对第三方设备或同生态内执行设备的精准联动控制。

2. 核心技术架构与对接原理

芯步的生态强调 “设备直连云端” 与 “接口标准化” 。设备不依赖复杂的本地网关进行逻辑判断，而是通过 HTTP 协议将状态实时上报至服务器，由服务器端执行指令分发。

2.1 接口机制解析

在对接过程中，必须区分两种不同的 HTTP 交互模式：

上行消息（设备 -> 服务器）：传感数据的获取这是联动的“眼睛”。吸顶式存在传感器在检测到“有人”或“无人”状态变化时，会立即构造一个 HTTP 请求，推送到开发者预设的服务器地址。
- 关键数据字段：包含 device（设备ID）以及 infrared_target（红外目标）或雷达探测的状态值（1 为有人，0 为无人）。
下行命令（服务器 -> 设备）：执行动作这是联动的“手”。服务器在收到传感器的上报后，经过逻辑判断，向灯具、通断器、空调控制器等执行设备发送指令。
- 接口地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。
- 数据格式：JSON，例如 {"device":820720, "order":{"power":1}} 用于开灯。

2.2 对接流程概览

准备阶段：在芯步控制台获取 AppId 和 AppSecret，配置消息接收服务器 URL 。
设备配网：通过小程序或控制台为传感器和受控设备配置 Wi-Fi 。
接口开发：开发消息接收端（处理上报）和指令下发端（控制设备）。

3. 详细对接实施步骤

3.1 环境准备与安全验证

为了保障系统安全，芯步接口采用了签名验证机制。在对接初期，在控制台开启“调试模式”以忽略签名验证，快速验证业务逻辑上线后，请一定要关闭调试模式，并严格实现签名算法（通常是将 AppSecret 与参数排序后 MD5 加密）。

3.2 接收传感器数据（实现联动触发）

你需要搭建一个公网可访问的 HTTP 服务端（支持 POST 方法）。当吸顶传感器探测到状态变化时，它会主动将消息推送到这个地址。

服务器端接收逻辑示例（伪代码）：

3.3 下发控制指令（执行联动）

当服务器判断需要执行动作时，需要反向调用芯步的 API 来控制受控设备。

API 调用详情

URLPOST https://api.thingboot.com/your_AppId/device/control/?sign=xxxx&ts=当前时间戳
HeaderContent-Type: application/json
Body
{ "device": 820721, // 此处为智能通断器或灯光的设备ID "order": { "power": 1 // 1=开，0=关 } }

注：如果是控制窗帘或多路控制器，order 字段需参考对应产品手册修改为 {"power1":1} 或 {"curr_position":50}。

4. 典型联动场景解决方案

基于吸顶式存在感应控制器（以红外版为例），针对不同行业痛点，提出以下三种定制化联动方案：

4.1 第一种场景：办公节能与工位管理

需求：在开放办公区，只有人所在的区域照明和空调开启，无人区域自动关闭。
实施方案
1. 吸顶传感器安装在工位正上方，设置为“有人触发持续时间”为 0（马上反应）。
2. 联动逻辑
  - 传感器上报 infrared_target=1 -> 服务器向 智能通断器AC4-20A 发送 power=1 -> 接通灯具及插座电源。
  - 传感器上报 infrared_target=0 -> 服务器等待 60秒（防止误判，可根据配置项调整）-> 若持续无人，发送断电指令。
- 优势：通过 HTTP 接口修改 infrared_change_0 配置项（如设为 5m），可灵活调整无人关断的延迟时间。

4.2 第二种场景：共享棋牌室/包间自动化

需求：客户进入包间自动通电，下单后自动解锁门禁，客户离开且保洁打扫完毕后自动断电。
实施方案
1. 门锁联动：服务器结合传感器状态（有人）+ 订单支付状态 -> 调用 智能包间控制器 接口 {"power7":"0"}（电磁锁断电开门）。
2. 总闸控制：利用传感器“无人”上报机制。
  - 设备支持配置 relay_change_0（发现无人时线路动作）。开发者可直接利用此硬件特性。
  - 或在云端实现：收到 无人 信号 -> 调用控制器接口 {"batch":{"relay":[1,2,3,4,5,6],"power":0}}，一键关闭麻将机、空调、灯光。
- 优势：批量控制指令减少网络开销，响应更快。

4.3 第三种场景：智慧病房看护

需求：监测病人是否在床上/在房间，联动记录日志或控制夜灯。
实施方案
1. 吸顶传感器（雷达版，可探测微动）高于床位安装。
2. 联动逻辑
  - 夜间时段：传感器上报“有人” -> 服务器控制床底氛围灯带 {"power":1}，亮度设低，避免刺眼。
  - 异常报警：若长时间检测到“有人”在卫生间未移动（根据上报频率判定），服务器可推送告警给护士站。

5. 关键配置优化与性能调优

为了达到最佳的用户体验，请重点调整传感器内置的 配置项

红外无人触发持续时间 (infrared_change_0)
- 场景差异：在办公室设为 1m 或 2m，避免员工静坐时灯光误灭；在卫生间或走廊设为 30s 或 马上，保证节能。
- 配置方式：通过 API 下发配置，或登录控制台在设备详情页修改。
发现无人时线路动作 (relay_change_0)
- 这是一个非常有特色的功能。你可以直接配置传感器 infrared_enable 为开启，并设置 relay_change_0 为 0（关闭），此时传感器本身自带 “检测无人直接断电” 的功能，甚至不需要依赖服务器下发指令。
局域网与广域网通讯选择
- 芯步开放平台支持私有化部署。在对延迟极其敏感（如工业控制）或内网环境中，开启 局域网 模式，设备指令不再经过外网，直接通过内网 IP 下发，可将响应时间控制在 20ms 以内。
混合传感器策略
- 吸顶红外传感器对静态人体（如熟睡、静坐办公）可能存在不敏感的情况。在高要求的场景下，组合使用 红外 + 雷达 “双模”传感器。接口逻辑设置为：红外触发上报或雷达触发上报，均判定为有人，以此消除盲区。

6. 总结

通过对接芯步的吸顶式存在感应控制器，开发者可以轻松构建“中心化”的智能控制系统。利用 /device/control/ 接口与 消息推送 机制，可以将传感侧的“物理信号”无损转化为服务器端的“数字指令”，进而联动任意支持 HTTP 接口的第三方设备。

实施该方案的核心关键在于：正确处理传感器的超时上报机制，避免因响应延迟造成的“人在灯灭”尴尬，并充分利用芯步提供的配置项优化本地执行逻辑，以此实现高效、稳定的智能闭环。