Szybka konfiguracja przez WEBService

Wbudowana w oprogramowanie układowe MeshCom 4.0 usługa lokalnego serwera WWW (WEBService) umożliwia bardzo precyzyjne dostrojenie parametrów pracy węzła bezpośrednio z poziomu przeglądarki internetowej. Poniżej przedstawiono kompletny poradnik opisujący procedurę uruchomienia połączenia oraz funkcje i znaczenie wszystkich opcji dostępnych w panelu administracyjnym stacji.

1. Uzyskanie dostępu do panelu WEBService

Wbudowana usługa lokalnego serwera konfiguracyjnego (WEBService) wymaga spełnienia określonych warunków wstępnych oraz wyboru odpowiedniej ścieżki połączenia sieciowego. Domyślnie, ze względów oszczędności energii, serwer może być wyłączony. Uruchomienie usługi realizuje się na dwa sposoby:

Z poziomu aplikacji mobilnej: Po połączeniu się z węzłem przez Bluetooth (BLE), należy przejść do zakładki ustawień (Settings) i aktywować przełącznik Webserver.
Przez konsolę szeregową (USB): Po podłączeniu urządzenia do komputera i otwarciu terminala szeregowego (np. PuTTY, prędkość 115200 bodów) należy wprowadzić i zatwierdzić komendę --webserver on.

Ścieżka A: Połączenie przez sieć domową (Tryb kliencki)

Ta metoda jest zalecana dla stacji stacjonarnych i bramek domowych, które mają stały zasięg domowego routera bezprzewodowego.

Konfiguracja danych Wi-Fi: W pierwszej kolejności należy wprowadzić nazwę (SSID) oraz hasło do domowej sieci Wi-Fi w sekcji IP Network Settings za pomocą aplikacji mobilnej lub komend konsoli: --setssid <nazwa> i --setpwd <hasło>.
Inicjalizacja połączenia: Po zapisaniu ustawień i restarcie, węzeł automatycznie połączy się z domowym routerem i pobierze lokalny adres IP z serwera DHCP.
Identyfikacja adresu urządzenia: Adres IP nadany stacji można odczytać z poziomu aplikacji mobilnej (zakładka Info), na fizycznym wyświetlaczu urządzenia podczas uruchomienia lub w konsoli szeregowej USB po wpisaniu komendy --info.
Wywołanie w przeglądarce: Na komputerze lub telefonie połączonym z tą samą siecią domową należy otworzyć przeglądarkę i wpisać adres IP węzła (np. http://192.168.1.150) lub skorzystać z protokołu mDNS, wpisując adres: http://<ZNAK_WĘZŁA>.local (np. http://SP9XXX.local – gdzie zamiast SP9XXX wpisuje się własny znak stacji).

Ścieżka B: Połączenie bezpośrednie (Tryb autonomiczny / WiFi AP)

Metoda ta jest niezastąpiona w warunkach terenowych lub podczas pierwszej konfiguracji stacji, gdy nie ma dostępu do zewnętrznego routera Wi-Fi.

Uruchomienie Punktu Dostępowego (AP): Należy aktywować wbudowany punkt dostępowy mikrokontrolera. Wykonuje się to poprzez kliknięcie przycisku WiFi AP w zakładce ustawień aplikacji mobilnej lub wpisując w konsoli szeregowej USB komendę --wifiap on.
Połączenie z siecią bezprzewodową: Na komputerze lub smartfonie należy otworzyć listę dostępnych sieci Wi-Fi, wyszukać sieć o nazwie MeshCom-OTA i połączyć się z nią bezpośrednio.
Wywołanie w przeglądarce: Po pomyślnym połączeniu należy otworzyć przeglądarkę i wpisać domyślny, sztywny adres IP bramy: http://192.168.4.1 lub uniwersalny host mDNS: http://MeshCom-OTA.local.

2. Szczegółowy opis sekcji konfiguracyjnych

Poniżej znajduje się szczegółowe omówienie ról i właściwości każdego z pól konfiguracyjnych widocznych w panelu serwera WWW.

2.1 Manual Command (Konsola poleceń)

Sekcja ta znajduje się na samej górze panelu i stanowi bezpośrednie, sieciowe okno terminala do komunikacji z procesorem urządzenia:

Enter manual command: Pole tekstowe służące do ręcznego wpisywania tekstowych komend CLI (CommandLine Interface) systemu MeshCom. Pozwala to na szybką zmianę parametrów bez przechodzenia do dedykowanych sekcji (np. wpisanie --bme on lub parametrów APRS).
send command (Przycisk): Przycisk zatwierdzający i wysyłający wpisaną w polu tekstowym komendę bezpośrednio do mikrokontrolera w celu jej natychmiastowego przetworzenia i wykonania.

2.2 Common Settings (Ustawienia Ogólne)

Główny blok odpowiedzialny za identyfikację radiową stacji oraz podstawowe parametry zasilania i pracy sieci kratowej:

Call-Sign: Znak wywoławczy operatora wraz z zalecanym identyfikatorem SSID (np. SP9XXX-10). Używanie unikalnych sufiksów SSID zapobiega konfliktom adresowym w sieci i umożliwia prawidłowe doręczanie wiadomości bezpośrednich (DM).
Via-Call-Sign: Znak wywoławczy stacji pośredniczącej, przez którą ma być stale kierowany ruch.
Country: Kraj pracy urządzenia (dla Polski należy wybrać PL). To krytyczne ustawienie automatycznie programuje parametry pracy modułu LoRa stacji do zgodności z polskimi ustaleniami amatorskimi, ustawiając częstotliwość aprs na 433.175 MHz.
TX Power: Moc nadawania modułu radiowego wyrażona w dBm (standardowa bezpieczna wartość to 22 dBm).
UTC Offset: Przesunięcie czasu dla Polski (w okresie zimowym CET ustawia się wartość 1.0, w okresie letnim CEST wartość 2.0).
max. Voltage: Maksymalne napięcie zasilania akumulatora (np. 4.200 V dla ogniw Li-Ion), wykorzystywane do kalibracji wskazań telemetrycznych.
Display (Przełącznik): Włącza lub wyłącza podświetlenie fizycznego wyświetlacza stacji.
Voltage (Przełącznik): Przełącza sposób prezentacji stanu baterii na wyświetlaczu – prezentuje rzeczywiste napięcie w woltach zamiast wartości procentowej.
Mesh (Przełącznik): Aktywuje funkcja przekaźnika. Gdy przełącznik jest włączony, węzeł automatycznie odbiera, wzmacnia i realizuje dalsze przekazywanie pakietów radiowych innych uczestników.
Via (Przełącznik): Włącza funkcję wymuszonego routingu pakietów przez stację zdefiniowaną w polu Via-Call-Sign.
Reboot into OTA Updater (Przycisk): Wymusza natychmiastowy restart stacji i jej przejście w tryb bezprzewodowego pobierania nowej wersji oprogramowania układowego przez Wi-Fi.

2.3 IP Network Settings (Ustawienia Sieciowe)

Sekcja dedykowana dla urządzeń pracujących w trybie stacji bramowej, odpowiadająca za połączenie z siecią Wi-Fi oraz konfigurację protokołów sieciowych:

SSID / WiFi Password: Dane logowania do domowej sieci bezprzewodowej Wi-Fi (nazwa sieci oraz klucz zabezpieczający).
fixed IP / Subnet Mask / Gateway / DNS: Pola pozwalające na przypisanie stacji stałego, statycznego adresu IP w lokalnej sieci komputerowej, maski podsieci, adresu bramy oraz serwera DNS (zalecane dla stabilnej pracy bramki).
NTP: Serwer czasu NTP (Network Time Protocol) wykorzystywany do synchronizacji wewnętrznego zegara stacji przy braku modułu GPS.
ext. UDP IP: Adres IP zewnętrznego komputera lub serwera, na który mają być przesyłane pakiety danych.
ext UDP (Przełącznik): Włącza obsługę zewnętrznego protokołu UDP, co pozwala na integrację stacji z zewnętrznym oprogramowaniem klienckim lub zewnętrznymi skryptami (np. stacji pogodowych).
net console (Przełącznik): Aktywuje konsolę sieciową na porcie 2323, umożliwiając bezpieczne zarządzanie stacją przez protokół Telnet/NetConsole.
Gateway (Przełącznik): Kluczowy przełącznik aktywujący funkcję bramki internetowej. Po jego włączeniu stacja zaczyna przekazywać pakiety radiowe odebrane z eteru bezpośrednio do centralnego serwera MeshCom i odwrotnie.

2.4 Position & APRS Settings (Pozycja i APRS)

Ustawienia lokalizacji i tożsamości stacji w globalnym systemie automatycznej lokalizacji stacji APRS (widoczność m.in. na aprs.fi):

A. Position Settings (Ustawienia lokalizacji)

Position Latitude / Longitude (+/-): Szerokość i długość geograficzna stacji. Dla stacji stacjonarnych (domowych) bez fizycznego modułu GPS współrzędne należy wprowadzić na stałe ręcznie.
Position Altitude (meter): Wysokość stacji nad poziomem morza wyrażona w metrach.
GPS (Przełącznik): Aktywuje zasilanie i odczyt danych z wbudowanego lub podłączonego zewnętrznego modułu GNSS/GPS. Należy wyłączyć dla stacji stacjonarnych, aby zapobiec nadpisywaniu wprowadzonych na stałe współrzędnych.
Track (Przełącznik): Aktywuje tryb dynamicznego pozycjonowania (Smart-Beaconing) stacji w ruchu, przesyłający pozycję do sieci LoRa-APRS. Bezwzględnie wyłączony dla stacji stałych.

B. APRS Settings (Identyfikacja i symbole APRS)

Operator Name: Imię operatora lub unikalny opis stacji (maksymalnie 19 znaków).
APRS Comment: Krótki komentarz (maksymalnie 39 znaków) dołączany do każdego pakietu pozycji stacji, widoczny na mapach aprs.fi.
APRS Group / Symbol: Kod grupy oraz symbolu APRS. Zgodnie z najnowszymi standardami uzgodnionymi przez społeczność MeshCom:
- Bramki internetowe (Gateway – GW): Powinny korzystać z grupy G i symbolu # (komendy: --symid G oraz --symcd #). Wyświetla to stację na mapach jako dedykowaną ikonę bramki sieciowej.
- Standardowe stacje radiowe (Mesh-only): Powinny korzystać z grupy M i symbolu # (ikona zielonej gwiazdy z literą M).
- Stacje pogodowe (Meteo – WX): Powinny korzystać z grupy / i symbolu _ (ikona stacji pogodowej WX).

2.5 External Hardware Settings (Peryferia i Czujniki)

Sekcja przeznaczona do zarządzania fizycznymi wejściami/wyjściami mikrokontrolera oraz czujnikami środowiskowymi na magistralach danych:

1-Wire GPIO: Numer fizycznego pinu procesora obsługującego magistralę OneWire (np. pin 4).
1-Wire (Przełącznik): Włącza odczyt z cyfrowych czujników temperatury OneWire (np. DS18B20).
Userbutton GPIO / Userbutton (Przełącznik): Definiuje pin fizycznego przycisku stacji oraz aktywuje funkcja przewijania odebranych wiadomości na fizycznym ekranie urządzenia.
BMP280 / BME280 / BME680 / INA226 (Przełączniki): Aktywują obsługę konkretnych cyfrowych czujników telemetrycznych (temperatury, wilgotności, ciśnienia, napięcia, prądu) podłączonych do szyny danych I2C.
Indoor / Outdoor Temp Offset: Pozwala na wprowadzenie korekty kalibracyjnej (offsetu) dla odczytów temperatury wewnętrznej i zewnętrznej.

2.6 Groups / Messaging (Polskie Grupy Rozmowne GRC)

Filtrowanie i subskrypcja pakietów grupowych przesyłanych przez bramkę sieciową:

Listen to Group (Pola 1-6): Umożliwia zdefiniowanie do 6 cyfrowych grup rozmównych, które stacja ma subskrybować. Bramka sieciowa będzie pobierać z serwera internetowego i emitować radiowo w lokalny eter wyłącznie ruch przeznaczony dla tych konkretnych grup, co zapobiega przeciążeniu pasma radiowego RF.

W polskiej części sieci MeshCom standard GRC zdefiniowano następująco:

260: Ogólnopolska grupa główna (ruch wywoławczy i ogólny).
2601 do 2609: Grupy okręgów amatorskich SP1–SP9 (np. grupa 2606 dla okręgu Dolnego Śląska i Opolszczyzny).
26001: Ogólnopolska grupa telemetryczna dla automatycznych stacji pogodowych i czujników środowiskowych.
26009: Ogólnopolska grupa alarmowa przeznaczona dla powiadomień i alertów kryzysowych stacji Notfunk.
26066: Grupa lokalna Brzeg (zsynchronizowana bezpośrednio z lokalną grupą Talkgroup cyfrowego systemu DMR).
9: Specjalna grupa lokalna (LOC). Ruch w tej grupie nie opuszcza lokalnej sieci radiowej RF i nie jest przekazywany przez bramki sieciowe do Internetu.

No MSG All (Przełącznik): Włączenie tej opcji powoduje odrzucanie i niewyświetlanie wiadomości ogólnych (kierowanych do wszystkich uczestników sieci, oznaczonych znakiem *). Pozostawienie przełącznika w pozycji wyłączonej (OFF) gwarantuje odbiór wszystkich komunikatów z sieci.

3. MCP23017 oraz INA226 – Dlaczego nie są widoczne w panelu?

Wielu użytkowników po uruchomieniu panelu WEBService zastanawia się, dlaczego w sekcji External Hardware Settings nie widzi opcji konfiguracji zaawansowanych peryferiów, takich jak ekspander 16-pinowy MCP23017, czujnik poboru prądu INA226 czy zegar czasu rzeczywistego RTC DS3231.

Wynika to z faktu, że oprogramowanie układowe stacji MeshCom 4.0 realizuje zasadę dynamicznego wykrywania sprzętu:

Skanowanie magistrali I2C: Podczas rozruchu (bootowania) urządzenia, oprogramowanie układowe skanuje szynę I2C w poszukiwaniu określonych adresów sprzętowych (np. 0x20 dla ekspandera MCP23017, 0x40 dla czujnika INA226 oraz 0x56 dla zegara RTC DS3231).
Automatyczna aktywacja: Jeśli dany układ zostanie fizycznie wykryty i poprawnie zainicjalizowany, system automatycznie uruchamia jego obsługę.
Dynamiczny interfejs panelu WWW: Dopiero po udanym fizycznym wykryciu urządzenia, w interfejsie serwera WEBService pojawi się dedykowana sekcja konfiguracyjna (skierowana do obsługi danego układu). Jeśli peryferia nie są fizycznie podłączone, opcje te pozostają ukryte, aby zachować przejrzystość i lekkość interfejsu konfiguracyjnego.

Programowanie modułu Główna Oprogramowanie