MQTT

De metingen publiceren naar een eigen broker en kiezen tussen de vijf berichtformaten.

Het tabblad MQTT publiceert dezelfde metingen naar elke broker. Het dient wie een ander systeem dan Home Assistant voedt, of wie Home Assistant liever via de eigen broker voedt.

Net als bij de eigen integratie loopt de verbinding van jouw telefoon rechtstreeks naar jouw machine, zonder langs onze servers te gaan.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. Test voor je weggaat

    Tik op Verbinding testen. De test bevestigt het adres, de poort, TLS en de inloggegevens voordat je de transmissie aanzet.

  6. Zet de transmissie aan en sla op

    Zet Schakel transmissie in aan, stel het Verzendinterval in en sla op met de zwevende knop.

Als er iets misgaat

Controleer in deze volgorde: het adres en de poort, of de telefoon op een netwerk zit dat de broker bereikt, of Gebruik TLS (SSL) overeenkomt met wat de broker verwacht, en of gebruiker en wachtwoord kloppen.

Poort 1883 draait meestal zonder TLS, en 8883 met TLS. TLS aanzetten tegen een poort die het niet gebruikt levert een mislukking op zonder nuttige melding.

Kies het formaat Home Assistant Discovery, het enige met automatische ontdekking. Bij de andere formaten moeten de entiteiten met de hand worden aangemaakt.

Overweeg voor Home Assistant de eigen integratie: die werkt twee kanten op, publiceert gebeurtenissen op de bus en heeft geen broker nodig.

De app vraagt of je de topics van het vorige formaat wilt opruimen. Was het antwoord om ze te houden, dan blijven ze op de broker staan tot ze daar worden verwijderd.

Voor Home Assistant biedt de eigen integratie meer: die werkt twee kanten op, publiceert gebeurtenissen op de bus en heeft geen broker nodig.

MQTT is de juiste keuze wanneer je al een broker draait, wanneer je een systeem voedt dat geen Home Assistant is, of wanneer je de gegevens tegelijk op meer dan één plek nodig hebt.

← Alle handleidingenIn de FAQ: Home Assistant en MQTT →