libumqtt 使用教程

libumqtt 使用教程

libumqttA Lightweight and fully asynchronous MQTT client C library based on libev项目地址:https://gitcode.com/gh_mirrors/li/libumqtt

1、项目介绍

libumqtt 是一个轻量级且完全异步的 MQTT 客户端 C 库，基于 libev 构建。它支持 MQTT 3.1.1 协议，并提供了 Lua 绑定功能。该库的特点包括轻量级（使用 glibc 剥离后仅 27KB）、完全异步（使用 libev 作为事件后端）、支持 QoS 0、1 和 2 以及 SSL（支持 OpenSSL、mbedtls 和 CyaSSl(wolfssl)）。

2、项目快速启动

安装依赖

首先，安装必要的依赖包：

sudo apt install libev-dev libssl-dev liblua5.2-dev

克隆项目并编译安装

git clone --recursive https://github.com/zhaojh329/libumqtt.git
cd libumqtt
mkdir build && cd build
cmake ..
sudo make install
sudo ldconfig

示例代码

以下是一个简单的示例代码，展示如何使用 libumqtt 连接到 MQTT 服务器并发布消息：

#include <umqtt/client.h>
#include <stdio.h>

void on_connect(struct umqtt_client *client, int rc) {
    printf("Connected with result code %d\n", rc);
    umqtt_publish(client, "test/topic", "Hello, libumqtt!", 18, 0, 0);
}

int main() {
    struct umqtt_client *client = umqtt_new("tcp://broker.hivemq.com:1883", "libumqtt_client", NULL, NULL);
    umqtt_set_on_connect(client, on_connect);
    umqtt_connect(client);
    umqtt_loop_forever(client);
    umqtt_destroy(client);
    return 0;
}

3、应用案例和最佳实践

应用案例

libumqtt 适用于嵌入式系统、物联网设备和需要轻量级 MQTT 客户端的场景。例如，智能家居系统可以使用 libumqtt 与云端进行通信，实现设备控制和数据上报。

最佳实践

1. 选择合适的 SSL 后端：根据具体需求选择 OpenSSL、mbedtls 或 CyaSSl(wolfssl) 作为 SSL 后端。
2. 优化内存使用：在嵌入式系统中，注意内存使用，尽量减少不必要的内存分配。
3. 错误处理：在回调函数中处理连接、发布和订阅的错误，确保程序的健壮性。

4、典型生态项目

libumqtt 可以与以下项目结合使用，构建完整的 MQTT 生态系统：

1. OpenWrt：在 OpenWrt 路由器上使用 libumqtt 实现设备间的通信。
2. Mosquitto：作为 MQTT 代理服务器，与 libumqtt 客户端进行通信。
3. Node-RED：使用 Node-RED 进行可视化编程，与 libumqtt 客户端进行数据交互。

通过这些项目的结合，可以构建出功能丰富、稳定可靠的 MQTT 应用系统。

libumqttA Lightweight and fully asynchronous MQTT client C library based on libev项目地址:https://gitcode.com/gh_mirrors/li/libumqtt