openelab.de
openelab.com
Czym jest Meshtastic UI?
Meshtastic UI (MUI) to niezależny i kompleksowy interfejs użytkownika zaprojektowany specjalnie dla urządzeń Meshtastic. Jego głównym celem jest umożliwienie użytkownikom bezpośredniej interakcji z ich siecią mesh bez polegania na aplikacji towarzyszącej na telefonie w przypadku większości codziennych konfiguracji. Pozwala to zarządzać urządzeniami i monitorować je w bardziej autonomiczny sposób. Początkowo MUI powstało z myślą o autonomicznych urządzeniach z ekranem dotykowym, jednak z czasem rozszerzono je o obsługę systemów natywnych dla Linuksa, dzięki czemu jest wszechstronnym rozwiązaniem dla szerokiej gamy platform sprzętowych. Chociaż wiele podstawowych ustawień można zmieniać bezpośrednio w MUI, niektóre zaawansowane funkcje mogą nadal wymagać sparowania z innym urządzeniem, takim jak smartfon, aby odblokować pełną funkcjonalność.
Rozwój MUI rozpoczął się na początku 2024 roku. Po ponad roku aktywnych prac pierwsza wersja zapoznawcza została udostępniona na początku 2025 roku. Do tego czasu projekt znacznie się rozrósł: obejmował około 12 000 linii kodu napisanego ręcznie i 50 000 linii kodu wygenerowanego. Pomyślnie przeniesiono go na 10 różnych urządzeń i przetłumaczono na 18 języków, co dowodzi jego szerokiego zastosowania i międzynarodowego zasięgu. MUI nadal się rozwija — trwają prace nad wprowadzaniem nowych funkcji, optymalizacją wydajności oraz rozszerzaniem kompatybilności z kolejnymi platformami sprzętowymi.
Obsługiwane urządzenia
MUI jest kompatybilne z różnorodnymi urządzeniami, między innymi z:
-
autonomiczne LoRa urządzenia z ESP32-S3 i wyświetlaczami TFT:
-
LilyGo T-Deck
-
Seeed SenseCAP Indicator
-
unPhone
-
PICOmputerem
-
-
Urządzenia typu CYD z ESP32-S3 połączonym przez port szeregowy z LoRa moduły:
-
T-HMI
-
Mesh-Tab „Replicator” (ESP-4848S040)
-
Makerfabs 4"
-
-
wbudowanym Urządzenia z systemem Linux z SPI/I2C i GPIO obsługa:
-
Raspberry Pi
-
Milk-V
-
LuckFox z TFT SPI i nakładką LoRa
-
-
Konfiguracje natywne dla systemu Linux:
-
Komputer PC z Meshstickiem lub symulacja SIMRadio z użyciem MUI w X11
-
Instalacja
W przypadku większości urządzeń autonomicznych MUI można zainstalować za pomocą internetowego flashera Meshtastic. Użytkownicy powinni szukać logo MUI na obsługiwanym sprzęcie, wybrać wersję oprogramowania układowego 2.6 lub nowszą oraz włączyć opcję Meshtastic UI podczas procesu flashowania.
Niektóre urządzenia nie są obsługiwane przez flasher internetowy, ale mają dostępne gotowe pliki binarne oprogramowania układowego. Pliki te można rozpoznać po sufiksie „-tft” w nazwach. Gotowe oprogramowanie układowe można pobrać z oficjalnej strony pobierania.
W przypadku niektórych obsługiwanych urządzeń, dla których nie są dostępne automatyczne kompilacje oprogramowania sprzętowego ani obsługa webowego flashowania, konieczne jest ręczne skompilowanie i wgranie oprogramowania. Szczegółowe instrukcje ręcznego budowania oprogramowania sprzętowego można znaleźć w dokumentacji dla deweloperów.
Wykorzystanie
Obsługa kart SD
Urządzenia wyposażone w gniazda kart SD wymagają prawidłowego sformatowania karty przed użyciem. Zalecany schemat partycji to MBR. MUI obsługuje systemy plików FAT32 i exFAT, przy czym preferowany jest exFAT ze względu na lepszą wydajność i zgodność.
Konfiguracja początkowa
Podczas pierwszego uruchomienia MUI lub po przywróceniu ustawień fabrycznych urządzenie wyświetli ekran szybkiej konfiguracji. Ekran ten pozwala jednocześnie ustawić region urządzenia, długą nazwę i krótką nazwę. Połączenie tych kroków sprawia, że wymagane jest tylko jedno ponowne uruchomienie, co upraszcza proces konfiguracji w porównaniu z ustawianiem każdej opcji osobno.
Pulpit główny
Po zakończeniu początkowej konfiguracji ekran główny pulpitu staje się domyślnym ekranem wyświetlanym przy każdym uruchomieniu. Zapewnia zwięzły przegląd statusu urządzenia oraz szybki dostęp do kluczowych obszarów i ustawień. Wiele elementów pulpitu obsługuje zarówno krótkie, jak i długie naciśnięcie, umożliwiając dodatkowe funkcje i personalizację. Szczegółowy opis dostępnych elementów sterujących i ich funkcji można znaleźć w infografice pulpitu.
Na urządzeniach autonomicznych widoczna jest również ikona karty SD. Ikona ta pokazuje rozmiar, format i statystyki wykorzystania wykrytej karty SD, zarówno w gigabajtach, jak i procentach. Dotknięcie ikony odświeża status karty SD, co jest szczególnie przydatne po jej wymianie podczas pracy urządzenia. Podczas odświeżania oprogramowanie sprzętowe może na krótko wstrzymać działanie.
Lista węzłów
Lista węzłów zapewnia kompleksowy widok wszystkich węzłów w sieci mesh. Użytkownicy mogą wyświetlać, filtrować i wyróżniać węzły na podstawie wybranych kryteriów. Pojedyncze dotknięcie ikony Węzły otwiera pełną listę aktywnych węzłów, a długie naciśnięcie otwiera Opcje węzłów, w których można zastosować filtry i wyróżnienia, aby wyeksponować określone węzły.
Kanały
Ekran Kanały wyświetla wszystkie skonfigurowane kanały urządzenia wraz z ikonami wskazującymi ich status szyfrowania:
-
Żty klucz: Kanał korzysta z domyślnego klucza wstępnie współdzielonego (PSK).
-
Zielona kłódka: Kanał korzysta z niestandardowo skonfigurowanego klucza PSK.
-
Czerwona kłódka: Kanał nie ma skonfigurowanego klucza PSK.
Dotknięcie skonfigurowanego kanału otwiera okno czatu dla tego kanału.
Czaty
Ekran rozmów zawiera listę wszystkich dostępnych konwersacji, w tym udostępnionych kanałów i wiadomości bezpośrednich. Listę rozmów można otworzyć, dotykając ikony czatu. Długie naciśnięcie rozmowy wyświetla opcję usunięcia, a nieprzeczytane wiadomości są wyróżnione na pomarańczowo. W obrębie rozmowy wiadomości są wyświetlane w formie wątku: wiadomości przychodzące pojawiają się po lewej stronie, a wychodzące z urządzenia lokalnego — po prawej. Kolor obramowania wiadomości zmienia się w zależności od stanu potwierdzenia, zapewniając natychmiastową informację zwrotną o pomyślnym dostarczeniu.
Mapa
Ekran mapy wyświetla kafelki map zapisane na karcie SD urządzenia. Domyślnie nie zawiera żadnych kafelków — należy dodać je ręcznie. Kafelki powinny być obrazami PNG o wymiarach 256x256 pikseli, najlepiej z 8-bitową głębią kolorów i paletą 256 kolorów. Zestaw startowy kafelków obejmujący poziomy powiększenia 1–6 dla całej Ziemi jest dostępny tutaj. Elementy sterujące mapą obejmują ikony strzałek do przesuwania mapy, ikony lupy do powiększania i pomniejszania, ikonę GPS do wyśrodkowania mapy na bieżącej lokalizacji urządzenia oraz celownik do ponownego wyśrodkowania mapy na pozycji domowej. Długie naciśnięcie celownika pozwala ustawić nową pozycję domową. Jeśli dane o lokalizacji są niedostępne, mapa domyślnie wskazuje Big Bena w Londynie w Wielkiej Brytanii.
Ustawienia i narzędzia
Ekran Ustawienia i narzędzia zapewnia dostęp do konfiguracji urządzenia oraz narzędzi diagnostycznych. Jest podzielony na dwie karty:
-
Ustawienia: Umożliwiają bezpośrednią konfigurację różnych aspektów urządzenia w MUI.
-
Narzędzia: Udostępniają narzędzia do diagnostyki i monitorowania sieci, w tym Detektor Mesh, Skaner sygnału, Trasowanie, Statystyki i Dziennik pakietów.
Dostęp do tego ekranu jest prosty: pojedyncze dotknięcie ikony ustawień otwiera ekran, a długie naciśnięcie blokuje ekran (jeśli funkcja blokady ekranu jest włączona) lub usypia urządzenie (jeśli jest wyłączona).
Dostęp do Client API
MUI działa jako klient, podobnie jak aplikacje na Androida i iOS. Uruchamia się na jednym rdzeniu mikrokontrolera, podczas gdy standardowe oprogramowanie sprzętowe Meshtastic działa na drugim. Komunikacja między MUI a oprogramowaniem sprzętowym odbywa się za pośrednictwem interfejsu Client API, który obsługuje tylko jedno aktywne połączenie naraz. Oznacza to, że podczas działania MUI nie można jednocześnie korzystać z innych klientów. Ponieważ nie wszystkie ustawienia można skonfigurować w MUI, użytkownicy mogą potrzebować przełączyć się w tryb programowania przez Bluetooth lub skorzystać z BaseUI, aby zwolnić API dla innych klientów.
Tryb programowania przez Bluetooth
Tryb programowania przez Bluetooth można włączyć na dwa sposoby: naciskając i przytrzymując logo Meshtastic podczas uruchamiania albo wybierając ikonę Bluetooth w menu wyłączania/resetowania w ustawieniach. Po aktywowaniu tego trybu urządzenie uruchomi się ponownie w trybie programowania przez Bluetooth i wyświetli losowo wygenerowany kod PIN, który należy wprowadzić podczas łączenia się przez Bluetooth w aplikacji klienckiej. Aby wyjść z tego trybu, ponownie naciśnij i przytrzymaj ikonę Bluetooth, a urządzenie uruchomi się ponownie w MUI.
Tryb BaseUI
Od wprowadzenia ujednoliconego oprogramowania układowego dla urządzeń TFT w wersji 2.7 przełączanie między Meshtastic UI (MUI) a BaseUI stało się bezproblemowe. Użytkownicy nie muszą już ponownie instalować oprogramowania układowego, aby zmienić interfejs. Uruchomienie BaseUI zwalnia połączenie Client API, umożliwiając innym klientom, takim jak aplikacje mobilne lub narzędzia szeregowe, połączenie i konfigurację zaawansowanych ustawień.
Aby przejść do BaseUI z trybu programowania przez Bluetooth, naciśnij i przytrzymaj ikonę Bluetooth, aż system uruchomi się ponownie. W BaseUI użytkownicy uzyskują dostęp do bardziej tradycyjnego interfejsu, który priorytetowo traktuje zgodność z klientami zewnętrznymi. Ten tryb jest szczególnie przydatny, gdy trzeba wykonać konfiguracje niedostępne bezpośrednio w MUI.
Powrót do MUI jest prosty: przejdź do okna System w BaseUI, a następnie przytrzymaj ekran, aż pojawi się okno dialogowe Działania systemu. Wybierz Uruchom ponownie/Wyłącz, a następnie Przełącz na MUI. Urządzenie uruchomi się ponownie i załaduje środowisko Meshtastic UI.
Podsumowanie
Meshtastic UI to wydajny, elastyczny i przyjazny dla użytkownika interfejs do zarządzania sieciami mesh na szerokiej gamie urządzeń. Dzięki obsłudze samodzielnego sprzętu LoRa, systemów Linux embedded i natywnych konfiguracji na komputerach PC MUI zapewnia bezpośrednią kontrolę bez konieczności korzystania z aplikacji na telefonie przy większości zadań. Funkcje takie jak pulpit główny, lista węzłów, kanały, czaty, integracja z mapą i narzędzia diagnostyczne czynią z niego kompleksowe rozwiązanie zarówno dla początkujących, jak i zaawansowanych użytkowników.
Opcje instalacji są różnorodne — od prostego wgrywania przez przeglądarkę po ręczną kompilację — co zapewnia dostępność na obsługiwanym sprzęcie. Obsługa kart SD, ekrany szybkiej konfiguracji i intuicyjna nawigacja dodatkowo zwiększają wygodę użytkowania. W przypadku zaawansowanych konfiguracji użytkownicy mogą przełączać się między MUI, trybem programowania przez Bluetooth a BaseUI, zyskując elastyczność zależnie od potrzeb.
W miarę postępu prac MUI będzie zyskiwać nowe funkcje, optymalizacje i szerszą obsługę sprzętu, umacniając swoją rolę jako kluczowego interfejsu ekosystemu Meshtastic.
