RyanMqtt 期望社区试用、测试、提issue

发布于 2022-12-01 10:32:11 浏览：877 订阅该版

[tocm]

## RyanMqtt
github: https://github.com/Ryan-CW-Code/RyanMqtt
**已经可以再env直接添加了，如果没有搜到可以更新下软件包索引.**
### 介绍
RyanMqtt 实现了 MQTT3.1.1 协议的客户端。此库针对资源受限的嵌入式设备进行了优化。
初衷：在使用RT-Thread时，没有非常合适的 mqtt 客户端。项目中 mqtt 又是非常核心的功能。随即参考 MQTT3.1.1 标准和项目需求设计的 mqtt 客户端，它拥有以下特点。

- 严格遵循 MQTT3.1.1 协议标准
- 应该是非常稳定的 QOS2 / QOS1 消息实现。用户可控的消息丢弃，避免 QOS2 / QOS1 消息无限重发消耗的内存空间
- 丰富的、可配置的事件回调函数和多功能参数配置，满足实际项目的绝大部分需求
- 支持多客户端
- 完整的 MQTT3.1.1 通配符支持
- 可选择的内部心跳保活、掉线重连、遗嘱消息等
- 跨平台，只需实现少量的平台接口即可
- 更高的并发能力，无等待的连续 200 条 QOS2 消息稳定发送和接收(也取决于硬件收发能力)
- 没有内置 TLS 支持，用户可以在接口层实现 TLS（作者对 TLS 并不熟悉、项目中也暂未使用到）
- 不支持裸机平台，裸机想要稳定的 MQTT3.1.1 实现可以参考coreMQTT

### 示例
RT-Thread 平台
接口示例请参考platform/rtthread文件夹
RyanMqtt使用示例请参考 example 文件夹
需要使能 SAL 或者 LWIP，示例使用 socket 实现数据收发。
需要MSH组件，示例默认挂载到MSH组件
其余平台暂无示例

### 依赖
RT-Thread 内置 ulog 组件，方便的使用 ulog api 来管理 RyanMqtt 打印信息
如果没有使能 ulog 或者非 RT-Thread 平台，用户需要手动修改 RyanMqttLog.h 文件调整打印等级。

### 声明
请勿将此库QOS消息等级用于支付等可能造成重大损失的场景，如需使用请自行深度评估后使用，作者不对使用此库造成的任何经济损失负责。（尽管此库QOS2消息等级经过很多测试，但是异步组件由于诸多因素例如波动非常大的网络甚至无法建立稳定的tcp连接、mqtt服务端的策略配置等，无法做到绝对的实时性，需要用户手动做到数据的最终一致性。）

**此库为疫情封控一个星期时间写的，本人能力有限，也还没有经过大量全覆盖测试(条件不允许，现在还没解封)。
肯定还有大量问题和不完善的地方，期待社区多用用RyanMqtt发现问题提issue。解决速度应该很快**😬