MQTT pour Home Assistant (intégration native)

À propos

MQTT est une intégration native qui connecte Home Assistant à un broker MQTT et fonctionne en local. Elle prend en charge de nombreuses plateformes d’entités, dont les capteurs, les interrupteurs, des commandes de type lumière comme les ventilateurs et les volets, la climatisation, les caméras, les serrures et les aspirateurs. Les nouveaux appareils peuvent apparaître grâce à la découverte automatique, qui utilise un préfixe de topic configurable. Les messages de naissance et de dernière volonté peuvent être définis avec leur propre topic, leur propre contenu, leur qualité de service et leurs options de conservation. La connexion prend en charge l’authentification par nom d’utilisateur et mot de passe, les certificats CA personnalisés, les certificats client, un choix de transport et un intervalle de keep alive. Les actions publient un message sur un topic, exportent les messages d’un topic vers un fichier et rechargent les entités définies en YAML. Elle se configure dans l’interface, et ses réglages de connexion peuvent être modifiés par la suite.

Résumé automatique du code source de Home Assistant, traduit automatiquement. Une erreur ? Prendre contact

Prise en charge

Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Configuration dans l’interface Ajoute-la dans Paramètres > Appareils et services. Rien à télécharger.
Déclencheurs d’appareil Ses appareils peuvent lancer des automatisations directement.
Ajoute les nouveaux appareils Les nouveaux appareils apparaissent sans avoir à tout reconfigurer.
Paramètres modifiables ensuite Ses paramètres de connexion peuvent changer sans qu’il faille la supprimer.
Qualité platine La note que Home Assistant donne lui-même à son code et à son expérience de configuration.
Mise à jour avec Home Assistant Livrée et mise à jour avec chaque version de Home Assistant.

Fournit

Climatisation
Chauffe-eau
Humidificateurs
Ventilateurs
Volets
Vannes
Caméras
Serrures
Alarmes
Aspirateurs
Interrupteurs
Capteurs
Présence

Mise en place

Elle s’ajoute dans Paramètres > Appareils et services, avec « Ajouter une intégration ».

Étape 1

BrokerLe nom d'hôte ou l'adresse IP de votre broker MQTT.
Mot de passeLe mot de passe pour vous connecter à votre broker MQTT.
PortLe port sur lequel votre broker MQTT écoute. Par exemple 1883.
Protocole MQTTLa version du protocole MQTT utilisée. Notez que Home Assistant basculera silencieusement vers la version 5 si votre broker la prend en charge.
Nom d'utilisateurLe nom d'utilisateur pour vous connecter à votre broker MQTT.
Téléverser le certificat de l'autorité de certification personnaliséLe fichier de certificat CA personnalisé pour valider le certificat de votre broker MQTT.
Téléverser le certificat clientLe certificat client pour vous authentifier auprès de votre broker MQTT.
ID client (laisser vide pour en générer un aléatoirement)L'ID unique pour identifier l'API MQTT de Home Assistant en tant que client MQTT. Il est recommandé de laisser cette option vide.
Téléverser la clé privéeLe fichier de clé privée qui appartient à votre certificat client.
Mot de passeLe mot de passe du fichier de clé privée (si défini).
Le temps entre l'envoi de messages Keep AliveUne valeur inférieure à 90 secondes est conseillée. La valeur par défaut est de 60 secondes.
Validation du certificat du brokerLorsqu'il est déjà réglé sur Personnalisé, un certificat de validation CA personnalisé est configuré. Sélectionnez Auto pour une validation CA automatique, ou téléversez un certificat CA personnalisé, afin de permettre la validation du certificat de votre broker MQTT.
Utiliser un certificat clientLorsqu'il est déjà sélectionné, l'authentification par certificat client est activée. Téléversez un certificat client et une clé pour l'activer.
Ignorer la validation du certificat du brokerOption pour ignorer la validation du certificat de votre broker MQTT.
Transport MQTTLe transport à utiliser pour la connexion à votre broker MQTT.

Ré-authentification requise auprès du broker MQTT

Mot de passeLe mot de passe pour vous connecter à votre broker MQTT.
Nom d'utilisateurLe nom d'utilisateur pour vous connecter à votre broker MQTT.

Après la mise en place

Activer le message de naissanceLorsque cette option est activée, Home Assistant publiera un message « en ligne » à votre broker MQTT lorsque MQTT est prêt.
Contenu du message de naissanceLe message de « naissance » qui est publié lorsque MQTT est prêt et connecté.
QoS du message de naissanceLa qualité de service du message de « naissance » qui est publié lorsque MQTT est prêt et connecté
Retenir le message de naissanceLorsque cette option est activée, Home Assistant conservera le message de « naissance » publié sur votre broker MQTT.
Topic du message de naissanceLe topic MQTT où Home Assistant publiera un message de « naissance ».
Activer la découverteOption pour activer la découverte automatique MQTT.
Préfixe de découverteLe préfixe des topics de configuration auxquels l'intégration MQTT s'abonnera.
QoS de découverteLa qualité de service des abonnements de découverte à votre broker MQTT.
Activer le message de testamentLorsque cette option est activée, Home Assistant demandera à votre broker de publier un message « testamentaire » lorsque MQTT est arrêté ou lorsqu'il perd la connexion avec votre broker.
Contenu du message de testamentLe message « testamentaire » que votre broker MQTT publiera lorsque l'intégration MQTT est arrêtée ou lorsque la connexion est perdue.
QoS du message de testamentLa qualité de service du message « testamentaire » publié par votre broker MQTT.
Retenir le message de testamentSi cette option est activée, votre broker MQTT conservera le message « testamentaire ».
Topic du message de testamentLe topic MQTT sur lequel votre broker MQTT publiera un message « testamentaire ».

Textes issus du code source de Home Assistant, Apache License 2.0.

Actions

ExporterÉcrit tous les messages sur un topic spécifique dans le fichier mqtt_dump.txt de votre dossier de configuration.Champs : Durée, Topic
PublierPublie un message dans un topic MQTT.Champs : Évaluer la charge utile, Intervalle d'expiration de message, Charge utile, QoS, Conservation, Topic
RechargerRecharge les entités MQTT à partir de la configuration YAML.

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Échec de la migration du protocole MQTT, MQTT n'est pas correctement configuré

S’affiche dans Vulpo :

carte Bascule rapide, carte Volet, carte Climat, carte Ventilateur, Apple Watch, centre de contrôle, Activité en direct de climatisation, Activité en direct d’aspirateur.

Widgets et Activités en direct dans Vulpo