Remerciements à : Bertrand GEAIFFRAI qui a partagé cette information sur le salon Telegram dédié au TDeck.
Cet article n’est que la traduction de la documentation officielle Meshtastic que vous pouvez retrouver en suivant ce lien. Il a le mérite d’exister et je tiens encore à remercier les membres de la communauté qui comme Bertrand GEAIFFRAI partagent ou communiquent les informations.
Qu’est ce que Meshtastic UI ?
Meshtastic UI (MUI) est une interface utilisateur indépendante pour les appareils Meshtastic, conçue pour une interaction directe avec le réseau sans nécessiter d’application mobile pour la plupart des réglages de base. Initialement développée pour les appareils tactiles autonomes, MUI a depuis été étendue pour prendre en charge les systèmes Linux natifs, ce qui en fait une solution polyvalente sur différentes plateformes matérielles. Si de nombreux paramètres peuvent être configurés directement, certaines options avancées peuvent nécessiter l’appairage avec un autre appareil, comme un téléphone.
Le développement de MUI a débuté début 2024 et, après plus d’un an de travail intensif, la première version préliminaire a été publiée début 2025. À cette date, elle comptait 12 000 lignes de code manuscrit, 50 000 lignes de code généré, avait été portée avec succès sur 10 appareils différents et traduite en 18 langues. MUI continuera d’évoluer avec de nouvelles fonctionnalités, des optimisations et une prise en charge matérielle étendue.

Les appareils pris en charge
- Appareils LoRa autonomes avec ESP32 S3 et écran TFT
- LilyGo T Deck / T Deck Plus
- Heltec Expand Board (avec l’option écran TFT) pour le V4
- Indicateur Seeed SenseCAP
- unPhone
- PICOrdinateur
- Appareils de type CYD avec ESP32 S3 connectés via série à n’importe quel appareil LoRa
- T HMI
- Réplicateur Mesh Tab (ESP4848S040)
- Makerfabs 4″
- Périphériques Linux embarqués avec SPI/I2C et GPIO
- Raspberry Pi
- Lait V
- LuckFox avec TFT SPI et chapeau LoRa
- Configurations natives Linux
- PC avec simulation Meshstick ou SIMRadio à l’aide de X11 MUI
Installation
Pour la plupart des appareils autonomes, MUI peut être installé à l’aide de Meshtastic Web Flasher. Recherchez le logo MUI sur le matériel pris en charge, sélectionnez un micrologiciel de version 2.6+ et activez l’option Meshtastic UI sur l’écran avant de lancer le flash.
Certains appareils ne sont pas pris en charge par le flasheur Web, mais disposent de fichiers binaires de firmware compilés. Ces fichiers sont identifiables par le suffixe « tft » dans leur nom. Le firmware peut être trouvé sur la page de téléchargement https://meshtastic.org/downloads/
Certains appareils pris en charge ne disposent pas de la compilation automatique du firmware ni de la prise en charge du flashage web. Ces appareils nécessitent une compilation et un flashage manuels. Les instructions pour la
compilation manuelle du firmware sont disponibles dans la documentation de développement.
Usage
Prise en charge de la carte SD
Pour les appareils compatibles avec les emplacements pour carte SD, assurez vous que la carte est correctement configurée avant utilisation. La carte SD doit être formatée en MBR. MUI prend en charge les partitions FAT32 et exFAT, exFAT étant le format recommandé.
Configuration initiale
Lors du premier démarrage de MUI ou après une réinitialisation d’usine, l’écran initial affiché est une fenêtre de configuration rapide permettant de définir la région, le nom complet et le nom court de l’appareil. Cet écran permet de configurer ces paramètres simultanément, ce qui ne nécessite qu’un seul redémarrage, plutôt que de les configurer et de les redémarrer à chaque modification (2 fois).

Tableau de bord d’accueil
Le tableau de bord d’accueil est le premier écran qui s’affiche au démarrage de l’appareil après la configuration initiale. Il offre un aperçu rapide de l’état de l’appareil et permet une navigation rapide pour sélectionner des zones ou modifier des paramètres. De nombreux éléments prennent en charge les appuis courts et longs pour des fonctionnalités supplémentaires.
Pour une description détaillée des commandes disponibles et de leurs fonctions, reportez vous à l’Infographie du tableau de bord.

Une icône non affichée dans le graphique ci dessus mais visible sur les appareils autonomes est celui d’une carte SD. Elle indique la taille et le format de la carte SD détectée, affiche l’espace de stockage utilisé en Go et en pourcentage. Appuyez sur l’icône pour
actualiser l’état de la carte SD. ❗ Le micrologiciel peut se bloquer brièvement pendant ce processus. Ceci est utile seulement si vous avez échangé à chaud la carte SD.
Liste des nœuds
La liste des nœuds répertorie tous les nœuds du réseau maillé. Elle permet aux utilisateurs de visualiser, filtrer et mettre en évidence les nœuds selon des critères sélectionnés.
- Un simple appui sur l’icône du nœud ouvrira la liste des nœuds, affichant tous les nœuds actifs dans le maillage
- Appuyez longuement sur l’icône du nœud pour ouvrir les options du nœud, où les filtres et les surlignages
- Appuyez longuement sur l’icône du nœud pour ouvrir les options du nœud, où les filtres et les surlignages peuvent être appliqués.

Options de nœud – Filtre
L’onglet Filtre permet aux utilisateurs de filtrer les nœuds en fonction de critères sélectionnés.

Options de nœud – Highlight (Surligner)
L’onglet Surligner permet aux nœuds sélectionnés de se démarquer en fonction de critères choisis.

Channels (Canaux / Groupe)
L’écran « Canaux » répertorie tous les canaux configurés pour l’appareil. Chaque canal est représenté par une icône indiquant son état de chiffrement :
- Une clé jaune indique que la chaîne utilise une clé PSK (clé pré partagée) par défaut.
- Un cadenas vert indique que le canal utilise un PSK configuré.
- Un cadenas rouge indique qu’aucun code PSK n’est configuré pour ce canal.
Appuyer sur un canal configuré ouvrira une discussion pour ce canal.

Chats (Discussions)
L’écran Chats répertorie tous les chats disponibles pour l’appareil, y compris les deux canaux partagés Chats et des messages directs. La liste de discussion s’ouvre en appuyant sur l’icône de discussion.

- Un appui long sur une discussion révèle un bouton SUPPR pour la supprimer
- Une discussion surlignée en orange indique un nouveau message non lu
Messages de discussion
Dans une discussion, les messages sont organisés en fils de discussion :
- Les messages provenant d’autres appareils apparaissent sur la gauche.
- Les messages provenant de l’appareil local apparaissent sur la droite.
- Lorsqu’un message est envoyé, le contour de la boîte de message est mis à jour en fonction de son status :
- Si un accusé de réception (ACK) est reçu, le contour du message passera au vert Meshtastic.
- Si le nombre maximal de retransmissions est atteint et qu’aucun ACK n’est reçu, le contour du message devient rouge.
- Si le message est entendu et transmis par d’autres nœuds, et qu’il n’y a pas encore d’accusé de réception du destinataire prévu, le contour du message deviendra jaune

Carte
L’écran de la carte affiche des tuiles vectorielles au format PNG, qui doivent être stockées sur la carte SD de l’appareil. Aucune tuile n’est incluse ; elles doivent être ajoutées manuellement à la carte SD, soit dans un répertoire /map si vous utilisez un seul style, soit dans le répertoire /maps/{STYLE}/ si vous utilisez plusieurs styles.
Un ensemble de tuiles de démarrage pour les niveaux de zoom 1 à 6 couvrant la Terre est disponible, ainsi que des instructions pour obtenir des tuiles de carte supplémentaires, sur ce lien.
Contrôles de la carte
L’écran de la carte affiche le style de carte sélectionné et fournit des commandes interactives pour la navigation :
- Icônes fléches – Déplacez/déplacez la vue de la carte dans n’importe quelle direction.
- Loupe (+/) – Réglez le niveau de zoom.
- Icône GPS – Centre la carte sur la position GPS actuelle de l’appareil (si disponible).
- Réticule – Recentrez vous sur la position d’origine, appuyez longuement pour définir manuellement une nouvelle position d’origine
📖Si aucun appareil avec un emplacement connu n’est présent et que l’appareil lui même n’a pas d’emplacement, la carte sera par défaut Big Ben à Londres, au Royaume Uni

Options de la carte
Le menu des options de la carte, accessible en appuyant longuement sur l’icône de la carte, propose les éléments suivants :
- Réglages de luminosité et de contraste
- Sélection du style de carte (si plusieurs styles sont disponibles)

Paramètres et outils
L’écran « Paramètres et outils » permet d’accéder à la configuration de l’appareil et aux fonctions
utilitaires. Il est divisé en deux onglets :
- Paramètres – Permet aux utilisateurs de configurer divers aspects de l’appareil à partir de l’interface MUI directement.
- Outils – Fournit des utilitaires pour le diagnostic et la surveillance du réseau.
Accéder aux paramètres et aux outils
- Appuyez une fois sur l’icône des paramètres pour ouvrir l’écran Paramètres et outils.
- Un appui long sur l’icône des paramètres verrouille l’écran si la fonction de verrouillage est activée. Si l’écran de verrouillage est désactivé, l’appareil se met en veille.
Onglet Paramètres (Settings)
L’onglet Paramètres comprend diverses options de configuration qui peuvent être définies dans MUI.

Onglet Outils (Tools)
L’onglet Outils donne accès à divers utilitaires de diagnostic, notamment :
- Détecteur de maillage – Envoie périodiquement une demande nodeinfo pour détecter les nœuds à proximité.
❗ A n’utiliser que lorsque vous êtes en zone blanche pour ne pas utiliser la bande passante du réseau. - Scanner de signal – Surveille la force du signal entre les nœuds sélectionnés pour faciliter le placement des nœuds.
- Trace Route – Exécute un trace route sur le nœud sélectionné.
- Statistiques – Décompose les paquets reçus par type, tels que la télémétrie, les mises à jour de position, les données de tracé d’itinéraire, etc
- Journal des paquets – Affiche un journal des paquets transmis et reçus.

Mode de programmation Bluetooth
MUI fonctionne comme un client, similaire aux applications Android et Apple. Il s’exécute sur un cœur du microcontrôleur (MCU), tandis que le firmware Meshtastic classique fonctionne sur l’autre. MUI communique avec le firmware via l’API Client, la même interface utilisée par les autres clients Meshtastic.
L’API Client ne prend en charge qu’une seule connexion active à la fois, ce qui signifie que le Bluetooth ne peut pas être utilisé lorsque MUI est en cours d’exécution. Étant donné que tous les paramètres ne peuvent pas être configurés directement dans MUI, le mode de programmation Bluetooth permet aux utilisateurs de désactiver temporairement MUI, activant ainsi le Bluetooth pour que l’appareil puisse être configuré via une autre application cliente
Le mode de programmation Bluetooth peut être activé de deux manières :
- Pendant le démarrage – Appuyez et maintenez le logo Meshtastic sur l’écran de démarrage.
- Appuyez sur l’icône Bluetooth dans le menu d’arrêt/réinitialisation dans les paramètres.

Une fois activé, l’appareil redémarre en mode de programmation Bluetooth. Dans ce mode, mode, l’écran affichera un code PIN généré aléatoirement, qui doit être saisi lorsque
Appuyez sur l’icône Bluetooth dans le menu d’arrêt/réinitialisation dans les paramètres.
Pendant le démarrage – Appuyez et maintenez le logo Meshtastic sur l’écran de démarrage.
connexion via Bluetooth sur l’application client.

Quitter le mode de programmation Bluetooth
Appuyez longuement sur l’icône Bluetooth pour redémarrer l’appareil dans MUI.
📌
Et ce n’est pas tout il y a aussi des combinaisons de touches que vous pouvez utiliser pour allumer le clavier par exemple …
C’est par ici 👉👉👉
