Flex-WavelogGate je desktopová aplikace od Olivera, OM0RX, která čte stav slice rádia FlexRadio přes program xCAT od DL3LSM a udržuje v 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 příkazů RigCtlD, kterou xCAT 2.0 podporuje. Původní funkcionalita WaveLogGate – párování, přeposílání QSO a WebSocket služby – zostáva zachovaná.
V článku se dočtete
Architektura a tok dat
Řetězec je lineární: FlexRadio nebo Maestro, xCAT (režim CAT a RigCtlD), TCP port 4532, Flex-WavelogGate, radio API Wavelogu a nakonec stránka Hardware Interfaces s formulářem Přidat QSO. Aplikace dotazuje aktivní slice každou sekundu. Změnu frekvence nebo módu posílá do Wavelogu okamžitě, stabilní stav obnovuje periodicky.
Při lovu se používají jen požadavky f a m. Flex-WavelogGate nikdy nevysílá PTT, neposílá dotazy na split-VFO ani výkon a rotátor nesměřuje přes xCAT. Žádosti o QSY z Wavelogu se provádějí setterem F a volitelně M.
| Stav v xCAT | Mód ve Wavelogu |
|---|---|
| USB, LSB | USB, LSB |
| CW, CWR | CW |
| RTTY, RTTYR | RTTY |
| AM, FM, PKTFM | AM, FM |
| Datový mód na dial frekvenci FT8/FT4 | FT8 / FT4 |
| Datový mód jinde | podkladové USB nebo LSB |
Poslední řádek je záměrný. CAT nedokáže spolehlivě určit aplikační protokol, proto FT8 a FT4 aplikace rozpozná jen podle standardních dial frekvencí. Jiný digitální programy zapisují svůj mód vlastním způsobem QSO/ADIF.
Požadavky a instalace
Aplikace běží na macOS (Apple Silicon i Intel), Windows (x64, ARM64, 32-bit) a Linuxu. Linux vyžaduje GTK 3 a odpovídající WebKit2GTK – verzi 4.0 pro Ubuntu 22.04 a 4.1 pro Ubuntu 24.04. Z GitHub Releases se stahují obrazy DMG, exe instalátory a balíčky .deb a .rpm; každé vydání obsahuje soubor SHA256SUMS.txt. README zmiňuje také upozornění Gatekeeper na macOS a SmartScreen ve Windows.
Potrebný je xCAT 2.0 (testováno na macOS) pro SmartSDR 2.5.1 a novější; xCAT 1.0 je určen pro SmartSDR 2.4.9 a starší. Zdrojový kód se buduje s Go 1.25+, Wails CLI 2.13.0 a příkazem Bun wails build -clean; testy spustíte přes go test ./… a go vet ./…
Konfigurace
Nastavení jsou v souboru ~/Library/Application Support/Flex-WavelogGate/config.json. Při prvním spuštění se zkopíruje existující konfigurace WaveLogGate; originál se nemění. Zachovávají se URL Wavelogu, API klíč, ID stanice, název rádia a další profily. API klíče jsou v uživatelské konfiguraci, ne ve zdrojovém kódu. Proměnné prostředí README nedokumentuje.
Výchozí endpoint xCAT je 127.0.0.1:4532. Jde o port RigCtlD, nikoli o CAT port 5002. Aplikace dále používá tyto porty:
| Port | Protokol | Účel |
|---|---|---|
| 2333 | UDP, vstup | QSO pakety z WSJT-X / Fldigi |
| 54321 | HTTP/HTTPS, vstup | žádosti o QSY z Wavelogu |
| 54322 | WebSocket | lokální stav rádia a události Wavelogu |
| 54323 | Bezpečný WebSocket | TLS WebSocket |
Postup nasazení a použití v shacku
V xCAT zvolte pro slice protokol CAT a RigCtlD a ověřte indikaci Slice present. V Flex-WavelogGate zadejte URL Wavelogu, API klíč, stanici a název rádia, poté zapněte xCAT Radio Control na 127.0.0.1:4532. Ve Wavelogu nastavte nové rádio jako výchozí v Hardware Interfaces, otevřete Add QSO a počkejte jeden polling interval. Pro WSJT-X nastavte Secondary UDP Server na localhost:2333.
Praktický přínos je v tom, že formulář Add QSO přebírá frekvenci a mód z rádia bez ručního zadávání a z Wavelogu se dá rádio přeladit. RigCtlD nevystavujte na internet; README doporučuje důvěryhodnou LAN nebo soukromou VPN.
Řešení problémů a přispívání
Dokument docs/XCAT_SETUP.md uvádí tyto situace. Při „connection refused“ zkontrolujte, zda xCAT běží, zda je zapnutý RigCtlD a zda sedí host a port. Při připojení bez dat ověřte Slice present a správnou stanici. Pokud CAT port 5002 funguje jinde, ale brána ne, použijte RigCtlD port 4532. Pokud Wavelog ukazuje staré rádio, nastavte správně jako výchozí. Při vzdáleném hostu povolte port ve firewallu a ověřte, že xCAT naslouchá na dostupné adrese. Test spojení pouze pro čtení: printf ‚f\nm\n‘ | nc 127.0.0.1 4532; správná odpověď obsahuje frekvenci vherzích a poté mód s passband. Umístění logů dokumentace neuvádí.
Projekt je pod licencí GPL-3.0-or-later, původní MIT oznámení DJ7NT je v souboru NOTICE. Repozitář měl při kontrole 330 commitů a žádné hvězdičky ani forky. README neobsahuje pravidla pro přispívání, takže problémy a návrhy změn řešte standardně přes issues a pull requesty na GitHub. Projekt není spojen s FlexRadio Systems, Wavelogem ani autorem xCAT.