Guide Meshtastic - Interface Meshtastic – OpenELAB Technology Ltd.

Qu'est-ce que Meshtastic UI ?

Meshtastic UI (MUI) est une interface utilisateur indépendante et complète conçue spécifiquement pour les appareils Meshtastic. Son objectif principal est de permettre aux utilisateurs d'interagir directement avec leur réseau maillé sans dépendre d'une application compagnon sur téléphone pour la plupart des configurations quotidiennes. Cela rend possible la gestion et la surveillance des appareils de manière plus autonome. Initialement, MUI a été créé pour des appareils à écran tactile autonomes, mais au fil du temps, il a été étendu pour prendre en charge les systèmes Linux natifs, en faisant une solution polyvalente sur une grande variété de plateformes matérielles. Bien que de nombreux réglages essentiels puissent être ajustés directement via MUI, certaines fonctionnalités avancées peuvent encore nécessiter un appairage avec un autre appareil, comme un smartphone, pour débloquer la pleine fonctionnalité.

Le développement de MUI a commencé début 2024. Après plus d'un an de travail actif, la première version preview a été mise à disposition début 2025. À ce moment-là, le projet avait considérablement grandi, englobant environ 12 000 lignes de code manuscrit et 50 000 lignes de code généré. Il avait été porté avec succès sur 10 appareils différents et traduit en 18 langues, démontrant sa large applicabilité et sa portée internationale. MUI continue d'évoluer, avec des mises à jour en cours visant à introduire de nouvelles fonctionnalités, optimiser les performances et étendre la compatibilité avec d'autres plateformes matérielles.

Appareils compatibles

MUI est compatible avec une large gamme d'appareils, y compris mais sans s'y limiter :

Autonome LoRa appareils avec ESP32-S3 et écrans TFT :
- LilyGo T-Deck
- Seeed SenseCAP Indicator
- unPhone
- PICOmputer
Appareils de type CYD avec ESP32-S3 connectés en série à LoRa modules :
- T-HMI
- Mesh-Tab "Replicator" (ESP-4848S040)
- Makerfabs 4"
Intégré Appareils Linux avec SPI/I2C et GPIO support :
- Raspberry Pi
- Milk-V
- LuckFox avec TFT SPI et chapeau LoRa
Configurations natives Linux :
- PC avec Meshstick ou simulation SIMRadio utilisant X11 MUI

Installation

Pour la plupart des appareils autonomes, MUI peut être installé en utilisant le Meshtastic Web Flasher. Les utilisateurs doivent rechercher le logo MUI sur le matériel pris en charge, sélectionner la version du firmware 2.6 ou supérieure, et activer l’option Meshtastic UI lors du processus de flashage.

Certains appareils ne sont pas pris en charge par le flashage web mais disposent de binaires de firmware précompilés. Ces fichiers de firmware peuvent être identifiés par le suffixe « -tft » dans leurs noms de fichiers. Le firmware précompilé peut être téléchargé depuis la page officielle de téléchargements.

Pour certains appareils pris en charge qui ne disposent pas de builds automatiques de firmware ou de support de flashage web, une compilation et un flashage manuels sont nécessaires. Des instructions détaillées pour la compilation manuelle du firmware sont disponibles dans la documentation développeur.

Utilisation

Support de la carte SD

Les appareils équipés de fentes pour carte SD doivent s’assurer que la carte est correctement formatée avant utilisation. Le schéma de partition recommandé est MBR. MUI prend en charge les systèmes de fichiers FAT32 et exFAT, l’exFAT étant l’option préférée en raison de ses meilleures performances et compatibilités.

Installation initiale

Lors du premier démarrage de MUI, ou après une réinitialisation d’usine, l’appareil affiche un écran de configuration rapide. Cet écran permet aux utilisateurs de définir simultanément la région de l’appareil, son nom long et son nom court. En regroupant ces étapes, un seul redémarrage est nécessaire, simplifiant ainsi le processus de configuration par rapport à la configuration de chaque paramètre séparément.

Tableau de bord principal

Une fois la configuration initiale terminée, le tableau de bord principal devient l’écran par défaut affiché à chaque démarrage. Il fournit un aperçu concis de l’état de l’appareil et offre une navigation rapide vers les zones ou paramètres clés. De nombreux éléments du tableau de bord prennent en charge des actions de pression courte et longue, permettant des fonctionnalités supplémentaires et une personnalisation. Pour une description détaillée des contrôles disponibles et de leurs fonctions, les utilisateurs peuvent se référer à l’infographie du tableau de bord.

Sur les appareils autonomes, une icône de carte SD est également visible. Cette icône affiche la taille, le format et les statistiques d’utilisation de la carte SD détectée, en gigaoctets et en pourcentage. Appuyer sur l’icône actualise l’état de la carte SD, ce qui est particulièrement utile si la carte a été échangée à chaud. Pendant cette actualisation, le firmware peut brièvement se mettre en pause.

Liste des nœuds

La liste des nœuds offre une vue complète de tous les nœuds au sein du réseau maillé. Les utilisateurs peuvent visualiser, filtrer et mettre en surbrillance les nœuds selon des critères sélectionnés. Une simple pression sur l’icône du nœud ouvre la liste complète des nœuds actifs, tandis qu’une pression longue ouvre les options du nœud, où des filtres et des mises en surbrillance peuvent être appliqués pour accentuer certains nœuds.

Canaux

L'écran Canaux affiche tous les canaux configurés pour l'appareil, avec des icônes indiquant leur statut de chiffrement :

Clé jaune : Le canal utilise une clé pré-partagée (PSK) par défaut.
Verrou vert : Le canal utilise un PSK configuré sur mesure.
Verrou rouge : Le canal n'a pas de PSK configuré.

Appuyer sur un canal configuré ouvre une fenêtre de chat pour ce canal.

Conversations

L'écran Conversations liste toutes les conversations disponibles, y compris les canaux partagés et les messages directs. La liste des conversations est accessible en appuyant sur l'icône de chat. Une pression longue sur une conversation révèle une option de suppression, tandis que les messages non lus sont mis en surbrillance en orange. Dans une conversation, les messages sont organisés en fils : les messages entrants apparaissent à gauche, et les messages sortants de l'appareil local apparaissent à droite. Les contours des messages changent de couleur selon le statut d'accusé de réception, fournissant un retour immédiat sur le succès de la livraison.

Carte

L'écran Carte affiche les tuiles cartographiques stockées sur la carte SD de l'appareil. Aucune tuile n'est incluse par défaut et doit être ajoutée manuellement. Les tuiles doivent être des images PNG de 256x256, idéalement avec une profondeur de couleur de 8 bits et une palette de 256 couleurs. Un ensemble de tuiles de démarrage couvrant les niveaux de zoom 1 à 6 de la Terre est disponible ici. Les contrôles de la carte incluent des icônes fléchées pour le panoramique, des icônes de loupe pour le zoom, une icône GPS pour centrer sur la position actuelle de l'appareil, et une croix de visée pour recentrer sur la position d'origine. Une pression longue sur la croix de visée permet aux utilisateurs de définir une nouvelle position d'origine. Si aucune donnée de localisation n'est disponible, la carte se centre par défaut sur Big Ben à Londres, Royaume-Uni.

Paramètres & Outils

L'écran Paramètres & Outils donne accès à la configuration de l'appareil et aux utilitaires de diagnostic. Il est divisé en deux onglets :

Paramètres : Permet aux utilisateurs de configurer divers aspects de l'appareil directement dans MUI.

Outils : Fournit des utilitaires pour le diagnostic et la surveillance du réseau, incluant Mesh Detector, Signal Scanner, Trace Route, Statistiques et Journal des Paquets.

Accéder à cet écran est simple : une simple pression sur l'icône des paramètres l'ouvre, tandis qu'une pression longue verrouille l'écran (si la fonction de verrouillage est activée) ou met l'appareil en veille (si désactivée).

Accès à l'API Client

MUI fonctionne comme un client, similaire aux applications Android et iOS. Il s'exécute sur un cœur du MCU, tandis que le firmware standard Meshtastic fonctionne sur l'autre. La communication entre MUI et le firmware est gérée via l'API Client, qui ne supporte qu'une seule connexion active à la fois. Cela signifie que d'autres clients ne peuvent pas être utilisés simultanément pendant que MUI est en fonctionnement. Comme tous les paramètres ne peuvent pas être configurés dans MUI, les utilisateurs peuvent avoir besoin de passer en mode de programmation Bluetooth ou à BaseUI pour libérer l'API pour d'autres clients.

Mode de programmation Bluetooth

Le mode de programmation Bluetooth peut être activé de deux manières : en appuyant longuement sur le logo Meshtastic au démarrage, ou en sélectionnant l'icône Bluetooth dans le menu d'arrêt/réinitialisation des paramètres. Une fois activé, l'appareil redémarre en mode de programmation Bluetooth et affiche un code PIN généré aléatoirement, qui doit être saisi lors de la connexion via Bluetooth sur l'application cliente. Pour quitter ce mode, appuyez de nouveau longuement sur l'icône Bluetooth, et l'appareil redémarrera en MUI.

Mode BaseUI

Depuis l'introduction du firmware unifié pour les appareils TFT en version 2.7, la bascule entre Meshtastic UI (MUI) et BaseUI est devenue transparente. Les utilisateurs n'ont plus besoin de réinstaller le firmware pour changer d'interface. Démarrer en BaseUI libère la connexion Client API, permettant à d'autres clients tels que les applications mobiles ou les outils série de se connecter et de configurer des paramètres avancés.

Pour entrer dans BaseUI depuis le mode de programmation Bluetooth, appuyez longuement sur l'icône Bluetooth jusqu'au redémarrage du système. Une fois dans BaseUI, les utilisateurs accèdent à une interface plus traditionnelle qui privilégie la compatibilité avec les clients externes. Ce mode est particulièrement utile lorsque vous devez effectuer des configurations non disponibles directement dans MUI.

Revenir à MUI est simple : naviguez vers la fenêtre Système dans BaseUI, puis appuyez longuement jusqu'à ce que la boîte de dialogue Action Système apparaisse. De là, sélectionnez Redémarrer/Éteindre et choisissez Basculer vers MUI. L'appareil redémarrera et chargera de nouveau l'environnement Meshtastic UI.

Résumé

L'interface Meshtastic UI offre une interface puissante, flexible et conviviale pour gérer les réseaux maillés sur une large gamme d'appareils. Avec le support du matériel LoRa autonome, des systèmes Linux embarqués et des configurations natives PC, MUI permet un contrôle direct sans nécessiter d'application téléphonique pour la plupart des tâches. Des fonctionnalités telles que le tableau de bord principal, la liste des nœuds, les canaux, les discussions, l'intégration de la carte et les outils de diagnostic en font une solution complète pour les débutants comme pour les utilisateurs avancés.

Les options d'installation sont variées, allant du simple flashage web à la compilation manuelle, garantissant l'accessibilité sur le matériel pris en charge. L'inclusion du support de carte SD, des écrans de configuration rapide et d'une navigation intuitive améliore encore l'ergonomie. Pour les configurations avancées, les utilisateurs peuvent basculer entre MUI, le mode de programmation Bluetooth et BaseUI, offrant une flexibilité selon leurs besoins.

Au fur et à mesure du développement, MUI s'enrichira de nouvelles fonctionnalités, d'optimisations et d'un support matériel plus large, consolidant ainsi son rôle d'interface clé pour l'écosystème Meshtastic.

Guide Meshtastic - Interface Meshtastic