DecoDXLog: program logujący rodziny Decodium z natywnym wsparciem FT2

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.

Odbiór QSO z Decodium, WSJT-X i JTDX

DecoDXLog odbiera zalogowane QSO przez UDP na porcie 2237 (wartość domyślna, konfigurowalna, multicast opcjonalny) od Decodium, WSJT-X, JTDX a kompatibilných programov. Preferovanou správou je LoggedADIF, ktorá prenáša všetky ADIF pola bez straty; jeśli nie dotrze w ciągu 1,5 sekundy, program przechodzi do zapasowego formatu QSOLogged. Oba warianty nie są duplikowane – do logu zawsze zapisuje się jedno QSO. Duplikaty są konfigurowalne: domyślne okno to ±2 minuty dla trybów cyfrowych i ±10 minut dla ręcznych zapisów, które można ustawić osobno dla każdego trybu.

Stan klienta UDP jest zawsze widoczny – program pokazuje, kto jest podłączony, na jakiej częstotliwości i w jakim trybie pracuje oraz czy TX jest aktywny. Jeśli Decodium przestanie wysyłać wiadomości, DecoDXLog powiadomi operatora komunikatem ostrzegawczym.

FT2 jako tryb pierwszej klasy

FT2 jest natywnie wspieranym trybem w DecoDXLog. W ADIF jest rejestrowany jako TRYB=MFSK, PODTRYB=FT2 a w całym interfejsie wyświetlany jako skrót FT2 – nie jako ogólny MFSK. Ta integracja sięga głębiej: w schemacie bazy danych istnieje dedykowany 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) domyślnie nadaje QSO w trybie FT2, co pokazuje, gdzie są priorytety rozwojowe autora.

Callbook, DXCC a automatické dopĺňanie

Program podporuje dve callbook služby: QRZ.com XML API a HamQTH. Dane logowania są przechowywane w systemowym skarbcu kluczy (Menedżer poświadczeń Windows, Pęk kluczy macOS, Secret Service na Linuksie) – w pliku konfiguracyjnym przechowywana jest wyłącznie nazwa użytkownika. Wyniki zapytań są przechowywane w pamięci przez jeden dzień, więc powtarzające się QSO z tą samą stacją nie wymagają komunikacji sieciowej.

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 i druhej a obe odpovede zlúči. QSO zalogované cez UDP si doplnia tieto údaje bezprostredne po uložení, bez zásahu operátora.

Określenie podmiotu DXCC odbywa się z bazy danych cty.csv od AD1C (country-files.com), która jest bezpośrednio zawarta w pliku wykonywalnym i może być aktualizowana z ustawień programu. Dla każdego importowanego lub odebranego QSO automatycznie uzupełniane są: podmiot DXCC, kraj, strefa CQ, strefa ITU i kontynent. Jeśli operator pracuje z nowym podmiotem DXCC lub nową strefą, program zgłasza to bezpośrednio podczas logowania komunikatem NEW DXCC i NEW DXCC ON pasmo.

Dyplomy, statystyki i mapa

DecoDXLog 0.5.2 oblicza następujące dyplomy bezpośrednio z logu:

For each diploma program, it displays a table of band slots (● confirmed, ○ worked) including total sums for each band. A list of missing entities, zones, or states is available with one click. Statistics are in a separate window and include QSO by year, month, hour UTC, band, mode, and continent. An interesting feature is the band/hour heat map, which visually shows when a given band was open from the operator's own log - a useful tool for planning operations. The world map contains coastlines from the Natural Earth database.(public domain, directly in the executable file), a gray line according to the current position of the Sun, worked locators, and color-coded spots from the 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é i 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 (hasło logowania w systemowym magazynie) oraz aktywacje POTA. Logowanie odbywa się automatycznie pod nominatywnym profilem w formacie 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 i wiek punktu; filtry można zapisywać pod nazwą. Zasady powiadomień działają z komunikatami głosowymi przez systemowe głosy OS (włoski i angielski, alfabet fonetyczny). Podwójne kliknięcie na punkt bezpośrednio ustawia częstotliwość i tryb w Decodiu.

Rotator jest zintegrowany przez protokół DecoRotor na porcie WebSocket 8765 lub przez standardowy rotctld na porcie 4532; program nigdy nie łączy się bezpośrednio z portem szeregowym. Panel sterowania odtwarza całą stronę „Controllo” z DecoRotor, w tym koronę skali, mapę azymutalną z okrągłymi odległościami, sześć pamięci bezpośrednich i punkt na stopnie lub lokalizator. Kierunek anteny jest również wyświetlany na mapie z punktami klastra.

Klucz CW i dekoder są wbudowane bezpośrednio w programie. Panel CW zawiera osiem makr na klawiszach F1–F8 (zmienne {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 może również uruchomić rigctld samodzielnie, jeśli zna model radia i port szeregowy.

Contest a QSL funkcie

Tryb konkursu jest aktywowany skrótem klawiszowym Ctrl+T (aktywacja POTA/SOTA/WWFF/IOTA) lub Ctrl+Shift+T (okno konkursowe z logowaniem strumieniowym). Program wyświetla duplikaty w czasie rzeczywistym, śledzi tempo QSO za ostatnie 10 minut i ostatnią godzinę, oblicza QSO/h i wyświetla, ile połączeń brakuje do ważnej aktywacji (10 QSO dla POTA, 4 dla SOTA). Eksport do formatu Cabrillo 3.0 zawiera nagłówek z kategoriami, lokalizatorem, wynikiem i soapbox; częstotliwości są w kHz, tryby według konwencji Cabrillo (CW/PH/RY/DG/FM). Sesja konkursowa przetrwarestart programu - jest zapisany bezpośrednio w logu.

QSL odosielanie pokrýva LoTW (signature ADIF via installed TQSL, certificate remains in place), 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 i otwarty kod źródłowy

DecoDXLog Cloud is an optional synchronization layer between multiple computers. Unlike a classic cloud log, it synchronizes not only QSO but also 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 with a key derived via PBKDF2 from the Cloud account password; the server knows the password only as an Argon2 hash, the encrypted block itself cannot be opened without this password. The program also works completely offline – Cloud je voliteľný, nie podmienka.

Source code is available at github.com/iu8lmc/DecoDXLog under GPL-3.0 license. The project includes 22 groups of automated tests for the core program and 73 test cases for the cloud service. Compilation on Windows requires Qt ≥ 6.5 with modules Quick, QuickControls2, Sql, Network, and Test; CMake + Ninja in the MSYS2 environment is used for dependency management. The CI pipeline on GitHub produces an artifact on each commit decodxlog-windows-x64 ready to run without installation.

Source code, documentation, and updates are available at github.com/iu8lmc/DecoDXLog. The project page with an overview of features is at ft2.it/decodxlog/.