MQTT

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

L'onglet MQTT publie les mêmes lectures sur n'importe quel broker. Il sert à qui alimente un système autre que Home Assistant, ou à qui préfère alimenter Home Assistant par son propre broker.

Comme pour l'intégration native, la connexion va de votre téléphone directement à votre machine, sans passer par nos serveurs.

  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.

  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.

Si quelque chose ne va pas

Vérifiez dans cet ordre : l'adresse et le port, si le téléphone est sur un réseau qui atteint le broker, si Utiliser TLS (SSL) correspond à ce que le broker attend, et si l'utilisateur et le mot de passe sont bons.

Le port 1883 tourne d'ordinaire sans TLS, et le 8883 avec TLS. Activer TLS face à un port qui ne l'utilise pas produit un échec sans message utile.

Choisissez le format Home Assistant Discovery, le seul avec découverte automatique. Sur les autres formats, les entités doivent être déclarées à la main.

Pour Home Assistant, pensez à l'intégration native : elle est bidirectionnelle, publie des événements sur le bus et ne demande aucun broker.

L'application demande si vous voulez nettoyer les sujets du format précédent. Si la réponse a été de les garder, ils restent sur le broker jusqu'à ce qu'ils y soient supprimés.

Pour Home Assistant, l'intégration native offre davantage : elle est bidirectionnelle, publie des événements sur le bus et ne demande aucun broker.

MQTT est le bon choix quand vous faites déjà tourner un broker, quand vous alimentez un système qui n'est pas Home Assistant, ou quand il vous faut les données à plusieurs endroits à la fois.

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