Meshtastic Anleitung - Meshtastic Benutzeroberfläche

Was ist Meshtastic UI?

Meshtastic UI (MUI) ist eine unabhängige und umfassende Benutzeroberfläche, die speziell für Meshtastic-Geräte entwickelt wurde. Ihr Hauptzweck ist es, den Nutzern zu ermöglichen, direkt mit ihrem Mesh-Netzwerk zu interagieren, ohne für die meisten alltäglichen Konfigurationen auf eine Begleit-App auf dem Telefon angewiesen zu sein. Dadurch ist es möglich, Geräte autonomer zu verwalten und zu überwachen. Ursprünglich wurde MUI für eigenständige Touchscreen-Geräte entwickelt, wurde aber im Laufe der Zeit erweitert, um Linux-native Systeme zu unterstützen, was es zu einer vielseitigen Lösung für eine breite Palette von Hardwareplattformen macht. Während viele wichtige Einstellungen direkt über MUI angepasst werden können, erfordern bestimmte erweiterte Funktionen möglicherweise weiterhin eine Kopplung mit einem anderen Gerät, wie einem Smartphone, um die volle Funktionalität freizuschalten.

Die Entwicklung von MUI begann Anfang 2024. Nach mehr als einem Jahr aktiver Arbeit wurde Anfang 2025 die erste Vorschauversion veröffentlicht. Zu diesem Zeitpunkt war das Projekt erheblich gewachsen und umfasste etwa 12.000 Zeilen handgeschriebenen Codes und 50.000 Zeilen generierten Codes. Es wurde erfolgreich auf 10 verschiedene Geräte portiert und in 18 Sprachen übersetzt, was seine breite Anwendbarkeit und internationale Reichweite zeigt. MUI entwickelt sich weiterhin, mit laufenden Updates, die darauf abzielen, neue Funktionen einzuführen, die Leistung zu optimieren und die Kompatibilität mit zusätzlichen Hardwareplattformen zu erweitern.

Unterstützte Geräte

MUI ist kompatibel mit einer Vielzahl von Geräten, einschließlich, aber nicht beschränkt auf:

Eigenständig LoRa Geräte mit ESP32-S3 und TFT-Displays:
- LilyGo T-Deck
- Seeed SenseCAP Indicator
- unPhone
- PICOmputer
CYD-ähnliche Geräte mit ESP32-S3, die seriell verbunden sind mit LoRa Module:
- T-HMI
- Mesh-Tab "Replicator" (ESP-4848S040)
- Makerfabs 4"
Eingebettet Linux-Geräte mit SPI/I2C und GPIO Unterstützung:
- Raspberry Pi
- Milk-V
- LuckFox mit TFT SPI und LoRa-Hat
Linux-native Setups:
- PC mit Meshstick- oder SIMRadio-Simulation unter Verwendung von X11 MUI

Installation

Für die meisten eigenständigen Geräte kann MUI mit dem Meshtastic Web Flasher installiert werden. Benutzer sollten nach dem MUI-Logo auf unterstützter Hardware suchen, Firmware-Version 2.6 oder höher auswählen und während des Flashvorgangs die Option Meshtastic UI aktivieren.

Einige Geräte werden vom Web-Flasher nicht unterstützt, haben aber vorgefertigte Firmware-Binärdateien verfügbar. Diese Firmware-Dateien sind an der Endung „-tft“ in ihren Dateinamen zu erkennen. Vorgefertigte Firmware kann von der offiziellen Download-Seite heruntergeladen werden.

Für bestimmte unterstützte Geräte, die keine automatischen Firmware-Builds oder Web-Flasher-Unterstützung haben, sind manuelle Kompilierung und Flashen erforderlich. Detaillierte Anweisungen zum manuellen Erstellen der Firmware sind in der Entwicklerdokumentation zu finden.

Verwendung

SD-Karten-Unterstützung

Geräte mit SD-Kartensteckplätzen müssen sicherstellen, dass die Karte vor der Verwendung richtig formatiert ist. Das empfohlene Partitionsschema ist MBR. MUI unterstützt sowohl FAT32- als auch exFAT-Dateisysteme, wobei exFAT aufgrund seiner verbesserten Leistung und Kompatibilität die bevorzugte Option ist.

Erste Einrichtung

Beim ersten Start von MUI oder nach einem Werksreset zeigt das Gerät einen Schnellkonfigurationsbildschirm an. Dieser Bildschirm ermöglicht es Benutzern, Region, Langname und Kurzname des Geräts gleichzeitig einzustellen. Durch die Zusammenfassung dieser Schritte ist nur ein Neustart erforderlich, was den Einrichtungsprozess im Vergleich zur separaten Konfiguration jeder Einstellung vereinfacht.

Home Dashboard

Nach Abschluss der Ersteinrichtung wird das Home Dashboard zum Standardbildschirm, der bei jedem Start angezeigt wird. Es bietet eine prägnante Übersicht über den Gerätestatus und ermöglicht eine schnelle Navigation zu wichtigen Bereichen oder Einstellungen. Viele Dashboard-Elemente unterstützen sowohl kurze als auch lange Druckaktionen, die zusätzliche Funktionen und Anpassungen ermöglichen. Für eine detaillierte Aufschlüsselung der verfügbaren Steuerungen und deren Funktionen können Benutzer die Dashboard-Infografik konsultieren.

Bei eigenständigen Geräten ist auch ein SD-Karten-Symbol sichtbar. Dieses Symbol zeigt die erkannte Größe, das Format und die Nutzungsstatistiken der SD-Karte sowohl in Gigabyte als auch in Prozent an. Ein Tipp auf das Symbol aktualisiert den SD-Kartenstatus, was besonders nützlich ist, wenn die Karte im laufenden Betrieb gewechselt wurde. Während dieser Aktualisierung kann die Firmware kurz pausieren.

Knoteliste

Die Knoteliste bietet eine umfassende Übersicht über alle Knoten im Mesh-Netzwerk. Benutzer können Knoten basierend auf ausgewählten Kriterien anzeigen, filtern und hervorheben. Ein einzelner Tipp auf das Knotensymbol öffnet die vollständige Liste der aktiven Knoten, während ein langer Druck die Knotenoptionen öffnet, in denen Filter und Hervorhebungen angewendet werden können, um bestimmte Knoten hervorzuheben.

Kanäle

Der Kanäle-Bildschirm zeigt alle für das Gerät konfigurierten Kanäle an, mit Symbolen, die ihren Verschlüsselungsstatus anzeigen:

Gelber Schlüssel: Kanal verwendet einen Standard-Pre-Shared Key (PSK).
Grünes Schloss: Kanal verwendet einen benutzerdefinierten PSK.
Rotes Schloss: Kanal hat keinen PSK konfiguriert.

Ein Tipp auf einen konfigurierten Kanal öffnet ein Chatfenster für diesen Kanal.

Chats

Der Chat-Bildschirm listet alle verfügbaren Unterhaltungen auf, einschließlich geteilter Kanäle und Direktnachrichten. Die Chat-Liste kann durch Tippen auf das Chat-Symbol aufgerufen werden. Ein langer Druck auf einen Chat zeigt eine Löschoption an, während ungelesene Nachrichten orange hervorgehoben werden. Innerhalb eines Chats sind Nachrichten in Threads organisiert: Eingehende Nachrichten erscheinen links, ausgehende Nachrichten vom lokalen Gerät rechts. Die Umrisse der Nachrichten ändern ihre Farbe je nach Bestätigungsstatus und geben so sofortiges Feedback über den Zustellungserfolg.

Karte

Der Kartenbildschirm zeigt Kartenkacheln an, die auf der SD-Karte des Geräts gespeichert sind. Standardmäßig sind keine Kacheln enthalten und müssen manuell hinzugefügt werden. Die Kacheln sollten 256x256 PNG-Bilder sein, idealerweise mit einer Farbtiefe von 8 Bit und einer 256-Farben-Palette. Ein Starter-Set von Kacheln, das die Zoomstufen 1–6 der Erde abdeckt, ist hier verfügbar. Die Kartensteuerung umfasst Pfeilsymbole zum Verschieben, Lupensymbole zum Zoomen, ein GPS-Symbol zum Zentrieren auf den aktuellen Standort des Geräts und Fadenkreuze zum Neuzentrieren auf die Heimatposition. Ein langer Druck auf die Fadenkreuze ermöglicht es Benutzern, eine neue Heimatposition festzulegen. Wenn keine Standortdaten verfügbar sind, wird die Karte standardmäßig auf Big Ben in London, UK, eingestellt.

Einstellungen & Werkzeuge

Der Bildschirm Einstellungen & Werkzeuge bietet Zugriff auf Gerätekonfiguration und Diagnosewerkzeuge. Er ist in zwei Registerkarten unterteilt:

Einstellungen: Ermöglicht es Benutzern, verschiedene Aspekte des Geräts direkt innerhalb von MUI zu konfigurieren.

Werkzeuge: Bietet Dienstprogramme für Netzwerkdiagnose und -überwachung, einschließlich Mesh Detector, Signal Scanner, Trace Route, Statistik und Paketprotokoll.

Der Zugriff auf diesen Bildschirm ist einfach: Ein einzelner Tipp auf das Einstellungssymbol öffnet ihn, während ein langer Druck entweder den Bildschirm sperrt (wenn die Bildschirmsperrfunktion aktiviert ist) oder das Gerät in den Ruhezustand versetzt (wenn deaktiviert).

Zugriff auf die Client-API

MUI funktioniert als Client, ähnlich wie die Android- und iOS-Anwendungen. Es läuft auf einem Kern des MCU, während die Standard-Meshtastic-Firmware auf dem anderen läuft. Die Kommunikation zwischen MUI und der Firmware erfolgt über die Client-API, die jeweils nur eine aktive Verbindung unterstützt. Das bedeutet, dass andere Clients nicht gleichzeitig verwendet werden können, während MUI läuft. Da nicht alle Einstellungen innerhalb von MUI konfiguriert werden können, müssen Benutzer möglicherweise in den Bluetooth-Programmiermodus oder BaseUI wechseln, um die API für andere Clients freizugeben.

Bluetooth-Programmiermodus

Der Bluetooth-Programmiermodus kann auf zwei Arten aktiviert werden: durch langes Drücken des Meshtastic-Logos beim Start oder durch Auswahl des Bluetooth-Symbols im Herunterfahren/Neustart-Menü in den Einstellungen. Nach der Aktivierung startet das Gerät neu in den Bluetooth-Programmiermodus und zeigt eine zufällig generierte PIN an, die beim Verbinden über Bluetooth in der Client-App eingegeben werden muss. Um diesen Modus zu verlassen, drücken und halten Sie erneut das Bluetooth-Symbol, und das Gerät startet zurück in MUI.

BaseUI-Modus

Seit der Einführung der Unified Firmware für TFT-Geräte in Version 2.7 ist der Wechsel zwischen Meshtastic UI (MUI) und BaseUI nahtlos geworden. Benutzer müssen die Firmware nicht mehr neu installieren, um die Schnittstelle zu wechseln. Das Booten in BaseUI gibt die Client-API-Verbindung frei, sodass andere Clients wie mobile Apps oder serielle Tools sich verbinden und erweiterte Einstellungen konfigurieren können.

Um vom Bluetooth-Programmiermodus in BaseUI zu wechseln, drücken und halten Sie das Bluetooth-Symbol, bis das System neu startet. Im BaseUI erhalten Benutzer Zugriff auf eine traditionellere Oberfläche, die die Kompatibilität mit externen Clients priorisiert. Dieser Modus ist besonders nützlich, wenn Sie Konfigurationen vornehmen müssen, die in MUI nicht direkt verfügbar sind.

Die Rückkehr zu MUI ist einfach: Navigieren Sie im BaseUI zum Systemfenster und halten Sie lange gedrückt, bis der Dialog „Systemaktion“ erscheint. Wählen Sie dort Neustart/Herunterfahren und dann Wechseln zu MUI. Das Gerät startet neu und lädt die Meshtastic UI-Umgebung.

Zusammenfassung

Meshtastic UI bietet eine leistungsstarke, flexible und benutzerfreundliche Oberfläche zur Verwaltung von Mesh-Netzwerken auf einer Vielzahl von Geräten. Mit Unterstützung für eigenständige LoRa-Hardware, eingebettete Linux-Systeme und native PC-Setups ermöglicht MUI direkte Steuerung, ohne für die meisten Aufgaben eine Telefon-App zu benötigen. Funktionen wie das Home-Dashboard, die Knotenliste, Kanäle, Chats, Kartenintegration und Diagnosewerkzeuge machen es zu einer umfassenden Lösung für Anfänger und Fortgeschrittene.

Die Installationsoptionen sind vielfältig, von einfachem Web-Flashing bis hin zur manuellen Kompilierung, um die Zugänglichkeit auf unterstützter Hardware zu gewährleisten. Die Einbindung von SD-Karten-Unterstützung, Schnellstartbildschirmen und intuitiver Navigation verbessert die Benutzerfreundlichkeit zusätzlich. Für erweiterte Konfigurationen können Benutzer zwischen MUI, Bluetooth-Programmiermodus und BaseUI wechseln, was je nach Bedarf Flexibilität bietet.

Während der Entwicklung wird MUI mit neuen Funktionen, Optimierungen und breiterer Hardwareunterstützung erweitert, wodurch seine Rolle als wichtige Schnittstelle für das Meshtastic-Ökosystem gefestigt wird.

Meshtastic Anleitung - Meshtastic Benutzeroberfläche