Aller au contenu

Guide d'installation

Sept étapes, dans cet ordre : rien à compiler, le firmware s'installe depuis le navigateur. Les étapes 1 à 6 sont nécessaires, la 7 est facultative.

Envie de voir d'abord ? Le mode démo montre le tableau de bord complet sur une tablette flashée, sans aucun Home Assistant.

Ce qu'il faut

  • Un M5Stack Tab5, et le nom de sa puce d'écran : il est écrit sur l'autocollant au dos, au-dessus du logo Espressif (ST7123, ST7121 ou ILI9881C, voir les révisions matérielles). La Waveshare ESP32-P4 7B de 7 pouces le fait tourner aussi, à l'essai : son firmware s'installe depuis la même page, dans le canal bêta pour l'instant, ou se compile sur votre ordinateur (Waveshare 7B).
  • Un ordinateur avec Chrome ou Edge (la page d'installation parle à la tablette par Web Serial) et un câble USB-C qui transmet les données : avec un câble de charge seule, aucun port n'apparaît.
  • Home Assistant 2026.8 ou plus récent, toute méthode d'installation, et un moyen de copier des fichiers dans son dossier config/ : partage Samba, ou le module File editor ou Studio Code Server. Avec HACS, seulement pour la ligne de configuration.yaml : l'intégration « Tab5 » que HACS installe pose les fichiers, puis les met à jour en un clic à chaque release.
  • Un réseau Wi-Fi en 2,4 GHz : la puce Wi-Fi 6 de la tablette est donnée pour le 2,4 GHz seul (fiche M5Stack du Tab5). Une box qui réunit les deux bandes sous un même nom n'exige rien ; avec deux noms distincts, choisissez celui du 2,4 GHz.
  • Une source d'alimentation USB-C. M5Stack ne donne aucune valeur d'entrée ; un chargeur 5 V / 2 A est un conseil, pas une exigence, et la tablette de l'auteur tourne sur un port USB de PC (alimentation).
  • Facultatif : une intégration météo (Met.no vient avec Home Assistant), vos agendas, un assistant vocal Home Assistant (voir les deux modes vocaux).

Les sept étapes

Étape Où Ce que vous faites
1. Fichiers Home Assistant Home Assistant décompresser une archive (ou laisser HACS le faire), ajouter une ligne à configuration.yaml, redémarrer
2. Installer le firmware la page d'installation, par l'USB choisir sa puce d'écran, Connecter et installer
3. Wi-Fi la même fenêtre, ou un téléphone donner son réseau à la tablette
4. Ajouter la tablette à Home Assistant Home Assistant Configurer l'appareil découvert, dans les 30 minutes
5. Vos sources Home Assistant météo, agendas, téléphone… dans les listes « Tab5 · »
6. Vos appareils Home Assistant une automatisation depuis le blueprint : pièces et tuiles
7. Un tableau de bord (facultatif) Home Assistant tous les réglages de la tablette dans un tableau de bord

Pourquoi Home Assistant d'abord : la tablette reçoit de ces fichiers tout ce qu'elle affiche, et leur demande le reste par des événements. Sans eux elle ne plante pas, mais rien de votre maison n'arrive à l'écran.

Les captures des pages de Home Assistant lui-même (page de l'appareil, table des entités, éditeurs d'automatisation et de modèle) viennent du test d'installation à neuf du projet : un Home Assistant neuf avec des appareils de test, où ces étapes sont rejouées pour de vrai à chaque changement des fichiers Home Assistant ou de l'API de la tablette.

Après l'installation

Tout le reste se règle dans Home Assistant, à la souris : les listes « Tab5 · » pour vos sources (étape 5), une automatisation créée depuis le blueprint pour vos pièces, tuiles, capteurs, caméras, ce que montre chaque zone de l'accueil et ce que fait chaque geste (étape 6). Chaque champ est facultatif et expliqué ; un changement arrive aussitôt à l'écran, sans flash.

Première installation : rien n'apparaît ?

Ce que vous voyez Ce qu'il faut vérifier
Aucune entité « Tab5 · » dans Home Assistant Les trois dossiers sont directement dans config/ (pas dans un dossier tab5_home_assistant/), la ligne packages: est dans configuration.yaml, et Home Assistant a redémarré : étape 1.
Home Assistant ne trouve pas la tablette La tablette a son Wi-Fi (étape 3) et elle a démarré il y a moins de 30 minutes : redémarrez-la pour rouvrir la fenêtre (étape 4).
L'écran est en français C'est le réglage par défaut. Changez « Langue » dans les réglages de la tablette ; la tablette redémarre pour l'appliquer.
L'horloge s'affiche, mais ni météo, ni pièces, ni tuiles Normal tant que les étapes 5 et 6 ne sont pas faites : la liste « Tab5 · source des prévisions » (étape 5, fournisseurs météo) et le blueprint (étape 6).

Un souci ? Incidents connus.