在 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++ 客户端程序。

相关推荐
国科安芯6 小时前
卫星控制板偶发复位:MCU供电、时钟、ECC与总线的联合定位——AS32S601ZIT2在星载控制单元中的FAE排查方法
单片机·嵌入式硬件·mcu·risc-v·抗辐射·通信芯片
无忧.芙桃6 小时前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
最强小杰7 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
戊本菌9 小时前
进程(三)进程优先级:谁先上 CPU
linux·c语言·硬件架构
aningx10 小时前
Arch 系用 greetd 实现开机自动进 Plasma Wayland,注销自动回桌面
linux
张小姐的猫11 小时前
【基于 WebSocket 的多用户网页五子棋】—— 整合封装服务器模块设计实现2️⃣
服务器·websocket·网络协议
江无行者11 小时前
Linux 服务器 top 命令详解
linux
HMS工业网络11 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全
嵌入式 Linux手记13 小时前
一块内存,三种解释:union 的真实用法
linux·c语言·驱动开发·嵌入式
星恒随风13 小时前
MySQL 从零入门(九):事务管理详解——ACID、COMMIT、ROLLBACK、SAVEPOINT 与四种隔离级别
linux·服务器·数据库·笔记·mysql