芯步的壁挂式人体移动探测器采用红外+雷达双模检测，能有效过滤窗帘飘动、宠物活动等误报。以下方案涵盖设备选型、API接入、消息处理到联动控制的完整流程，可直接落地到你的项目中。

解决方案：基于芯步开放接口的智能人体感应照明集成

1. 概述

本方案的目标是指导开发者如何利用芯步提供的标准HTTP API，将壁挂式人体存在传感器与照明控制设备（如智能开关/插座） 集成到自有软件系统（Web/App/小程序）中，实现“人来灯亮、人走灯灭”的自动化控制。

相较于传统红外传感器仅能检测大幅动作，本方案采用的设备具备红外+雷达双模检测能力，可感知呼吸等微动作，解决了“人静坐/办公时灯误灭”的痛点。

2. 硬件选型

选型：卫生间、走廊宜用壁挂式；办公室、会议室升级为吸顶式以确保360°检测无死角。执行层需根据照明电路实际路数选择对应规格的智能开关。

3. 集成架构与数据流

采用设备直连云端+服务器联动的架构。芯步的设备开放标准HTTP接口，支持私有化部署，数据可直接推送到你的服务器，无需经过芯步的SaaS层。

时序逻辑说明

1. 触发：人员进入探测区，传感器检测到人从“无人”变为“有人”。

2. 上报：传感器通过HTTP协议向你的服务器上报状态（presence=1）。

3. 逻辑处理：你的后端验证数据有效性，判断时间段（如是否在18:00-06:00）或联动规则。

4. 下发指令：服务器调用芯步的API，向指定的智能开关发送“闭合电路”指令（power=1）。

5. 执行与反馈：开关接通，灯具点亮。传感器在人离开后（如2分钟无人）再次上报，服务器下发关灯指令。

4. 详细集成步骤

4.1 环境准备与设备配网

1. 注册与创建：在芯步官网注册账号，进入控制台创建工作区。

2. 设备添加：在控制台通过“扫码添加”或“手动输入ID”将传感器和开关绑定至账户下。设备ID（Device ID）和AppSecret是后续API调用的凭证。

3. 联网配置：设备采用WiFi直连方式。通电后，设备通常开启热点模式，通过App/小程序为其配置目标WiFi的SSID和密码。设备支持设置5组备用WiFi以增强稳定性。

4.2 API接口对接详解

所有接口请求地址为： http(s)://api.thingboot.com/{AppId}/device/control/

第一步：签名计算为保证安全性，每次请求需携带签名。签名算法为：sign = md5( md5(AppSecret) + ts )其中 ts 为Unix时间戳（秒）。

第二步：接收传感器消息芯步通过HTTP推送或MQTT将传感器数据发送至你配置的服务器地址。

• 数据格式示例

• 关键点：传感器也支持上报环境光强，便于实现“白天不亮灯”的节能逻辑。

第三步：下发关灯指令当收到“无人”消息后，需要执行关灯动作。

• 请求方式：POST

• 请求地址https: //api.thingboot.com/YourAppId/device/control/?sign=xxxx&ts=1712739200

• HeaderContent-Type: application/json

• 请求Body

• 控制多路开关：若为2路开关，命令示例为 {"power1": 0} 或 {"power2": 1}。

4.3 联控逻辑与优化策略

• 防抖处理：在服务端增加“确认机制”。例如：传感器上报“无人”后，延迟30秒再次查询或等待二次上报确认，防止人短暂静止被误判离开。

• 私有化部署：若项目对数据安全要求较高（如政府、保密单位），可启用私有化模式。设备数据通过局域网或专线直接推送到本地服务器，不经过公网。

5. 项目落地优势

• 无需网关：设备直接连接WiFi路由器，降低硬件成本与故障点。

• 开发灵活：API基于标准HTTP协议，无论你的后端是Java、Python还是PHP，甚至是低代码平台，均可快速集成。

• 场景扩展：不仅是照明，该传感器数据还可联动空气净化器、排风扇或用于安防布防。

6. 常见问题排查

• 设备不在线：检查设备供电及2.4G WiFi信号强度。芯步设备支持多组WiFi配置，确保冗余连接。

• 灯误灭：这是由于红外无法检测微小动作，请确认采购的是“红外+雷达”双模版本，并在API中开启雷达探测功能。

• 接口返回200但灯未动：200仅代表指令到达芯步云，不代表设备执行。需检查设备是否真正在线，或订阅异步消息推送以核实执行结果。

通过上述方案，可以快速、稳定地将芯步的硬件能力赋能给自有项目，实现专业级的智能照明控制。