Przewodnik Meshtastic - Interfejs Meshtastic

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 konieczności korzystania z aplikacji towarzyszącej na telefonie do większości codziennych konfiguracji. Umożliwia to bardziej autonomiczne zarządzanie i monitorowanie urządzeń. Początkowo MUI zostało stworzone dla samodzielnych urządzeń z ekranem dotykowym, ale z czasem zostało rozszerzone o wsparcie dla systemów natywnych Linux, czyniąc je wszechstronnym rozwiązaniem na różnorodnych platformach sprzętowych. Chociaż wiele podstawowych ustawień można dostosować bezpośrednio przez MUI, niektóre zaawansowane funkcje mogą nadal wymagać sparowania z innym urządzeniem, takim jak smartfon, aby odblokować pełną funkcjonalność.

Prace nad MUI rozpoczęły się na początku 2024 roku. Po ponad roku intensywnej pracy, pierwsza wersja podglądowa została udostępniona na początku 2025 roku. Do tego czasu projekt znacznie się rozwinął, obejmując około 12 000 linii ręcznie pisanego kodu oraz 50 000 linii kodu generowanego. Został pomyślnie przeniesiony na 10 różnych urządzeń i przetłumaczony na 18 języków, co świadczy o jego szerokim zastosowaniu i międzynarodowym zasięgu. MUI nadal się rozwija, z bieżącymi aktualizacjami mającymi na celu wprowadzenie nowych funkcji, optymalizację wydajności oraz rozszerzenie kompatybilności z dodatkowymi platformami sprzętowymi.

Obsługiwane urządzenia

MUI jest kompatybilne z różnorodnymi urządzeniami, w tym między innymi:

Samodzielny LoRa urządzenia z ESP32-S3 i wyświetlaczami TFT:
- LilyGo T-Deck
- Seeed SenseCAP Indicator
- unPhone
- PICOmputer
Urządzenia w stylu CYD z ESP32-S3 podłączone przez szeregowe do LoRa moduły:
- T-HMI
- Mesh-Tab "Replicator" (ESP-4848S040)
- Makerfabs 4"
Wbudowany Urządzenia Linux z SPI/I2C oraz GPIO wsparcie:
- Raspberry Pi
- Milk-V
- LuckFox z TFT SPI i nakładką LoRa
Konfiguracje natywne dla Linux:
- PC z Meshstick lub symulacja SIMRadio za pomocą X11 MUI

Instalacja

Dla większości urządzeń samodzielnych MUI można zainstalować za pomocą Meshtastic Web Flasher. Użytkownicy powinni szukać logo MUI na obsługiwanym sprzęcie, wybrać wersję firmware 2.6 lub wyższą oraz włączyć opcję Meshtastic UI podczas procesu wgrywania.

Niektóre urządzenia nie są obsługiwane przez web flasher, ale mają dostępne prekompilowane pliki firmware. Pliki te można rozpoznać po sufiksie „-tft” w nazwach plików. Prekompilowane oprogramowanie można pobrać ze oficjalnej strony pobierania.

Dla niektórych obsługiwanych urządzeń, które nie mają automatycznych kompilacji oprogramowania układowego ani wsparcia web flashera, wymagane jest ręczne kompilowanie i wgrywanie firmware. Szczegółowe instrukcje dotyczące ręcznego budowania oprogramowania można znaleźć w dokumentacji dla deweloperów.

Użytkowanie

Obsługa kart SD

Urządzenia wyposażone w gniazda kart SD muszą upewnić się, że karta jest prawidłowo sformatowana przed użyciem. Zalecanym schematem partycji jest MBR. MUI obsługuje systemy plików FAT32 i exFAT, przy czym exFAT jest preferowaną opcją ze względu na lepszą wydajność i kompatybilność.

Początkowa konfiguracja

Podczas pierwszego uruchomienia MUI lub po wykonaniu resetu do ustawień fabrycznych, urządzenie wyświetli szybki ekran konfiguracji. Ekran ten pozwala użytkownikom jednocześnie ustawić region urządzenia, długą nazwę oraz krótką nazwę. Konsolidując te kroki, wymagany jest tylko jeden restart, co usprawnia proces konfiguracji w porównaniu do ustawiania każdego parametru osobno.

Pulpit Domowy

Po zakończeniu początkowej konfiguracji, pulpit domowy staje się domyślnym ekranem wyświetlanym przy każdym uruchomieniu. Zapewnia zwięzły przegląd statusu urządzenia i oferuje szybkie przejście do kluczowych obszarów lub ustawień. Wiele elementów pulpitu obsługuje zarówno krótkie, jak i długie naciśnięcia, umożliwiając dodatkową funkcjonalność i personalizację. Szczegółowy opis dostępnych kontrolerów i ich funkcji można znaleźć w Infografice Pulpitu.

Na urządzeniach samodzielnych widoczna jest również ikona karty SD. Ikona ta pokazuje rozmiar wykrytej karty SD, jej format oraz statystyki użycia zarówno w gigabajtach, jak i procentach. Stuknięcie ikony odświeża status karty SD, co jest szczególnie przydatne, jeśli karta została wymieniona na gorąco. Podczas tego odświeżania oprogramowanie układowe może chwilowo się zatrzymać.

Lista Węzłów

Lista Węzłów zapewnia kompleksowy przegląd wszystkich węzłów w sieci mesh. Użytkownicy mogą przeglądać, filtrować i wyróżniać węzły na podstawie wybranych kryteriów. Pojedyncze stuknięcie ikony Węzła otwiera pełną listę aktywnych węzłów, natomiast długie naciśnięcie otwiera Opcje Węzła, gdzie można zastosować filtry i wyróżnienia, aby podkreślić konkretne węzły.

Kanały

Ekran Kanałów wyświetla wszystkie skonfigurowane kanały dla urządzenia, z ikonami wskazującymi ich status szyfrowania:

Żółty klucz: Kanał używa domyślnego Pre-Shared Key (PSK).
Zielona kłódka: Kanał używa niestandardowo skonfigurowanego PSK.
Czerwona kłódka: Kanał nie ma skonfigurowanego PSK.

Stuknięcie w skonfigurowany kanał otwiera okno czatu dla tego kanału.

Czaty

Ekran Czatów wyświetla wszystkie dostępne rozmowy, w tym udostępnione kanały i wiadomości bezpośrednie. Listę czatów można otworzyć, stukając ikonę czatu. Długie przytrzymanie czatu ujawnia opcję usunięcia, a nieprzeczytane wiadomości są podświetlone na pomarańczowo. W obrębie czatu wiadomości są wątku: przychodzące pojawiają się po lewej, a wychodzące z lokalnego urządzenia po prawej. Obrysy wiadomości zmieniają kolor w zależności od statusu potwierdzenia, zapewniając natychmiastową informację zwrotną o powodzeniu dostarczenia.

Mapa

Ekran Mapy wyświetla kafelki mapy przechowywane na karcie SD urządzenia. Domyślnie nie ma żadnych kafelków i muszą być one dodane ręcznie. Kafelki powinny mieć rozmiar 256x256 PNG, najlepiej z głębią koloru 8-bit i paletą 256 kolorów. Zestaw startowy kafelków obejmujący poziomy powiększenia 1–6 Ziemi jest dostępny tutaj. Kontrolki mapy obejmują ikony strzałek do przesuwania, ikony lupy do powiększania, ikonę GPS do wyśrodkowania na aktualnej lokalizacji urządzenia oraz celownik do ponownego wyśrodkowania na pozycji domowej. Długie przytrzymanie celownika pozwala ustawić nową pozycję domową. Jeśli brak danych lokalizacyjnych, mapa domyślnie pokazuje Big Ben w Londynie, Wielka Brytania.

Ustawienia & Narzędzia

Ekran Ustawienia & Narzędzia zapewnia dostęp do konfiguracji urządzenia i narzędzi diagnostycznych. Jest podzielony na dwie zakładki:

Ustawienia: Pozwala użytkownikom konfigurować różne aspekty urządzenia bezpośrednio w MUI.

Narzędzia: Zapewnia narzędzia do diagnostyki i monitorowania sieci, w tym Mesh Detector, Signal Scanner, Trace Route, Statystyki oraz Packet Log.

Dostęp do tego ekranu jest prosty: pojedyncze stuknięcie w ikonę ustawień go otwiera, natomiast długie przytrzymanie 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 MCU, podczas gdy standardowe oprogramowanie Meshtastic działa na drugim. Komunikacja między MUI a oprogramowaniem odbywa się za pośrednictwem Client API, które obsługuje tylko jedno aktywne połączenie naraz. Oznacza to, że inne klienty nie mogą być używane jednocześnie podczas działania MUI. Ponieważ nie wszystkie ustawienia można skonfigurować w MUI, użytkownicy mogą potrzebować przełączyć się na Bluetooth Programming Mode lub BaseUI, aby zwolnić API dla innych klientów.

Bluetooth Programming Mode

Bluetooth Programming Mode można włączyć na dwa sposoby: przytrzymując logo Meshtastic podczas uruchamiania lub wybierając ikonę Bluetooth w menu wyłączania/resetowania w ustawieniach. Po aktywacji urządzenie uruchamia się ponownie w Bluetooth Programming Mode i wyświetla losowo wygenerowany 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 zrestartuje się i powróci do MUI.

Tryb BaseUI

Od wprowadzenia Unified Firmware dla urządzeń TFT w wersji 2.7, przełączanie się między Meshtastic UI (MUI) a BaseUI stało się płynne. Użytkownicy nie muszą już ponownie instalować firmware, aby zmienić interfejs. Uruchomienie BaseUI zwalnia połączenie Client API, umożliwiając innym klientom, takim jak aplikacje mobilne czy narzędzia szeregowe, łączenie się i konfigurowanie zaawansowanych ustawień.

Aby wejść do BaseUI z Bluetooth Programming Mode, naciśnij i przytrzymaj ikonę Bluetooth, aż system się zrestartuje. Po wejściu do BaseUI użytkownicy uzyskują dostęp do bardziej tradycyjnego interfejsu, który priorytetowo traktuje kompatybilność 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 długo, aż pojawi się okno dialogowe System Action. Stamtąd wybierz Reboot/Shutdown i wybierz Switch to MUI. Urządzenie uruchomi się ponownie i załaduje środowisko Meshtastic UI.

Podsumowanie

Meshtastic UI oferuje potężny, elastyczny i przyjazny dla użytkownika interfejs do zarządzania sieciami mesh na szerokiej gamie urządzeń. Dzięki wsparciu dla samodzielnego sprzętu LoRa, wbudowanych systemów Linux oraz natywnych konfiguracji PC, MUI umożliwia bezpośrednią kontrolę bez konieczności używania aplikacji na telefon do większości zadań. Funkcje takie jak Home Dashboard, Nodes List, Channels, Chats, integracja z mapą oraz narzędzia diagnostyczne czynią go kompleksowym rozwiązaniem zarówno dla początkujących, jak i zaawansowanych użytkowników.

Opcje instalacji są zróżnicowane, od prostego flashowania przez przeglądarkę po ręczną kompilację, co zapewnia dostępność na obsługiwanym sprzęcie. Dodanie wsparcia dla kart SD, szybkich ekranów konfiguracji oraz intuicyjnej nawigacji dodatkowo zwiększa użyteczność. Dla zaawansowanych konfiguracji użytkownicy mogą przełączać się między MUI, Bluetooth Programming Mode i BaseUI, co daje elastyczność w zależności od potrzeb.

W miarę postępu prac rozwojowych, MUI będzie się rozrastać o nowe funkcje, optymalizacje i szersze wsparcie sprzętowe, umacniając swoją rolę jako kluczowy interfejs dla ekosystemu Meshtastic.

Przewodnik Meshtastic - Interfejs Meshtastic