Het onderdeel MQTT publiceert dezelfde waarden naar elke broker. Het is vooral bedoeld voor wie naast Home Assistant andere platforms gebruikt, zoals openHAB, Node-RED, Domoticz of ThingsBoard, of wie Home Assistant liever zelf via een broker voedt.
Net als bij de native integratie gaan de gegevens rechtstreeks van de telefoon naar je broker.
Vul de broker in
Vul Brokeradres en Poort in. Vraagt de broker om authenticatie, vul dan ook Gebruiker en Wachtwoord in.
Zet Gebruik TLS (SSL) aan wanneer de broker buiten jouw netwerk bereikbaar is. Gebruik WebSocket en Basispad dienen brokers achter een proxy.
Het adres, de poort, de verbindingsopties en de inloggegevens worden alleen op deze telefoon bewaard. Op een andere telefoon met hetzelfde account vul je ze opnieuw in.
Kies de protocolversie
De knoppen MQTT 3.1.1 en MQTT 5.0 kiezen de versie. Bij twijfel kies je 3.1.1, de breedst ondersteunde.
Kies het formaat
MQTT-formaat legt de vorm van de topics en het formaat van elk bericht vast. Er zijn vijf opties:
- Home Assistant Discovery: met automatische ontdekking maken de entiteiten zichzelf aan, met naam, eenheid en pictogram.
- Homie 4.0: volgt de Homie-conventie.
- Eenvoudige topics: één waarde per topic, zonder extra structuur. Het makkelijkst te verwerken vanuit een script.
- Gecombineerde JSON: alles in één bericht, op het topic dat je instelt.
- ThingsBoard: het telemetrieformaat van ThingsBoard.
Sommige formaten hebben eigen instellingen, zoals JSON-payload (waarde + tijdstempel) bij de eenvoudige topics en Tijdstempel toevoegen bij ThingsBoard.
Stel het topicvoorvoegsel in
Onderwerpvoorvoegsel is de wortel van alles wat de app publiceert. Stel de waarde aan het begin in en verander hem daarna liever niet, want de wijziging laat de oude topics als wezen achter op de broker.
Test voor je weggaat
Tik op Verbinding testen. De test bevestigt het adres, de poort, TLS en de inloggegevens voordat je de transmissie aanzet.
Zet de transmissie aan en sla op
Zet Schakel transmissie in aan, stel het Verzendinterval in en sla op met de zwevende knop.
- Brokeradres en Poort
- Waarheen de app publiceert. Elke broker voldoet: Mosquitto, EMQX, de add-on binnen Home Assistant of een gehoste dienst.
- Gebruik TLS (SSL)
- Versleutelt de verbinding met de broker. Aanbevolen zodra hij buiten jouw netwerk bereikbaar is.
- Gebruik WebSocket en Basispad
- Bedoeld voor brokers achter een reverse proxy.
- MQTT-formaat
- Home Assistant Discovery, Homie 4.0, Eenvoudige topics, Gecombineerde JSON of ThingsBoard.
- Onderwerpvoorvoegsel
- De wortel van de gepubliceerde topics. Hem later veranderen laat de oude topics als wezen achter op de broker.
- Gebruiker en Wachtwoord
- De inloggegevens van de broker, wanneer die om authenticatie vraagt.
- Verbinding testen
- Bevestigt het adres, de poort, TLS en de inloggegevens voordat de transmissie wordt aangezet.
- Verzendinterval
- Hoe vaak de momentopname van de live sensoren wordt gestuurd.
- Opslaanknop
- Bewaart de instellingen van het actieve tabblad en de synchronisatiemodus.