Flex-WavelogGate ist eine Desktop-Anwendung von Oliver, OM0RX, die den Status des FlexRadio-Slice über das Programm liest xCAT von DL3LSM und hält in Wavelog 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 wurde durch eine kleine Teilmenge von RigCtlD-Befehlen ersetzt, die xCAT 2.0 unterstützt. Die ursprüngliche Funktionalität von WaveLogGate – Pairing, Weiterleitung QSO a WebSocket služby – zostáva zachovaná.
In diesem Artikel erfahren Sie
Architektur und Datenfluss
Die Kette ist linear: FlexRadio oder Maestro, xCAT (CAT- und RigCtlD-Modus), TCP-Port 4532, Flex-WavelogGate, Radio-API von Wavelog und schließlich die Seite Hardware-Schnittstellen mit dem Formular QSO hinzufügen. Die Anwendung fragt jede Sekunde den aktiven Slice ab. Änderungen der Frequenz oder des Modus werden sofort an Wavelog gesendet, der stabile Zustand wird regelmäßig aktualisiert.
Beim Jagen werden nur die Anforderungen f und m verwendet. Flex-WavelogGate sendet niemals PTT, sendet keine Anfragen an Split-VFO oder Leistung und der Rotator wird nicht über xCAT gesteuert. QSY-Anfragen von Wavelog werden mit dem Setter F und optional M durchgeführt.
| Status in xCAT | Modus in Wavelog |
|---|---|
| USB, LSB | USB, LSB |
| CW, CWR | CW |
| RTTY, RTTYR | RTTY |
| AM, FM, PKTFM | AM, FM |
| Datenmodus auf der Anruffrequenz FT8/FT4 | FT8 / FT4 |
| Datenmodus woanders | unterliegendes USB oder LSB |
Die letzte Zeile ist absichtlich. CAT kann das Anwendungsprotokoll nicht zuverlässig bestimmen, daher erkennt die FT8- und FT4-Anwendung nur anhand der Standard-Anruffrequenzen. Andere digitale Programme zeichnen ihren Modus auf eigene Weise QSO/ADIF auf.
Anforderungen und Installation
Die Anwendung läuft auf macOS (Apple Silicon und Intel), Windows (x64, ARM64, 32-Bit) und Linux. Linux benötigt GTK 3 und die entsprechende WebKit2GTK-Version – 4.0 für Ubuntu 22.04 und 4.1 für Ubuntu 24.04. DMG-Images, exe-Installationsprogramme und .deb- und .rpm-Pakete werden von den GitHub-Releases heruntergeladen; jede Version enthält eine Datei SHA256SUMS.txt. Die README erwähnt auch die Gatekeeper-Warnungen auf macOS und SmartScreen unter Windows.
Potrebný je xCAT 2.0 (getestet auf macOS) für SmartSDR 2.5.1 und neuer; xCAT 1.0 ist für SmartSDR 2.4.9 und älter vorgesehen. Der Quellcode wird mit Go 1.25+, Wails CLI 2.13.0 und dem Bun-Befehl wails build -clean erstellt; Tests können mit go test ./… und go vet ./… ausgeführt werden.
Konfiguration
Die Einstellungen befinden sich in der Datei ~/Library/Application Support/Flex-WavelogGate/config.json. Bei der ersten Ausführung wird die vorhandene WaveLogGate-Konfiguration kopiert; das Original bleibt unverändert. Die URLs von Wavelog, der API-Schlüssel, die Stations-ID, der Name des Radios und weitere Profile werden beibehalten. API-Schlüssel befinden sich in der Benutzerkonfiguration, nicht im Quellcode. Die Umgebungsvariablen werden in der README nicht dokumentiert.
Der Standard-Endpunkt xCAT ist 127.0.0.1:4532. Dies ist der Port RigCtlD, nicht der CAT-Port 5002. Die Anwendung verwendet außerdem diese Ports:
| Port | Protokoll | Zweck |
|---|---|---|
| 2333 | UDP, Eingang | QSO-Pakete von WSJT-X / Fldigi |
| 54321 | HTTP/HTTPS, Eingang | QSY-Anfragen von Wavelog |
| 54322 | WebSocket | lokaler Radiozustand und Wavelog-Ereignisse |
| 54323 | Sicherer WebSocket | TLS WebSocket |
Bereitstellung und Verwendung im Shack
Wählen Sie im xCAT für den Slice das Protokoll CAT und RigCtlD und überprüfen Sie die Anzeige Slice present. Geben Sie in Flex-WavelogGate die URL des Wavelogs, den API-Schlüssel, die Station und den Namen des Radios ein, und aktivieren Sie dann die xCAT Radio Control unter 127.0.0.1:4532. Stellen Sie im Wavelog das neue Radio als Standard in den Hardware-Schnittstellen ein, öffnen Sie Add QSO und warten Sie auf ein Polling-Intervall. Für WSJT-X stellen Sie den sekundären UDP-Server auf localhost:2333 ein.
Der praktische Vorteil besteht darin, dass das Formular Add QSO die Frequenz und den Modus automatisch vom Radio übernimmt, ohne dass eine manuelle Eingabe erforderlich ist, und dass das Radio über Wavelog umgestimmt werden kann. Stellen Sie RigCtlD nicht ins Internet; die README empfiehlt ein vertrauenswürdiges LAN oder ein privates VPN.
Fehlerbehebung und Mitwirkung
Dokument docs/XCAT_SETUP.md beschreibt diese Situationen. Bei „connection refused“ überprüfen Sie, ob xCAT läuft, ob RigCtlD aktiviert ist und ob Host und Port korrekt sind. Bei einer Verbindung ohne Daten überprüfen Sie, ob Slice vorhanden ist und ob die richtige Station eingestellt ist. Wenn der CAT-Port 5002 woanders funktioniert, aber das Gateway nicht, verwenden Sie den RigCtlD-Port 4532. Wenn Wavelog ein altes Radio anzeigt, stellen Sie es korrekt als Standard ein. Bei einem Remote-Host aktivieren Sie den Port in der Firewall und überprüfen Sie, ob xCAT an der erreichbaren Adresse lauscht. Read-only Verbindungstest: printf ‚f\nm\n‘ | nc 127.0.0.1 4532; die richtige Antwort enthält die Frequenz inHertz und dann den Modus mit Passband. Die Dokumentation gibt keinen Standort für die Protokolle an.
Das Projekt steht unter der GPL-3.0-or-later Lizenz, die ursprüngliche MIT-Benachrichtigung DJ7NT befindet sich in der Datei NOTICE. Das Repository hatte bei der Überprüfung 330 Commits und keine Sterne oder Forks. Die README enthält keine Regeln für Beiträge, daher sollten Probleme und Änderungsvorschläge standardmäßig über Issues und Pull Requests behandelt werden. GitHub. Das Projekt steht in keiner Verbindung zu FlexRadio Systems, Wavelog oder dem Autor von xCAT.