MeshCom Polska

Radioamatorska sieć mesh

Aplikacja mobilna MeshCom 4.0

 

 

Oficjalną aplikację mobilną do obsługi sieci MeshCom napisał Rainer, OE1KFR. Jest to jedyna oficjalna aplikacja projektu — dostępna zarówno na Androida, jak i na iOS. Kod źródłowy aplikacji jest jawny i publikowany na GitHubie: github.com/rainerfritz/Meshcom-MobileApp

 

Instrukcja instalacji i obsługi aplikacji mobilnej MeshCom 4.0

 

Dedykowana aplikacja dla systemów iOS oraz Android pozwala na wygodną obsługę węzłów sieci MeshCom. Służy ona przede wszystkim do odbierania i wysyłania wiadomości, a także do konfiguracji i dostrajania parametrów pracy urządzeń. Funkcja interaktywnej mapy pozwala na bieżący podgląd okolicznych uczestników sieci kratowej, z którymi można nawiązać kontakt bezpośrednio drogą radiową lub poprzez przekazywanie pakietów, również bez dostępu do Internetu.

 

1. Wymagania i pobieranie aplikacji

 

  • Do pełnej zgodności z aplikacją węzeł musi mieć wgraną najnowszą wersję firmware MeshCom. Jeśli na module wcześniej zainstalowano inne oprogramowanie, konieczne jest wykonanie operacji Erase, a następnie ponowne wgranie firmware MeshCom (opcja dostępna w Web-Installerze).
  • Aplikacja wymaga zgody na dostęp do: lokalizacji (GPS), Bluetooth oraz wiadomości.

Pobieranie aplikacji

iPhone (iOS): Apple App Store — https://apps.apple.com/at/app/meshcom/id6447483289

Android: Google Play — https://play.google.com/store/apps/details?id=io.ionic.meshcom

Dostępna jest też opcja instalacji ręcznej (side-loading) — plik APK do pobrania bezpośrednio ze strony icssw.org, bez pośrednictwa Google Play.

Praca w tle

  • iOS: praca w tle jest w pełni obsługiwana — komunikacja utrzymywana jest bez przerwy, a wiadomości trafiają na telefon. Nie działa jednak automatyczna synchronizacja czasu z węzłem.
  • Android: ze względu na ograniczenia systemu, aby aplikacja działała stabilnie w tle, trzeba ręcznie wyłączyć wszystkie optymalizacje baterii oraz ograniczenia aplikacji w ustawieniach systemowych telefonu. Bez tego połączenie po kilku minutach przestaje wymieniać dane.

 

2. Zakładka Connect: Parowanie węzłów ze smartfonem/tabletem

 

Po uruchomieniu aplikacji automatycznie rozpoczyna się skanowanie otoczenia w poszukiwaniu urządzeń Bluetooth Low Energy (BLE). Domyślnie na liście wyświetlane są wyłącznie dedykowane węzły MeshCom. Stuknięcie w nazwę wybranego urządzenia inicjuje proces parowania.

Przy pierwszym połączeniu wymagane jest podanie kodu PIN – domyślna wartość to 000000. Kod ten można później zmienić w ustawieniach aplikacji, przez interfejs WWW lub za pomocą konsoli szeregowej. Po pomyślnej weryfikacji aplikacja wczytuje konfigurację połączonego węzła, a urządzenie na liście zostaje podświetlone na zielono.

 

3. Zakładka Settings (Ustawienia)

 

Zakładka Settings służy do konfiguracji parametrów pracy stacji. Przy pierwszej konfiguracji należy najpierw wprowadzić poprawny znak wywoławczy (Callsign) i zapisać zmiany przyciskiem Save Settings to Node. Po kilku sekundach węzeł automatycznie zrestartuje się, co spowoduje chwilowe rozłączenie połączenia Bluetooth. Po ponownym automatycznym połączeniu można kontynuować konfigurację stacji.

3.1 Ustawienia Wi-Fi
Wprowadzone dane dostępowe do lokalnej sieci WLAN są trwale zapamiętywane w pamięci urządzenia i wykorzystywane wyłącznie, gdy węzeł pracuje w trybie bramki (Gateway) lub ma włączoną usługę serwera WWW.

3.2 Ustawienia APRS
Określają sposób prezentacji stacji w systemach APRS. Pole APRS-Comment pozwala na wprowadzenie krótkiego opisu (do 39 znaków).

3.3 Pin OneWire
Definiuje fizyczny pin GPIO mikrokontrolera obsługujący cyfrowe czujniki temperatury (np. DS18B20). Odczyty są widoczne w zakładce Info jako parametr TOUT.

3.4 Pin przycisku użytkownika (User Button)
Określa pin GPIO dla fizycznego przycisku stacji, którego naciśnięcie pozwala na ręczne przewijanie odebranych wiadomości bezpośrednio na wyświetlaczu urządzenia.

3.5 Kod PIN Bluetooth
Umożliwia zmianę domyślnego, 6-cyfrowego kodu PIN BLE w celu zabezpieczenia dostępu do stacji przed osobami nieuprawnionymi (dozwolone są wyłącznie cyfry 0-9).

3.6 Przesunięcie czasu UTC węzła (Time Offset)
Określa strefę czasową; dla Polski należy ustawić wartość 1 w okresie zimowym (CET) oraz 2 w okresie letnim (CEST).

3.7 Ustawienia kraju/regionu (Country Setting)
Wybór regionu automatycznie dostosowuje częstotliwości pracy i parametry nadawania modułu LoRa do lokalnych przepisów.
WAŻNA UWAGA: Ze względu na ograniczenia aplikacji mobilnej, obecnie nie ma możliwości ustawienia regionu dla Polski (PL) bezpośrednio z poziomu telefonu. Aby węzeł poprawnie pracował na polskich częstotliwościach amatorskich (433.175 MHz dla MeshCom oraz 434.855 MHz dla raportowania pozycji do LoRa APRS), konfigurację regionu należy przeprowadzić za pomocą lokalnego serwera WEBService przez przeglądarkę internetową.

3.8 Subskrypcja grup rozmównych (Group Subscription)
Aplikacja pozwala na zapisanie się do maksymalnie 6 grup rozmównych (identyfikatory od 1 do 5 cyfr). Informacja ta jest przekazywana do najbliższej bramki, aby pakiety z tych grup były kierowane drogą radiową do użytkownika. W polskiej sieci MeshCom przyjęto następujący standard podziału grup:

  • 2601 – 2609: Grupy dedykowane dla poszczególnych okręgów (np. 2606 dla Dolnego Śląska i Opolszczyzny).
  • 26001: Ogólnopolska grupa dla telemetrii, czujników i automatycznych stacji pogodowych.
  • 26009: Oficjalna grupa dla ostrzeżeń pogodowych, alertów kryzysowych i komunikatów o zagrożeniach.
  • 26066: Grupa lokalna dla regionu Brzeg (zunifikowana z lokalną grupą Talkgroup systemu DMR).
  • 9: Specjalna grupa lokalna (LOC) – komunikacja wewnątrz tej grupy nie jest przesyłana przez bramki (Gateway) do Internetu i pozostaje wyłącznie w zasięgu lokalnej sieci radiowej RF.
  • Przycisk Reset Groups zeruje wszystkie subskrypcje (ustawia wartość 0).

3.9 Przyciski sterujące użytkownika (User Buttons)
Wirtualne przełączniki służące do natychmiastowej aktywacji funkcji sprzętowych i programowych węzła. Stan przycisku na ekranie telefonu zaktualizuje się po przetworzeniu komendy przez węzeł i odesłaniu informacji zwrotnej, co może zająć kilka sekund.

  • Gateway: Aktywuje węzeł jako bramkę internetową (wymaga konfiguracji Wi-Fi).
  • Mesh: Włącza/wyłącza funkcję przekaźnika (dalsze przekazywanie pakietów drogą radiową w sieci kratowej).
  • Display: Włącza/wyłącza obsługę i podświetlenie fizycznego wyświetlacza stacji.
  • No ALL Msg RX: Ukrywa/pokazuje wiadomości ogólne adresowane do wszystkich (oznaczone znakiem „*”).
  • GPS: Włącza/wyłącza zasilanie i odczyt z fizycznego modułu GPS.
  • Button: Aktywuje/dezaktywuje obsługę fizycznego przycisku stacji.
  • RX Gain Boost: Włącza/wyłącza sprzętowe wzmocnienie odbiornika w węzłach z chipem LoRa SX1262.
  • Track: Aktywuje funkcję pozycjonowania (tracking): Smart-Beaconing za pośrednictwem sieci LoRa-APRS.
  • Send POS: Wysyła aktualną pozycję GPS w sieci MeshCom (maksymalnie raz na 15 sekund).
  • Send TRACK: Wysyła pojedynczy pakiet z pozycją bezpośrednio do sieci LoRa-APRS, jeśli funkcja TRACK jest aktywna.
  • BME280, BMP280, BME680, MCU-811: Zarządzanie obsługą czujników środowiskowych podłączonych do szyny I2C.
  • One Wire: Włącza/wyłącza obsługę cyfrowych czujników temperatury OneWire.
  • LPS33: Aktywuje dedykowaną płytkę czujnika ciśnienia LPS33 dla stacji opartych na module RAK4631.
  • WX-Info / Pos-Info: Automatycznie przełącza aplikację do zakładki Info i wyświetla odpowiednio dane z czujników lub pozycjonowania GPS.
  • Webserver: Włącza lub wyłącza lokalną usługę serwera WWW na węźle.
  • WiFi AP: Uruchamia węzeł w trybie punktu dostępowego Wi-Fi, tworząc własną podsieć w przypadku braku routera domowego.
  • Scan I2C: Skanuje magistralę I2C i wyświetla adresy wszystkich podłączonych czujników oraz ekranów.
  • Reboot: Restartuje oprogramowanie układowe węzła.
  • OTA Update: Wprowadza stację w tryb bezprzewodowej aktualizacji oprogramowania układowego przez Wi-Fi.

3.10 Moc nadawania (TX Power)
Regulacja siły sygnału (zazwyczaj od 17 do 22 dBm). Moduły ze wzmacniaczem PA (np. Ebyte E22) zwiększają te wartości o dodatkowe 8 lub 11 dB.

3.11 Zarządzanie pamięcią podręczną (Advanced Settings)
Opcje czyszczenia pozwalają na usunięcie lokalnych danych z telefonu:

  • Clear received Nodes: Usuwa z pamięci listę stacji na mapie.
  • Clear Text Messages: Trwale kasuje lokalną historię rozmów w czacie.
  • Clear Mheard Entries: Czyści listę stacji słyszanych bezpośrednio (MHeard).

 

4. Zakładka Info

 

Wyświetla szczegółowe informacje techniczne o węźle: stan naładowania baterii, dane z modułu GPS, odczyty telemetryczne ze wszystkich aktywnych czujników oraz wersje oprogramowania. Przycisk Log na dole ekranu daje dostęp do wewnętrznego dziennika zdarzeń aplikacji.

 

5. Zakładka Chat (Okno wiadomości)

 

Służy do prowadzenia korespondencji tekstowej – wyświetla wiadomości przychodzące oraz pozwala na wysyłanie własnych komunikatów za pośrednictwem węzła. Po aktywacji przycisku DM (Direct Message) pojawia się pole, w którym należy wpisać znak stacji docelowej (wraz z sufiksem) lub numer grupy docelowej.

Tapping koła zębatego w prawym górnym rogu ekranu pozwala na filtrowanie wyświetlanych komunikatów:

  • DM: Pokazuje wyłącznie wiadomości bezpośrednie (prywatne).
  • DM and GRP: Pokazuje wiadomości bezpośrednie oraz grupowe.
  • GRP: Pokazuje wyłącznie wiadomości grupowe.

Status wysłanej wiadomości sygnalizowany jest za pomocą czytelnych ikon:

  • Zielony ptaszek (checkmark): Wiadomość została pomyślnie przesłana ze smartfona do Waszego lokalnego węzła radiowego.
  • Ikona chmury: Wiadomość została odebrana i przekazana dalej (retransmitowana) przez inny węzeł w sieci radiowej.
  • Ptaszek wpisany w chmurę: Wiadomość dotarła do stacji bramowej (Gateway) i została przesłana do centralnego serwera MeshCom.

W przypadku wiadomości bezpośrednich (DM) kierowanych do konkretnego znaku, ikona ptaszka w chmurze stanowi jednocześnie potwierdzenie typu End-to-End, oznaczające, że adresat odebrał komunikat na swoim urządzeniu. Dłuższe przytrzymanie dowolnej wiadomości na liście otwiera menu, z poziomu którego można rozpocząć pisanie wiadomości prywatnej (DM) do nadawcy lub skopiować treść wiadomości do schowka.

 

6. Zakładka Map (Mapa poglądowa)

 

Prezentuje pozycję stacji własnej oraz stacji odebranych w sieci kratowej, oznaczając je kolorami:

  • Fioletowy: Wasz własny węzeł.
  • Zielony: Węzły słyszane bezpośrednio drogą radiową (odbiór bezpośredni RF).
  • Niebieski: Węzły słyszane pośrednio (odebrane przez inne stacje przekaźnikowe w sieci kratowej).

Dodatkowe przyciski na mapie oferują zaawansowane funkcje wizualizacji i nawigacji:

  • Przycisk Menu (Ikonka z dodatkowymi opcjami): Otwiera menu rozwijane z zaawansowanymi ustawieniami mapy.
  • Wizualizacja połączeń (Czerwone linie): Rysuje czerwone linie łączące Wasz węzeł ze stacjami słyszanymi bezpośrednio radiowo.
  • Wyszukiwarka (Ikonka lupy): Pozwala szybko zlokalizować na mapie stację o konkretnym znaku wywoławczym.
  • Centrowanie mapy: Przesuwa widok mapy i centruje go na Waszej aktualnej pozycji.
  • Śledzenie pozycji (Tracking): Włącza lub wyłącza automatyczne podążanie mapy za przemieszczającym się węzłem (dostępne przy aktywnym module GPS).
  • Kliknięcie na ikonę dowolnego węzła na mapie wyświetla okienko ze szczegółowymi informacjami telemetrycznymi, napięciem baterii i odległością.

 

7. Zakładka MHeard

 

Wyświetla pełną chronologiczną listę wszystkich węzłów, których sygnał radiowy (RF) został odebrany bezpośrednio przez Wasze urządzenie od momentu jego ostatniego uruchomienia.

 

 

Szybka konfiguracja Główna Grupy rozmówne