Rádioamatérsky svet sa neustále vyvíja a s ním aj nástroje, ktoré operátori používajú na evidenciu svojich spojení. Medzi najpopulárnejšie open-source logovacie programy pre operačný systém Linux patrí nepochybne CQRLOG.
Jeho autor, Petr OK2CQR, nedávno zverejnil správu, ktorá poteší najmä priaznivcov vysielania z terénu a používateľov moderných mobilných zariadení – projekt CQRLOG for web. Ide o webové rozhranie pre denník, ktoré prináša mobilitu bez nutnosti zložitej migrácie dát alebo zmeny filozofie ovládania, na ktorú sú používatelia CQRLOGu zvyknutí.
V článku sa dočítate
Filozofia projektu CQRLOG for web a motivácia k vzniku
Hlavnou myšlienkou CQRLOG for web je poskytnúť operátorom pohodlné a rýchle rozhranie v prehliadači, ktoré sa priamo pripája k ich existujúcej databáze CQRLOGu na desktope. Petr OK2CQR postavil tento projekt primárne pre potreby prenosnej prevádzky. Operátori, ktorí sa venujú aktivitám ako WWFF, GMA alebo SOTA, často riešia dilemu, aké zariadenie použiť na zápis spojení priamo v teréne. Klasický notebook môže byť v poľných podmienkach nepraktický kvôli váhe, výdrži batérie alebo čitateľnosti displeja na slnku. Tablety a smartfóny sú v tomto smere ideálne, no doteraz chýbalo riešenie, ktoré by bolo plne integrované s hlavným domácim logom bez nutnosti následného exportu a importu ADIF súborov.
Autor pri vývoji vychádzal z vlastnej skúsenosti. Predstavou bola jednoduchá zostava pozostávajúca z batohu, transceivra Elecraft KX2, batérie, telegrafného kľúča a antény typu EndFed. V takejto konfigurácii je tablet najlepším spoločníkom pre logovanie. Hoci sa prvý koncept webového rozhrania objavil už pred niekoľkými rokmi, vtedajšia verzia trpela viacerými chybami a nebola pripravená na širšie nasadenie. Súčasná verzia je kompletným prepísaním celého kódu od základov a predstavuje stabilné riešenie, ktoré autor s dôverou sprístupňuje komunite.
Architektúra a prepojenie s desktopovou verziou
Je dôležité zdôrazniť, že CQRLOG for web nie je samostatný, izolovaný logovací program. Je navrhnutý ako sprievodné rozhranie pre operátorov, ktorí už aktívne využívajú desktopovú verziu CQRLOGu. Systém pracuje priamo s databázou MariaDB, ktorú používa desktopová aplikácia. To znamená, že všetky spojenia zapísané cez tablet v teréne sa okamžite a bez ďalších krokov nachádzajú v hlavnej databáze.
Hoci webové rozhranie ponúka plnohodnotné možnosti zápisu a editácie spojení, niektoré pokročilé funkcie zostávajú výsadou desktopovej aplikácie. Ide najmä o nahrávanie dát na služby ako LoTW alebo eQSL, hromadnú editáciu záznamov a generovanie podrobných štatistík. CQRLOG for web sa sústredí na to, čo je v teréne najdôležitejšie: rýchly a presný zápis QSO.
Používateľské rozhranie a ergonómia logovania
Pri návrhu rozhrania sa kládol veľký dôraz na to, aby sa používatelia cítili ako doma. Rozloženie polí v hlavnom formulári kopíruje logiku desktopovej verzie. Operátor má k dispozícii polia pre volaciu značku, frekvenciu, pásmo, mód, reporty RST, meno, QTH, lokátor, výkon, dátum a čas, poznámky, stav QSL, IOTA, WAZ, ITU, štát, okres a informácie o diplomoch.
Ergonómia ovládania je optimalizovaná pre rádioamatérsku prácu. Podporovaná je navigácia pomocou šípok na klávesnici, čo urýchľuje pohyb medzi vstupnými poliami. Automatická kapitalizácia mena a QTH šetrí čas a zabezpečuje vizuálnu konzistenciu logu. Zaujímavou funkciou je správanie medzerníka, ktorý umožňuje rýchly skok z poľa volacej značky priamo na pole reportu RST. Pre rýchle vymazanie formulára pri neúspešnom spojení slúži dvojité stlačenie klávesy Escape.
Systém obsahuje automatické hodiny v reálnom čase, ktoré sa aktualizujú každú sekundu a zaznamenávajú čas začiatku aj konca spojenia. Pre situácie, kedy je potrebné do logu zapísať staršie spojenia, je k dispozícii offline režim, ktorý umožňuje manuálne zadávanie dátumu a času. Vývojár myslel aj na predvolené hodnoty reportov, ktoré sa dynamicky menia podľa zvoleného módu, napríklad 599 pre telegrafiu a 59 pre SSB alebo digitálne módy.
Inteligentné funkcie a vyhľadávanie dát
CQRLOG for web nie je len prázdny formulár. Je napojený na externé zdroje dát, ktoré operátorovi uľahčujú prácu. Pri zadávaní volacej značky prebieha v reálnom čase vyhľadávanie údajov o DXCC prostredníctvom HamQTH. Systém okamžite zobrazí krajinu, kontinent a zóny WAZ a ITU.
Ak sa v databáze už nachádzajú predchádzajúce spojenia s danou značkou, rozhranie automaticky predvyplní polia ako meno, QTH, lokátor, štát alebo okres. Táto funkcia je neoceniteľná pri contestoch alebo pri pravidelných spojeniach s tými istými operátormi. Pod hlavným formulárom sa tiež zobrazuje tabuľka histórie predchádzajúcich spojení s aktuálne volanou stanicou.
Pre členov rôznych rádioamatérskych klubov je k dispozícii zobrazenie klubovej príslušnosti. Systém dokáže zobraziť až päť rôznych klubových označení, pričom konfiguráciu preberá priamo z nastavení desktopovej verzie CQRLOGu. Súčasťou rozhrania je aj zoznam spojení s možnosťou stránkovania a editácie. Ak sa v editačnom móde zmení volacia značka, systém opätovne vykoná vyhľadávanie DXCC údajov, aby zabezpečil integritu dát.
Integrácia s DX Clusterom a solárne údaje
Efektívna rádioamatérska prevádzka sa nezaobíde bez informácií o aktuálnom dianí na pásmach. Webové rozhranie obsahuje integrovaný DX Cluster, ktorý čerpá dáta zo servera HamQTH. Zoznam spotov sa automaticky obnovuje každých dvadsať sekúnd, takže operátor má neustály prehľad o tom, kde sa objavila zaujímavá stanica.
Okrem samotných spotov sú v rozhraní integrované aj aktuálne solárne dáta. Zobrazujú sa indexy A a K, SFI (Solar Flux Index), SSN (Sunspot Number) a informácia o stave geomagnetického poľa. Tieto údaje sú kľúčové pre odhad podmienok šírenia rádiových vĺn na krátkych vlnách a pomáhajú operátorovi v rozhodovaní, na ktoré pásmo sa v danom momente sústrediť.
Prepojenie s rádiostanicou cez Pico radio gateway
Jednou z najzaujímavejších technologických vlastností projektu je možnosť synchronizácie s rádiostanicou. Webové rozhranie dokáže v reálnom čase čítať frekvenciu a mód z transceivrov Elecraft KX2 a KX3. Táto funkcionalita je realizovaná prostredníctvom ďalšieho autorovho projektu Pico radio gateway.
Hardvérové prepojenie transceivra s tabletom alebo počítačom, kde beží prehliadač, umožňuje automatické prepínanie pásma a módu v denníku podľa toho, ako operátor ladí rádio. Výstupný formát brány je úmyselne jednoduchý, čo otvára dvere komunite pre vývoj vlastných rozhraní pre rádiá, ktoré zatiaľ nie sú priamo podporované. V rozhraní denníka sa nachádza indikátor online alebo offline stavu spojenia s rádiom a používateľ si môže nakonfigurovať interval dopytovania frekvencie.
Dizajn a technické spracovanie
Z hľadiska dizajnu je CQRLOG for web modernou aplikáciou s responzívnym vzhľadom. Referenčným zariadením pre optimalizáciu bol iPad Mini v režime na výšku, čo je ideálna veľkosť pre operácie v teréne. Aplikácia však funguje korektne na širokej škále zariadení od desktopov až po mobilné telefóny. Používatelia majú možnosť prepínať medzi tmavým a svetlým režimom, pričom systém podporuje aj automatickú detekciu podľa nastavení operačného systému.
Zaujímavou funkciou pre českých a slovenských používateľov je transliterácia klávesnice. Ak operátor omylom píše slovenské alebo české znaky s diakritikou v hornom číselnom rade, systém ich automaticky konvertuje na číslice. Aplikácia si tiež pamätá posledné použité pásmo, mód, frekvenciu a výkon naprieč jednotlivými reláciami, čo urýchľuje opätovné spustenie práce.
Z technického hľadiska je backend postavený na frameworku PHP/Symfony, zatiaľ čo frontend využíva knižnicu React. Komunikácia prebieha cez REST API. Celá aplikácia je distribuovaná ako jeden Docker kontajner, čo výrazne zjednodušuje proces inštalácie a nasadenia v produkčnom prostredí.
Inštalácia a konfigurácia systému
Nasadenie CQRLOG for web vyžaduje základné znalosti práce s terminálom a nástrojom Docker. Základným predpokladom je funkčná MariaDB databáza s existujúcou schémou CQRLOGu. Inštalačný proces začína naklonovaním repozitára z GitHubu. Následne je potrebné vytvoriť konfiguračný súbor z priloženého príkladu a vyplniť v ňom dôležité údaje, ako sú prístupové údaje k databáze, URL adresa aplikácie a prihlasovacie údaje pre webové rozhranie.
Samotné spustenie aplikácie sa vykonáva pomocou príkazu make prod. Ak systém beží za reverzným proxy serverom, ako je napríklad Apache alebo Nginx, je možné aplikáciu publikovať pod vlastným doménovým menom. Podrobné inštrukcie vrátane riešenia potenciálnych problémov sú dostupné v súbore README.md v oficiálnom repozitári projektu.
Záverečné zhodnotenie a dostupnosť kódu
Petr OK2CQR vytvoril nástroj, ktorý vypĺňa medzeru v CQRLOGu. Hoci bol projekt vyvíjaný primárne pre osobnú potrebu autora, jeho kvalita a miera integrácie z neho robia atraktívnu voľbu pre širokú komunitu používateľov Linuxu a open-source softvéru. CQRLOG for web prináša slobodu pohybu bez straty kontroly nad dátami.
Zdrojové kódy pre webové rozhranie aj pre Pico radio gateway sú voľne dostupné na platforme GitHub pod účtom ok2cqr. Autor víta spätnú väzbu od používateľov a verí, že tento projekt uľahčí mnohým operátorom ich cesty za spojeniami z prírody. Ak hľadáte moderné, rýchle a spoľahlivé riešenie pre logovanie v teréne, ktoré bez problémov komunikuje s vaším domácim archívom spojení, CQRLOG for web je riešením, ktoré by nemalo uniknúť vašej pozornosti.