壁挂式智能雷达烟雾复合传感器集成了雷达存在检测与烟雾浓度监测两大功能，传统部署模式下告警仅能通过设备本地声光或平台内查看，难以融入用户自有运维体系。芯步提供的开放HTTP接口可打通设备数据与业务系统，实现故障告警的自动化外推。以下方案涵盖设计、接口适配、阈值判定逻辑及多渠道通知集成。

解决方案：基于芯步开放接口的传感器故障告警通知二次开发

1. 总体设计思路

本方案的目标是解决“如何及时发现传感器自身故障及环境险情”并推送通知。利用芯步提供的标准HTTP消息推送机制，将设备的实时状态数据接收至用户自建的服务器（本地或云端）。通过后端业务逻辑判断故障类型（设备离线、浓度超限、雷达失效等），对接钉钉、企业微信、短信或内部运维系统，实现秒级告警。

2. 核心技术架构

该方案不依赖特定的App或SaaS控制台，完全基于API进行二次开发，架构包含以下三层：

• 感知层（设备端） ：壁挂式智能雷达烟雾复合传感器（型号UNI-CGQ-RT-L-YW-BG）。设备通过WiFi联网，无需网关，直接与芯步云交互。

• 传输层（开放接口） ：

  • 上行（数据接收） ：采用HTTP推送方式，芯步平台将设备事件实时POST到开发者指定的公网或局域网服务器URL。

  • 下行（状态查询） ：若需主动巡检，调用/device/control/接口下发命令。

• 应用层（自建服务） ：开发者编写的业务服务器，负责解析数据、判断告警逻辑、执行通知发送。

3. 具体实现步骤

3.1 环境准备与接口配置

首先需要在芯步开发者后台（物联网控制台）进行基础配置，这是二次开发的前提：

1. 获取凭证：记录应用的 AppId 和 AppSecret，用于后续接口签名计算。

2. 配置消息推送

   • 在控制台设置“消息推送”方式为 HTTP。

   • 填入接收地址（由开发者提供），例如：https://yourdomain.com/api/yoyo/callback。

   • 保存后，设备上报的任何状态变化（如烟雾值变化、有人/无人触发、心跳包）都会自动转发至此地址。

3.2 数据接收与解析（接收层开发）

服务器的回调接口（Endpoint）需要解析芯步发来的POST请求。根据文档，消息格式如下

开发要点：

• 签名验证：为避免恶意攻击，在解析业务数据前，校验请求头中的签名（Sign），确认数据确实来自芯步平台。

• 解析data字段：根据设备的产品功能定义，data数组中可能包含power（电源状态）、radar_enable（雷达开关/状态）、mq_enable（烟感模块状态）或具体的烟雾浓度数值。

3.3 故障告警逻辑实现（核心逻辑）

这是二次开发的核心价值所在。并非所有上报数据都触发告警，需要开发者编写业务逻辑来判定“故障”。

第一种场景：设备离线/失联告警

• 逻辑判定：服务端需维护一个设备“最后心跳时间戳”。若超过5分钟（或自定义阈值）未收到特定device的任何消息，判定为离线。

• 触发动作：调用通知接口发送“【严重告警】车间A区烟雾传感器已离线，请检查网络供电”。

第二种场景：烟雾超标告警

• 逻辑判定：解析message.data中的烟雾浓度值（如smoke_val）。设定阈值（例如50为预警，100为火警）。

  • 注意：传感器通常具备去抖动机制，但业务层连续两次超过阈值再触发，避免瞬时干扰误报。

• 触发动作：调用钉钉/企业微信机器人发送“【火警】检测到高浓度烟雾，请立即处置”。

第三种场景：雷达模块自检故障

• 逻辑判定：该设备支持雷达人体存在检测。若服务器发现雷达模块状态数据异常（如radar_enable返回值为off但配置应为on，或长时间无任何雷达回波数据且未在睡眠模式），判定为传感器探头故障。

• 触发动作：通知运维人员“设备雷达探头失效，需维护”。

3.4 主动巡检（可选，增强稳定性）

虽然平台支持实时推送，但如果消息因网络抖动丢失，增加主动巡检机制。开发者可主动调用HTTP接口查询设备状态

• 请求地址http(s)://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

• 请求体示例：查询或控制传感器参数。

  { "device": "820720", "order": {"radar_enable": 1} // 询问雷达状态或保持开启 }

• 应用场景：每天凌晨3点定时调用接口，下发查询指令，检测设备是否存活。

4. 通知集成方案（输出层）

解析并确认故障后，利用自建服务器的能力，通过以下标准方式将告警推送给责任人：

1. 企业微信/钉钉/飞书（推荐） ：自建服务调用群机器人Webhook地址，Markdown格式发送告警内容。此方案免费且实时性高。

2. 自定义运维大屏：通过WebSocket将故障状态推送到内部运维看板，实现地图化闪烁告警。

3. 短信/语音呼叫：对接阿里云/腾讯云短信接口。仅针对“烟雾超标”这类最高优先级故障触发，进行电话语音告警。

5. 私有化部署与局域网支持

芯步该系列产品支持私有化部署和局域网通信。

• 实施：如果该方案部署在工厂或涉密单位，且要求数据不出园区，可搭建本地消息服务器。设备WiFi连接本地路由器后，自建服务器直接接收设备消息，完全不经过外网，实现纯内网环境下的故障告警闭环。

6. 总结

通过上述二次开发，可以完全脱离原厂App，实现7x24小时无人值守的智能告警。核心收益在于：

1. 告警内容精准定制：区分设备故障（雷达坏、离线）与环境险情（着火），不同故障对应不同处理流程与责任人。

2. 跨系统联动：故障产生时，不仅发通知，还可联动其他工单系统自动创建维修单。

3. 低代码/快速落地：芯步开放的HTTP接口标准通用，任何具备基础编程能力（Python/Java/C#等）的团队均可在一周内完成原型开发。