Chuleta de comandos MQTT de Tasmota: los topics cmnd, stat y tele explicados

Esta chuleta de comandos MQTT de Tasmota reúne los topics y comandos que usarás a diario para conmutar, consultar y ajustar dispositivos Tasmota desde cualquier cliente MQTT. Aprenderás cómo encajan los prefijos cmnd, stat y tele, qué payloads espera cada comando y cómo enviarlos desde un terminal, un script o el cliente web de ConnectMQ.

Cómo se construyen los topics MQTT de Tasmota

Cada topic de Tasmota sigue la plantilla Full Topic, que por defecto es %prefix%/%topic%/. El nombre del comando se añade al final. Con un dispositivo cuyo Topic es plug1:

Dos reglas cubren la mayoría de los errores. Primero, los comandos siempre van a cmnd; publicar en stat no hace nada. Segundo, un payload vacío en un topic de comando consulta el valor actual sin cambiarlo.

Si tu Full Topic añade un prefijo, por ejemplo home/%prefix%/%topic%/, todos los topics de esta chuleta llevan ese prefijo: home/cmnd/plug1/POWER. Si aún no has configurado MQTT en el dispositivo, empieza por la guía para configurar Tasmota MQTT.

Envío de comandos MQTT a Tasmota

Puedes enviar cada comando de esta chuleta de tres maneras.

Desde un terminal con los clientes de mosquitto. En el servidor MQTT público gratuito (solo para pruebas, nunca para datos de producción), usa un prefijo único en tu Full Topic, como connectmq/demo/k4w9ra/%prefix%/%topic%/:

mosquitto_pub -h broker.connectmq.com -p 1883 -i cli-k4w9ra \
  -t 'connectmq/demo/k4w9ra/cmnd/plug1/POWER' -m 'ON'

Desde el cliente web de ConnectMQ. En el portal, abre el cliente MQTT en el navegador, suscríbete a home/stat/plug1/# y publica en home/cmnd/plug1/POWER con el payload TOGGLE. El explorador de topics en directo muestra la respuesta RESULT junto al topic de estado original.

Desde código. Sirve cualquier biblioteca MQTT; este es un ejemplo en Python con paho-mqtt 2.x:

import paho.mqtt.client as mqtt

PREFIX = "connectmq/demo/k4w9ra"

client = mqtt.Client(mqtt.CallbackAPIVersion.VERSION2, client_id="py-k4w9ra")
client.connect("broker.connectmq.com", 1883, keepalive=30)
client.loop_start()
info = client.publish(f"{PREFIX}/cmnd/plug1/POWER", "TOGGLE", qos=1)
info.wait_for_publish()
client.loop_stop()
client.disconnect()

Comandos de encendido y relés

PulseTime es la forma segura de construir un interruptor de "funcionar durante N minutos". Por ejemplo, PulseTime1 400 apaga el relé 300 segundos después de encenderse, aunque la red se caiga entretanto.

PowerRetain 1 es útil para los paneles que arrancan después del dispositivo, porque el último estado de encendido se entrega inmediatamente al suscribirse. No retengas los topics de comando; un cmnd/.../POWER ON retenido volvería a encender el relé tras cada reconexión.

Comandos de telemetría y estado

Las respuestas a Status llegan a stat/<topic>/STATUS, STATUS2, etc., según el número. Los valores cortos de TelePeriod son prácticos durante las pruebas, pero unos cientos de dispositivos informando cada 10 segundos suman mucho. Elige el intervalo más lento que siga sirviendo a tu panel.

Comandos de luz y regulación

Comandos de configuración

Los topics de grupo facilitan el control en bloque: cada dispositivo con GroupTopic1 kitchen reacciona a cmnd/kitchen/POWER OFF. El topic de grupo integrado por defecto es tasmotas. Si tus dispositivos comparten broker con otras personas, cámbialo por algo único; de lo contrario, un cmnd/tasmotas/... perdido podría llegar a tus dispositivos.

Las conexiones cifradas tienen sus propios requisitos, que se tratan en la guía de Tasmota MQTT con TLS.

Comandos de mantenimiento

Ejecutar varios comandos con Backlog

Backlog ejecuta una lista de comandos separados por punto y coma, que también puedes enviar por MQTT:

mosquitto_pub -h broker.connectmq.com -p 1883 -i cli-k4w9ra \
  -t 'connectmq/demo/k4w9ra/cmnd/plug1/Backlog' \
  -m 'Power ON; Delay 50; Power OFF'

Delay usa unidades de 0,1 segundos, así que Delay 50 espera cinco segundos. Backlog es la forma más limpia de enviar una configuración completa a una flota de dispositivos sin visitar la interfaz web de cada uno.

Reglas: comandos que se ejecutan en el propio dispositivo

Las reglas permiten que un dispositivo reaccione sin ningún servidor. Un ejemplo clásico publica un mensaje personalizado cuando cambia el relé:

Rule1 ON Power1#State DO Publish home/events/plug1 {"power":"%value%"} ENDON
Rule1 1

Publish desde una regla envía a cualquier topic que quieras, algo práctico cuando otro sistema espera un formato concreto.

Lista de comprobación rápida

1. Envía los comandos a cmnd/<topic>/<Command>; lee las respuestas en stat/<topic>/RESULT.
2. Un payload vacío significa "consultar", no "apagar".
3. Vigila tele/<topic>/LWT para conocer la disponibilidad.
4. Retén los topics de estado si los paneles lo necesitan; nunca retengas comandos.
5. Usa client ID, topics y topics de grupo únicos en brokers compartidos.

Ejecuta tus dispositivos Tasmota en ConnectMQ

Probar en el broker público está bien, pero un broker privado mantiene a los desconocidos lejos de tus relés. Un broker MQTT gestionado de ConnectMQ da a cada dispositivo sus propias credenciales, un explorador de topics en directo para comprobar las respuestas y TLS en el puerto 8883 para las compilaciones ESP32. Crea un broker Serverless gratuito en app.connectmq.com sin tarjeta de crédito, y consulta la guía de automatización IoT para encontrar ideas de proyectos.

Preguntas frecuentes

¿Qué diferencia hay entre cmnd, stat y tele en Tasmota?

cmnd es donde envías los comandos, stat transporta las respuestas y los cambios de estado, y tele transporta la telemetría periódica y el mensaje de disponibilidad Online/Offline.

¿Cómo compruebo el estado de un dispositivo Tasmota sin conmutarlo?

Publica un payload vacío en el topic de comando, por ejemplo cmnd/plug1/POWER. El dispositivo responde en stat/plug1/RESULT.

¿Cómo envío varios comandos de Tasmota en un solo mensaje MQTT?

Publica en cmnd/<topic>/Backlog con los comandos separados por punto y coma, por ejemplo Power ON; Delay 50; Power OFF.

¿Por qué se ignoran mis comandos de Tasmota?

Normalmente el topic es incorrecto: los comandos deben usar el prefijo cmnd y coincidir exactamente con el Full Topic del dispositivo, incluido cualquier prefijo adicional y las mayúsculas y minúsculas.