1. Fichiers Home Assistant

Tout le côté Home Assistant tient dans une archive, tab5_home_assistant.zip, jointe à chaque release. Rien à remplir : chaque valeur de votre maison se choisit ensuite dans Home Assistant, à la souris (ADR-0024).

Deux façons de les mettre en place : avec HACS, qui les met ensuite à jour en un clic à chaque release, ou à la main, parties A à C ci-dessous.

Avec HACS

Depuis la release 3.7.0, les fichiers viennent aussi avec une petite intégration, « Tab5 », que HACS installe (ADR-0035). HACS doit déjà être installé. HACS ne propose que les releases complètes : les pré-releases (canal Bêta) seulement si les versions bêta sont activées pour ce dépôt dans HACS.

1. Ajoutez la ligne packages: de la partie B à configuration.yaml, si elle n'y est pas déjà.
2. Ouvrir Tab5 dans HACS : le lien passe par My Home Assistant, qui demande l'adresse de votre Home Assistant la première fois, puis HACS propose d'ajouter le dépôt : Add (ajouter ; une boîte avec un titre seul : rechargez la page, incidents connus). Sans le lien : ⋮ (en haut à droite) → Custom repositories (dépôts personnalisés), dépôt https://github.com/Axellum/M5-Tab5-ESPHome-LVGL, type Integration, Add, puis cherchez Tab5 dans HACS et ouvrez-le.
3. Sur la page de Tab5 dans HACS, Download (télécharger).
4. Redémarrez Home Assistant.
5. Paramètres → Appareils et services → Ajouter une intégration → Tab5. Laissez « Mettre ensuite la tablette à jour » coché pour que le firmware de la même version s'installe après les fichiers, à chaque release (mises à jour).

L'intégration pose alors les fichiers toute seule, sans autre redémarrage. C'est bon si une notification « Tab5 : fichiers Home Assistant 3.x.y » dit combien de fichiers ont été posés, et que les entités « Tab5 · » sont là (voir la partie C). Vos propres packages, modèles et blueprints ne sont jamais touchés, et retirer l'intégration laisse les fichiers en place. Rien d'autre à faire sur cette page : passez à l'étape 2, installer le firmware.

Assistant de configuration (depuis la 3.8, ADR-0052) : une fois les fichiers en place, Paramètres → Système → Corrections affiche « Tab5 : configurer la tablette depuis vos pièces ». Il prépare l'automatisation de l'étape 6 à partir de vos pièces de Home Assistant : jusqu'à cinq pièces, les mieux équipées d'abord, chacune avec ses lumières, volets, interrupteurs, ventilateurs et lecteurs (cinq au plus), ses capteurs de température et d'humidité et sa climatisation. Puis une page Maison (TV, batterie du téléphone, seconde température, clim, pots, météo : remplis seulement quand votre Home Assistant n'a qu'une réponse) et une page Agendas et personnes (les listes « Tab5 · … » : un choix déjà fait reste, une liste encore sur « Aucun » reçoit une proposition quand une seule entité convient, par exemple un agenda nommé « travail »). Chaque page est déjà remplie : vérifiez, changez ce que vous voulez, Valider. La dernière page récapitule ; valider écrit l'automatisation dans automations.yaml (sauvegardé avant dans tab5_sauvegardes/automatisations/) et recharge les automatisations, puis règle les listes changées. Une automatisation du blueprint déjà là ne change que si vous cochez « Remplacer les pièces et les entrées de la maison de l'automatisation existante », et seulement celles-ci (ADR-0053). Si automations.yaml ne peut pas être écrit sans risque (autre inclusion, un !secret dedans), rien n'est écrit et une notification donne le YAML à coller. Relancez-le quand vous voulez : Paramètres → Appareils et services → Tab5 → Configurer, case « Lancer l'assistant de configuration ». Il faut vos appareils rattachés à des pièces dans Home Assistant ; sans aucune, il le dit et ne change rien.

A. Télécharger et décompresser

Téléchargez tab5_home_assistant.zip depuis la dernière release (Assets, en bas de la release) et décompressez-la dans le dossier config/ de Home Assistant, celui de configuration.yaml : partage Samba, ou le module File editor ou Studio Code Server. Elle y ajoute trois dossiers :

Dossier	Ce qu'il contient
packages/	les automatisations et scripts qui alimentent l'écran, et les listes « Tab5 · » de l'étape 5
custom_templates/	le tableau de bord de l'étape 7, et le lecteur de certaines vigilances
blueprints/automation/tab5/	le blueprint de l'étape 6

Attention

Les dossiers vont directement dans config/. Certains outils décompressent dans un nouveau dossier au nom de l'archive (tab5_home_assistant/). Les trois dossiers doivent être directement dans config/, à côté de configuration.yaml. Un dossier packages/ que vous avez déjà garde ses fichiers : l'archive n'ajoute que les siens.

Un quatrième dossier, tab5_optionnel/, n'est pas chargé : voir un volet qui ne signale rien.

B. Une ligne dans configuration.yaml

La seule ligne de YAML à écrire (rien à faire si elle y est déjà) :

homeassistant:
  packages: !include_dir_named packages

Si homeassistant: existe déjà, ajoutez seulement la ligne packages: dessous, en retrait comme les lignes déjà là.

Facultatif, depuis la 3.8 : l'alerte levée quand une poussée vers la tablette ne se rend pas (packages/tab5_health.yaml) demande aussi system_log: fire_event: true dans configuration.yaml, puis un redémarrage. HACS ne peut pas l'ajouter pour vous ; sans elle, cette seule alerte reste muette, tout le reste marche.

C. Vérifier, puis redémarrer

Outils de développement → YAML → Vérifier la configuration, puis redémarrez Home Assistant (Paramètres → ⋮ → Redémarrer Home Assistant).

C'est bon si Paramètres → Appareils et services → Entités, en cherchant « Tab5 · », liste les entités « Tab5 · source des prévisions », « Tab5 · agenda de travail »… Vous les réglerez à l'étape 5, une fois la tablette là.

Un volet qui ne signale rien

tab5_optionnel/volet_serre_tracking.yaml ne sert qu'à un volet qui ne signale ni sa position ni sa course (le moteur Tuya de l'auteur) : copiez-le dans packages/, rechargez, et choisissez le volet dans « Tab5 · volet à course simulée ». Il n'est pas installé par défaut : le volet choisi dans cette liste ne reçoit plus les commandes du blueprint mais celles du script du package, qui chronomètre sa course. Réglez cette durée dans « Tab5 · course du volet » (en secondes, 26 par défaut ; depuis la 3.8). Laissée sur « Aucun », la liste ne change rien. Avec HACS, copiez-le depuis config/custom_components/tab5/fichiers/tab5_optionnel/ : une fois dans packages/, l'intégration le met à jour avec les autres.

D'où viennent ces fichiers

Les mêmes fichiers sont dans le dépôt (HomeAssistant_Config/packages/, custom_templates/, blueprints/, optionnel/) ; HomeAssistant_Config/README.md dit le rôle de chaque package. Ils sont exactement ce qui tourne sur le Home Assistant de l'auteur depuis le 26/09/2026, sans aucune retouche propre à sa maison depuis le 28/09/2026 : pas de version privée, rien à fusionner dans automations.yaml ou scripts.yaml.

Déjà installé, et vous mettez à jour ? Mises à jour.

Ensuite : étape 2, installer le firmware.