如何在鸿蒙系统中移植Paho-MQTT实现MQTT协议

MQTT 是当前最主流的物联 通信协议，需要物联 云平台，例如华为云、阿里云、移动 OneNET 都支持 MQTT。而 Hi3861则是一款专为 IoT 应用场景打造的芯片。

图片来自 Pexels

本节主要讲如何在鸿蒙系统中通过移植第 3 方软件包 Paho-MQTT 去实现 MQTT 协议功能，最后会给出测试验证。为后续的物联 项目打好基础。

友情预告，本节内容较多，源码也贴出来了，大家最好先看一遍，然后再操作一次。

相关源码已经打包上传，顺便上传了一个测试 OK 的固件，大家可以直接下载附件直接测试。解压后会得到 5 个压缩包，继续解压即可：

MQTT 介绍

MQTT 全称为 Message Queuing Telemetry Transport（消息队列遥测传输）是一种基于发布/订阅范式的二进制“轻量级”消息协议，由 IBM 公司发布。针对于 络受限和嵌入式设备而设计的一种数据传输协议。

MQTT 最大优点在于，可以以极少的代码和有限的带宽，为连接远程设备提供实时可靠的消息服务。

作为一种低开销、低带宽占用的即时通讯协议，使其在物联 、小型设备、移动应用等方面有较广泛的应用。

MQTT 模型如图所示：

更多 MQTT 协议的介绍见上篇文章：MQTT 协议开发入门。

移植 Paho-MQTT 软件包

下载 paho mqtt 软件包，添加到鸿蒙代码中

paho mqtt-c 是基于 C 语言实现的 MQTT 客户端，非常适合用在嵌入式设备上。

首先下载源码：

下载之后解压，会得到这么一个文件夹：

我们在鸿蒙系统源码的 third_party 文件夹下创建一个 pahomqtt 文件夹，然后把解压后的所有文件都拷贝到 pahomqtt 文件夹下。

目录结构大致如下：

下一步，我们在 pahomqtt 文件夹下面新建 BUILD.gn 文件，用来构建编译。

其内容如下：

让 hi3861编译的时候，编译 paho mqtt软件包

打开 vendorhisihi3861hi3861BUILD.gn 文件。

在 lite_component(“sdk”) 中增加 “//third_party/pahomqtt:pahomqtt_static”。

修改后文件内容如下：

完成以上修改后，就可以开始编译了，然而很不幸的…你会发现好多编译 错。

不过没事，我们来一个一个解决。

移植，修改编译 错

打开 third_partypahomqttMQTTPacketsamplestransport.c 文件，这个文件也是我们主要移植的文件，我们需要实现 socket 相关的操作，包括发送、接收数据。

其实移植就 3 步：

首先我们导入几个头文件：

其次修改 transport_sendPacketBuffer 函数，内容修改后如下：

后面编译的时候会 错说 close 函数不存在，我们修改 transport_close 函数，修改后内容如下：

修改完 transport.c 文件后，大家编译的时候估计会遇到很多编译错误，都是某个局部变量未使用那种，大家可以修改就行。

类似于这样的，提示 buflen 未使用的错误，大家只需要在代码中随便写个buflen = buflen; 即可。

编写测试代码

测试代码比较好写。主要是 3 个文件，内容我都贴出来了：

BUILD.gn 文件内容

at_entry.c 文件主要是注册了一个 AT 指令，后面大家可以使用 AT+MQTTTEST 指令来测试 MQTT 功能

代码内容如下：

mqtt_test.c 文件则是编写了一个简单的 MQTT 测试代码，具体代码讲解，后面会重新开一篇

其中测试用的 mqtt 服务器是我自己的服务器：106.13.62.194，大家也可以改成自己的，也可以直接用我个人的 mqtt 服务器。

mqtt_test.h 文件内容：

到这里就完成了代码部分，可以开始编译了。

MQTT 实验

这里我们需要先下载一个 Windows 电脑端的 MQTT 客户端，这样我们就可以用电脑订阅开发板的 MQTT 主题信息了。