芯步的吸顶式雷达传感器采用HTTP接口通信，传感器主动上报状态，业务服务器下发控制指令，两者分离但通过联动逻辑串联。以下方案涵盖设备接入、数据接收、指令下发三个核心环节，并提供办公节能和人来舒适两个典型场景的落地实现。

1 项目概述与设计

在智能办公与智慧家庭场景中，“人来灯亮、人走灯灭”是最基础却也最高频的刚需。芯步的吸顶式智能雷达感应开关（人体存在雷达传感器）通过毫米波雷达技术，能够精准探测微动甚至静坐的人体存在，配合其标准化的HTTP API接口，开发者可快速构建跨设备的场景联动控制系统。

本方案的核心设计思路是“传感采集-云端决策-终端执行”的闭环架构。系统无需依赖厂商的封闭App，而是通过芯步提供的开放接口，将雷达传感器与照明、空调、新风等终端设备无缝连接。整体架构分为四层：首先是感知层，即吸顶雷达传感器，负责采集人体存在状态；其次是传输层，通过WiFi 2.4G直连网络，将数据上报至用户自有的服务器；第三层是决策层，即用户的业务逻辑服务器，接收传感器事件并执行联动规则；最后是执行层，包括智能通断器、开关等受控设备，响应指令完成动作。

这种架构的优势在于解耦——传感器只负责“感知”，控制器只负责“执行”，而“决策”权完全掌握在用户自己的服务器手中。相比依赖云端定时轮询的方案，本方案采用状态变化实时推送机制，当雷达探测到有人/无人状态变化时，传感器会立即向服务器推送消息，系统响应速度可控制在毫秒级。

2 设备接入与接口准备

在正式开始对接前，需完成开发环境的初始化配置。芯步平台采用“AppID + AppSecret”的鉴权机制，所有API请求均需携带签名和时间戳，以确保接口调用的安全性。开发者首先需要登录芯步控制台，获取对应的AppID和AppSecret。为便于开发测试，可在“开发设置”中开启调试模式，该模式下系统暂时不校验签名和时间戳，待联调完成后再关闭以保障生产环境安全。

配网是设备接入的首要步骤。吸顶式雷达传感器和智能通断器均支持WiFi 2.4G直连，无需额外网关。通过芯步小程序或控制台，将现场WiFi名称和密码登记到设备中，设备上电后自动连接网络。配网成功后，可在控制台的设备列表中查看到设备ID，该ID是后续所有接口调用中的唯一标识。在配网阶段就为设备设定有意义的名称（如“会议室主灯雷达”、“前台吸顶雷达”），以便后期维护。

接口调用的请求地址为：http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}。所有设备控制均通过POST请求发送JSON格式的命令。值得注意的是，传感器类设备主要为“上行”消息，即主动上报环境状态；而开关、通断器等执行设备主要为“下行”消息，即接收控制指令。理解这一区别，有助于设计正确的联动。

3 雷达传感器事件接收与解析

吸顶式智能雷达感应开关的核心能力在于精准的人体存在探测。与传统红外传感器只能探测移动物体不同，毫米波雷达可以感知微动（如呼吸、心跳引起的胸腔起伏），因此即使人在办公桌前静坐不动，传感器也能准确判断为“有人”状态，不会出现“灵异关灯”的尴尬。

传感器的数据上报采用HTTP请求推送方式。当环境状态发生变化（从无人变为有人，或从有人变为无人），传感器会主动向开发者预设的服务器地址发送POST请求，携带设备ID、当前状态、时间戳等信息。开发者需要在公网或局域网内部署一个接收端点（Endpoint），用于接收并解析这些数据。对于私有化部署场景，芯步还提供了“软网关”方案——在局域网服务器上安装软网关软件，设备自动发现并上报数据，实现纯内网运行。

接收到的数据格式示例如下：

其中，status字段是关键，occupied表示有人，unoccupied表示无人。服务器收到消息后，根据业务逻辑判断需要执行什么动作——是立即关灯，还是延迟一段时间再关，或者同时执行多个设备的联动。

由于传感器上报频率可能较高（尤其是在人员频繁进出的区域），在服务器端设计防抖机制。例如，当连续收到“无人”状态时，仅第一次触发关灯动作，后续相同状态在短时间内不再重复执行，避免频繁调用控制接口造成网络拥堵。

4 场景联动控制指令下发

联动控制的本质是“事件驱动”——当雷达传感器上报特定状态时，服务器向其他受控设备下发执行命令。芯步设备控制接口设计简洁统一，仅需三个核心参数：设备ID（device）、命令对象（order）、以及鉴权信息。

以控制智能通断器AC4-20A为例，该设备支持4路独立输出，每路最大负载4400W，适用于照明、插座、电器等场景。当雷达检测到“无人”状态时，服务器需要向通断器发送关灯指令：

其中power1表示第一路输出，0代表断开（关），1代表接通（开）。对于多路控制场景，可以使用批量控制命令，例如同时关闭第1、3、5、7路：{"batch":{"relay":[1,3,5,7],"power":0}}。

对于需要延时关灯的场景（如走廊、卫生间），可以使用“先通后断”指令。例如，雷达检测到无人后，先执行关灯动作，但保持通断器在延时一段时间后才真正断电，或者直接向支持延时功能的开关下发指令：

该指令表示让第一路先接通（开灯），30秒后自动断开（关灯）。这一特性非常适合楼道、储物间等短暂停留区域，可避免传感器频繁触发导致的灯光闪烁问题。

5 典型场景实现

5.1 办公区智能照明联动

以开放式办公区为例，部署多台吸顶雷达传感器和对应的照明回路。当员工进入办公区，传感器探测到“有人”状态，服务器立即下发指令开启该区域的灯光；员工离开后，传感器上报“无人”，服务器执行关灯。为避免午休或临时外出时误关灯，可设置延迟确认机制——连续上报“无人”状态持续3分钟后再执行关灯。同时，通过服务器端的时段配置，仅在8:00-20:00的工作时间启用自动关灯逻辑，其他时间保持关闭或降低灵敏度。

5.2 会议室无人自动节能

会议室场景对稳定性要求更高。除了联动照明外，还可联动空调、投影仪、新风系统。当最后一个参会人员离开会议室，雷达传感器上报“无人”后，服务器依次执行：关闭投影仪（发送红外码或通过智能插座断电）、关闭照明、将空调切换至节能模式或关闭。为避免临时取物导致设备频繁启停，配置二次确认机制：第一次检测到无人后，启动60秒倒计时；倒计时期间若再次检测到有人，则取消关灯任务；倒计时结束仍为无人才执行全部关闭动作。

5.3 私有化部署与数据安全

对于金融、政企等高安全等级场景，数据必须在内网流转，不可上公网。芯步支持纯局域网私有化部署方案——所有设备连接到内网WiFi，在本地服务器上部署“软网关”软件。设备自动发现并向软网关注册，软网关对内提供统一的HTTP接口。用户的业务服务器调用本地接口即可完成设备控制和状态接收，整个过程不访问外网，确保数据不出园区。该方案同样适用于网络隔离环境下的工厂、仓库等工业场景。

6 调试优化和需要注意的点

在系统上线前，使用Postman或类似工具进行接口联调。芯步提供调试模式，开启后暂时不校验签名和时间戳，简化调试流程。开发者可以先验证雷达传感器的消息推送能否正常接收，再验证向通断器下发指令的执行效果。若设备响应缓慢，需检查WiFi信号强度——传感器距离路由器不宜过远，2.4G频段穿透力较强但易受同频干扰，部署时将WiFi信道调整至1、6、11等干扰较小的信道。

签名计算是接口安全的关键。生产环境下必须关闭调试模式，并按照规则生成sign：将AppSecret、时间戳ts、以及请求参数按字典序排序后拼接，再进行MD5加密。时间戳的有效性设置为5分钟，超时的请求直接拒绝，防止重放攻击。同时，在控制台中配置IP白名单，仅允许业务服务器的出口IP调用设备控制接口，进一步提升安全性。

对于大规模部署（如整栋办公楼），单台服务器可能面临高并发压力。此时可采用消息队列架构：雷达传感器上报的消息先进入队列，消费者服务从队列中取消息并执行联动逻辑。这样既能平滑峰值流量，又能保证联动指令的顺序性——同一区域内的“开灯”和“关灯”指令按时间顺序处理，避免状态错乱。

列举的产品型号及名称：

• 智能人体存在雷达传感器[吸顶]（型号：UNI-CGQ-RT-XD-L）

• 智能通断器AC4-20A

• 芯步软网关[Gateway]

列举的接口地址及API：

• 设备控制接口：POST http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 消息推送接收端：由开发者自建服务器提供URL，用于接收传感器上报数据

需要开发的代码/功能模块：

• 雷达传感器数据接收与解析服务（HTTP Endpoint）

• 场景联动规则引擎（事件→指令映射）

• 设备控制指令下发模块（含签名计算）

• 防抖与延迟确认逻辑

• （可选）私有化软网关配置与调用适配