openelab.de
openelab.com
Cos'è Meshtastic UI?
Meshtastic UI (MUI) è un'interfaccia utente indipendente e completa progettata specificamente per i dispositivi Meshtastic. Il suo scopo principale è permettere agli utenti di interagire direttamente con la loro rete mesh senza fare affidamento su un'applicazione telefonica companion per la maggior parte delle configurazioni quotidiane. Questo rende possibile gestire e monitorare i dispositivi in modo più autonomo. Inizialmente, MUI è stato creato per dispositivi touchscreen standalone, ma col tempo è stato ampliato per supportare sistemi nativi Linux, rendendolo una soluzione versatile su una vasta gamma di piattaforme hardware. Sebbene molte impostazioni essenziali possano essere regolate direttamente tramite MUI, alcune funzionalità avanzate potrebbero ancora richiedere l'abbinamento con un altro dispositivo, come uno smartphone, per sbloccare la piena funzionalità.
Lo sviluppo di MUI è iniziato all'inizio del 2024. Dopo più di un anno di lavoro attivo, la prima versione di anteprima è stata resa disponibile all'inizio del 2025. A quel punto, il progetto era cresciuto significativamente, comprendendo circa 12.000 righe di codice scritto a mano e 50.000 righe di codice generato. Era stato portato con successo su 10 dispositivi diversi e tradotto in 18 lingue, dimostrando la sua ampia applicabilità e portata internazionale. MUI continua a evolversi, con aggiornamenti in corso volti a introdurre nuove funzionalità, ottimizzare le prestazioni ed espandere la compatibilità con ulteriori piattaforme hardware.
Dispositivi supportati
MUI è compatibile con una vasta gamma di dispositivi, inclusi ma non limitati a:
-
Autonomo LoRa dispositivi con ESP32-S3 e display TFT:
-
LilyGo T-Deck
-
Seeed SenseCAP Indicator
-
unPhone
-
PICOmputer
-
-
Dispositivi in stile CYD con ESP32-S3 collegati via seriale a LoRa moduli:
-
T-HMI
-
Mesh-Tab "Replicator" (ESP-4848S040)
-
Makerfabs 4"
-
-
Incorporato Dispositivi Linux con SPI/I2C e GPIO supporto:
-
Raspberry Pi
-
Milk-V
-
LuckFox con TFT SPI e LoRa hat
-
-
Configurazioni native Linux:
-
PC con Meshstick o simulazione SIMRadio usando X11 MUI
-
Installazione
Per la maggior parte dei dispositivi standalone, MUI può essere installato utilizzando il Meshtastic Web Flasher. Gli utenti devono cercare il logo MUI sull'hardware supportato, selezionare la versione del firmware 2.6 o superiore e abilitare l'opzione Meshtastic UI durante il processo di flashing.
Alcuni dispositivi non sono supportati dal web flasher ma dispongono di firmware precompilati disponibili. Questi file firmware possono essere identificati dal suffisso “-tft” nei loro nomi. Il firmware precompilato può essere scaricato dalla pagina ufficiale dei download.
Per alcuni dispositivi supportati che non dispongono di build firmware automatiche o supporto per il web flasher, è necessaria la compilazione e il flashing manuale. Istruzioni dettagliate per la compilazione manuale del firmware sono disponibili nella documentazione per sviluppatori.
Uso
Supporto Scheda SD
I dispositivi dotati di slot per schede SD devono assicurarsi che la scheda sia formattata correttamente prima dell'uso. Lo schema di partizione raccomandato è MBR. MUI supporta sia i file system FAT32 che exFAT, con exFAT come opzione preferita grazie alle sue migliori prestazioni e compatibilità.
Configurazione iniziale
Quando si avvia MUI per la prima volta, o dopo aver eseguito un reset di fabbrica, il dispositivo mostrerà una schermata di configurazione rapida. Questa schermata consente agli utenti di impostare contemporaneamente la regione del dispositivo, il nome lungo e il nome breve. Consolidando questi passaggi, è richiesto un solo riavvio, semplificando il processo di configurazione rispetto all'impostazione separata di ogni parametro.
Home Dashboard
Una volta completata la configurazione iniziale, la Home Dashboard diventa la schermata predefinita visualizzata ad ogni avvio. Fornisce una panoramica concisa dello stato del dispositivo e offre una navigazione rapida verso aree o impostazioni chiave. Molti elementi della dashboard supportano sia azioni di tocco breve che prolungato, permettendo funzionalità aggiuntive e personalizzazione. Per una descrizione dettagliata dei controlli disponibili e delle loro funzioni, gli utenti possono consultare l'Infografica della Dashboard.
Su dispositivi standalone, è visibile anche un'icona della scheda SD. Questa icona mostra la dimensione, il formato e le statistiche di utilizzo della scheda SD rilevata, sia in gigabyte che in percentuale. Toccando l'icona si aggiorna lo stato della scheda SD, cosa particolarmente utile se la scheda è stata sostituita a caldo. Durante questo aggiornamento, il firmware potrebbe fare una breve pausa.
Lista Nodi
La Lista dei Nodi fornisce una vista completa di tutti i nodi all'interno della rete mesh. Gli utenti possono visualizzare, filtrare e evidenziare i nodi in base a criteri selezionati. Un singolo tocco sull'icona del Nodo apre l'elenco completo dei nodi attivi, mentre una pressione prolungata apre le Opzioni Nodo, dove è possibile applicare filtri ed evidenziazioni per mettere in risalto nodi specifici.
Canali
La schermata Canali mostra tutti i canali configurati per il dispositivo, con icone che indicano il loro stato di crittografia:
-
Chiave gialla: Il canale utilizza una Pre-Shared Key (PSK) predefinita.
-
Lucchetto verde: Il canale utilizza una PSK configurata personalizzata.
-
Lucchetto rosso: Il canale non ha una PSK configurata.
Toccando un canale configurato si apre una finestra di chat per quel canale.
Chat
La schermata Chat elenca tutte le conversazioni disponibili, inclusi canali condivisi e messaggi diretti. La lista delle chat è accessibile toccando l'icona della chat. Una pressione prolungata su una chat rivela l'opzione di eliminazione, mentre i messaggi non letti sono evidenziati in arancione. All'interno di una chat, i messaggi sono organizzati in thread: i messaggi in arrivo appaiono a sinistra, quelli in uscita dal dispositivo locale a destra. Il contorno dei messaggi cambia colore in base allo stato di conferma, fornendo un feedback immediato sul successo della consegna.
Mappa
La schermata Mappa mostra le tessere della mappa memorizzate sulla scheda SD del dispositivo. Nessuna tessera è inclusa di default e devono essere aggiunte manualmente. Le tessere devono essere immagini PNG 256x256, idealmente con profondità di colore a 8 bit e una palette di 256 colori. Un set iniziale di tessere che copre i livelli di zoom da 1 a 6 della Terra è disponibile qui. I controlli della mappa includono icone a freccia per il panning, icone a lente d'ingrandimento per lo zoom, un'icona GPS per centrare sulla posizione attuale del dispositivo e un mirino per recentrare sulla posizione home. Una pressione prolungata sul mirino permette di impostare una nuova posizione home. Se non sono disponibili dati di localizzazione, la mappa si posiziona di default su Big Ben a Londra, Regno Unito.
Impostazioni & Strumenti
La schermata Impostazioni & Strumenti offre accesso alla configurazione del dispositivo e alle utilità diagnostiche. È divisa in due schede:
-
Impostazioni: Permette agli utenti di configurare vari aspetti del dispositivo direttamente all'interno di MUI.
-
Strumenti: Fornisce utilità per la diagnostica e il monitoraggio della rete, inclusi Mesh Detector, Signal Scanner, Trace Route, Statistiche e Packet Log.
Accedere a questa schermata è semplice: un singolo tocco sull'icona delle impostazioni la apre, mentre una pressione prolungata blocca lo schermo (se la funzione di blocco schermo è abilitata) o mette il dispositivo in modalità sleep (se disabilitata).
Accesso alla Client API
MUI funziona come un client, simile alle applicazioni Android e iOS. Viene eseguito su un core del MCU, mentre il firmware standard Meshtastic gira sull'altro. La comunicazione tra MUI e il firmware è gestita tramite la Client API, che supporta una sola connessione attiva alla volta. Ciò significa che altri client non possono essere utilizzati simultaneamente mentre MUI è in esecuzione. Poiché non tutte le impostazioni possono essere configurate all'interno di MUI, gli utenti potrebbero dover passare alla Modalità di Programmazione Bluetooth o a BaseUI per liberare l'API per altri client.
Bluetooth Programming Mode
La Bluetooth Programming Mode può essere attivata in due modi: premendo e tenendo premuto il logo Meshtastic durante l'avvio, oppure selezionando l'icona Bluetooth nel menu di spegnimento/riavvio all'interno delle impostazioni. Quando attivata, il dispositivo si riavvia in Bluetooth Programming Mode e mostra un PIN generato casualmente, che deve essere inserito durante la connessione via Bluetooth nell'app client. Per uscire da questa modalità, premi e tieni premuta nuovamente l'icona Bluetooth, e il dispositivo si riavvierà tornando in MUI.
Modalità BaseUI
Dall'introduzione del Firmware Unificato per dispositivi TFT nella versione 2.7, il passaggio tra Meshtastic UI (MUI) e BaseUI è diventato fluido. Gli utenti non devono più reinstallare il firmware per cambiare interfaccia. L'avvio in BaseUI libera la connessione Client API, permettendo ad altri client come app mobili o strumenti seriali di connettersi e configurare impostazioni avanzate.
Per entrare in BaseUI dalla Bluetooth Programming Mode, premi e tieni premuta l'icona Bluetooth finché il sistema non si riavvia. Una volta in BaseUI, gli utenti accedono a un'interfaccia più tradizionale che privilegia la compatibilità con client esterni. Questa modalità è particolarmente utile quando è necessario eseguire configurazioni non disponibili direttamente in MUI.
Tornare a MUI è semplice: naviga nella Finestra di Sistema all'interno di BaseUI, quindi tieni premuto a lungo finché non appare la finestra di dialogo Azione di Sistema. Da lì, seleziona Riavvia/Spegni e scegli Cambia a MUI. Il dispositivo si riavvierà e caricherà nuovamente l'ambiente Meshtastic UI.
Riepilogo
Meshtastic UI offre un'interfaccia potente, flessibile e facile da usare per gestire reti mesh su una vasta gamma di dispositivi. Con supporto per hardware LoRa standalone, sistemi Linux embedded e configurazioni native per PC, MUI offre controllo diretto senza richiedere un'app per telefono per la maggior parte delle operazioni. Funzionalità come la Home Dashboard, la Lista Nodi, i Canali, le Chat, l'integrazione con la Mappa e gli strumenti diagnostici la rendono una soluzione completa sia per principianti che per utenti avanzati.
Le opzioni di installazione sono varie, dalla semplice flashing web alla compilazione manuale, garantendo accessibilità su hardware supportato. L'inclusione del supporto per schede SD, schermate di configurazione rapida e una navigazione intuitiva migliorano ulteriormente l'usabilità. Per configurazioni avanzate, gli utenti possono passare tra MUI, Bluetooth Programming Mode e BaseUI, offrendo flessibilità a seconda delle loro esigenze.
Con il proseguire dello sviluppo, MUI si espanderà con nuove funzionalità, ottimizzazioni e un supporto hardware più ampio, consolidando il suo ruolo come interfaccia chiave per l'ecosistema Meshtastic.
