一、背景与概述
在现代办公环境中，节能管理与安全监测是两个密不可分的议题。一方面，办公区域的照明、空调、会议设备在无人使用时持续运行，造成大量能源浪费；另一方面，烟雾火灾隐患需要实时监测，而传统烟感无法区分人员在场与否，容易在无人时漏报或误报。
芯步推出的智能人体存在雷达和烟雾传感器（壁挂），正是为解决这一痛点而设计。该设备集成了24GHz毫米波雷达和烟雾浓度传感器，能够同时实现：
人体存在感知：不仅能检测移动人体，还能识别静止、微动甚至睡眠状态的人体
烟雾浓度监测：实时监测环境烟雾浓度，超标自动告警
开放API接口：提供标准的HTTP API和控制台，支持任何支持HTTP请求的编程语言接入
本文将详细阐述如何将该设备接入自己的软件项目，实现办公场景下的“人来灯亮、人走电断、烟雾联动告警”等智能化能力。
二、设备核心能力解析
在接入之前，需要了解该设备暴露的核心能力。通过芯步平台的开放接口，开发者可以调用以下命令
| 模块 | 命令名 | 功能说明 | 典型应用 |
|---|---|---|---|
| 雷达模块 | radar_enable | 启用/关闭人体雷达探测 | 控制感应开关，有人时开灯 |
| 烟感模块 | mq_enable | 启用/关闭烟雾浓度检测 | 烟雾报警联动、上报浓度数据 |
| 蜂鸣器 | buzzer | 控制蜂鸣器开关 | 本地告警提示（如烟雾超标时蜂鸣） |
此外，设备具备上行消息推送能力：当环境状态变化时（如检测到人体移动、烟雾浓度变化），设备会主动向开发者配置的服务器地址推送实时数据。这意味着开发者无需频繁轮询设备状态，而是被动接收事件，大幅降低接口调用压力。
三、接入准备
3.1 注册与创建工作台
接入的第一步是在芯步平台完成账号注册和工作台创建：
访问芯步官网，点击“立即注册”完成账号注册
登录后进入控制台，点击“创建新的工作台”
进入“物联网控制台”模块，即可开始设备管理
3.2 获取接入凭证
在工作台的“开发设置”中，可以获取到两个核心凭证
AppID：应用的唯一标识，用于构造请求URL
AppSecret：开发者密码，用于生成签名（Sign），保障接口调用安全
3.3 获取设备ID
设备ID是设备的唯一标识，可以在控制台的设备列表中查看，也可以从设备外壳上的标签获取。
四、接口鉴权机制
芯步的开放接口采用双重MD5签名机制，每次API调用都需要携带动态生成的签名和时间戳，防止请求被篡改或重放攻击。
4.1 签名生成规则
签名的计算规则如下
YourSign = md5( md5(AppSecret) + ts )
其中：
AppSecret：从控制台获取的开发者密码ts：当前时间的Unix时间戳（秒级）+：表示字符串拼接
计算步骤
对
AppSecret进行一次MD5加密，得到secret_md5将
secret_md5与时间戳ts拼接为字符串对拼接后的字符串再次进行MD5加密，得到最终的
sign
4.2 代码示例（C语言 / libcurl）
以下是使用C语言和libcurl库调用接口的示例代码
其他语言（Python、Java、JavaScript等）的调用逻辑完全一致，只需按上述规则构造URL和请求体即可。
五、核心功能接入实现
5.1 设备控制（下发指令）
API调用地址格式为
POST http(s)://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}请求体格式（JSON）：
典型命令示例
| 意图 | 命令JSON |
|---|---|
| 开启人体雷达感应 | {"radar_enable":1} |
| 关闭人体雷达感应 | {"radar_enable":0} |
| 开启烟雾检测 | {"mq_enable":1} |
| 触发蜂鸣器告警 | {"buzzer":1} |
注意：接口返回
code:200仅代表平台已接收命令并下发，不代表设备已成功执行。如需确认执行结果，需通过消息推送接收异步反馈。
5.2 接收设备上行消息（事件推送）
设备上报的数据（如探测到人体、烟雾浓度超标）会主动推送到开发者配置的服务器地址，推送格式如下（典型结构）：
推荐架构：在服务器端实现一个HTTP端点接收推送消息，根据设备ID和事件类型触发相应的业务逻辑。
5.3 批量设备与分组控制
当办公区域部署了多台设备时，芯步支持一次请求控制多台设备或通过分组进行统一管理
控制多台设备（device字段用逗号分隔）：
分组控制
POST http(s)://api.thingboot.com/{AppID}/group/control/?sign={sign}&ts={ts}六、典型应用场景方案
6.1 人来灯亮 / 人走电断（节能联动）
业务逻辑：当雷达探测到有人时，自动打开照明和空调；无人持续一段时间后，自动关闭相关设备。
实现流程
在服务器配置消息接收端点，订阅设备的状态上报
当收到
radar.presence = 1的消息时，调用芯步接口向智能插座/开关下发power=1命令当连续N分钟未收到
radar.presence = 1（或收到无人信号），下发power=0关闭设备
关键优化：雷达传感器支持静态人体检测，可以识别在工位上安静工作的员工，避免“人还在、灯却关了”的尴尬。
6.2 烟雾告警 + 本地联动
业务逻辑：烟雾浓度超标时，触发蜂鸣器报警，同时向管理员推送告警通知，并联动切断非必要电源。
实现流程
收到
smoke.alarm = 1的消息立即调用接口下发
buzzer=1命令，启动设备本地蜂鸣告警通过企业微信/钉钉/邮件推送告警通知管理员
（可选）下发
power=0切断办公区域非消防必需电源，防止火灾扩大
6.3 会议管理系统集成
场景：会议室安装该设备后，可实时感知房间是否有人，自动释放未使用的预订。
实现流程
会议预订系统通过API查询设备当前人体感应状态
预订时间开始后15分钟，若雷达持续探测到无人，自动释放该会议室
结合烟雾传感器，会议室无人且烟雾异常时，自动通知安保
6.4 隐私保护方案设计
毫米波雷达传感器不采集任何图像信息，这与摄像头方案有着本质区别。它在保障人员感知能力的同时，完全规避了视频监控带来的隐私争议，更适合部署在办公室、会议室等对隐私敏感的场景。
七、接入注意事项
7.1 设备离线处理
API返回code:200仅表示命令已下发至平台，不代表设备已执行。在接收推送消息时，增加设备心跳检测机制，对长时间离线的设备进行告警。
7.2 签名时效性
签名中携带的时间戳ts用于防重放攻击，通常有5分钟的有效期窗口。确保服务器时间与标准时间同步，避免因时间偏差导致签名验证失败。
7.3 网络与部署选项
芯步接口支持公网和局域网调用，也支持私有化部署。对于对数据安全要求较高的企业，可选择私有化方案，所有数据在企业内部闭环流转。
7.4 并发控制
当办公区域有大量设备同时上报状态时，采用消息队列（如Kafka、RabbitMQ）缓冲处理，避免业务服务器瞬时压力过高。
八、扩展能力与生态整合
8.1 MQTT协议支持
除了HTTP接口，芯步同时支持MQTT协议接入。对于需要高吞吐、低延迟的实时场景（如大量设备同时上报），MQTT是更优选择。发布主题格式为
api/{AppID}/device/control8.2 与智能开关联动
该人体雷达烟感设备可与芯步生态内的智能触摸墙壁开关无缝联动。开发者可以通过同一套API调用开关的power1命令，实现“感应到人→开灯”的完整闭环。
8.3 数据可视化与BI分析
通过持续收集设备上报的人体感应和烟雾数据，可以生成办公区域的热力图、利用率报表、安全态势看板，为办公空间优化提供数据支撑。
九、总结
芯步的“双模”式人体雷达烟感设备，通过开放、标准的HTTP API和控制台，极大降低了办公设备智能化改造的接入门槛。
核心优势
一体双能：一台设备同时解决人体感知和烟雾监测
静态检测：能识别静止人体，避免误关设备
接口标准：HTTP + MQTT双协议，签名机制简单清晰
生态完整：可与智能开关、插座形成联动闭环
接入成本：开发者仅需掌握基础的HTTP请求能力，按文档完成签名计算和接口调用，数小时内即可完成从设备配网到业务逻辑打通的全流程。
本文提供了从设备能力解析、接口鉴权、代码示例到场景的完整方案，开发者可根据实际项目需求，选择性地实现节能控制、安全监测、空间管理等能力模块。