openelab.de
openelab.com
Wat is Meshtastic UI?
Meshtastic UI (MUI) is een onafhankelijke en uitgebreide gebruikersinterface die specifiek is ontworpen voor Meshtastic-apparaten. Het primaire doel is gebruikers in staat te stellen direct met hun mesh-netwerk te communiceren zonder voor de meeste dagelijkse configuraties afhankelijk te zijn van een begeleidende telefoonapp. Dit maakt het mogelijk apparaten op een meer autonome manier te beheren en te monitoren. Aanvankelijk werd MUI gemaakt voor zelfstandige touchscreen-apparaten, maar in de loop van de tijd is het uitgebreid om Linux-native systemen te ondersteunen, waardoor het een veelzijdige oplossing is voor een breed scala aan hardwareplatforms. Hoewel veel essentiële instellingen direct via MUI kunnen worden aangepast, kunnen bepaalde geavanceerde functies nog steeds vereisen dat er wordt gekoppeld met een ander apparaat, zoals een smartphone, om volledige functionaliteit te ontgrendelen.
De ontwikkeling van MUI begon begin 2024. Na meer dan een jaar actief werk werd de eerste preview-release begin 2025 beschikbaar gesteld. Tegen die tijd was het project aanzienlijk gegroeid, met ongeveer 12.000 regels handgeschreven code en 50.000 regels gegenereerde code. Het was succesvol geporteerd naar 10 verschillende apparaten en vertaald in 18 talen, wat de brede toepasbaarheid en internationale reikwijdte aantoont. MUI blijft zich ontwikkelen, met voortdurende updates gericht op het introduceren van nieuwe functies, het optimaliseren van prestaties en het uitbreiden van compatibiliteit met extra hardwareplatforms.
Ondersteunde apparaten
MUI is compatibel met een breed scala aan apparaten, waaronder maar niet beperkt tot:
-
Op zichzelf staand LoRa apparaten met ESP32-S3 en TFT-displays:
-
LilyGo T-Deck
-
Seeed SenseCAP Indicator
-
unPhone
-
PICOmputer
-
-
CYD-stijl apparaten met ESP32-S3 verbonden via seriële aansluiting met LoRa modules:
-
T-HMI
-
Mesh-Tab "Replicator" (ESP-4848S040)
-
Makerfabs 4"
-
-
Ingebed Linux-apparaten met SPI/I2C en GPIO ondersteuning:
-
Raspberry Pi
-
Milk-V
-
LuckFox met TFT SPI en LoRa-hat
-
-
Linux-native configuraties:
-
PC met Meshstick- of SIMRadio-simulatie met X11 MUI
-
Installatie
Voor de meeste zelfstandige apparaten kan MUI worden geïnstalleerd met behulp van de Meshtastic Web Flasher. Gebruikers moeten zoeken naar het MUI-logo op ondersteunde hardware, firmwareversie 2.6 of hoger selecteren en de Meshtastic UI-optie inschakelen tijdens het flashingproces.
Sommige apparaten worden niet ondersteund door de webflasher, maar hebben vooraf gebouwde firmwarebinaries beschikbaar. Deze firmwarebestanden zijn te herkennen aan het achtervoegsel “-tft” in hun bestandsnamen. Vooraf gebouwde firmware kan worden gedownload van de officiële downloadpagina.
Voor bepaalde ondersteunde apparaten die geen automatische firmware-builds of webflasher-ondersteuning hebben, is handmatige compilatie en flashing vereist. Gedetailleerde instructies voor het handmatig bouwen van firmware zijn te vinden in de ontwikkelaarsdocumentatie.
Gebruik
SD-kaartondersteuning
Apparaten met SD-kaartsleuven moeten ervoor zorgen dat de kaart correct is geformatteerd voordat ze wordt gebruikt. Het aanbevolen partitieschema is MBR. MUI ondersteunt zowel FAT32- als exFAT-bestandssystemen, waarbij exFAT de voorkeur heeft vanwege de verbeterde prestaties en compatibiliteit.
Eerste installatie
Bij het eerste opstarten van MUI, of na het uitvoeren van een fabrieksreset, toont het apparaat een snelconfiguratiescherm. Dit scherm stelt gebruikers in staat om tegelijkertijd de regio, lange naam en korte naam van het apparaat in te stellen. Door deze stappen te consolideren is slechts één herstart nodig, wat het installatieproces vereenvoudigt in vergelijking met het afzonderlijk configureren van elke instelling.
Home Dashboard
Zodra de initiële setup is voltooid, wordt het Home Dashboard het standaardscherm dat bij elke opstart wordt weergegeven. Het biedt een beknopt overzicht van de status van het apparaat en snelle navigatie naar belangrijke gebieden of instellingen. Veel dashboardelementen ondersteunen zowel korte als lange drukacties, waardoor extra functionaliteit en aanpassing mogelijk zijn. Voor een gedetailleerd overzicht van beschikbare bedieningselementen en hun functies kunnen gebruikers de Dashboard Infographic raadplegen.
Op zelfstandige apparaten is ook een SD-kaarticoon zichtbaar. Dit icoon toont de gedetecteerde SD-kaartgrootte, het formaat en gebruiksstatistieken in zowel gigabytes als percentage. Door op het icoon te tikken wordt de status van de SD-kaart vernieuwd, wat vooral handig is als de kaart hot-swapped is. Tijdens deze vernieuwing kan de firmware kort pauzeren.
Knopenlijst
De Knopenlijst biedt een uitgebreid overzicht van alle knopen binnen het mesh-netwerk. Gebruikers kunnen knopen bekijken, filteren en markeren op basis van geselecteerde criteria. Een enkele tik op het knoopicoon opent de volledige lijst met actieve knopen, terwijl een lange druk de Knoopopties opent, waar filters en markeringen kunnen worden toegepast om specifieke knopen te benadrukken.
Kanalen
Het Kanalen-scherm toont alle geconfigureerde kanalen voor het apparaat, met pictogrammen die hun versleutelingsstatus aangeven:
-
Geel sleutel: Kanaal gebruikt een standaard Pre-Shared Key (PSK).
-
Groen slot: Kanaal gebruikt een zelfgeconfigureerde PSK.
-
Rode slot: Kanaal heeft geen PSK geconfigureerd.
Tikken op een geconfigureerd kanaal opent een chatvenster voor dat kanaal.
Chats
Het Chats-scherm toont alle beschikbare gesprekken, inclusief gedeelde kanalen en directe berichten. De chatlijst is toegankelijk door op het chatpictogram te tikken. Lang drukken op een chat toont een verwijderoptie, terwijl ongelezen berichten oranje worden gemarkeerd. Binnen een chat zijn berichten in threads: binnenkomende berichten verschijnen aan de linkerkant, en uitgaande berichten van het lokale apparaat aan de rechterkant. De omtrek van berichten verandert van kleur op basis van de bevestigingsstatus, wat directe feedback geeft over het succes van de levering.
Kaart
Het Kaartscherm toont kaarttegels die op de SD-kaart van het apparaat zijn opgeslagen. Er worden standaard geen tegels meegeleverd en deze moeten handmatig worden toegevoegd. Tegels moeten 256x256 PNG-afbeeldingen zijn, bij voorkeur met een kleurendiepte van 8 bit en een palet van 256 kleuren. Een startset tegels die zoomniveaus 1–6 van de aarde dekt, is beschikbaar hier. Kaartbediening omvat pijlpictogrammen voor pannen, vergrootglasiconen voor in- en uitzoomen, een GPS-pictogram om te centreren op de huidige locatie van het apparaat, en kruisdraden om te hercentreren op de thuispositie. Door lang op de kruisdraden te drukken, kunnen gebruikers een nieuwe thuispositie instellen. Als er geen locatiegegevens beschikbaar zijn, wordt de kaart standaard ingesteld op Big Ben in Londen, VK.
Instellingen & Tools
Het scherm Instellingen & Tools biedt toegang tot apparaatconfiguratie en diagnostische hulpmiddelen. Het is verdeeld in twee tabbladen:
-
Instellingen: Hiermee kunnen gebruikers verschillende aspecten van het apparaat direct binnen MUI configureren.
-
Tools: Biedt hulpmiddelen voor netwerkdiagnose en monitoring, waaronder Mesh Detector, Signaalscanner, Trace Route, Statistieken en Packet Log.
Toegang tot dit scherm is eenvoudig: een enkele tik op het instellingenpictogram opent het, terwijl een lange druk het scherm vergrendelt (als de vergrendelingsfunctie is ingeschakeld) of het apparaat in slaapstand zet (als deze is uitgeschakeld).
Toegang tot Client API
MUI werkt als een client, vergelijkbaar met de Android- en iOS-applicaties. Het draait op één core van de MCU, terwijl de standaard Meshtastic-firmware op de andere draait. Communicatie tussen MUI en de firmware wordt afgehandeld via de Client API, die slechts één actieve verbinding tegelijk ondersteunt. Dit betekent dat andere clients niet gelijktijdig kunnen worden gebruikt terwijl MUI actief is. Omdat niet alle instellingen binnen MUI kunnen worden geconfigureerd, moeten gebruikers mogelijk overschakelen naar Bluetooth Programmeermodus of BaseUI om de API vrij te maken voor andere clients.
Bluetooth Programmeermodus
Bluetooth Programmeermodus kan op twee manieren worden ingeschakeld: door het Meshtastic-logo ingedrukt te houden tijdens het opstarten, of door het Bluetooth-pictogram te selecteren in het uitschakel-/resetmenu binnen de instellingen. Wanneer geactiveerd, start het apparaat opnieuw op in Bluetooth Programmeermodus en toont een willekeurig gegenereerde PIN, die moet worden ingevoerd bij het verbinden via Bluetooth in de client-app. Om deze modus te verlaten, druk en houd het Bluetooth-pictogram opnieuw ingedrukt, waarna het apparaat opnieuw opstart in MUI.
BaseUI-modus
Sinds de introductie van Unified Firmware voor TFT-apparaten in versie 2.7 is het schakelen tussen Meshtastic UI (MUI) en BaseUI naadloos geworden. Gebruikers hoeven de firmware niet meer opnieuw te installeren om van interface te wisselen. Opstarten in BaseUI maakt de Client API-verbinding vrij, waardoor andere clients zoals mobiele apps of seriële tools kunnen verbinden en geavanceerde instellingen kunnen configureren.
Om BaseUI te openen vanuit de Bluetooth Programmeermodus, druk en houd het Bluetooth-pictogram ingedrukt totdat het systeem opnieuw opstart. Eenmaal in BaseUI krijgen gebruikers toegang tot een meer traditionele interface die compatibiliteit met externe clients prioriteert. Deze modus is vooral handig wanneer je configuraties moet uitvoeren die niet direct beschikbaar zijn in MUI.
Terugkeren naar MUI is eenvoudig: navigeer naar het Systeemvenster binnen BaseUI en houd ingedrukt totdat het dialoogvenster Systeemactie verschijnt. Selecteer vervolgens Herstart/Uitschakelen en kies Schakel over naar MUI. Het apparaat zal opnieuw opstarten en terugkeren naar de Meshtastic UI-omgeving.
Samenvatting
Meshtastic UI biedt een krachtige, flexibele en gebruiksvriendelijke interface voor het beheren van mesh-netwerken op een breed scala aan apparaten. Met ondersteuning voor standalone LoRa-hardware, embedded Linux-systemen en native pc-omgevingen, biedt MUI directe controle zonder dat een telefoonapp voor de meeste taken nodig is. Functies zoals het Home Dashboard, Nodes List, Channels, Chats, kaartintegratie en diagnostische tools maken het een complete oplossing voor zowel beginners als gevorderde gebruikers.
Installatie-opties zijn gevarieerd, van eenvoudige webflashing tot handmatige compilatie, wat toegankelijkheid op ondersteunde hardware garandeert. De toevoeging van SD-kaartondersteuning, snelle installatieschermen en intuïtieve navigatie verbeteren de bruikbaarheid verder. Voor geavanceerde configuraties kunnen gebruikers schakelen tussen MUI, Bluetooth Programmeermodus en BaseUI, wat flexibiliteit biedt afhankelijk van hun behoeften.
Naarmate de ontwikkeling vordert, zal MUI uitbreiden met nieuwe functies, optimalisaties en bredere hardware-ondersteuning, waarmee het zijn rol als belangrijke interface voor het Meshtastic-ecosysteem verstevigt.
