MQTT C 客户端库

Eclipse Paho CMQTT C Client Library - 图1 (opens new window) 与 Eclipse Paho Embedded CMQTT C Client Library - 图2 (opens new window) 均为 Eclipse Paho 项目下的 C 语言客户端库（MQTT C Client），均为使用 ANSI C 编写的功能齐全的 MQTT 客户端。

Eclipse Paho Embedded C 可以在桌面操作系统上使用，但主要针对 mbedMQTT C Client Library - 图3 (opens new window)，ArduinoMQTT C Client Library - 图4 (opens new window)和 FreeRTOSMQTT C Client Library - 图5 (opens new window) 等嵌入式环境。

该客户端有同步/异步两种 API ，分别以 MQTTClient 和 MQTTAsync 开头：

  • 同步 API 旨在更简单，更有用，某些调用将阻塞直到操作完成为止，使用编程上更加容易；
  • 异步 API 中只有一个调用块 API-waitForCompletion ，通过回调进行结果通知，更适用于非主线程的环境。

Paho C 使用示例

MQTT C 语言相关两个客户端库的比较、下载、使用方式等详细说明请移步至项目主页查看，本示例包含 C 语言的 Paho C 连接 EMQX Broker，并进行消息收发完整代码：

  1. #include "stdio.h"
  2. #include "stdlib.h"
  3. #include "string.h"
  5. #include "MQTTClient.h"
  7. #define ADDRESS     "tcp://broker.emqx.io:1883"
  8. #define CLIENTID    "emqx_test"
  9. #define TOPIC       "testtopic/1"
  10. #define PAYLOAD     "Hello World!"
  11. #define QOS         1
  12. #define TIMEOUT     10000L
  14. int main(int argc, char* argv[])
  15. {
  16.     MQTTClient client;
  17.     MQTTClient_connectOptions conn_opts = MQTTClient_connectOptions_initializer;
  18.     MQTTClient_message pubmsg = MQTTClient_message_initializer;
  19.     MQTTClient_deliveryToken token;
  20.     int rc;
  22.     MQTTClient_create(&client, ADDRESS, CLIENTID,
  23.         MQTTCLIENT_PERSISTENCE_NONE, NULL);
  25.     // MQTT 连接参数
  26.     conn_opts.keepAliveInterval = 20;
  27.     conn_opts.cleansession = 1;
  29.     if ((rc = MQTTClient_connect(client, &conn_opts)) != MQTTCLIENT_SUCCESS)
  30.     {
  31.         printf("Failed to connect, return code %d\n", rc);
  32.         exit(-1);
  33.     }
  35.     // 发布消息
  36.     pubmsg.payload = PAYLOAD;
  37.     pubmsg.payloadlen = strlen(PAYLOAD);
  38.     pubmsg.qos = QOS;
  39.     pubmsg.retained = 0;
  40.     MQTTClient_publishMessage(client, TOPIC, &pubmsg, &token);
  41.     printf("Waiting for up to %d seconds for publication of %s\n"
  42.             "on topic %s for client with ClientID: %s\n",
  43.             (int)(TIMEOUT/1000), PAYLOAD, TOPIC, CLIENTID);
  44.     rc = MQTTClient_waitForCompletion(client, token, TIMEOUT);
  45.     printf("Message with delivery token %d delivered\n", token);
  47.     // 断开连接
  48.     MQTTClient_disconnect(client, 10000);
  49.     MQTTClient_destroy(&client);
  50.     return rc;
  51. }

Paho C MQTT 5.0 支持

目前 Paho C 已经完整支持 MQTT 5.0。