一个高性能、高稳定性的跨平台MQTT客户端
一个高性能、高稳定性的跨平台MQTT客户端，基于socket API之上开发，可以在嵌入式设备（FreeRTOS/LiteOS/RT-Thread/TencentOS tiny）、Linux、Windows、Mac上使用，拥有非常简洁的API接口，以极少的资源实现QOS2的服务质量，并且无缝衔接了mbedtls加密库。开源地址：https://github.com/jiejieTop/mqttclient
本次使用TencentOS tiny官方开发板——TencentOS_tiny_EVB_MX_Plus开发板作为移植实验，使用wifi模块连接到云平台。
本次实验需要使用到TencentOS tiny操作系统，大家对于TencentOS tiny操作系统的移植不会的话，
可以看我之前录制的TencentOS tiny视频教程——【全网首发】TencentOS tiny物联网操作系统视频教程，
或者博客文档——TencentOS tiny 移植到STM32F103全教程（基于标准库）。
我们可以将TencentOS tiny官方仓库拉取到你的电脑上，地址是：https://github.com/Tencent/TencentOS-tiny
然后选择一个TencentOS_tiny_EVB_MX_Plus开发板的hello world例程就好了，当然这里面已经有移植完毕的mqttclient例程，我们现在是学习移植过程，就选个helloworld就好了。
可以将它提取出来，我已经把它拿出来了（当然目录结构可能跟官方的有点不太一样，不过不影响我们的移植），目录结构如下：
只有一些比较简单的驱动，我们可以尝试将它编译并且下载到开发板行，跑一遍这个例程，是非常简单的现象：
为了保证网络的底层，我们要移植TencentOS tiny的at框架：
在工程中创建一个文件夹，路径如下：net\at\src，然后将TencentOS-tiny\net\at\src路径下的tos_at.c拷贝到新建的文件夹目录下：
在工程中创建一个文件夹，路径如下：net\sal_module_wrapper，然后将TencentOS-tiny\net\sal_module_wrapper路径下的sal_module_wrapper.c与sal_module_wrapper.h拷贝到新建的文件夹目录下：
在工程中创建一个devices文件夹，然后将TencentOS-tiny\devices路径下的bc35_28_95文件夹与esp8266文件夹以及m26文件夹拷贝到新建的文件夹目录下：
在工程中创建一个文件夹，路径如下：platform\hal\st\stm32l4xx\src，然后将TencentOS-tiny\platform\hal\st\stm32l4xx\src路径下的tos_hal_usrt.c文件拷贝到新建的文件夹目录下：
打开工程，添加at、devices、hal三个分组，具体操作如下：
然后添加相关的文件到分组中，这些文件是我们刚刚拷贝的文件：
tos_at.c、sal_module_wrapper.c文件放在at分组中：
bc35_28_95.esp8266.c文件放在devices分组中：
tos_hal_usrt.c文件放在hal分组中：
添加完成后分组的文件如下：
然后尝试编译，可能会报错，因为相关头文件还没处理好。
拷贝at框架的头文件，在工程目录下创建以下路径的文件夹net\at\include，将TencentOS-tiny\net\at\include路径下的tos_at.h文件拷贝到新建的文件夹目录下：
拷贝了头文件还需要将头文件添加进去到工程中，头文件路径如下：
只需要在stm32l4xx_it_module.c文件的HAL_UART_RxCpltCallback函数中添加以下代码即可：
extern uint8_t data;
if (huart->Instance == LPUART1) {
HAL_UART_Receive_IT(&hlpuart1, &data, 1);
tos_at_uart_input_byte(data);
}
拷贝源码到工程目录下：首先在工程目录下创建一个components\connectivity文件夹，将TencentOS-tiny仓库中路径TencentOS-tiny\components\connectivity下的mqttclient文件夹拷贝到工程中：
在工程中创建分组：mqttclient、mqttclient/mqtt、mqttclient/salof、mqttclient/common、mqttclient/network、mqttclient/platform、mqttclient/config。
添加对应的文件，根据工程分组的目录进行添加即可，因为这些目录与工程分组的目录是一样的：
简单介绍mqttclient仓库文件夹
common文件夹：是一些通用的文件内容，比如链表的处理，错误代码的处理、随机数生成器、日志库等内容。
mqtt文件夹：著名的paho mqtt库。
mqttclient文件夹：实现mqttclient的主要文件，并且包含了一个默认的配置文件。
network文件夹：网络抽象层，封装了mbedtls加密库、网络数据的通道类型，自动选择tls加密传输或者是tcp直连。
platform文件夹：平台抽象层，此处封装了各种平台的内存管理、互斥锁、线程管理、时间管理等内容，如linux平台，freertos平台、rt-thread平台、TencentOS tiny平台等。
添加完成后的分组代码如下：
为工程添加mqttclient的头文件路径
编译代码，发现没有错误，则可以添加对应的例程，在工程目录的BSP\Src文件夹下创将一个mqttclient.c文件，然后添加以下代码：
#include "stm32l4xx_hal.h"
#include "mcu_init.h"
#include "tos_k.h"
#include "esp8266.h"
#include "mqttclient.h"
#define USE_ESP8266
//#define USE_NB_BC35
#ifdef USE_ESP8266
static hal_uart_port_t esp8266_port = HAL_UART_PORT_0;
void mqtt_set_esp8266_port(hal_uart_port_t port) {
esp8266_port = port;
}
#endif
static void tos_topic_handler(void* client, message_data_t* msg)
{
(void) client;
MQTT_LOG_I("-----------------------------------------------------------------------------------");
MQTT_LOG_I("%s:%d %s()...\ntopic: %s, qos: %d. \nmessage:\n\t%s\n", __FILE__, __LINE__, __FUNCTION__,
msg->topic_name, msg->message->qos, (char*)msg->message->payload);
MQTT_LOG_I("-----------------------------------------------------------------------------------\n");
}
void mqttclient_task(void)
{
int error;
char buf[100] = { 0 };
mqtt_client_t *client = NULL;
mqtt_message_t msg;
memset(&msg, 0, sizeof(msg));
#ifdef USE_ESP8266
esp8266_sal_init(esp8266_port);
esp8266_join_ap("wifii", "woshijiejie");
#endif
#ifdef USE_NB_BC35
int bc35_28_95_sal_init(hal_uart_port_t uart_port);
bc35_28_95_sal_init(HAL_UART_PORT_0);
#endif
mqtt_log_init();
client = mqtt_lease();
mqtt_set_port(client, "1883");
mqtt_set_host(client, "www.jiejie01.top"); //111.230.189.156
mqtt_set_client_id(client, random_string(10));
mqtt_set_user_name(client, random_string(10));
mqtt_set_password(client, random_string(10));
mqtt_set_clean_session(client, 1);
error = mqtt_connect(client);
MQTT_LOG_D("mqtt connect error is %#x", error);
mqtt_subscribe(client, "tos-topic", QOS0, tos_topic_handler);
MQTT_LOG_D("mqtt subscribe error is %#x", error);
memset(&msg, 0, sizeof(msg));
for (;;) {
sprintf(buf, "welcome to mqttclient, this is a publish test, a rand number: %d ...", random_number());
msg.qos = QOS0;
msg.payload = (void *) buf;
error = mqtt_publish(client, "tos-topic", &msg);
tos_task_delay(4000);
}
}
void application_entry(void *arg)
{
mqttclient_task();
while (1) {
printf("This is a mqtt demo!\r\n");
tos_task_delay(1000);
}
}
然后将其添加到工程中，最后，编译并下载到开发板上运行，注意需要修改你的wifi账号密码，效果如下：
本次移植教程结束。
可以关注微信公众号：
在后台回复“25”即可获取源代码