Home Assistant peut effectuer des communications MQTT grâce à l'intégration MQTT.
Cette intégration installera un client MQTT avec la possibilité d'installer également un agent.
Rappel : pour qu'une communication MQTT ait lieu, il faut :
Dans cette fiche :
Pour installer l'intégration MQTT dans Home Assistant :
Dans l'écran suivant, choisissez l'une des options :
La configuration du client MQTT consiste principalement à indiquer les coordonnées de l'agent MQTT à utiliser.
Les configurations du client MQTT seront enregistrées dans le fichier /mnt/data/supervisor/homeassistant/.storage/core.config_entries.
Une fois le client correctement configuré, Home Assistant pourra publier sur des canaux et à s'abonner à d'autres canaux sur ce même agent.
Il est possible en tout temps de modifier les configurations du client MQTT. Rendez-vous dans le menu / / Clic sur la tuile / Clic sur les trois points verticaux / .
Pendant le processus d'installation du client MQTT, vous devez préciser si vous souhaitez travailler avec un agent MQTT installé sur le même Raspberry Pi que Home Assistant ou utiliser un agent MQTT externe.
Pour travailler avec l'agent test.mosquitto.org, choisissez .
Avec l'agent test.mosquitto.org, il n'y a pas de code d'usager ni de mot de passe à fournir.
Il ne faut pas oublier que toutes les informations publiées sur test.mosquitto.org sont publiques donc il ne faut utiliser cet agent que pour faire des tests avec des données non sensibles.
Remarquez que dans cet exemple, le port 1883 est utilisé pour les communications non cryptées.
Notez que puisque l'agent test.mosquitto.org est un agent de test, il n'y a pas de garantie qu'il fonctionne correctement en tout temps.
De plus, il est possible qu'il limite le nombre de connexions en provenance d'une même adresse IP publique (toutes les boîtes domotiques de la classe ont la même adresse IP publique).
Si vous obtenez le message « Échec de connexion », assurez-vous que vous avez bien écrit l'URL de l'agent puis réessayez.
Si cela ne fonctionne toujours pas, il faudra qu'une autre personne de la classe referme sa connexions pour que vous y ayez accès.
Parfois, c'est l'agent qui est temporairement non disponible. Il faut alors réessayer plus tard. Notez qu'il peut arriver que l'agent ne soit pas disponible pendant plusieurs heures.
Pour installer un agent MQTT sur le même Raspberry Pi que Home Assistant, vous pouvez cliquer sur lors de l'installation du client. L'agent sera alors installé en même temps que le client.
Vous pouvez alors modifier les configurations de l'agent en vous rendant dans le menu / / Clic sur la tuile / Clic sur les trois points verticaux / .
Avec ce type d'installation, un autre système pourra utiliser cet agent à l'aide de ces informations :
Dans l'écran de configuration de l'agent MQTT, si vous cliquez sur l'icône pour voir le mot de passe, vous verrez apparaître __**password_not_changed**__.
Pour retrouver le mot de passe, vous devez consulter le fichier /mnt/data/supervisor/homeassistant/.storage/core.config_entries).
...{"broker":"core-mosquitto","discovery":true,"password":"Ath4Goh4Ierai0ahWaeSiejeaquat8ailohk7raiyoo4xeeLe6TooKo8aejo3sha","port":1883,"username":"homeassistant"} ...
Il est également possible de modifier le code d'usager et son mot de passe comme suit :
Si vous avez installé votre client MQTT en cliquant sur , aucun agent n'aura été installé sur votre Home Assistant.
Il est possible d'ajouter un agent après que l'installation du client ait été complétée.
Cette technique permet également de remettre les configurations en place si vous avez utilisé un autre agent MQTT et que vous désirez revenir à l'agent installé sur votre Home Assistant.
L'agent MQTT à utiliser peut être installé n'importe où, en autant que votre boîte domotique y ait accès.
Dans cet exemple, l'agent est installé sur un second Raspberry Pi ou sur tout autre ordinateur.
Pour savoir si Home Assistant peut accéder à cet agent, il suffit de faire un ping vers son adresse IP.
Afin de sécuriser la communication, il faut utiliser le port 8883.
Il faut alors activer les options avancées puis configurer le certificat TLS.
Pour plus d'information : https://www.home-assistant.io/integrations/mqtt/#advanced-broker-configuration
Avant d'automatiser les publications MQTT, c'est une bonne idée de tester vos configurations.
Cet écran vous permet de publier un paquet ou d'écouter un sujet.
Pour publier un paquet, il suffit d'entrer le nom du canal désiré dans la zone puis d'entrer la valeur à publier.
Les valeurs publiées pourront être utilisées par un autre système au même titre que si la publication avait été faite à l'aide d'une automatisation, par exemple.
Attention : si vous ajoutez un saut de ligne, ce saut de ligne fera partie de la valeur envoyée.
Ici, vous pouvez écouter un sujet pour vérifier si vos configurations sont correctes.
Ceci est utile seulement pour tester MQTT.
Avec cette technique, si votre boîte Home Assistant est redémarrée, elle ne réagira plus aux messages reçus sur ce canal.
Pour un vrai abonnement MQTT, il faut utiliser la technique officielle.
Dans la zone , entrez le nom du canal désiré.
Cliquez sur .
Dès qu'une information est publiée sur ce canal, elle apparaîtra au bas de l'écran.
Si vous désirez écouter tout ce qui se publie sur un canal, peu importe les sous-niveaux, vous pouvez utiliser un #.
Par exemple, pour écouter tout ce qui se dit sur le canal jeedom, peu importe les sous-niveaux, vous écouterez le canal jeedom/#.
Les techniques pour utiliser le client MQTT sont détaillées dans la fiche « Publication et abonnement MQTT avec Home Assistant ».
▼Publicité
