Comment Home Assistant détecte-t-il et réconcilie-t-il les changements entre les appareils ?

Home Assistant détecte et réconcilie les changements d’appareils en associant les nouvelles observations à des identifiants d’intégration stables, puis en mettant à jour les registres des appareils, des entités et des états.

La détection peut s’effectuer via multidiffusion, Bluetooth, USB, MQTT, une API cloud ou une analyse d’intégration. Le nom ou l’adresse observés peuvent changer. Home Assistant s’appuie donc sur les identifiants fournis par l’intégration pour déterminer s’il s’agit d’un appareil existant, d’un nouvel appareil ou d’un conflit. La réconciliation met à jour les métadonnées et la disponibilité tout en essayant de préserver les références d’entités utilisées par les tableaux de bord et les automatisations.

La détection produit des candidats, pas une identité définitive

Un paquet de détection ou une analyse peut révéler une adresse, un modèle, un service annoncé, un numéro de série ou un topic. Ces observations sont des candidats, car les noms et les adresses IP peuvent changer et des annonces en double peuvent exister. L’intégration interprète le protocole et propose une entrée de configuration ou une mise à jour, au lieu de considérer chaque paquet comme un nouvel appareil domestique.

Les limites du réseau déterminent quel trafic de détection atteint Home Assistant. Cette discussion sur la détection réseau des conteneurs montre pourquoi un conteneur peut disposer d’une connectivité IP normale tout en ne détectant pas la multidiffusion, qui dépend du mode réseau et du comportement du sous-réseau.

L’ajout manuel peut tout de même fonctionner lorsque la détection passive ne peut pas franchir cette limite, mais cela ne répare pas la détection elle-même. Distinguez la résolution de noms, la monodiffusion routée, le transfert multicast et les passerelles propres à chaque protocole. Un appareil qui n’apparaît qu’après une modification du réseau révèle une relation d’accessibilité, pas nécessairement un défaut d’intégration.

Les identifiants stables préservent la continuité des registres

Les intégrations attribuent des identifiants uniques qui relient un appareil physique ou logique aux enregistrements de configuration, d’appareil et d’entité. Les noms conviviaux et les identifiants d’entité sont des références destinées à l’utilisateur et peuvent être renommés ; ils constituent des preuves d’identité moins fiables qu’un numéro de série de protocole, qu’un identifiant dérivé de l’adresse MAC ou qu’une clé de compte propre à l’intégration.

Le remplacement du matériel tout en conservant l’historique met en évidence la distinction entre identité et nom d’affichage. Ce processus de remplacement d’entité montre comment les choix concernant les registres et les identifiants d’entité influencent la continuité des automatisations et des statistiques à long terme.

La continuité échoue lorsque le micrologiciel modifie un identifiant, lorsque deux appareils revendiquent le même identifiant ou lorsqu’une intégration modifie sa règle d’association. Ne supprimez pas et ne redétectez pas l’appareil à répétition avant d’avoir relevé les anciennes et les nouvelles valeurs des registres. Ces éléments permettent de déterminer si la réponse sûre consiste en un renommage, une migration, une correction de l’intégration ou la création d’un nouvel appareil.

La réconciliation fusionne les événements avec l’état existant

Après la configuration, une intégration interroge, s’abonne ou écoute les événements transmis, puis traduit les données du protocole en états et attributs d’entités. La réconciliation compare les observations actuelles aux définitions des registres, marque les entités comme indisponibles, ajoute les nouvelles fonctionnalités prises en charge et peut retirer les métadonnées obsolètes. Il s’agit d’un cycle de vie continu, et non d’un simple écran de détection initial.

La détection MQTT rend les changements d’identifiants et de noms particulièrement visibles, car les appareils publient des charges utiles de configuration que Home Assistant traite de manière répétée. La discussion sur le changement de nom MQTT montre pourquoi la politique de renommage doit préserver une identité stable tout en permettant aux métadonnées d’affichage d’évoluer.

Un appareil retardataire peut être temporairement indisponible sans être supprimé, tandis qu’une charge utile contenant un nouvel identifiant unique peut créer un doublon. La limite critique apparaît lorsque la rotation des identifiants interrompt les automatisations ou divise l’historique. Conservez les messages et les enregistrements des registres avant toute tentative de nettoyage.

-15% OFF

ZimaBoard 2 - Mini serveur domestique pour votre grande idée

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Vérifiez la réconciliation avec une matrice de changements

Choisissez un appareil de test et notez son intégration, ses identifiants uniques, son enregistrement d’appareil, ses identifiants d’entité, ses noms conviviaux, sa zone, ses automatisations et son historique récent. Testez ensuite séparément quatre changements contrôlés : l’adresse IP, le nom convivial, une période temporaire hors ligne et une mise à jour des fonctionnalités prises en charge. Rétablissez chaque changement avant de passer au suivant.

Utilisez le modèle ZimaSpace de la détection et du routage pour déterminer si un changement manqué relève du transport ou de la réconciliation des registres.

Le test est réussi lorsque le même enregistrement d’appareil est conservé, que les métadonnées attendues sont modifiées, que les entités redeviennent disponibles après une période hors ligne, que les automatisations conservent leurs références et que l’historique reste cohérent. Arrêtez-vous si un appareil en double apparaît ou si un identifiant d’entité change de manière inattendue. Exportez les diagnostics et comparez les identifiants avant de supprimer l’un ou l’autre des enregistrements.