Flex-WavelogGate jest aplikacją desktopową od Olivera, OM0RX, która odczytuje stan slice radia FlexRadio przez program xCAT od DL3LSM i utrzymuje w Wavelogu aktuálnu frekvenciu a mód. Vychádza z projektu WaveLogGate vo verzii 2.1.1 (autor Jörg Dorgeist, DJ7NT). Všeobecného Hamlib klienta zastąpiła mała podzbiór komend RigCtlD, którą wspiera xCAT 2.0. Oryginalna funkcjonalność WaveLogGate – parowanie, przesyłanie QSO a WebSocket služby – zostáva zachovaná.
W artykule przeczytasz
Architektura i przepływ danych
Łańcuch jest liniowy: FlexRadio lub Maestro, xCAT (tryb CAT i RigCtlD), port TCP 4532, Flex-WavelogGate, radio API Wavelogu i w końcu strona Interfejsy sprzętowe z formularzem Dodaj QSO. Aplikacja pyta aktywny slice co sekundę. Zmiana częstotliwości lub trybu jest natychmiast wysyłana do Wavelogu, stabilny stan jest okresowo odtwarzany.
Podczas polowania używane są tylko żądania f i m. Flex-WavelogGate nigdy nie wysyła PTT, nie wysyła zapytań na split-VFO ani mocy, a rotator nie kieruje przez xCAT. Żądania QSY z Wavelogu są realizowane przez ustawienie F i opcjonalnie M.
| Stan w xCAT | Tryb w Wavelogu |
|---|---|
| USB, LSB | USB, LSB |
| CW, CWR | CW |
| RTTY, RTTYR | RTTY |
| AM, FM, PKTFM | AM, FM |
| Tryb danych na częstotliwości FT8/FT4 | FT8 / FT4 |
| Tryb danych gdzie indziej | podstawowe USB lub LSB |
Ostatnia linia jest zamierzona. CAT nie potrafi niezawodnie określić protokołu aplikacji, dlatego aplikacja FT8 i FT4 rozpoznaje tylko na podstawie standardowych częstotliwości. Inne programy cyfrowe zapisują swój tryb w swoim własnym formacie QSO/ADIF.
Wymagania i instalacja
Aplikacja działa na macOS (Apple Silicon i Intel), Windows (x64, ARM64, 32-bit) oraz Linuxie. Linux wymaga GTK 3 oraz odpowiedniego WebKit2GTK – wersji 4.0 dla Ubuntu 22.04 i 4.1 dla Ubuntu 24.04. Obrazy DMG, instalatory exe oraz pakiety .deb i .rpm pobierane są z GitHub Releases; każda wersja zawiera plik SHA256SUMS.txt. README wspomina również o ostrzeżeniach Gatekeeper na macOS oraz SmartScreen w Windows.
Potrebný je xCAT 2.0 (testowane na macOS) dla SmartSDR 2.5.1 i nowszy; xCAT 1.0 jest przeznaczony dla SmartSDR 2.4.9 i starszych. Kod źródłowy buduje się przy użyciu Go 1.25+, Wails CLI 2.13.0 oraz polecenia Bun wails build -clean; testy uruchomisz za pomocą go test ./… i go vet ./….
Konfiguracja
Ustawienia znajdują się w pliku ~/Library/Application Support/Flex-WavelogGate/config.json. Przy pierwszym uruchomieniu skopiowana zostanie istniejąca konfiguracja WaveLogGate; oryginał nie zostanie zmieniony. Zachowane zostaną adresy URL Wavelogu, klucz API, ID stacji, nazwa radia oraz inne profile. Klucze API znajdują się w konfiguracji użytkownika, a nie w kodzie źródłowym. Zmienne środowiskowe nie są dokumentowane w README.
Domyślny punkt końcowy xCAT to 127.0.0.1:4532. Jest to port RigCtlD, a nie port CAT 5002. Aplikacja używa również tych portów:
| Port | Protokół | Cel |
|---|---|---|
| 2333 | UDP, wejście | Pakiety QSO z WSJT-X / Fldigi |
| 54321 | HTTP/HTTPS, wejście | żądania QSY z Wavelogu |
| 54322 | WebSocket | lokalny stan radia i wydarzenia Wavelogu |
| 54323 | Bezpieczny WebSocket | TLS WebSocket |
Procedura wdrożenia i użycia w shacku
W xCAT wybierz dla slice protokół CAT i RigCtlD oraz sprawdź, czy Slice jest obecny. W Flex-WavelogGate wprowadź URL Wavelogu, klucz API, stację i nazwę radia, a następnie włącz xCAT Radio Control na 127.0.0.1:4532. W Wavelogu ustaw nowe radio jako domyślne w Hardware Interfaces, otwórz Add QSO i poczekaj na jeden interwał pollingowy. Dla WSJT-X ustaw Secondary UDP Server na localhost:2333.
Praktycznym zyskiem jest to, że formularz Add QSO przejmuje częstotliwość i tryb z radia bez ręcznego wprowadzania, a z Wavelogu można przełączyć radio. Nie wystawiaj RigCtlD na internet; README zaleca zaufaną LAN lub prywatne VPN.
Rozwiązywanie problemów i wkład
Dokument docs/XCAT_SETUP.md przedstawia te sytuacje. W przypadku „connection refused” sprawdź, czy xCAT działa, czy RigCtlD jest włączony i czy host i port są poprawne. Przy połączeniu bez danych sprawdź, czy Slice jest obecny i czy stacja jest poprawna. Jeśli port CAT 5002 działa gdzie indziej, ale brama nie, użyj portu RigCtlD 4532. Jeśli Wavelog pokazuje stare radio, ustaw je poprawnie jako domyślne. Przy zdalnym hoście zezwól na port w zaporze i sprawdź, czy xCAT nasłuchuje na dostępny adres. Test połączenia tylko do odczytu: printf ‚f\nm\n‘ | nc 127.0.0.1 4532; poprawna odpowiedź zawiera częstotliwość whercach i następnie tryb z passband. Lokalizacja logów nie jest podana.
Projekt jest objęty licencją GPL-3.0-or-later, oryginalne ogłoszenie MIT DJ7NT znajduje się w pliku NOTICE. Repozytorium miało podczas kontroli 330 commitów i żadnych gwiazdek ani forków. README nie zawiera zasad dotyczących wkładu, więc problemy i propozycje zmian zgłaszaj standardowo przez issues i pull requesty na GitHub. Projekt nie jest powiązany z FlexRadio Systems, Wavelog ani autorem xCAT.