目前 RT-Thread 的 paho-mqtt 软件包，是基于 pahomqtt 1.1.0 设计的一套 MQTT 客户端程序。从实际使用中，和论坛反馈中出现如下问题：
-
只支持 Qos=1，不支持 Qos=0 和 Qos=2 的情况；
-
数据发送可能出现粘包情况；
-
功能配置较少，且资源占用较高；
针对上述 mqtt 软件包实际使用问题，RT-Thread 推出 mqtt2.0 版本软件包，即 uMQTT 软件包，符合 MQTT 3.1.1 协议规范，并完善之前存在问题。
uMQTT 软件包介绍
框架图
功能特点
保活机制
-
uMQTT 具有心跳断连，短时间内重试心跳连接功能
-
避免短时间内大量订阅发布消息与心跳请求冲突
重连机制
多种重连机制，为您网络连接的稳定性保驾护航。
- 连接过程中，连接失败进行多次重连尝试
- 保活机制失败后，进行多次重连尝试
- 数据接收失败后，进行多次重连尝试
多客户端
- 同时兼容多个客户端运行工作，便于同个设备连接多个服务器
同步异步
支持用户在复杂情况下订阅发布的需求。
- 支持同步订阅发送功能，保证开发请求数据同步
- 异步订阅发送，资源开销小，系统任务运行速率更高。
QOS 0/1/2
- 完美支持 QOS 0/1/2 的订阅发布请求，让用户不用再关心信息的重发机制，直接交给软件包处理
订阅发布
- 支持基本的订阅发布功能，实现 mqtt 协议规定功能
多功能参数可配置可裁剪
-
重连时间间隔、重连次数、心跳周期、最大订阅数量、保活机制、重连机制等等参数功能可裁剪可配置，满足开发者再复杂、简单等各种开发环境下的使用需求
资源占用小
- 所有功能开启，占用空间足够小，适用低资源的 MCU
接口简单，使用方便
- 每个功能都有独立的接口，接口简单但功能完善，让开发者用最少的接口实现各类需求。
各类软件包对比
uMQTT 软件包获取
-
menuconfig 配置获取软件包和示例代码
打开 RT-Thread 提供的 ENV 工具，使用 menuconfig 配置软件包,
启用 uMQTT 软件包，并配置使能测试例程 (Enable MQTT example), 如下所示:
1RT-Thread online packages
2 IoT - internet of things --->
3 [*] umqtt: A light weight, powerful, customizable, easy-to-use and embeddable mqtt client for RT-Thread. --->
4 [*] Enable MQTT example # 开启 UMQTT 例程
- 使用 pkgs --update 命令下载软件包;
相关文档
- uMQTT 软件包地址：https://github.com/RT-Thread-packages/umqtt.git
- uMQTT 介绍文档地址：https://github.com/RT-Thread-packages/umqtt/blob/master/README.md