一、下载
github 下载paho mqtt c库源码,编译安装库文件。
地址:https://github.com/eclipse/paho.mqtt.c
关键API:Paho Asynchronous MQTT C Client Library: MQTTAsync.h File Reference
说明:paho客户端库是纯c库,支持两种操作模式:同步模式和异步模式。异步方式调用MQTTClient_setCallbacks接口设置回调函数。
- 同步模式
客户端应用程序在单个线程上运行,主要使用MQTTClient_publish()和MQTTClient_publishMessage()函数。应用程序必须调用MQTTClient_waitForCompletion()函数查询以确定QoS1或QoS2消息已成功传递。接收消息使用MQTTClient_receive()函数。此外,客户端应用程序必须调用MQTTClient_receive()或MQTTClient_yield()处理确认和MQTT保持与服务器的网络连接处于活动状态。
- 异步模式
客户端应用程序在多个线程上运行。主程序调用客户端库中的函数来发布和订阅。不同的是握手和维护的处理、网络连接是在后台执行。向客户端提供状态和消息接收通知使用通过调用向库注册的回调的应用程序MQTTClient_setCallbacks()、MQTTClient_messageArrived()、MQTTClient_connectionLost()和MQTTClient_deliveryComplete()。
注意:但是,此API不是线程安全的,不可能从多个端口调用它,没有同步的线程。线程安全的异步模式需要使用MQTTAsync API。
二、安装
下载后解压,执行make,如果报错找不到openssl头文件的问题,需要安装openssl和相关依赖。
apt-get install openssl libssl-dev
查看是否安装成功:
openssl version -a
如果要编译API doxygen文档,还需要安装doxygen
apt-get install doxygen graphviz
再次make即可编译完成,make install进行安装
make
make install
执行make html, 编译生成api文档
三、使用
具体参看提供的sample,相当清晰和明了。