DecoDXLog: Logging-Programm der Decodium-Familie mit nativer FT2-Unterstützung

DecoDXLog je staničný log od IU8LMC, napísaný v C++20 s rozhraním Qt6/QML. Patrí do rodiny aplikácií Decodium – spolu s dekodérom Decodium a programom DecoRTTY zdieľa rovnaký vizuálny jazyk, rovnaké klávesové skratky a rovnakú filozofiu práce. Databázou je SQLite v režime WAL, čo znamená offline-first prístup bez externého servera: celý log, všetky profily, histórie revízií a stavy QSL žijú v jednom súbore na disku. Program je dostupný pod licenciou GPL-3.0, zdrojové kódy sú verejné na GitHube (github.com/iu8lmc/DecoDXLog). Aktuálna verzia je 0.5.2.

Empfang von QSO aus Decodium, WSJT-X und JTDX

DecoDXLog empfängt protokollierte QSO über UDP auf Port 2237 (Standardwert, konfigurierbar, Multicast optional) von Decodium, WSJT-X, JTDX a kompatibilných programov. Preferovanou správou je LoggedADIF, ktorá prenáša všetky ADIF Felder ohne Verlust; wenn es nicht innerhalb von 1,5 Sekunden ankommt, wechselt das Programm zum Backup-Format QSOLogged. Beide Varianten werden nicht dupliziert – es wird immer ein QSO ins Log geschrieben. Duplikate sind konfigurierbar: das Standardfenster beträgt ±2 Minuten für digitale Modi und ±10 Minuten für manuelle Aufzeichnungen, wobei es für jeden Modus separat eingestellt werden kann.

Der Status des UDP-Clients ist ständig sichtbar – das Programm zeigt, wer verbunden ist, auf welcher Frequenz und in welchem Modus gearbeitet wird und ob TX aktiv ist. Wenn Decodium aufhört, Nachrichten zu senden, warnt DecoDXLog den Operator mit einer Warnmeldung.

FT2 als erstklassiger Modus

FT2 ist im DecoDXLog nativ unterstützter Modus. Im ADIF wird er erfasst als MODE=MFSK, SUBMODE=FT2 und wird im gesamten Interface als Abkürzung FT2 angezeigt – nicht als generisches MFSK. Diese Integration geht tiefer: In der Datenbankschema gibt es ein dediziertes FT2 Award panel, ktorý je vždy viditeľný a sleduje počet DXCC entít a lokátorov potvrdených práve v tomto móde, vrátane stavu potvrdení cez LoTW. Simulátor na testovanie bez rádia (decodxlog_udpsend) sendet standardmäßig QSO im FT2-Modus, was zeigt, wo die Entwicklungsprioritäten des Autors liegen.

Callbook, DXCC a automatické dopĺňanie

Program podporuje dve callbook služby: QRZ.com XML API a HamQTH. Die Anmeldedaten werden im systemweiten Schlüsselbund gespeichert (Windows Credential Manager, macOS Keychain, Secret Service unter Linux) – im Konfigurationsdatei wird ausschließlich der Benutzername gespeichert. Die Ergebnisse der Anfragen werden einen Tag lang im Speicher gehalten, sodass wiederholte QSO mit derselben Station keine Netzwerkkommunikation erfordern.

Pri každom novom QSO callbook doplní iba prázdne polia – meno, QTH, šesťznakový lokátor, adresu, štát, kraj a zóny. Ak primárna callbook služba daný nominatív nepozná alebo neobsahuje polohu stanice, program sa opýta automaticky aj druhej a obe odpovede zlúči. QSO zalogované cez UDP si doplnia tieto údaje bezprostredne po uložení, bez zásahu operátora.

Die Bestimmung der DXCC-Entität erfolgt aus der Datenbank cty.csv von AD1C (country-files.com), die direkt in die ausführbare Datei integriert ist und über die Programmeinstellungen aktualisiert werden kann. Für jedes importierte oder empfangene QSO werden automatisch ergänzt: DXCC-Entität, Land, CQ-Zone, ITU-Zone und Kontinent. Wenn der Operator eine neue DXCC-Entität oder ein neues Band arbeitet, meldet das Programm dies direkt beim Logging mit dem Text NEW DXCC und NEW DXCC ON Band.

Diplome, Statistiken und Karte

DecoDXLog 0.5.2 berechnet die folgenden Diplome direkt aus dem Log:

Für jedes Diplomprogramm wird eine Tabelle mit Band-Slots (● bestätigt, ○ bearbeitet) angezeigt, einschließlich der Gesamtsummen für jedes Band. Eine Liste fehlender Entitäten, Zonen oder Staaten ist mit einem Klick verfügbar. Die Statistiken befinden sich in einem separaten Fenster und umfassen QSOs nach Jahr, Monat, UTC-Stunde, Band, Modus und Kontinent. Eine interessante Funktion ist die Wärmebildkarte Band/Stunde, die visuell zeigt, wann das jeweilige Band geöffnet war – ein nützliches Werkzeug zur Planung des Betriebs. Die Weltkarte enthält Küstenlinien aus der Natural Earth-Datenbank.(öffentliche Domäne, direkt in der ausführbaren Datei), graue Linie basierend auf der aktuellen Position der Sonne, bearbeitete Locator und farblich markierte Spots aus dem Cluster.

Logbook, filtrovanie a správa QSO

Tabuľka logu zobrazuje voliteľné stĺpce vrátane CQ zóny, ITU zóny, IOTA, štátu, kraja a stĺpcov QSL stavu (L Q C E). Každý QSO záznam má históriu revízií: každá úprava vytvára novú revíziu, staré verzie sú dostupné a obnoviteľné. Vymazanie je mäkké – QSO ostáva v histórii a dá sa vrátiť. ADIF import a export sú bezstratové: polia bez priradenia v schéme sa ukladajú do adif_extra a pri exporte vychádzajú identicky. Logbook podporuje filtrovanie podľa pásma, módu, mesiaca, dátumového rozsahu, entity DXCC, stavu QSL, profilu stanice a štítkov; filtre sa dajú ukladať pod menom a opätovne aplikovať. Ručné aj hromadné akcie na vybraných riadkoch zahŕňajú pridanie alebo odobranie štítku a export do ADIF. Klávesnica pokrýva všetky hlavné funkcie: Ctrl+N nové QSO, Ctrl+F hľadanie, Ctrl+I import, Ctrl+E export, Ctrl+K cluster, Ctrl+T aktivácia.

DX Cluster, rotátor a CW keyer

Okno DX Clustra (Ctrl+K) integruje viacero zdrojov naraz: telnetové uzly DX Spider a CC Cluster, Reverse beacon Network pre CW/RTTY aj FT8/FT4, HamAlert (prihlasovacie heslo v systémovom úložisku) a POTA aktivácie. Prihlasovanie prebieha automaticky pod nominatívom profilu vo formáte CALL-2, takže Decodium môže mať vlastnú paralelnú session na tom istom uzle. Každý spot je v reálnom čase porovnaný s logom a označený stavom: NEW DXCC, nové pásmo, nový mód, nový slot, už pracovaný, nepotvrdená entita, alebo používateľ LoTW. Filtre pokrývajú pásmo, mód, stav, kontinent DX stanice aj spottujúcej stanice, zdroj, nominatívy s wildcard, minimálny SNR skimmera a vek spotu; filtre sa dajú ukladať pod menom. Pravidlá upozornení pracujú s hlasovými oznamami cez systémové Stimmen OS (taliančina a angličtina, fonetická abeceda). Dvojité kliknutie na spot priamo nastaví frekvenciu a mód v Decodiu.

Rotátor je integrovaný cez protokol DecoRotor na WebSocket porte 8765 alebo cez štandardný rotctld na porte 4532; program sa nikdy nepripája priamo na sériovú linku. Ovládacia plocha reprodukuje celú stránku „Controllo“ z DecoRotoru vrátane stupnicovej koruny, azimuálnej mapy s kruhovými vzdialenosťami, šiestich priamych pamätí a punta na stupne alebo lokátor. Smer antény je zobrazený aj na mape s clusterovými spotmi.

CW keyer a dekodér sú zabudované priamo v programe. Panel CW obsahuje osem makier na klávesoch F1–F8 (premenné {CALL}, {MYCALL}, {RST}, {NR}, {EXCH}), riadok pre okamžitý vstup textu a dekodér, ktorý číta audio výstup rádia, automaticky vyhľadá nosný tón a priebežne sa prispôsobuje rýchlosti operátora. Komunikácia s rádio prebieha cez Hamlib/rigctld; program vie rigctld aj sám spustiť, ak pozná model rádia a sériový port.

Contest a QSL funkcie

Der Contestmodus wird mit der Tastenkombination Ctrl+T (Aktivierung POTA/SOTA/WWFF/IOTA) oder Ctrl+Shift+T (Contestfenster mit Live-Protokollierung) aktiviert. Das Programm zeigt Duplikate in Echtzeit an, überwacht das QSO-Tempo der letzten 10 Minuten und der letzten Stunde, berechnet QSO/h und zeigt an, wie viele Verbindungen für eine gültige Aktivierung noch fehlen (10 QSO für POTA, 4 für SOTA). Der Export im Cabrillo 3.0-Format enthält einen Header mit Kategorien, Locator, Punktzahl und Soapbox; Frequenzen sind in kHz, Modi gemäß Cabrillo-Konvention (CW/PH/RY/DG/FM). Die Contest-Session überlebt.Programmneustart – wird direkt im Log gespeichert.

QSL odosielanie pokrýva LoTW (Unterschrift ADIF über installiertes TQSL, das Zertifikat bleibt an Ort und Stelle), QRZ Logbook (API kľúč), eQSL (meno a heslo) a Club Log (e-mail, heslo, nominatív, API kľúč). Každý z týchto servisov sa dá nastaviť na automatické odosielanie po každom QSO alebo spúšťať ručne. Stav QSL pre každú službu je uložený v samostatnej tabuľke a zobrazený v logu stĺpcami L (LoTW), Q (QRZ), C (Club Log), E (eQSL). Sťahovanie potvrdení z LoTW prebieha z lotwreport.adi, len nové záznamy od posledného syncu, manuálne alebo automaticky každých 6, 12 alebo 24 hodín. Párovanie QSO s potvrdeniami zodpovedá metodike LoTW: nominatív, pásmo, skupina módov a čas v tolerancii ±30 minút.

DecoDXLog Cloud und Open Source Code

DecoDXLog Cloud ist eine optionale Synchronisierungsschicht zwischen mehreren Computern. Im Gegensatz zu einem klassischen Cloud-Log synchronisiert es nicht nur QSOs, sondern auch profily stanice a všetky nastavenia – tému, jazyk, filtre, konfiguráciu clustra, zoznam zálohovacích adresárov, adresy susedných programov. Druhý počítač po prvej synchronizácii nájde identickú stanicu, nie len jej podobizeň. Prihlásenie prebieha nomináciou a heslom; program ukladá len token v systémovom úložisku kľúčov. Heslá externých služieb (QRZ, LoTW, Club Log, eQSL, HamQTH, HamAlert) sa synchronizujú zašifrované: šifrovanie je AES-256-GCM mit einem über PBKDF2 aus dem Passwort des Cloud-Kontos abgeleiteten Schlüssel; der Server kennt das Passwort nur als Argon2-Hash, der verschlüsselte Block kann ohne dieses Passwort nicht geöffnet werden. Das Programm funktioniert auch vollständig offline – Cloud je voliteľný, nie podmienka.

Der Quellcode ist verfügbar unter github.com/iu8lmc/DecoDXLog unter der Lizenz GPL-3.0. Das Projekt umfasst 22 Gruppen automatisierter Tests für den Programmkern und 73 Testfälle für den Cloud-Service. Die Kompilierung unter Windows erfordert Qt ≥ 6.5 mit den Modulen Quick, QuickControls2, Sql, Network und Test; zur Verwaltung der Abhängigkeiten dient CMake + Ninja in der MSYS2-Umgebung. Die CI-Pipeline auf GitHub erzeugt bei jedem Commit ein Artefakt decodxlog-windows-x64 bereit zur Ausführung ohne Installation.

Der Quellcode, die Dokumentation und Updates sind auf github.com/iu8lmc/DecoDXLog verfügbar. Die Projektseite mit einer Übersicht über die Funktionen ist auf ft2.it/decodxlog/.