Guía práctica para conectar un ESP32 a un broker MQTT usando ESP-IDF. Publica tu primer mensaje de telemetría en menos de 5 minutos.

Conecta tu ESP32 a MQTT en 5 minutos

Si estás comenzando con IoT, una de las primeras cosas que necesitas aprender es cómo conectar un microcontrolador a un broker MQTT. En esta guía te mostraré cómo hacerlo con un ESP32 usando el framework ESP-IDF oficial de Espressif.

¿Qué necesitas?

Un ESP32 (cualquier modelo: DevKit, WROOM, S3)
Cable USB para programar
ESP-IDF instalado (v5.x o superior)
Un proyecto en Kuska IoT (o cualquier broker MQTT)

idf_component_register(SRCS "main.c" INCLUDE_DIRS ".")

Paso 1: Crear el proyecto

Abre tu terminal y crea un nuevo proyecto basado en el ejemplo MQTT de ESP-IDF:

cp -r $IDF_PATH/examples/protocols/mqtt/tcp ~/esp/mqtt-esp32
cd ~/esp/mqtt-esp32
idf.py set-target esp32

Paso 2: Configurar WiFi y MQTT

Edita el archivo main/app_main.c y configura las credenciales:

#define WIFI_SSID      "TU_WIFI"
#define WIFI_PASS      "TU_CONTRASENA"
#define MQTT_BROKER    "mqtt://mqtt.kuska.io:1883"
#define MQTT_USER      "tu_usuario_mqtt"
#define MQTT_PASS      "tu_password_mqtt"

Paso 3: Publicar telemetría

Dentro de la función de evento MQTT conectado, publica un mensaje:

esp_mqtt_client_publish(client, "proyecto/sensor/temperatura", "24.5", 0, 1, 0);

Paso 4: Compilar y flashear

idf.py build
idf.py -p /dev/ttyUSB0 flash monitor

¡Listo! Tu ESP32 ya está publicando datos. Ahora ve al dashboard de Kuska IoT y verás los mensajes en tiempo real.

¿No tienes un proyecto en Kuska IoT todavía? Crea una cuenta gratis y obtén tus credenciales MQTT en segundos.

Conclusión

En 5 minutos has conectado un ESP32 a un broker MQTT y has publicado tu primer mensaje de telemetría. Este es el bloque fundamental de cualquier sistema IoT. Desde aquí puedes escalar a múltiples dispositivos, sensores y dashboards.