DecoDXLog: logovací program rodiny Decodium s nativní podporou 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.

Příjem QSO z Decodium, WSJT-X a JTDX

DecoDXLog přijímá zalogované QSO přes UDP na portu 2237 (výchozí hodnota, konfigurovatelná, multicast volitelný) od Decodium, WSJT-X, JTDX a kompatibilných programov. Preferovanou správou je LoggedADIF, ktorá prenáša všetky ADIF pole bez ztráty; pokud nedorazí do 1,5 sekundy, program přejde na záložní formát QSOLogged. Obě varianty se neduplikují – do logu se zapíše vždy jedno QSO. Duplicitní záznamy jsou konfigurovatelné: výchozí okno je ±2 minuty pro digitální módy a ±10 minut pro ruční záznamy, přičemž se dá nastavit zvlášť pro každý mód.

Stav UDP klienta je neustále viditelný – program zobrazuje, kdo je připojený, na jaké frekvenci a v jakém módu pracuje a zda je TX aktivní. Pokud Decodium přestane posílat zprávy, DecoDXLog upozorní operátora varovným hlášením.

FT2 jako mód první třídy

FT2 je v DecoDXLog nativně podporovaný mód. V ADIF se eviduje jako MODE=MFSK, SUBMODE=FT2 a v celém rozhraní se zobrazuje zkratkou FT2 – ne jako generický MFSK. Tato integrace sahá hlouběji: v schématu databáze existuje dedikovaný 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) výchozí hodnotou je vysílání QSO v módu FT2, což ukazuje, kde jsou vývojářské priority autora.

Callbook, DXCC a automatické dopĺňanie

Program podporuje dve callbook služby: QRZ.com XML API a HamQTH. Přihlašovací údaje jsou uloženy v systémovém úložišti klíčů (Windows Credential Manager, macOS Keychain, Secret Service na Linuxu) – v konfiguračním souboru se ukládá výlučně jméno uživatele. Výsledky dotazů se uchovávají v paměti jeden den, takže opakované QSO se stejnou stanicí nevyžadují síťovou komunikaci.

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.

Určování DXCC entity probíhá z databáze cty.csv od AD1C (country-files.com), která je přímo zahrnuta ve spustitelném souboru a dá se aktualizovat z nastavení programu. Na každé importované nebo přijaté QSO se automaticky doplní: entita DXCC, země, CQ zóna, ITU zóna a kontinent. Pokud operátor pracuje novou DXCC entitu nebo nové pásmo, program to hlásí přímo při logování textem NEW DXCC a NEW DXCC ON pásmo.

Diplomy, statistiky a mapa

DecoDXLog 0.5.2 vypočítává následující diplomy přímo z logu:

Pro každý diplomový program zobrazuje tabulku pásmových slotů (● potvrzené, ○ pracované) včetně celkových součtů za každé pásmo. Seznam chybějících entit, zón nebo států je k dispozici na jedno kliknutí. Statistika je v samostatném okně a zahrnuje QSO podle roku, měsíce, hodiny UTC, pásma, módu a kontinentu. Zajímavou funkcí je mapa tepla pásmo/hodina, která z vlastního logu operátora vizuálně ukazuje, kdy bylo dané pásmo otevřeno – užitečný nástroj při plánování provozu. Světová mapa obsahuje pobřežní linie z databáze Natural Earth.(veřejná doména, přímo v spustitelném souboru), šedou linii podle aktuální polohy Slunce, pracované lokátory a barevně odlišené spoty z clusteru.

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é hlasy 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

Soutěžní režim se aktivuje klávesovou zkratkou Ctrl+T (aktivace POTA/SOTA/WWFF/IOTA) nebo Ctrl+Shift+T (soutěžní okno s průběžným logováním). Program zobrazuje duplicity v reálném čase, sleduje tempo QSO za posledních 10 minut i za poslední hodinu, počítá QSO/h a zobrazuje, kolik spojení ještě chybí na platnou aktivaci (10 QSO pro POTA, 4 pro SOTA). Export do formátu Cabrillo 3.0 obsahuje hlavičku s kategoriemi, lokátorem, skóre a soapbox; frekvence jsou v kHz, módy podle Cabrillo konvence (CW/PH/RY/DG/FM). Soutěžní session přežije.restart programu – je uložen přímo v logu.

QSL odosielanie pokrýva LoTW (podpis ADIF přes nainstalovaný TQSL, certifikát zůstává na místě), 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 a otevřený zdrojový kód

DecoDXLog Cloud je volitelná synchronizační vrstva mezi několika počítači. Na rozdíl od klasického cloud logu synchronizuje nejen QSO, ale i 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 s klíčem odvozeným přes PBKDF2 z hesla Cloud účtu; server zná heslo jen jako otisk Argon2, samotný zašifrovaný blok bez tohoto hesla nelze otevřít. Program funguje i úplně offline – Cloud je voliteľný, nie podmienka.

Zdrojový kód je dostupný na adrese github.com/iu8lmc/DecoDXLog pod licencí GPL-3.0. Projekt zahrnuje 22 skupin automatizovaných testů pro jádro programu a 73 testovacích případů pro cloudovou službu. Kompilace na Windows vyžaduje Qt ≥ 6.5 s moduly Quick, QuickControls2, Sql, Network a Test; pro správu závislostí slouží CMake + Ninja v prostředí MSYS2. CI pipeline na GitHubu produkuje při každém commitu artefakt decodxlog-windows-x64 připravený k spuštění bez instalace.

Zdrojový kód, dokumentace a aktualizace jsou dostupné na github.com/iu8lmc/DecoDXLog. Stránka projektu s přehledem funkcí je na ft2.it/decodxlog/.