Flex-WavelogGate je desktopová aplikácia od Olivera, OM0RX, ktorá číta stav slice rádia FlexRadio cez program xCAT od DL3LSM a udržiava vo 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 nahradila malá podmnožina RigCtlD príkazov, ktorú xCAT 2.0 podporuje. Pôvodná funkcionalita WaveLogGate – párovanie, preposielanie QSO a WebSocket služby – zostáva zachovaná.
V článku sa dočítate
Architektúra a tok dát
Reťazec je lineárny: FlexRadio alebo Maestro, xCAT (režim CAT and RigCtlD), TCP port 4532, Flex-WavelogGate, radio API Wavelogu a nakoniec stránka Hardware Interfaces s formulárom Add QSO. Aplikácia dotazuje aktívny slice každú sekundu. Zmenu frekvencie alebo módu posiela do Wavelogu okamžite, stabilný stav obnovuje periodicky.
Pri polovaní sa používajú len požiadavky f a m. Flex-WavelogGate nikdy nevysiela PTT, neposiela dotazy na split-VFO ani výkon a Rotátor nesmeruje cez xCAT. Žiadosti o QSY z Wavelogu sa vykonávajú setterom F a voliteľne M.
| Stav v xCAT | Mód vo Wavelogu |
|---|---|
| USB, LSB | USB, LSB |
| CW, CWR | CW |
| RTTY, RTTYR | RTTY |
| AM, FM, PKTFM | AM, FM |
| Dátový mód na dial frekvencii FT8/FT4 | FT8 / FT4 |
| Dátový mód inde | podkladové USB alebo LSB |
Posledný riadok je zámerný. CAT nevie spoľahlivo určiť aplikačný protokol, preto FT8 a FT4 aplikácia rozpozná len podľa štandardných dial frekvencií. Iné digitálne programy zapisujú svoj mód vlastnou cestou QSO/ADIF.
Požiadavky a inštalácia
Aplikácia beží na macOS (Apple Silicon aj Intel), Windows (x64, ARM64, 32-bit) a Linuxe. Linux vyžaduje GTK 3 a zodpovedajúci WebKit2GTK – verziu 4.0 pre Ubuntu 22.04 a 4.1 pre Ubuntu 24.04. Z GitHub Releases sa sťahujú obrazy DMG, exe inštalátory a balíky .deb a .rpm; každé vydanie obsahuje súbor SHA256SUMS.txt. README spomína aj upozornenia Gatekeeper na macOS a SmartScreen vo Windows.
Potrebný je xCAT 2.0 (testované na macOS) pre SmartSDR 2.5.1 a novší; xCAT 1.0 je určený pre SmartSDR 2.4.9 a starší. Zdrojový kód sa buduje s Go 1.25+, Wails CLI 2.13.0 a Bun príkazom wails build -clean; testy spustíte cez go test ./… a go vet ./….
Konfigurácia
Nastavenia sú v súbore ~/Library/Application Support/Flex-WavelogGate/config.json. Pri prvom spustení sa skopíruje existujúca konfigurácia WaveLogGate; originál sa nemení. Zachovajú sa URL Wavelogu, API kľúč, ID stanice, názov rádia a ďalšie profily. API kľúče sú v používateľskej konfigurácii, nie v zdrojovom kóde. Premenné prostredia README nedokumentuje.
Predvolený endpoint xCAT je 127.0.0.1:4532. Ide o port RigCtlD, nie o CAT port 5002. Aplikácia ďalej používa tieto porty:
| Port | Protokol | Účel |
|---|---|---|
| 2333 | UDP, vstup | QSO pakety z WSJT-X / Fldigi |
| 54321 | HTTP/HTTPS, vstup | žiadosti o QSY z Wavelogu |
| 54322 | WebSocket | lokálny stav rádia a udalosti Wavelogu |
| 54323 | Secure WebSocket | TLS WebSocket |
Postup nasadenia a použitie v shacku
V xCAT zvoľte pre slice protokol CAT and RigCtlD a overte indikáciu Slice present. V Flex-WavelogGate zadajte URL Wavelogu, API kľúč, stanicu a názov rádia, potom zapnite xCAT Radio Control na 127.0.0.1:4532. Vo Wavelogu nastavte nové rádio ako predvolené v Hardware Interfaces, otvorte Add QSO a počkajte jeden polling interval. Pre WSJT-X nastavte Secondary UDP Server na localhost:2333.
Praktický prínos je v tom, že formulár Add QSO preberá frekvenciu a mód z rádia bez ručného zadávania a z Wavelogu sa dá rádio preladiť. RigCtlD nevystavujte na internet; README odporúča dôveryhodnú LAN alebo súkromnú VPN.
Riešenie problémov a prispievanie
Dokument docs/XCAT_SETUP.md uvádza tieto situácie. Pri „connection refused“ skontrolujte, či xCAT beží, či je zapnutý RigCtlD a či sedí host a port. Pri pripojení bez dát overte Slice present a správnu stanicu. Ak CAT port 5002 funguje inde, ale brána nie, použite RigCtlD port 4532. Ak Wavelog ukazuje staré rádio, nastavte správne ako predvolené. Pri vzdialenom hoste povoľte port vo firewalle a overte, že xCAT počúva na dosiahnuteľnej adrese. Read-only test spojenia: printf ‚f\nm\n‘ | nc 127.0.0.1 4532; správna odpoveď obsahuje frekvenciu v hertzoch a potom mód s passband. Umiestnenie logov dokumentácia neuvádza.
Projekt je pod licenciou GPL-3.0-or-later, pôvodný MIT notice DJ7NT je v súbore NOTICE. Repozitár mal pri kontrole 330 commitov a žiadne hviezdičky či forky. README neobsahuje pravidlá pre prispievanie, takže problémy a návrhy zmien riešte štandardne cez issues a pull requesty na GitHube. Projekt nie je spojený s FlexRadio Systems, Wavelogom ani autorom xCAT.