芯步的吸顶式智能感应控制器支持红外与雷达双模检测，通过开放HTTP接口可快速对接至您的照明项目。以下方案涵盖设备选型、接口对接、联动逻辑与部署配置。

解决方案：基于芯步开放接口的智能家居人体感应照明系统对接

1. 项目分析与设备选型

在智能家居或办公照明项目中，实现“人来灯亮、人走灯灭”是核心刚需。要将其对接到您的自有项目中（如APP、SaaS平台或PC端软件），关键在于利用芯步设备开放的 HTTP API 接口 与 实时消息推送机制。

硬件选型：采用 吸顶式智能人体存在传感器（雷达/红外双模版）。相较于普通红外传感器，它具备以下优势：

• 双模检测：融合红外和雷达技术，能识别人体微动（如呼吸、心跳），避免常规传感器在人体静止时误判为“无人”而导致灯光熄灭。

• 高灵敏度：检测距离可达5米以上，360度无死角覆盖，适合安装在会议室、走廊或卫生间吊顶中央。

• 产品化成熟度：该产品具备标准的“线路”（power）控制属性，可直接关联灯具，也能通过接口读取“红外感应”（infrared_target）状态。

2. 对接设计

为了让您的服务器能够控制并接收设备状态，需要建立如下双向通信架构：

• 控制链路（下行）：您的服务器 $\rightarrow$ 芯步云端 API $\rightarrow$ 吸顶传感器（执行开灯/关灯）。

• 状态上报链路（上行）：吸顶传感器（探测到有人/无人）$\rightarrow$ 芯步云端 $\rightarrow$消息推送$\rightarrow$ 您的服务器接收地址。

该架构支持公网和局域网通信，即使在互联网断开的情况下，只要本地网络通畅，设备依然能响应控制指令。

3. 核心对接流程详解

3.1 基础准备：获取关键凭证

在开始编码前，请在芯步控制台完成以下准备工作：

1. 获取 AppId 和 AppSecret：这是您的应用在云端的唯一标识。

2. 获取 Device ID：将吸顶传感器配网添加后，在设备列表中查看其对应的设备ID（例如 820720）。

3. 配置消息推送URL：在控制台设置您的服务器公网回调地址（例如 https://yourdomain.com/api/yoyo/callback），用于接收设备上报的数据。

3.2 下行控制：实现开关灯指令

通过 HTTP 请求向设备下发命令。接口地址格式为：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名机制：为确保安全性，每次请求需携带签名 sign 和时间戳 ts。通常算法为 md5(AppSecret + ts) 或平台约定的具体格式。

业务场景示例：假设您正在开发管理后台，需要手动关闭某个会议室的灯。

• 请求方式： POST

• Content-Type： application/json

• 请求体

• 代码逻辑：发送上述请求后，如果返回 {"code":200}，代表指令已成功下发给设备，设备将在约100ms内执行。

进阶功能：

• 批量控制device 字段支持逗号分隔，可同时控制同一区域的多台设备。

• 特征透传：在 order 中加入 extra 字段（如 {"power":0,"extra":"scene_off_001"}），云端推送结果时会原样返回，方便您对账或追踪指令。

3.3 上行感知：接收“有人/无人”事件

这是实现自动化的核心。您无需轮询设备状态，设备检测到环境变化时会主动推送。

接收方式：当传感器探测到有人进入或无人离开时，芯步云端会向您预设的 URL 发送 POST 请求。

数据解析示例：

业务处理逻辑：

1. 您的服务器接收到 infrared_target=1（有人）。

2. 触发联动：您的服务器解析到“有人”事件后，切勿立即循环发送开灯指令（避免死循环）。正确的做法是：您的逻辑判断当前是否是“关灯”状态，若是，则调用上文3.2的下行接口 {"power":1} 开启照明。

3. 防抖动处理：配置传感器的“无人触发持续时间”，设置为30秒或1分钟。即确认无人离开持续30秒后，服务器才收到“无人”信号，再下发关灯指令。这可以避免因人体短暂离开（如拿快递）导致的频繁关灯开灯。

3.4 设备物模型深入解析

为了更好地自定义功能，理解物模型是关键。对于吸顶传感器，主要有以下可调属性

4. 典型场景解决方案落地

场景A：纯本地自动化（无需服务器介入）如果您项目较小或网络不稳定，可在配网时通过API一次性配置传感器的内部逻辑：

• 配置指令：下发 {"relay_change_1": 1}（发现有人时自动闭合线路开灯）和 {"relay_change_0": 0}（发现无人时自动断开线路关灯）。

• 结果：配置成功后，传感器完全本地运行，即使断网也能实现人来灯亮，只需在需要统计日志时上报状态到云端。

场景B：云端智能联动（复杂的SaaS管理）对于办公楼租户计费或安防联动，必须经由服务器处理：

1. 安防模式：下班时间段，若传感器上报“有人”，您的服务器不亮灯，而是触发摄像头录像或推送告警给安保人员。

2. 节能策略：服务器统计每个传感器上报的“无人时长”，若超过2小时，除关灯外，联动智能插座切断饮水机、电脑电源，实现深度节能。

5. 注意事项与最佳实践

• 接口超时与重试：控制指令返回200仅代表云端收到，若设备当时离线（如刚重启），指令会失败。您的项目针对关键控制指令实现“查询设备状态”或“重试队列”机制。

• 私有化部署需求：如果您的项目对数据隐私要求比较高（如政府、军事单位），芯步支持 私有化部署。设备数据直接上报到您指定的私有 MQTT Broker 或网关，不经过芯步官方云，接口协议不变。

• 调试技巧：利用芯步控制台的“设备调试”功能，先手动发送 {"system":"network"} 命令查看设备信号强度，确保安装位置 Wi-Fi 覆盖良好，避免因信号问题导致指令延迟。

通过以上步骤，您可以利用芯步标准的 HTTP API 和消息推送机制，快速将吸顶式智能感应控制器无缝集成到您的智能家居照明管理系统中。