shmuelzon / esp-mqtt

MQTT component for esp-idf projects based on the lwmqtt library

esp-mqtt

MQTT component for esp-idf projects based on the lwmqtt library

This component bundles the lwmqtt client and adds a simple async API similar to other esp networking components.

Installation

You can install the component by adding it as a git submodule:

git submodule add https://github.com/256dpi/esp-mqtt.git components/esp-mqtt
git submodule update --init --recursive

The component will automatically enable the LWIP receive buffers.

API

Initialize the component once by passing the necessary callbacks:

void esp_mqtt_init(esp_mqtt_status_callback_t scb, esp_mqtt_message_callback_t mcb,
                   size_t buffer_size, int command_timeout);

When the WiFi connection has been established, start the process:

void esp_mqtt_start(const char *host, const char *port, const char *client_id,
                    const char *username, const char *password);

When the client has connected, interact with the broker:

bool esp_mqtt_subscribe(const char *topic, int qos);
bool esp_mqtt_unsubscribe(const char *topic);
bool esp_mqtt_publish(const char *topic, uint8_t *payload, size_t len, int qos, bool retained);

If the WiFi connection has been lost, stop the process:

void esp_mqtt_stop();