在 ARM 嵌入式 Linux 下使用 C/C++ 实现 MQTT

在 ARM 嵌入式 Linux 下使用 C/C++ 实现 MQTT 通信是一个常见的需求，尤其是在资源受限的环境中。以下是一个详细的教程，使用 Eclipse Paho C Client 库来实现 MQTT 客户端。

---

1. 安装 Eclipse Paho C Client 库

Eclipse Paho C Client 是一个轻量级的 MQTT 客户端库，适合嵌入式系统。

安装依赖

在 ARM 嵌入式 Linux 中，首先安装必要的依赖：

sudo apt update
sudo apt install build-essential cmake libssl-dev

下载和编译 Paho C Client

1. 下载 Paho C Client 源码：

   git clone https://github.com/eclipse/paho.mqtt.c.git
   cd paho.mqtt.c
   

2. 编译并安装：

   cmake -Bbuild -H. -DPAHO_WITH_SSL=OFF
   make -C build
   sudo make -C build install
   

---

2. 编写 MQTT 客户端代码

以下是一个简单的 MQTT 客户端示例，包括订阅和发布功能。

代码：mqtt_client.c

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "MQTTClient.h"

#define ADDRESS     "tcp://localhost:1883"
#define CLIENTID    "arm_mqtt_client"
#define TOPIC       "test/topic"
#define PAYLOAD     "Hello from ARM MQTT Client!"
#define QOS         1
#define TIMEOUT     10000L

// 收到消息的回调函数
void messageArrived(void *context, char *topicName, int topicLen, MQTTClient_message *message) {
    printf("Message arrived on topic: %s\n", topicName);
    printf("Payload: %.*s\n", message->payloadlen, (char *)message->payload);
    MQTTClient_freeMessage(&message);
    MQTTClient_free(topicName);
}

int main() {
    MQTTClient client;
    MQTTClient_connectOptions conn_opts = MQTTClient_connectOptions_initializer;
    int rc;

    // 创建 MQTT 客户端
    rc = MQTTClient_create(&client, ADDRESS, CLIENTID, MQTTCLIENT_PERSISTENCE_NONE, NULL);
    if (rc != MQTTCLIENT_SUCCESS) {
        printf("Failed to create client, return code: %d\n", rc);
        exit(EXIT_FAILURE);
    }

    // 设置消息到达回调
    rc = MQTTClient_setCallbacks(client, NULL, NULL, messageArrived, NULL);
    if (rc != MQTTCLIENT_SUCCESS) {
        printf("Failed to set callbacks, return code: %d\n", rc);
        MQTTClient_destroy(&client);
        exit(EXIT_FAILURE);
    }

    // 连接 MQTT 代理
    conn_opts.keepAliveInterval = 20;
    conn_opts.cleansession = 1;
    rc = MQTTClient_connect(client, &conn_opts);
    if (rc != MQTTCLIENT_SUCCESS) {
        printf("Failed to connect, return code: %d\n", rc);
        MQTTClient_destroy(&client);
        exit(EXIT_FAILURE);
    }

    // 订阅主题
    rc = MQTTClient_subscribe(client, TOPIC, QOS);
    if (rc != MQTTCLIENT_SUCCESS) {
        printf("Failed to subscribe, return code: %d\n", rc);
        MQTTClient_disconnect(client, TIMEOUT);
        MQTTClient_destroy(&client);
        exit(EXIT_FAILURE);
    }
    printf("Subscribed to topic: %s\n", TOPIC);

    // 发布消息
    MQTTClient_message pubmsg = MQTTClient_message_initializer;
    pubmsg.payload = (void *)PAYLOAD;
    pubmsg.payloadlen = strlen(PAYLOAD);
    pubmsg.qos = QOS;
    pubmsg.retained = 0;
    rc = MQTTClient_publishMessage(client, TOPIC, &pubmsg, NULL);
    if (rc != MQTTCLIENT_SUCCESS) {
        printf("Failed to publish message, return code: %d\n", rc);
        MQTTClient_disconnect(client, TIMEOUT);
        MQTTClient_destroy(&client);
        exit(EXIT_FAILURE);
    }
    printf("Published message: %s\n", PAYLOAD);

    // 等待消息到达
    printf("Waiting for messages...\n");
    while (1) {
        sleep(1);
    }

    // 断开连接并销毁客户端
    MQTTClient_disconnect(client, TIMEOUT);
    MQTTClient_destroy(&client);
    return 0;
}

---

3. 编译代码

在 ARM 嵌入式 Linux 中编译代码：

gcc -o mqtt_client mqtt_client.c -lpaho-mqtt3c

---

4. 运行代码

1. 确保 Mosquitto 代理已启动。
2. 运行编译后的程序：

   ./mqtt_client
   

3. 如果一切正常，程序将订阅 test/topic 主题并发布一条消息。

---

5. 测试和验证

1. 使用 mosquitto_sub 订阅 test/topic 主题：

   mosquitto_sub -h localhost -t test/topic
   

2. 运行 mqtt_client，你应该能在 mosquitto_sub 终端中看到发布的消息。

---

6. 优化和注意事项

1. 资源优化：
   • 如果内存资源紧张，可以禁用 SSL（如示例中所示）。
   • 减少 MQTTClient_message 的缓冲区大小。
2. 网络稳定性：
   • 在嵌入式系统中，确保网络连接稳定，避免因网络问题导致通信失败。
3. 日志管理：
   • 在发布版本中禁用调试日志，减少资源占用。
4. 交叉编译：
   • 如果需要在开发主机上交叉编译，请使用合适的交叉编译工具链，例如：

     arm-linux-gnueabihf-gcc -o mqtt_client mqtt_client.c -lpaho-mqtt3c
     

通过以上步骤，可在 ARM 嵌入式 Linux 中成功实现 MQTT 通信，并编写高效的 C/C++ 客户端程序。