MQTT für Home Assistant (eingebaute Integration)

Überblick

MQTT ist eine integrierte Integration, die Home Assistant mit einem MQTT-Broker verbindet und lokal arbeitet. Sie unterstützt viele Entitätsplattformen, darunter Sensoren, Schalter, lichtähnliche Steuerungen wie Ventilatoren und Abdeckungen, Klima, Kameras, Schlösser und Saugroboter. Neue Geräte können durch automatische Erkennung erscheinen, die ein konfigurierbares Topic-Präfix verwendet. Birth- und Will-Nachrichten lassen sich mit eigenem Topic, eigener Payload, eigener Servicequalität und eigenen Retain-Optionen festlegen. Die Verbindung unterstützt die Anmeldung mit Benutzername und Passwort, eigene CA-Zertifikate, Client-Zertifikate, eine Auswahl des Transports und ein Keep-Alive-Intervall. Aktionen veröffentlichen eine Nachricht zu einem Topic, exportieren Nachrichten eines Topics in eine Datei und laden in YAML definierte Entitäten neu. Sie wird in der Benutzeroberfläche eingerichtet, und ihre Verbindungseinstellungen lassen sich später ändern.

Zusammenfassung des Quellcodes von Home Assistant, automatisch erstellt und übersetzt. Stimmt etwas nicht? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Einrichtung in der Benutzeroberfläche Füge sie unter Einstellungen > Geräte & Dienste hinzu. Kein Download nötig.
Geräteauslöser Die Geräte können Automationen direkt starten.
Fügt neue Geräte hinzu Neue Geräte erscheinen, ohne dass die Integration neu eingerichtet werden muss.
Einstellungen später ändern Die Verbindungseinstellungen lassen sich ändern, ohne die Integration zu entfernen.
Qualitätsstufe Platin Die eigene Bewertung von Home Assistant für Code und Einrichtung der Integration.
Mit Home Assistant aktualisiert Kommt mit jeder Version von Home Assistant und wird mit ihr aktualisiert.

Stellt bereit

Klima
Warmwasserbereiter
Luftbefeuchter
Ventilatoren
Abdeckungen
Ventile
Kameras
Schlösser
Alarmanlagen
Saugroboter
Schalter
Sensoren
Anwesenheit

Einrichtung

Sie wird unter Einstellungen > Geräte & Dienste über „Integration hinzufügen“ eingerichtet.

Schritt 1

ServerDer Hostname oder die IP-Adresse deines MQTT-Brokers.
PasswortDas Passwort zur Anmeldung bei deinem MQTT-Broker.
PortDer Port, den dein MQTT-Broker überwacht. Zum Beispiel 1883.
MQTT-ProtokollDie verwendete MQTT-Protokollversion. Beachte, dass Home Assistant automatisch auf Version 5 umstellt, sofern dein Broker diese unterstützt.
BenutzernameDer Benutzername zur Anmeldung bei deinem MQTT-Broker.
Hochladen einer benutzerdefinierten CA-ZertifikatsdateiDie benutzerdefinierte CA-Zertifikatsdatei zur Validierung des Zertifikats deines MQTT-Brokers.
Client-Zertifikatsdatei hochladenDas Client-Zertifikat zur Authentifizierung gegenüber deinem MQTT-Broker.
Client-ID (für eine zufällig generierte Client-ID leer lassen)Die eindeutige ID zur Identifizierung der Home Assistant MQTT-API als MQTT-Client. Es wird empfohlen, diese Option leer zu lassen.
Datei mit privatem Schlüssel hochladenDie Datei des privaten Schlüssels, der zu deinem Client-Zertifikat gehört.
PasswortDas Passwort für die Datei mit privatem Schlüssel (falls festgelegt).
Die Zeit zwischen dem Senden von Keep-Alive-NachrichtenEin Wert unter 90 Sekunden wird empfohlen. Standardwert: 60 Sekunden.
Validierung des Broker-ZertifikatsWenn die Option bereits auf Benutzerdefiniert eingestellt ist, wird ein benutzerdefiniertes CA-Validierungszertifikat konfiguriert. Wähle Automatisch für die automatische CA-Validierung oder lade ein benutzerdefiniertes CA-Zertifikat hoch, um die Validierung des Zertifikats deines MQTT-Brokers zu ermöglichen.
Ein Client-Zertifikat verwendenWenn die Clientzertifikatsauthentifizierung bereits ausgewählt ist, ist sie aktiviert. Lade ein Clientzertifikat und einen Schlüssel hoch, um die Authentifizierung zu aktivieren.
Validierung des Broker-Zertifikats ignorierenOption zum Ignorieren der Validierung des Zertifikats deines MQTT-Brokers.
MQTT-TransportDas Transportprotokoll, das für die Verbindung zu deinem MQTT-Broker verwendet werden soll.

Erneute Authentifizierung beim MQTT-Broker erforderlich

PasswortDas Passwort zur Anmeldung bei deinem MQTT-Broker.
BenutzernameDer Benutzername zur Anmeldung bei deinem MQTT-Broker.

Nach der Einrichtung

„birth“-Nachricht aktivierenWenn diese Einstellung aktiviert ist, veröffentlicht Home Assistant eine Online-Nachricht an deinen MQTT-Broker, wenn MQTT bereit ist.
Payload der „birth“-NachrichtDie „birth“-Nachricht, die veröffentlicht wird, wenn MQTT bereit und verbunden ist.
QoS der „birth“-NachrichtDie Quality of Service der „birth“-Nachricht, die veröffentlicht wird, wenn MQTT bereit und verbunden ist
Retain für „birth“-Nachricht aktivierenWenn dies festgelegt ist, behält Home Assistant die an deinen MQTT-Broker veröffentlichte „birth“-Nachricht bei.
Topic der „birth“-NachrichtDas MQTT-Topic, in dem Home Assistant eine „birth“-Nachricht veröffentlicht.
Suche aktivierenOption zum Aktivieren der automatischen MQTT-Erkennung.
Discovery-PräfixDas Präfix der Konfigurations-Topics, die von der MQTT-Integration abonniert werden.
Discovery QoSDie Servicequalität für Discovery-Abonnements bei deinem MQTT-Broker.
„will“-Nachricht aktivierenWenn diese Einstellung aktiviert ist, fordert Home Assistant deinen Broker auf, eine „will“-Nachricht zu veröffentlichen, wenn MQTT gestoppt oder die Verbindung zu deinem Broker unterbrochen wird.
Payload der „will“-NachrichtDie „will“-Nachricht, die dein MQTT-Broker veröffentlicht, wenn die MQTT-Integration gestoppt oder die Verbindung unterbrochen wird.
QoS der „will“-NachrichtDie Quality of Service der „will“-Nachricht, die von deinem MQTT-Broker veröffentlicht wird.
Retain für „will“-Nachricht aktivierenWenn dies festgelegt ist, behält dein MQTT-Broker die „will“-Nachricht bei.
Topic der „will“-NachrichtDas MQTT-Topic, in dem dein MQTT-Broker eine „will“-Nachricht veröffentlichen wird.

Texte aus dem Quellcode von Home Assistant, Apache License 2.0.

Aktionen

ExportierenSchreibt alle Nachrichten zu einem bestimmten Topic in die Datei mqtt_dump.txt in deinem Konfigurationsordner.Felder: Dauer, Topic
VeröffentlichenVeröffentlicht eine Nachricht in einem MQTT-Topic.Felder: Payload auswerten, Message Expiry Interval, Payload, QoS, Retain, Topic
Neu ladenLädt MQTT-Entitäten aus der YAML-Konfiguration neu.

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:MQTT-Protokoll-Migration fehlgeschlagen, MQTT ist nicht korrekt eingerichtet.

Erscheint in Vulpo

Schnellumschalterkarte, Rollladenkarte, Klimasteuerungs-Karte, Ventilatorkarte, Apple Watch, Kontrollzentrum, Klima-Live-Aktivität, Saugroboter-Live-Aktivität.

Widgets und Live-Aktivitäten in Vulpo