Tasmota-MQTT-Befehle als Spickzettel: cmnd-, stat- und tele-Topics erklärt

Dieser Spickzettel zu Tasmota-MQTT-Befehlen sammelt die Topics und Befehle, mit denen Sie Tasmota-Geräte täglich von jedem MQTT-Client aus schalten, abfragen und feinjustieren. Sie erfahren, wie die Präfixe cmnd, stat und tele zusammenspielen, welche Payloads die einzelnen Befehle erwarten und wie Sie sie aus einem Terminal, einem Skript oder dem ConnectMQ-Webclient senden.

Wie Tasmota-MQTT-Topics aufgebaut sind

Jedes Tasmota-Topic folgt der Full-Topic-Vorlage, standardmäßig %prefix%/%topic%/. Der Befehlsname wird am Ende angehängt. Bei einem Gerät mit dem Topic plug1:

Zwei Regeln decken die meisten Fehler ab. Erstens gehen Befehle immer an cmnd; ein Publish auf stat bewirkt nichts. Zweitens fragt ein leerer Payload auf einem Befehls-Topic den aktuellen Wert ab, ohne ihn zu ändern.

Fügt Ihr Full Topic ein Präfix hinzu, zum Beispiel home/%prefix%/%topic%/, erhält jedes Topic auf diesem Spickzettel dieses Präfix: home/cmnd/plug1/POWER. Wenn Sie MQTT auf dem Gerät noch nicht eingerichtet haben, beginnen Sie mit der Anleitung zum Einrichten von Tasmota MQTT.

Tasmota-MQTT-Befehle senden

Jeden Befehl auf diesem Spickzettel können Sie auf drei Arten senden.

Aus einem Terminal mit den Mosquitto-Clients. Der kostenlose öffentliche MQTT-Broker ist für Tests gedacht und für jeden lesbar; verwenden Sie dort ein eindeutiges Präfix in Ihrem Full Topic, etwa 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'

Aus dem ConnectMQ-Webclient. Öffnen Sie im Portal den MQTT-Client im Browser, abonnieren Sie home/stat/plug1/# und veröffentlichen Sie dann auf home/cmnd/plug1/POWER mit dem Payload TOGGLE. Der Live-Topic-Explorer zeigt die RESULT-Antwort neben dem ursprünglichen Zustands-Topic.

Aus Code. Jede MQTT-Bibliothek funktioniert; hier Python mit 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()

Schalt- und Relaisbefehle

PulseTime ist der sichere Weg, einen Schalter „N Minuten laufen lassen“ zu bauen. Zum Beispiel schaltet PulseTime1 400 das Relais 300 Sekunden nach dem Einschalten wieder aus, selbst wenn zwischendurch das Netzwerk ausfällt.

PowerRetain 1 ist nützlich für Dashboards, die nach dem Gerät starten, denn der letzte Schaltzustand wird beim Abonnieren sofort zugestellt. Retainen Sie keine Befehls-Topics; ein retained cmnd/.../POWER ON würde das Relais nach jeder Neuverbindung wieder einschalten.

Telemetrie- und Statusbefehle

Antworten auf Status kommen je nach Nummer auf stat/<topic>/STATUS, STATUS2 und so weiter an. Kurze TelePeriod-Werte sind beim Testen praktisch, aber ein paar hundert Geräte, die alle 10 Sekunden melden, summieren sich. Wählen Sie das langsamste Intervall, das Ihr Dashboard noch ausreichend versorgt. Das gilt auch, wenn Zwischenstecker mit Energiemessung in einer Werkstatt oder einem Büro als günstiger Einstieg ins Energiemonitoring dienen: Für Tageslastgänge reichen meist 60 bis 300 Sekunden.

Licht- und Dimmerbefehle

Konfigurationsbefehle

Gruppen-Topics erleichtern die Massensteuerung: Jedes Gerät mit GroupTopic1 kitchen reagiert auf cmnd/kitchen/POWER OFF. Das eingebaute Standard-Gruppen-Topic ist tasmotas. Teilen sich Ihre Geräte einen Broker mit anderen Personen, ändern Sie es in etwas Eindeutiges, sonst könnte ein verirrtes cmnd/tasmotas/... Ihre Geräte erreichen.

Verschlüsselte Verbindungen haben eigene Anforderungen, die die Anleitung zu Tasmota MQTT mit TLS behandelt.

Wartungsbefehle

Mehrere Befehle mit Backlog ausführen

Backlog führt eine Liste von durch Semikolons getrennten Befehlen aus, die Sie auch per MQTT senden können:

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 arbeitet in Einheiten von 0,1 Sekunden, Delay 50 wartet also fünf Sekunden. Backlog ist der sauberste Weg, eine komplette Konfiguration auf eine Flotte von Geräten zu verteilen, ohne jede Weboberfläche einzeln aufzurufen.

Rules: Befehle, die auf dem Gerät ausgelöst werden

Mit Rules reagiert ein Gerät ganz ohne Server. Ein klassisches Beispiel veröffentlicht eine eigene Nachricht, wenn sich das Relais ändert:

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

Publish aus einer Rule sendet an ein beliebiges Topic, was praktisch ist, wenn ein anderes System ein bestimmtes Format erwartet.

Kurz-Checkliste

1. Befehle an cmnd/<topic>/<Command> senden; Antworten auf stat/<topic>/RESULT lesen.
2. Leerer Payload bedeutet „abfragen“, nicht „ausschalten“.
3. tele/<topic>/LWT für die Verfügbarkeit beobachten.
4. Zustands-Topics retainen, wenn Dashboards es brauchen; Befehle niemals retainen.
5. Auf gemeinsam genutzten Brokern eindeutige Client IDs, Topics und Gruppen-Topics verwenden.

Betreiben Sie Ihre Tasmota-Geräte mit ConnectMQ

Zum Testen ist der öffentliche MQTT-Broker in Ordnung, aber ein privater Broker hält Fremde von Ihren Relais fern. Ein verwalteter MQTT-Broker von ConnectMQ gibt jedem Gerät eigene Zugangsdaten, bietet einen Live-Topic-Explorer zum Prüfen der Antworten und TLS auf Port 8883 für ESP32-Builds. Erstellen Sie einen kostenlosen Serverless-Broker unter app.connectmq.com ohne Kreditkarte, und holen Sie sich im IoT-Automatisierungsleitfaden Ideen für Projekte.

Häufig gestellte Fragen

Was ist der Unterschied zwischen cmnd, stat und tele in Tasmota?

An cmnd senden Sie Befehle, stat transportiert Antworten und Zustandsänderungen, und tele transportiert periodische Telemetrie sowie die Verfügbarkeitsmeldung Online/Offline.

Wie prüfe ich den Zustand eines Tasmota-Geräts, ohne es zu schalten?

Veröffentlichen Sie einen leeren Payload auf dem Befehls-Topic, zum Beispiel cmnd/plug1/POWER. Das Gerät antwortet auf stat/plug1/RESULT.

Wie sende ich mehrere Tasmota-Befehle in einer MQTT-Nachricht?

Veröffentlichen Sie auf cmnd/<topic>/Backlog mit durch Semikolons getrennten Befehlen, zum Beispiel Power ON; Delay 50; Power OFF.

Warum werden meine Tasmota-Befehle ignoriert?

Meist stimmt das Topic nicht: Befehle müssen das Präfix cmnd verwenden und exakt zum Full Topic des Geräts passen, einschließlich zusätzlicher Präfixe und Groß-/Kleinschreibung.