Meshtastic Guide - Meshtastic användargränssnitt

Vad är Meshtastic UI?

Meshtastic UI (MUI) är ett självständigt och omfattande användargränssnitt designat specifikt för Meshtastic-enheter. Dess huvudsakliga syfte är att låta användare interagera direkt med sitt mesh-nätverk utan att behöva förlita sig på en medföljande telefonapp för de flesta vardagliga inställningar. Detta gör det möjligt att hantera och övervaka enheter på ett mer autonomt sätt. Ursprungligen skapades MUI för fristående pekskärmsenheter, men med tiden har det utökats för att stödja Linux-native system, vilket gör det till en mångsidig lösning över en mängd olika hårdvaruplattformar. Medan många viktiga inställningar kan justeras direkt via MUI, kan vissa avancerade funktioner fortfarande kräva parkoppling med en annan enhet, såsom en smartphone, för att låsa upp full funktionalitet.

Utvecklingen av MUI började i början av 2024. Efter mer än ett års aktivt arbete släpptes den första förhandsversionen i början av 2025. Vid den tidpunkten hade projektet vuxit avsevärt och omfattade cirka 12 000 rader handskriven kod och 50 000 rader genererad kod. Det hade framgångsrikt portats till 10 olika enheter och översatts till 18 språk, vilket visar dess breda tillämplighet och internationella räckvidd. MUI fortsätter att utvecklas med pågående uppdateringar som syftar till att introducera nya funktioner, optimera prestanda och utöka kompatibiliteten med ytterligare hårdvaruplattformar.

Stödda enheter

MUI är kompatibelt med en mångfald av enheter, inklusive men inte begränsat till:

Fristående LoRa enheter med ESP32-S3 och TFT-skärmar:
- LilyGo T-Deck
- Seeed SenseCAP Indicator
- unPhone
- PICOmputer
CYD-stil enheter med ESP32-S3 anslutna via seriell till LoRa moduler:
- T-HMI
- Mesh-Tab "Replicator" (ESP-4848S040)
- Makerfabs 4"
Inbäddad Linux-enheter med SPI/I2C och GPIO support:
- Raspberry Pi
- Milk-V
- LuckFox med TFT SPI och LoRa-hatt
Linux-native installationer:
- PC med Meshstick eller SIMRadio-simulering med X11 MUI

Installation

För de flesta fristående enheter kan MUI installeras med Meshtastic Web Flasher. Användare bör leta efter MUI-logotypen på stödd hårdvara, välja firmwareversion 2.6 eller högre och aktivera Meshtastic UI-alternativet under flashningsprocessen.

Vissa enheter stöds inte av webbladdaren men har förbyggda firmwarebinärer tillgängliga. Dessa firmwarefiler kan identifieras genom suffixet ”-tft” i deras filnamn. Förbyggd firmware kan laddas ner från den officiella nedladdningssidan.

För vissa stödda enheter som inte har automatiska firmwarebyggen eller webbladdarstöd krävs manuell kompilering och flashing. Detaljerade instruktioner för manuell firmwarekompilering finns i utvecklardokumentationen.

Användning

SD-kortsstöd

Enheter utrustade med SD-kortplatser måste säkerställa att kortet är korrekt formaterat innan användning. Den rekommenderade partitionsschemat är MBR. MUI stödjer både FAT32 och exFAT-filsystem, där exFAT är det föredragna alternativet tack vare dess förbättrade prestanda och kompatibilitet.

Initial installation

Vid första uppstart av MUI, eller efter en fabriksåterställning, visas en snabbkonfigurationsskärm. Denna skärm låter användare ställa in enhetens region, långa namn och korta namn samtidigt. Genom att samla dessa steg krävs endast en omstart, vilket förenklar installationsprocessen jämfört med att konfigurera varje inställning separat.

Hemdashboard

När den initiala installationen är klar blir Hemdashboard standardvyn som visas vid varje uppstart. Den ger en kortfattad översikt över enhetens status och erbjuder snabb navigering till viktiga områden eller inställningar. Många dashboard-element stödjer både korta och långa tryck, vilket möjliggör ytterligare funktionalitet och anpassning. För en detaljerad genomgång av tillgängliga kontroller och deras funktioner kan användare hänvisa till Dashboard-infografiken.

På fristående enheter är även en SD-kortikon synlig. Denna ikon visar den upptäckta SD-kortets storlek, format och användningsstatistik i både gigabyte och procent. Ett tryck på ikonen uppdaterar SD-kortets status, vilket är särskilt användbart om kortet har bytts ut under drift. Under denna uppdatering kan firmware tillfälligt pausas.

Nodlista

Nodlistan ger en omfattande översikt över alla noder inom mesh-nätverket. Användare kan visa, filtrera och markera noder baserat på valda kriterier. Ett enkelt tryck på Node-ikonen öppnar hela listan över aktiva noder, medan ett långt tryck öppnar Node-alternativ, där filter och markeringar kan tillämpas för att framhäva specifika noder.

Kanaler

Kanalskärmen visar alla konfigurerade kanaler för enheten, med ikoner som indikerar deras krypteringsstatus:

Gult nyckel: Kanalen använder en standard Pre-Shared Key (PSK).
Grönt lås: Kanalen använder en anpassad konfigurerad PSK.
Rött lås: Kanalen har ingen PSK konfigurerad.

Att trycka på en konfigurerad kanal öppnar ett chattfönster för den kanalen.

Chattar

Chats-skärmen listar alla tillgängliga konversationer, inklusive delade kanaler och direkta meddelanden. Chattlistan nås genom att trycka på chattikonen. Ett långt tryck på en chatt visar ett raderingsalternativ, medan olästa meddelanden markeras i orange. Inom en chatt är meddelanden trådade: inkommande meddelanden visas till vänster och utgående meddelanden från den lokala enheten visas till höger. Meddelanderamar ändrar färg baserat på bekräftelsestatus, vilket ger omedelbar återkoppling om leveransstatus.

Karta

Kartskärmen visar kartplattor som lagras på enhetens SD-kort. Inga plattor ingår som standard och måste läggas till manuellt. Plattorna bör vara 256x256 PNG-bilder, helst med 8-bitars färgdjup och en 256-färgs palett. Ett startpaket med plattor som täcker zoomnivåer 1–6 av jorden finns tillgängligt här. Kartkontroller inkluderar pilikoner för panorering, förstoringsglasikoner för zoomning, en GPS-ikon för att centrera på enhetens aktuella position och sikten för att återcentrera på hempositionen. Ett långt tryck på sikten låter användare ställa in en ny hemposition. Om ingen positionsdata är tillgänglig visas kartan som standard Big Ben i London, Storbritannien.

Inställningar & Verktyg

Skärmen Inställningar & Verktyg ger tillgång till enhetskonfiguration och diagnostiska verktyg. Den är uppdelad i två flikar:

Inställningar: Gör det möjligt för användare att konfigurera olika aspekter av enheten direkt inom MUI.

Verktyg: Tillhandahåller verktyg för nätverksdiagnostik och övervakning, inklusive Mesh Detector, Signal Scanner, Trace Route, Statistik och Paketlogg.

Att komma åt denna skärm är enkelt: ett enda tryck på inställningsikonen öppnar den, medan ett långt tryck antingen låser skärmen (om låsskärmsfunktionen är aktiverad) eller sätter enheten i viloläge (om den är inaktiverad).

Client API-åtkomst

MUI fungerar som en klient, liknande Android- och iOS-applikationerna. Den körs på en kärna av MCU:n, medan den standard Meshtastic-firmware körs på den andra. Kommunikation mellan MUI och firmware hanteras genom Client API, som endast stödjer en aktiv anslutning åt gången. Detta innebär att andra klienter inte kan användas samtidigt medan MUI körs. Eftersom inte alla inställningar kan konfigureras inom MUI kan användare behöva byta till Bluetooth Programming Mode eller BaseUI för att frigöra API:et för andra klienter.

Bluetooth Programming Mode

Bluetooth Programming Mode kan aktiveras på två sätt: genom att trycka och hålla ned Meshtastic-logotypen under uppstart, eller genom att välja Bluetooth-ikonen i avstängnings-/återställningsmenyn i inställningarna. När det aktiveras startar enheten om i Bluetooth Programming Mode och visar en slumpmässigt genererad PIN-kod, som måste anges vid anslutning via Bluetooth i klientappen. För att avsluta detta läge, tryck och håll ned Bluetooth-ikonen igen, och enheten startar om tillbaka till MUI.

BaseUI-läge

Sedan introduktionen av Unified Firmware för TFT-enheter i version 2.7 har växlingen mellan Meshtastic UI (MUI) och BaseUI blivit sömlös. Användare behöver inte längre installera om firmware för att byta gränssnitt. Att starta i BaseUI frigör Client API-anslutningen, vilket tillåter andra klienter som mobilappar eller seriella verktyg att ansluta och konfigurera avancerade inställningar.

För att gå in i BaseUI från Bluetooth Programming Mode, tryck och håll ned Bluetooth-ikonen tills systemet startar om. När du är i BaseUI får användare tillgång till ett mer traditionellt gränssnitt som prioriterar kompatibilitet med externa klienter. Detta läge är särskilt användbart när du behöver utföra konfigurationer som inte är tillgängliga direkt i MUI.

Att återvända till MUI är enkelt: navigera till Systemfönstret inom BaseUI, håll sedan nedtryckt tills dialogrutan Systemåtgärd visas. Välj därifrån Starta om/Stäng av och välj Byt till MUI. Enheten startar om och laddar tillbaka in i Meshtastic UI-miljön.

Sammanfattning

Meshtastic UI erbjuder ett kraftfullt, flexibelt och användarvänligt gränssnitt för att hantera mesh-nätverk över ett brett spektrum av enheter. Med stöd för fristående LoRa-hårdvara, inbäddade Linux-system och inbyggda PC-installationer erbjuder MUI direkt kontroll utan att kräva en telefonapp för de flesta uppgifter. Funktioner som Hemdashboard, Nodlista, Kanaler, Chattar, Kartintegration och diagnostikverktyg gör det till en komplett lösning för både nybörjare och avancerade användare.

Installationsalternativen är varierade, från enkel webbladdning till manuell kompilering, vilket säkerställer tillgänglighet över stödd hårdvara. Inkluderingen av SD-kortsstöd, snabba installationsskärmar och intuitiv navigering förbättrar ytterligare användarvänligheten. För avancerade konfigurationer kan användare växla mellan MUI, Bluetooth Programming Mode och BaseUI, vilket ger flexibilitet beroende på deras behov.

När utvecklingen fortsätter kommer MUI att utökas med nya funktioner, optimeringar och bredare hårdvarustöd, vilket befäster dess roll som ett nyckelgränssnitt för Meshtastic-ekosystemet.

Meshtastic Guide - Meshtastic användargränssnitt