Paho MQTT C/C++客户端库嵌入式平台使用教程

范意妲Kiefer

于 2025-03-31 11:10:35 发布

阅读量957

点赞数 8

本文链接：https://blog.csdn.net/gitblog_00542/article/details/146805043

版权

Paho MQTT C/C++客户端库嵌入式平台使用教程

paho.mqtt.embedded-c EclipsePaho是一个轻量级的MQTT客户端库，可用于嵌入式系统和其他资源受限的环境。它支持多种操作系统和编程语言，并提供了一些高级功能，如质量服务、订阅过滤器等。项目地址: https://gitcode.com/gh_mirrors/pa/paho.mqtt.embedded-c

1. 项目介绍

Eclipse Paho MQTT C/C++客户端库是一个为嵌入式平台设计的轻量级库，用于发布和订阅消息到MQTT代理。Paho是Eclipse IoT项目的一部分，提供了MQTT协议的实现，支持多种编程语言和平台。本项目包含C和C++两种语言的客户端实现，适用于不同的嵌入式开发环境。

2. 项目快速启动

环境准备

确保您的系统中已安装CMake。
安装适用于您平台的交叉编译工具链。

下载源码

从GitHub克隆或下载项目源码：

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

编译项目

创建一个构建目录并运行CMake和make：

mkdir build.paho
cd build.paho
cmake ..
make

运行示例

在samples目录下，您可以找到示例代码。例如，运行C客户端的简单发布和订阅示例：

./MQTTClient-C/samples/CClient.c

确保您的MQTT代理正在运行，并且客户端能够连接到代理。

3. 应用案例和最佳实践

案例一：温度传感器的数据发布

假设您有一个温度传感器，并且想要将读数发布到MQTT代理。以下是一个简单的示例代码：

#include "MQTTClient.h"

#define ADDRESS     "tcp://mqtt.example.com:1883"
#define CLIENTID    "ExampleClient"
#define TOPIC       "sensor/temperature"
#define PAYLOAD     "28.5"
#define QOS         1
#define TIMEOUT     10000L

int main(int argc, char* argv[])
{
    MQTTClient client;
    MQTTClient_connectOptions conn_opts = MQTTClient_connectOptions_initializer;
    MQTTClient_message pubmsg = MQTTClient_message_initializer;
    MQTTClient_deliveryToken token;
    int rc;

    // 初始化网络
    MQTTClient_create(&client, ADDRESS, CLIENTID, MQTTCLIENT_PERSISTENCE_NONE, NULL);
    // 设置连接选项
    conn_opts.keepAliveInterval = 20;
    conn_opts.cleansession = 1;

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

    // 准备消息
    pubmsg.payload = PAYLOAD;
    pubmsg.payloadlen = strlen(PAYLOAD);
    pubmsg.qos = QOS;
    pubmsg.retained = 0;

    // 发布消息
    MQTTClient_publishMessage(client, TOPIC, &pubmsg, &token);
    printf("Waiting for up to %d seconds for publication of %s\n"
            "on topic %s for client with ClientID: %s\n",
            (int)(TIMEOUT/1000), PAYLOAD, TOPIC, CLIENTID);
    rc = MQTTClient_waitForCompletion(client, token, TIMEOUT);
    printf("Message with delivery token %d delivered\n", token);

    // 断开连接
    MQTTClient_disconnect(client, 10000);
    MQTTClient_destroy(&client);
    return rc;
}