芯步的壁挂式存在感应传感器采用WiFi直连方式，开放HTTP接口，支持数据上报和设备控制双向通信。以下方案涵盖硬件选型、API对接架构、签名算法实现，以及“人来控制灯”的完整联动逻辑。

解决方案：基于芯步开放接口的壁挂式存在感应控制器智能化接入

1. 背景与选型

在许多智能化改造场景中，传统的红外传感器往往无法精准识别静态人体（如办公久坐、卫生间如厕），容易造成“人还在，灯灭了”的尴尬。而芯步的壁挂式存在感应传感器（型号：UNI-CGQ-RT-H-BG） 基于雷达技术，能够探测微动甚至呼吸。

核心优势：

• WiFi直连：无需网关，减少设备故障点和成本 。

• 开放API：提供标准HTTP接口，无论你的后端是Java、Python还是Node.js，甚至是纯前端应用，均可直接调用 。

• 私有化部署：数据可完全走局域网或私有服务器，保障隐私安全 。

2. 整体设计

为了实现“感应到人 -> 触发动作”的闭环，我们不能仅依赖传感器单向上报，还需要你的后台具备控制能力。以下是推荐的标准架构：

graph TD
    Sensor[壁挂式存在传感器] -->|HTTP POST / 有人/无人事件| Your_Server[你的业务服务器]
    Your_Server -->|逻辑判断: 持续时间/时间段| Your_Server
    Your_Server -->|HTTP请求 / 控制指令| Actuator[执行器设备
智能开关/插座/喇叭]
    Actuator -->|执行动作| Light_Fan[灯光/排风扇/报警器]

数据流向解析：

1. 上行（数据上报）：传感器探测到“有人”或“无人”时，主动向你的服务器推送状态。

2. 逻辑处理：你的服务器接收数据，判断是否满足联动条件（例如：无人持续时间超过1分钟）。

3. 下行（设备控制）：服务器向芯步的执行器（如智能墙壁开关）发送指令，闭合或断开电路。

3. 接入开发核心步骤

3.1 基础准备：注册与凭证

在芯步控制台完成以下操作：

1. 注册企业/个人账号，获取 AppId 和 AppSecret。

2. 将壁挂式传感器配置到现场2.4G WiFi网络（传感器支持预设5组WiFi，信号自动切换）。

3. 记录下设备的 Device ID（例如：820720），后续接口调用需要此ID。

3.2 接收数据：配置消息推送（最关键步骤）

芯步使用 HTTP POST 请求将传感器消息推送到你指定的公网或局域网URL。你需要在服务端准备一个接口（例如：http(s)://你的域名/api/sensor/callback）来接收数据。

• 如何配置：在控制台中，将你的服务器回调地址填入“消息推送”设置中。

• 接收的数据格式示例当传感器探测到状态变化时，你的接口会收到如下JSON数据：

  { "device": "820720", // 设备ID "type": "deviceReport", // 消息类型:设备上报 "data": { "radar": "1", // 雷达探测状态: 1=有人, 0=无人 "humidity": 45.2, // 湿度 "temperature": 24.5, // 温度 "light": 320 // 光照强度 }, "time": 1700000000 }

• 开发要点

  • 验签：为防止伪造请求，验证请求头中的签名或来源IP（根据平台文档实现）。

  • 响应：收到推送后，你的服务器需尽快返回字符串 success（通常是HTTP 200状态码），否则平台会重试推送。

3.3 下发指令：控制灯光或电器

当你的逻辑层判断需要开灯/关灯时，需要调用芯步的设备控制接口。

• 请求地址： https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求方式：POST

• 签名算法sign = md5( md5(AppSecret) + ts )

• 代码示例（以JavaScript/Node.js为例，其他语言逻辑相同）

  const crypto = require('crypto'); // 配置参数 const AppId = "你的AppId"; const AppSecret = "你的AppSecret"; const DeviceId = "智能开关的设备ID"; // 1. 生成签名 const ts = parseInt(Date.now() / 1000); // 当前时间戳 const md5Secret = crypto.createHash('md5').update(AppSecret).digest("hex"); const sign = crypto.createHash('md5').update(md5Secret + ts).digest("hex"); // 2. 构建请求 const url = `https://api.thingboot.com/${AppId}/device/control/?sign=${sign}&ts=${ts}`; const body = { device: DeviceId, order: { "power": 1 } // 1为开，0为关 }; // 3. 发送请求 (使用axios示例) axios.post(url, body, { headers: { 'Content-Type': 'application/json' } }).then(response => { console.log("控制成功", response.data); });

4. 实战场景逻辑编排：人走灯灭与节能

结合上述上下行链路，以下是实现“卫生间/走廊智能化”的推荐逻辑流程：

进阶逻辑（结合光照度）：传感器也上报 light 字段。如果 light > 500 (光线充足)，即使有人，服务器也不下发开灯指令，最大限度节能。

5. 私有化与局域网部署（针对高安全项目）

如果你的项目运行在纯内网（如涉密单位、无公网IP的工厂），芯步支持私有化部署。

1. 自建MQTT/HTTP Broker：芯步设备允许配置自定义的服务器地址。

2. 修改配置：在设备配网时，将服务器地址指向你的内网IP（例如：192.168.1.100:8080）。

3. 结果：所有数据在内网流转，不经过外网，延迟进一步降低（可低至10ms级）。

6. 常见问题与排障

• 设备不在线怎么办？

  • 检查WiFi是否为2.4G（不支持5G频段）。

  • 确认传感器供电正常。

  • 利用平台的“心跳”机制检测设备最后活跃时间 。

• 如何区分“移动”和“存在”？

  • 芯步的雷达传感器具备参数灵敏度调节，如果场景需要探测微动（如挥手），可以保持默认；如果需要探测静坐呼吸，需在购买前确认该型号支持超低灵敏度模式。

• 接口调用返回签名错误？

  • 检查 ts (时间戳) 是否与服务器时间相差过大（一般允许5分钟内）。

  • 确认MD5计算顺序：先MD5(AppSecret)，拼接ts，再整体MD5。

通过上述方案，你可以在几个小时内完成从硬件配网到代码联调的全过程，将现成的工业级传感器无缝融入你的自有系统中。