Disclaimer:
The UPT MQTT module is in early development and is not production ready.
It is not yet available through library managers. Have a look at the open issues to know what to expect.
Arduino library for publishing messages to an MQTT broker.
It offers a simplified interface to the ESP-IDF mqtt_client libraries and optionaly handles Wi-Fi connectivity for you.
This project was developed and tested on Espressif ESP32 DevKitC and Lilygo T-Display S3 hardware.
We recommend using the PlatformIO VSCode extension to compile and flash the code in this example. You will find more instructions here
It is also possible to use the application using Arduino IDE. You will find more instructions here
Two example scripts are available in the examples
folder:
-
delegatedWifiUsage: In this example the main application delegates the WiFi management to the MQTT client. Such approach should be used if your application does no use Wi-Fi overwise and you do not want any fancy Wi-Fi configuration.
-
selfManagedWifiUsage: In this example the main application will handle the WiFi management, and the MQTT client will not care about it. Such approach should be used in most cases since your application will likely use WiFi for other things.
You will find a more detailed API guide here
This library uses the following dependencies.
- Arduino ESP32
(In particular, the Wi-Fi library,
message logging and
MQTT client)
Caution: the ArduinoEspressif implementation of the ESP MQTT Client does not match the official API documentation!