2. Installer le firmware¶
Le firmware s'installe depuis la page d'installation, par l'USB : rien à compiler, il est compilé et signé par le projet (ADR-0022). Pour le compiler vous-même à la place : compiler son propre firmware.
1. Ouvrir la page d'installation¶
Ouvrez la page d'installation dans Chrome ou Edge, sur un ordinateur : elle parle à la tablette par Web Serial, que les autres navigateurs et les téléphones n'ont pas (la page le dit à la place de son bouton). Branchez la tablette à l'ordinateur avec un câble USB-C qui transmet les données.
2. Choisir sa puce d'écran¶
La puce d'écran est écrite sur l'autocollant au dos de la tablette, juste au-dessus du logo Espressif. Chacune a son firmware (révisions matérielles) :
| Puce d'écran | Fabriquées | Avec ce firmware |
|---|---|---|
| ST7123 | octobre 2025 → avril 2026 | celle de l'auteur, utilisée tous les jours |
| ST7121 | depuis avril 2026 | tourne chez un autre utilisateur depuis octobre 2026 |
| ILI9881C | mai → octobre 2025 | compilée, jamais essayée |
Une tablette étiquetée « ST7123 » peut porter une ST7121 : dans le doute, essayez l'une, puis l'autre.
Une Waveshare ESP32-P4 7B (une autre carte, 7 pouces, expérimentale) : choisissez « Waveshare ESP32-P4 7B », dans le canal Bêta pour l'instant, et branchez le port USB-C de son ESP32-P4 (Waveshare 7B).
3. Choisir le canal¶
Stable, sauf si vous voulez essayer la prochaine version avant tout le monde (Bêta, qui passe à la stable suivante). La tablette suit ensuite le canal installé : ses mises à jour arrivent dans Home Assistant (mises à jour). Pour changer de canal plus tard, réinstallez depuis la page, sans effacer. En Bêta, prenez aussi tab5_home_assistant.zip de cette pré-release (Assets sur la page des releases), ou laissez l'intégration HACS le faire avec les versions bêta activées : les fichiers de la stable n'ont pas ce que la pré-release ajoute côté Home Assistant.
4. Connecter et installer¶
- Connecter et installer. Le navigateur liste les ports série : la tablette s'appelle « USB JTAG/serial debug unit ». Si plusieurs ports portent ce nom, débranchez la tablette : celui qui disparaît est le sien.
- Une tablette neuve (elle porte la démo de M5Stack) : Install, puis acceptez d'effacer l'appareil. Une tablette déjà installée : Update, sans effacer : elle garde son Wi-Fi, sa clé de Home Assistant et ses réglages. Si la page propose Install à la place (elle ne reconnaît pas le firmware de la tablette), laissez « Erase device » décoché dans la boîte qui suit : un effacement emporte aussi la clé de Home Assistant et les réglages de l'écran, et Home Assistant attend ensuite une confirmation (réinstallée avec effacement).
- Attendez la fin de l'installation. La même fenêtre propose ensuite de régler le Wi-Fi : c'est l'étape 3.
Fermer la fenêtre redémarre la tablette une fois : c'est normal.
Vérifier un téléchargement (facultatif)¶
À partir de la release qui suit la 3.8.0-rc.3, chaque release porte un fichier SHA256SUMS et une attestation signée de l'endroit où ses fichiers ont été construits (le compte GitHub, le dépôt, le commit). Pour vérifier un fichier téléchargé à la main, depuis le dossier qui le contient :
sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify tab5-ha-hmi-st7123.ota.bin --repo Axellum/M5-Tab5-ESPHome-LVGL
La page d'installation et la tablette n'en ont pas besoin : la tablette n'accepte qu'un firmware signé par la clé du projet (ADR-0020), et la page contrôle le SHA-256 du manifeste.
Si ça ne marche pas¶
| Ce que vous voyez | Que faire |
|---|---|
| Aucun port dans la liste | un câble qui ne fait que charger ne montre aucun port : essayez un autre câble, puis un autre port USB de l'ordinateur |
| « Failed to initialize… holding the BOOT button » | le Tab5 n'a pas de bouton BOOT. Maintenez son bouton reset environ 2 s, jusqu'à ce que la LED verte interne clignote vite : la tablette est en mode téléchargement. Relancez Connecter et installer ; à la fin, un appui court sur reset la redémarre |
| Pas de bouton Install | la même version est déjà sur la tablette. Pour repartir de zéro, « Erase User Data » (en rouge, en bas) efface tout, Wi-Fi, clé et réglages compris (réveil, luminosité… : notez-les d'abord dans Home Assistant), puis réinstalle ; Home Assistant demande ensuite une confirmation (réinstallée avec effacement) |
| « Ce navigateur ne gère pas Web Serial » | Chrome ou Edge, sur un ordinateur |
| L'écran n'est pas normal après l'installation | peut-être la mauvaise puce d'écran : un autocollant « ST7123 » peut cacher une ST7121. Installez l'autre (Update, sans effacer) |
Autres cas déjà rencontrés sur cette tablette : incidents connus.
Ensuite : étape 3, le Wi-Fi.