MQTT - Aircoookie/WLED-wiki-DE GitHub Wiki

** Hinweis: ** Die MQTT-Implementierung wird derzeit ** umstrukturiert **, um Benutzern von Home Assistant und anderer Automatisierungssoftware eine bessere Benutzererfahrung zu bieten. ** Dies ist eine bahnbrechende Änderung **, daher bezieht sich die folgende Dokumentation nur auf WLED-Versionen bis einschließlich 0.8.5. Einzelheiten zur Überarbeitung finden Sie unter # 207!

WLED-Versionen ab 0.8.0 können eine Verbindung zu einem MQTT-Broker für die Smart-Home-Steuerung herstellen. Die Verbindung zu Domänen und IP-Servern wird an Port 1883 unterstützt.

Sichere Verbindungen werden derzeit nicht unterstützt. Ich empfehle, nur eine Verbindung zu lokalen MQTT-Brokern herzustellen. Ab Version 0.8.4 unterstützt WLED die automatische Erkennung von MQTT durch die HomeAssistant-Software.

WLED wird bis zu sechs Themen abonnieren, um den Zustand der Lichter zu ändern.

  • [mqttDeviceTopic]
    -> Senden Sie die Helligkeit als ASCII-Nummer 0-255 oder als Zeichenfolgen "ON", "OFF" und "T" (zum Umschalten).

  • [mqttDeviceTopic]/col
    -> Farbe als HEX (#WWRRGGBB oder #RRGGBB) oder 32bit DEC senden. Hex hat '#', 'h' oder 'H' als Präfix.

  • [mqttDeviceTopic]/api
    -> Senden Sie einen API-Aufruf (unter Verwendung der Syntax HTTP API). Sie können den "Gewinn" weglassen und einfach z. FX = 73

  • [mqttGroupTopic]

  • [mqttGroupTopic]/col

  • [mqttGroupTopic]/api

Die Themenpfade [mqttDeviceTopic] und [mqttGroupTopic] können in den Synchronisierungseinstellungen angepasst werden. Wenn [mqttGroupTopic] leer gelassen wird, wird nichts abonniert. Ein leeres [mqttDeviceTopic] wird stattdessen durch das Standard "wled / macaddr" ersetzt. [mqttDeviceTopic] soll für ein WLED-Gerät eindeutig sein und nur dieses Gerät steuern. [mqttGroupTopic] dient zur Steuerung einer Gruppe oder aller WLED-Geräte.

UDP-Benachrichtigungen werden so gesendet, als ob die Änderung über die Benutzeroberfläche oder die HTTP-API vorgenommen worden wäre.

Darüber hinaus veröffentlicht WLED bei Lichtwechsel drei Themen für MQTT-Clients, um den Lichtstatus abzufragen.

  • [mqttDeviceTopic]/g
    -> Enthält die aktuelle Helligkeit als ASCII-Nummer 0-255

  • [mqttDeviceTopic]/c
    -> Enthält die aktuelle Farbe als HEX (#RRGGBB wenn Weiß 0 ist, sonst #WWRRGGBB)

  • [mqttDeviceTopic]/v
    -> Enthält eine XML-API-Antwort (wie HTTP-API)

Derzeit wird die Authentifizierung / Verschlüsselung nicht unterstützt.