MQTT voor Home Assistant (ingebouwde integratie)

Over dit item

MQTT is een ingebouwde integratie die Home Assistant verbindt met een MQTT-broker en lokaal werkt. Ze ondersteunt veel entiteitsplatforms, waaronder sensoren, schakelaars, bediening in de stijl van lichten zoals ventilatoren en rolluiken, klimaat, camera's, sloten en stofzuigers. Nieuwe apparaten kunnen verschijnen via automatische detectie, die een instelbaar topicvoorvoegsel gebruikt. Birth- en will-berichten kunnen worden ingesteld met een eigen topic, payload, quality of service en retain-opties. De verbinding ondersteunt inloggen met gebruikersnaam en wachtwoord, eigen CA-certificaten, clientcertificaten, een keuze van transport en een keep-aliveinterval. Acties publiceren een bericht naar een topic, exporteren berichten van een topic naar een bestand en laden entiteiten opnieuw die in YAML zijn gedefinieerd. Ze wordt ingesteld in de gebruikersinterface en de verbindingsinstellingen kunnen later worden gewijzigd.

Automatische samenvatting van de broncode van Home Assistant, automatisch vertaald. Klopt er iets niet? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Instellen in de interface Voeg het toe onder Instellingen > Apparaten en diensten. Er hoeft niets gedownload te worden.
Apparaattriggers De apparaten kunnen rechtstreeks automatiseringen starten.
Voegt nieuwe apparaten toe Nieuwe apparaten verschijnen zonder dat je het opnieuw hoeft in te stellen.
Instellingen later wijzigen De verbindingsinstellingen kunnen veranderen zonder dat je het verwijdert.
Platina kwaliteit De eigen beoordeling van Home Assistant van de code en het instellen ervan.
Bijgewerkt met Home Assistant Wordt meegeleverd en bijgewerkt met elke release van Home Assistant.

Levert

Klimaat
Boilers
Luchtbevochtigers
Ventilatoren
Rolluiken
Kleppen
Camera’s
Sloten
Alarmpanelen
Stofzuigers
Schakelaars
Sensoren
Aanwezigheid

Instellen

Je voegt het toe onder Instellingen > Apparaten en diensten, met “Voeg integratie toe”.

Stap 1

BrokerDe hostnaam of IP-adres van je MQTT broker.
WachtwoordHet wachtwoord om in te loggen bij je MQTT broker.
PoortDe poort waarnaar je MQTT broker luistert. Bijvoorbeeld 1883.
MQTT protocolDe gebruikte MQTT-protocolversie. Houd er rekening mee dat Home Assistant automatisch overschakelt naar versie 5 als de broker dit ondersteunt.
GebruikersnaamDe gebruikersnaam om in te loggen bij je MQTT broker.
Upload aangepast CA-certificaat bestandHet aangepaste CA-certificaat om het certificaat van je MQTT broker te valideren.
Upload client certificaatbestandHet clientcertificaat om mee te authenticeren tegen je MQTT broker.
Client ID (laat leeg om een random ID te genereren)Het unieke ID om de Home Assistant MQTT API te identificeren als MQTT client. Het wordt aanbevolen deze optie leeg te laten.
Uploaden van je privésleutelbestandHet privésleutelbestand dat hoort bij je clientcertificaat.
WachtwoordHet wachtwoord voor het privésleutelbestand (als deze is ingesteld).
De tijd tussen het versturen van keep-alive berichtenEen waarde minder dan 90 seconden wordt geadviseerd. Standaardwaarde is 60 seconden.
Broker certificaatvalidatieAls deze optie al op Aangepast staat, is er een aangepast CA-certificaat voor validatie geconfigureerd. Selecteer Auto voor automatische CA validatie, of upload een aangepast CA-certificaat om validatie van je MQTT broker certificaat toe te staan.
Een clientcertificaat gebruikenAls deze optie al is geselecteerd, is client certificaat authenticatie ingeschakeld. Upload een client en sleutel om in te schakelen.
De broker certificaatvalidatie negerenOptie om de validatie van je MQTT broker certificaat te negeren.
MQTT-transportHet transport om te gebruiken voor de connectie naar je MQTT broker.

Herauthenticatie is nodig met de MQTT broker

WachtwoordHet wachtwoord om in te loggen bij je MQTT broker.
GebruikersnaamDe gebruikersnaam om in te loggen bij je MQTT broker.

Na het instellen

Birth bericht inschakelenGeselecteerd zal Home Assistant een online bericht naar je MQTT broker sturen zoda MQTT klaar is met opstarten.
Birth bericht inhoudHet "birth" bericht dat is gepubliceerd wanneer MQTT klaar is opgestart en verbonden.
Birth bericht QoSDe "quality of service" van het "birth" bericht dat wordt gepubliceerd wanneer MQTT klaar is en verbonden.
Birth bericht vasthoudenGeselecteerd zal Home Assistant de "retain" vlag aanzetten op het "birth" bericht naar je MQTT broker.
Birth bericht topicHet MQTT topic waarop Home Assistant een "birth" bericht zal publiceren.
Discovery inschakelenOptie om de automatische ontdekking MQTT apparaten in te schakelen.
Discovery-voorvoegselDe prefix van de configuratie topics waarop de MQTT integratie zich zal abonneren.
Discovery QoSDe "quality of service" voor automatische discovery abonnementen op je MQTT broker.
Will bericht inschakelenWanner dit is geselecteerd zal Home Assistant je broker vragen om een "will" bericht te publiceren wanneer MQTT is gestopt of de verbinding met je MQTT broker is verloren.
Will bericht inhoudHet bericht dat je MQTT broker zal publiceren wanneer de verbinding is verbroken.
Will bericht QoSDe "quality of service" van het "will" bericht dat is gepubliceerd door je MQTT broker.
Will bericht vasthoudenGeselecteerd zal je MQTT broker de "retain" vlag zetten op het "will" bericht.
Will bericht topicHet MQTT topic waar je MQTT broker een "will" bericht naar publiceert.

Teksten uit de broncode van Home Assistant, Apache License 2.0.

Acties

ExporterenSchrijft alle berichten over een specifiek topic in het mqtt_dump.txt bestand in je configuratiemap.Velden: Duur, Topic
PubliceerPubliceert een bericht naar een MQTT-topic.Velden: Evalueer payload, Message Expiry Interval, Bericht, QoS, Vasthouden, Topic
HerladenHerlaadt MQTT-entiteiten uit de YAML-configuratie.

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:MQTT-protocolmigratie mislukt, MQTT is niet correct ingesteld

Te zien in Vulpo

“Snel wisselen”-kaart, Rolluik-kaart, Klimaat-kaart, Ventilator-kaart, Apple Watch, Bedieningspaneel, Klimaat-Live-activiteit, Stofzuiger-Live-activiteit.

Widgets en Live-activiteiten in Vulpo