Administrator
发布于 2026-01-18 / 1 阅读
0
0

ThingsBoard MQTT 总结

00、概述

在 ThingsBoard 中,MQTT 是最常用、最核心的设备通信协议。它轻量、稳定、实时性好,非常适合传感器、DTU、边缘网关等设备的数据上报与控制。

核心特点

  • 使用 Token 作为 MQTT 用户名(无需密码)

  • Topic 以 v1/devices/me 为核心

  • 数据统一采用 JSON 格式

  • 支持:

    • 数据上报

    • 属性同步

    • 服务器下发控制

    • 设备状态感知

01、主题分类表

分类

Topic

方向

用途说明

遥测数据上报

v1/devices/me/telemetry

设备 → 平台

核心数据通道。用于设备上传传感器读数、状态等时序数据。

v1/devices/me/telemetry

设备 → 平台

带时间戳的遥测。用于补传历史数据或指定精确时间点。

属性管理

v1/devices/me/attributes

设备 → 平台

上报客户端属性。上报设备自身的状态、版本等属性。

v1/devices/me/attributes

设备 → 平台

上报设备声明。上报设备的静态信息,如型号、能力等。

v1/devices/me/attributes/request/{id}

设备 → 平台

请求服务端属性。设备主动向平台请求配置、参数。

v1/devices/me/sub

平台 → 设备

接收属性更新。订阅此主题以接收平台下发的服务端属性变更。

远程控制与响应

v1/devices/me/sub

平台 → 设备

接收RPC指令。订阅此主题以接收平台下发的远程过程调用命令。

v1/devices/me/rpc/response/{id}

设备 → 平台

回复RPC结果。设备在执行RPC命令后,向平台回复执行结果。

设备生命周期

v1/devices/me/telemetry

设备 → 平台

上报在线状态(可选)。可通过上报特定字段标记设备在线。

(MQTT遗嘱,LWT)

设备 → 平台

设置离线遗嘱。在MQTT连接时设置,设备异常断开时平台自动标记为离线。


评论