MQTT

Publier les lectures sur un broker à vous et choisir parmi les cinq formats de message.

La section MQTT publie les mêmes mesures vers n'importe quel broker. Elle s'adresse surtout à ceux qui utilisent d'autres plateformes que Home Assistant, comme openHAB, Node-RED, Domoticz ou ThingsBoard, ou qui préfèrent alimenter leur propre Home Assistant via un broker.

Comme pour l'intégration native, les données vont directement du téléphone à votre broker.

  1. Renseignez le broker

    Renseignez Adresse du broker et Port. Si le broker demande une authentification, renseignez aussi Utilisateur et Mot de passe.

    Activez Utiliser TLS (SSL) quand le broker est exposé hors de votre réseau. Utiliser WebSocket et Chemin de base servent aux brokers derrière un proxy.

    L'adresse, le port, les options de connexion et les identifiants sont enregistrés uniquement sur ce téléphone. Sur un autre téléphone avec le même compte, renseignez-les à nouveau.

  2. Choisissez la version du protocole

    Les boutons MQTT 3.1.1 et MQTT 5.0 sélectionnent la version. Dans le doute, choisissez 3.1.1, la plus largement compatible.

  3. Choisissez le format

    Format MQTT fixe la forme des sujets et le format de chaque message. Il y a cinq options :

    • Home Assistant Discovery : avec la découverte automatique, les entités se créent toutes seules, avec nom, unité et icône.
    • Homie 4.0 : suit la convention Homie.
    • Sujets simples : une valeur par sujet, sans structure supplémentaire. Le plus facile à consommer depuis un script.
    • JSON unifié : tout dans un seul message, sur le sujet que vous fixez.
    • ThingsBoard : le format de télémétrie de ThingsBoard.

    Certains formats ont des réglages à eux, comme Charge utile JSON (valeur + horodatage) sur les sujets simples et Inclure l'horodatage sur ThingsBoard.

  4. Fixez le préfixe des sujets

    Préfixe du sujet est la racine de tout ce que l'application publie. Fixez la valeur au départ et évitez de la changer ensuite, car le changement laisse les anciens sujets orphelins sur le broker.

  5. Testez avant de quitter

    Touchez Tester la connexion. Le test confirme l'adresse, le port, TLS et les identifiants avant que vous n'activiez la transmission.

  6. Activez la transmission et enregistrez

    Activez Activer la transmission, réglez l'Intervalle de transmission et enregistrez avec le bouton flottant.


← Tous les guidesDans la FAQ : Home Assistant et MQTT →