Com utilitzar aquest manual

El manual està dividit en tres parts:

Els noms dels comandaments es donen tal com apareixen a la interfície en anglès (Monitor, Setup > Radio, Halt), perquè és la llengua de referència del codi. Si utilitzes Decodium en català, italià, letó o qualsevol de les altres llengües disponibles, els comandaments es troben exactament als mateixos llocs, i la traducció s'indica allà on pugui generar dubtes.

Nota sobre la disponibilitat de les funcions. Decodium es compila per a Windows, macOS i Linux amb motors de descodificació i biblioteques diferents. Algunes funcions descrites aquí poden no aparèixer, o aparèixer desactivades, segons la plataforma, la ràdio connectada i les opcions de compilació del paquet que hagis baixat. El manual ho indica allà on és rellevant.

Part I — Instal·lar i configurar

1. Introducció

1.1 Què és Decodium 4

Decodium 4.0 Core Shannon és una estació digital completa per als modes de senyal feble. Neix de la línia WSJT-X / Decodium i la porta a una arquitectura diferent: interfície Qt 6 / QML, descodificadors i moduladors reescrits progressivament en C++, gestió CAT integrada amb diversos motors, waterfall i panadapter accelerats per GPU, mapa en directe, DX Cluster, PSK Reporter, registre de QSO i un historial de descodificacions en base de dades.

Amb Decodium 4 pots:

• rebre i transmetre en FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W i WSPR;
• controlar la ràdio per CAT (Hamlib, motors natius, Ham Radio Deluxe, OmniRig, TCI);
• gestionar QSO manuals, Auto Sequence, Auto CQ, Multi Answer Mode i els modes DX-Pedition;
• enviar spots i registres a PSK Reporter, QRZ Logbook, Cloudlog, LoTW i a programes externs mitjançant UDP, ADIF TCP o N1MM;
• controlar l'estació des d'una tauleta o un mòbil amb el tauler web remot.

El nom Core Shannon remet a Claude Shannon i a la idea de fons del projecte: tractar la comunicació digital feble com un problema d'informació, sincronització, robustesa i fiabilitat operativa, i no com un exercici de modulació.

1.2 Què canvia respecte de Decodium 3

Qui ve de Decodium 3 «Raptor» troba tres diferències substancials:

1. Interfície nova. La interfície Qt Widgets s'ha substituït per una interfície QML amb plafons que es poden ancorar, desancorar i reordenar, i amb una disposició que es manté entre sessions.
2. Motor en C++. Els descodificadors i moduladors de la família FTx s'han migrat a C++, amb proves de comparació contra les rutines anteriors. Queden components heretats per a alguns modes especialitzats de VHF/UHF.
3. Serveis integrats. L'historial de descodificacions en SQLite, el tauler web, el DX Cluster, la telemetria PWR/SWR/ALC i el diagnòstic d'estació formen part del programa i no requereixen eines externes.

El fitxer CHANGELOG.md inclòs amb el codi font detalla els canvis versió per versió.

1.3 FT2 en dues línies

FT2 (Fast Track 2) és el mode digital creat dins d'aquest projecte i certificat en ADIF amb MODE=MFSK i SUBMODE=FT2.

El capítol 6 està dedicat íntegrament a FT2 i a les seves opcions.

1.4 Llicència i codi font

Decodium 4 es distribueix sota GPL-3.0. El text complet de la llicència és al fitxer COPYING inclòs amb el codi font i amb els paquets. El codi font és públic a GitHub, amb l'historial complet de commits i les versions descarregables.

2. Requisits i instal·lació

2.1 Requisits

Sistemes operatius compatibles

• Windows 10 / 11 de 64 bits
• macOS amb Apple Silicon (i amb Intel on el paquet estigui disponible)
• Linux x86_64 i aarch64, com a AppImage

Maquinari mínim recomanat

• CPU de quatre nuclis recent per operar en FT2 amb descodificació asíncrona
• 4 GB de RAM (8 GB recomanats amb Live Map i panadapter actius)
• GPU amb controladors actualitzats: Decodium fa servir Qt Quick/RHI i aprofita l'acceleració per maquinari per al waterfall, el panadapter i el mapa
• Targeta de so o interfície USB de la ràdio
• Connexió a internet per a NTP, DX Cluster, PSK Reporter i actualitzacions

En màquines més modestes hi ha el mode Slow-PC (apartat 4.9), que redueix la càrrega gràfica i la freqüència de refresc de la interfície.

2.2 Baixar el paquet

1. Obre la pàgina Releases del repositori oficial.
2. Baixa el paquet corresponent al teu sistema: - Windows: instal·lador x64; - macOS Apple Silicon / Intel: fitxer .dmg; - Linux: AppImage per a x86_64 o aarch64.
3. Instal·la el paquet o fes executable el fitxer i engega Decodium.

2.3 Windows

Executa l'instal·lador i segueix l'assistent. En el primer arrencament Windows pot demanar permís d'accés a la xarxa: cal concedir-lo si vols fer servir NTP, DX Cluster, PSK Reporter, el tauler web o les actualitzacions automàtiques.

Els paquets de Windows estan signats digitalment; les notes sobre la signatura de codi són al fitxer CODE_SIGNING_POLICY.md del codi font.

2.4 macOS

Si macOS bloqueja l'aplicació per quarantena, elimina l'atribut de l'aplicació instal·lada:

sudo xattr -r -d com.apple.quarantine /Applications/Decodium.app

El nom exacte de l'aplicació pot variar segons el paquet generat.

macOS demana autorització per fer servir el micròfon la primera vegada que Decodium obre l'entrada d'àudio: sense aquesta autorització no arriba cap senyal al descodificador.

2.5 Linux (AppImage)

Fes executable l'AppImage i engega'l:

chmod +x Decodium*.AppImage
./Decodium*.AppImage

En algunes distribucions cal libfuse2, o bé pots extreure el contingut manualment:

./Decodium*.AppImage --appimage-extract
cd squashfs-root
./AppRun

Per accedir als ports sèrie l'usuari ha de pertànyer al grup correcte (dialout a Debian/Ubuntu, uucp a Arch). Després d'afegir-t'hi cal tornar a iniciar sessió.

2.6 Actualitzacions

Decodium inclou una comprovació d'actualitzacions (Setup > Advanced > DATA UPDATES). Quan hi ha una versió més recent apareix una finestra amb les notes de la versió i l'enllaç al paquet. L'actualització no esborra els paràmetres, ni els registres, ni l'historial de descodificacions.

3. Primera configuració

Aquest capítol cobreix el mínim indispensable per fer el primer QSO. La referència completa de tots els paràmetres és al capítol 14.

Obre els paràmetres amb el botó ⚙ Setup de la barra superior.

3.1 Estació — Setup > Station

Omple els camps de la secció STATION DETAILS:

La secció STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) no influeix en la transmissió: alimenta el registre ADIF i els serveis externs. Omplir-la ara t'estalvia registres incomplets més endavant.

3.2 Ràdio i CAT — Setup > Radio

A la secció BACKEND CAT tria com parla Decodium amb la ràdio:

A més d'aquests, Decodium pot funcionar amb Ham Radio Deluxe quan la ràdio ja està sota control de HRD.

A la secció CAT CONTROL configura el port sèrie, la velocitat, els bits de parada, l'handshake i el mètode de PTT (CAT, RTS, DTR, VOX). A Linux conve fer servir els camins estables /dev/serial/by-id/... en lloc de /dev/ttyUSB*, que poden canviar a cada reinici.

A la secció SPLIT OPERATION tria el mode split:

• None — sense split, el to de transmissió queda dins la banda d'àudio;
• Rig — split gestionat per la ràdio;
• Fake It — Decodium desplaça la freqüència del VFO per mantenir el to de transmissió en una zona neta del filtre.

Fake It és la millor opció amb la majoria de ràdios modernes, perquè manté el to de transmissió lluny dels flancs del filtre i redueix la distorsió en transmissió.

Verifica l'enllaç amb la secció DIAGNOSTICS: has de veure la freqüència real de la ràdio, el canvi de banda ha de funcionar en tots dos sentits i el PTT ha de posar la ràdio en transmissió amb Tune.

Modes de dades. Decodium procura preservar els modes DATA/PKT de les ràdios Icom, Yaesu i Kenwood, per no forçar la ràdio a USB/LSB quan la configuració correcta és DATA-U. Si veus que la ràdio surt del mode de dades quan Decodium canvia de freqüència, revisa el mode configurat en aquesta secció.

Perfils CAT. Pots desar diverses configuracions CAT com a perfils i recuperar-les des del menú Profile. És la manera més ràpida de passar d'una ràdio a una altra, o del muntatge de casa al portàtil.

3.3 Àudio — Setup > Audio

A la secció AUDIO DEVICES selecciona:

• Input: el dispositiu que rep l'àudio de la ràdio (còdec USB o targeta de so);
• Output: el dispositiu que envia l'àudio a la ràdio;
• Canal: Mono, Left, Right o Both, segons el cablatge.

A la secció LEVELS ajusta els nivells de RX i TX. Decodium té un anivellament automàtic de RX, actiu per defecte, que protegeix del retall sense obligar-te a perseguir el control: si el desactives, busca un nivell de recepció que mantingui el soroll de fons al voltant de 30–50 dB a l'indicador.

Per a la transmissió continua valent la regla dels modes digitals: sense compressió, sense processament, ALC en repòs. Apuja el nivell de TX fins a la potència desitjada, i no més. L'apartat 16.2 explica com llegir la telemetria d'ALC per comprovar-ho.

A Windows el reinici del camí d'àudio després de transmetre és deliberadament agressiu, per evitar memòries intermèdies no buidades i portadores encallades. Si notes un breu silenci després de cada transmissió, és aquest mecanisme funcionant correctament.

3.4 Sincronització del rellotge

Per a FT8, FT4 i, encara més críticament, per a FT2, la sincronització del temps és la diferència entre descodificar i no descodificar res.

Decodium inclou:

• un client NTP intern (Setup > Advanced > NTP TIME SYNC);
• el plafó DecoSyncTime, que mostra el desplaçament, l'estat de sincronització, el DT mitjà de les descodificacions i la latència de descodificació.

Activa Enable NTP i comprova que el plafó indiqui un estat sincronitzat. Un DT mitjà sistemàticament diferent de zero en moltes estacions apunta a un problema del rellotge local, no a la propagació.

3.5 Mode d'operació

Tria el mode al selector de la barra superior. Per al primer QSO:

1. Comença per FT8 en una freqüència estàndard: així verifiques àudio, CAT i temps en condicions conegudes.
2. Comprova que apareguin descodificacions a Full Spectrum en un o dos períodes.
3. Només després passa a FT2, que és molt menys indulgent amb els errors de temporització i de configuració d'àudio.

4. La interfície

4.1 Estructura de la finestra

La finestra principal de Decodium 4 està formada per:

4.2 La barra superior

Els botons disponibles a la barra superior són configurables (Setup > UI Buttons), tant en visibilitat com en ordre:

Per reordenar els botons: premuda llarga i arrossegament. Per tornar a la disposició original fes servir Restore default button order a Setup > UI Buttons.

4.3 Waterfall i panadapter

El waterfall mostra l'evolució de l'espectre en el temps; el panadapter mostra l'espectre instantani, amb l'escala de freqüència d'àudio a baix.

Operacions principals:

• clic esquerre al waterfall: mou la freqüència d'àudio de recepció;
• clic amb modificador (segons la configuració): mou la freqüència d'àudio de transmissió;
• roda del ratolí: zoom o desplaçament, segons la zona;
• paletes: seleccionables i personalitzables a Setup > Colors > SPECTRUM.

El waterfall es pot desancorar en una finestra pròpia, ancorar de nou o minimitzar. En disposició compacta fa servir un llindar d'historial més baix, i redueix memòria i textures sense perdre la part visible.

4.4 Full Spectrum

Full Spectrum llista totes les descodificacions del període actual. Les columnes visibles es configuren a Setup > Display > DECODES i inclouen, entre altres, la distància (Dist), l'azimut (Az) i la freqüència.

• doble clic en una fila: selecciona aquella estació com a corresponsal del QSO i prepara els missatges;
• Clear: buida la llista;
• el botó de final de llista (Go to the latest decode) torna la vista a baix quan t'has desplaçat cap amunt.

Les files es coloregen segons les regles de Setup > Colors > DECODE COLORS: nou DXCC, nou continent, nova zona CQ o ITU, nou locator, nou indicatiu, CQ al missatge, 73/RR73, estacions ja treballades (B4), usuaris de LoTW i missatges transmesos.

4.5 Signal RX

Signal RX és la vista quirúrgica: mostra només allò que afecta el QSO en curs i les estacions que et truquen. Durant un pile-up és el plafó que cal mirar, perquè Full Spectrum es torna il·legible.

4.6 Plafó TX

El plafó TX conté:

• els missatges TX1…TX7, que es poden generar i editar;
• l'estat del QSO i del corresponsal;
• els comandaments operatius: Auto (Auto Sequence), Call, Hold, Tune, Halt;
• la potència de TX i els controls ràpids de transmissió.

L'ordre dels botons del plafó TX també és personalitzable, amb restabliment mitjançant Restore default TX panel order.

Halt (o Esc) interromp la transmissió immediatament: és el comandament que cal tenir memoritzat.

4.7 Disposició: ancorar, desancorar, restablir

Cada plafó principal es pot:

• desancorar en una finestra independent (Detach), útil amb diverses pantalles;
• tornar a ancorar a la disposició (Dock);
• amagar i després restaurar (Restore …);
• moure entre columnes arrossegant-lo;
• tornar al seu estat inicial amb Reset Layout.

La disposició es desa en tancar el programa i es torna a carregar en l'arrencada següent, incloses les finestres desancorades i la seva posició.

4.8 Mode compacte

El mode compacte redueix l'alçada de les capçaleres i de les files per mostrar més descodificacions a la pantalla. És l'opció adequada en portàtils i pantalles petites.

4.9 Mode Slow-PC

Slow-PC mode redueix la càrrega d'interfície i de gràfics: menys freqüència de refresc del waterfall, menys animacions, menys treball al fil gràfic. Activa'l si notes salts a la interfície o retards en la descodificació en màquines més antigues: en FT2 una interfície que va justa et pot fer perdre l'interval de transmissió.

4.10 Temes i aspecte

A Setup > Display > ASPETTO / TEMA pots triar el tema (inclòs el tema fosc), els colors de la interfície i els tipus de lletra. A Setup > Display > FONT es configura el tipus de lletra de les descodificacions: fes servir una lletra monoespaiada, o les columnes dels missatges no quedaran alineades.

Part II — Operar

5. El QSO: de la recepció al registre

5.1 Engegar la recepció

1. Prem Monitor: el botó passa a STOP i el waterfall comença a desplaçar-se.
2. Comprova que el nivell de RX no estigui retallant.
3. Espera un o dos períodes: les descodificacions apareixen a Full Spectrum al final de cada interval.

Si no descodifiques res però el waterfall mostra senyals, el problema és gairebé sempre el rellotge (apartat 3.4) o un mode equivocat per a aquella freqüència.

5.2 Trucar una estació

1. Doble clic a la fila de l'estació a Full Spectrum o a Signal RX. Decodium fixa el corresponsal, genera els missatges i tria l'interval correcte.
2. Comprova la freqüència d'àudio de TX: en els modes FTx la bona pràctica és transmetre en una zona lliure de l'espectre, no a sobre de l'estació que truques.
3. Revisa els missatges generats al plafó TX.
4. Activa la transmissió.
5. Amb Auto Sequence actiu, Decodium completa el QSO tot sol: informe, confirmació, RR73/73.

5.3 Trucar CQ

1. Selecciona TX6 (el missatge de CQ).
2. Activa la transmissió, o Auto CQ per trucar de manera cíclica.
3. Segueix Signal RX per veure les respostes directes.
4. Deixa treballar Auto Sequence o intervén manualment.

Amb Auto CQ actiu Decodium torna a trucar CQ al final de cada QSO, tret de les proteccions que hagis configurat (watchdog, comprovació de ROE, límits de reintents).

5.4 Auto Sequence i les seves opcions

Setup > TX > AUTO SEQUENCE reuneix les regles que governen l'automatisme:

Quick QSO està pensat per a concursos i activitat de ritme alt: redueix el QSO a quatre passos i manté un registre vàlid.

5.5 Reintents i tancament del QSO

Setup > TX > FT2 UTILITY conté els paràmetres de tancament del QSO, amb valors separats per a FT2, FT4 i FT8:

El conjunt d'aquestes opcions té un objectiu precís: tancar els QSO febles sense ocupar la freqüència indefinidament. Si treballes DX marginal, apuja el reforç per als corresponsals molt febles; si operes en concurs, mantén els reintents baixos.

5.6 Registrar el QSO

Al tancar-se el QSO, Decodium obre la finestra de confirmació del registre (si Prompt to log QSO és actiu a Setup > Reporting > LOGGING). El QSO s'escriu al registre ADIF local i, si estan configurats, es reenvia a QRZ Logbook, Cloudlog, LoTW i als programes externs connectats.

Amb Alt+L registres el QSO actual sense tocar el ratolí.

5.7 Worked-before (B4)

Decodium reconeix les estacions ja treballades distingint indicatiu, banda i mode. Un QSO en 20 m FT2 no marca com a treballat el mateix indicatiu en 20 m FT8 ni en 40 m FT2. Per tant el color B4 a Full Spectrum indica un duplicat real, i els ressaltats de «nou DXCC / locator / zona» segueixen sent fiables encara que canviïs de mode durant la sessió.

6. Operar en FT2

FT2 és el mode amb què va néixer aquest projecte i continua sent el seu objectiu principal. Aquest capítol reuneix en un sol lloc tot el que fa referència a FT2.

6.1 Què esperar de FT2

L'interval de FT2 és de 3,75 segons i la transmissió dura uns 2,52 segons. Això vol dir dues coses:

1. El ritme de QSO és molt més alt que en FT8 i apreciablement més alt que en FT4: és el seu avantatge en concursos, pile-ups i expedicions, on el coll d'ampolla és el temps per QSO i no la sensibilitat.
2. El marge de temps per descodificar, decidir i preparar la transmissió és reduït. La configuració d'àudio, el rellotge i la càrrega de CPU compten molt més que en FT8.

FT2 no és un mode «millor que FT8»: és un mode ràpid, optimitzat per a condicions en què el senyal hi és i el temps és el recurs escàs.

6.2 Descodificació asíncrona

Decodium descodifica FT2 de manera asíncrona: en lloc d'esperar el final de l'interval per processar-ho tot de cop, treballa sobre lots que se solapen mentre el senyal encara arriba. Això redueix la latència entre el final de la transmissió de l'estació corresponsal i l'aparició del missatge a la pantalla, temps que en FT2 es necessita sencer per respondre a l'interval correcte.

L'estat de la descodificació asíncrona es veu amb el botó Async FT2 (A) de la barra superior.

6.3 El planificador de transmissió

El planificador de TX de FT2 té una regla no negociable: no iniciar una transmissió que no pugui acabar dins l'interval. Una transmissió truncada no la descodifica ningú i només embruta la freqüència.

Per això existeixen les proteccions següents:

Si veus que les teves transmissions arrenquen i es tallen, la primera cosa a comprovar és la sincronització del temps; la segona, la finestra de TX conservadora.

6.4 Les opcions de robustesa de FT2

Aquestes opcions són per a senyals febles, inestables o amb QSB. No les activis totes «per si de cas»: cada una costa CPU o latència.

Configuració recomanada per començar: deixa els valors per defecte, activa FT2 partner-memory si treballes DX amb QSB i activa Conservative FT2 només quan persegueixis senyals al límit.

6.5 Proteccions del registre i dels missatges

Aquesta última opció és útil quan cal informar d'un problema de seqüència: produeix la traça exacta dels estats recorreguts, que és el que es necessita per reproduir l'error.

6.6 Gestió d'indicatius i hashes

FT2, igual que FT8 i FT4, comprimeix els indicatius. Els indicatius llargs o compostos viatgen com a hash i el receptor els resol amb els indicatius ja vistos. Decodium inclou proteccions contra les ghost call (indicatius aparentment descodificats però que no hi són realment) i contra les càrregues útils no resoltes: si un missatge no es pot atribuir amb certesa, no es fa servir per fer avançar la seqüència del QSO.

Aquest comportament és deliberat: és preferible un QSO sense completar que un QSO registrat amb l'indicatiu equivocat.

6.7 FT2 en CPU limitades

En màquines lentes:

1. activa Slow-PC mode;
2. activa FT2: adaptive decode (CPU saver);
3. valora FT2: skip redundant end-slot decode;
4. redueix l'alçada del waterfall i l'historial visible;
5. tanca Live Map si no el necessites.

La prioritat en FT2 és sempre la mateixa: primer la temporització, després la sensibilitat, i per últim l'estètica de la interfície.

7. Multi Answer Mode i cua de trucadors

7.1 Què és

Multi Answer Mode (MAM) permet gestionar diversos trucadors en paral·lel i mantenir més d'un QSO actiu alhora. El plafó MAM mostra els fluxos actius i permet afegir estacions amb doble clic.

L'operador continua sent el responsable: MAM organitza la feina, no l'autoritza. Abans de fer-lo servir en una freqüència concorreguda, assegura't que el teu senyal i la teva configuració són nets.

7.2 Multi-stream

Setup > TX > FT2 UTILITY conté:

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — habilita la gestió de diversos fluxos simultanis;
• MAM multi-stream: max stream simultanei — quants fluxos es permeten.

L'opció està marcada com a experimental: augmenta el nombre de transmissions simultànies i, amb ell, les ocasions d'equivocar-se. Comença amb dos fluxos.

7.3 Cua de trucadors

El plafó Caller Queue recull les estacions que et truquen i permet ordenar-les segons criteris operatius. És l'eina natural quan truques CQ des d'una estació sol·licitada i les respostes arriben més ràpid del que pots treballar-les.

8. Modes DX-Pedition i concurs

8.1 Fox / Hound / SuperFox

A Setup > Advanced > OPERATING MODE:

Els paràmetres OTP (Setup > Advanced > OTP: OTP Enabled, OTP Seed, OTP Interval, OTP URL) governen la generació i la distribució dels codis que serveixen per verificar una activitat: interessen a qui organitza una expedició, no al trucador individual.

8.2 DX-Pedition Workspace

El DX-Pedition Workspace és una disposició dedicada que col·loca en una sola vista Full Spectrum · Decode, Signal RX · QSO Lock i Log · QSO Entry, amb l'hora UTC i l'indicatiu de l'operador. Està pensat per a torns d'operador en una estació sol·licitada, on cal tenir a la vista alhora l'activitat de la banda, el QSO en curs i la introducció al registre.

8.3 Concurs

Setup > Advanced > CONTEST estableix l'activitat en curs:

• Activity: None, Field Day, Fox, Hound;
• FD Exchange i RTTY Exchange: els intercanvis previstos pel reglament;
• Contest Name, Indiv Name, NCCC Sprint: paràmetres per als formats específics.

L'elecció de l'activitat modifica la generació dels missatges: revisa sempre els missatges de TX abans de començar a transmetre en un concurs.

9. Descodificació avançada

Setup > Advanced > ADV DECODING reuneix tres tecnologies de recuperació, que es poden activar per separat o deixar en gestió automàtica:

Amb Auto Mode actiu, Decodium habilita les tres tecnologies només quan calen, segons les condicions mesurades; el camp Live state mostra quines són actives en cada moment.

El cost d'aquestes opcions és CPU. En màquines lentes, activar-les totes a mà empitjora la situació en lloc de millorar-la: Auto Mode és l'opció més sensata en la majoria dels casos.

Altres opcions de descodificació són a Setup > Decode:

• DECODE PARAMETERS — profunditat i paràmetres generals de descodificació;
• JT65 VHF/UHF — paràmetres específics per a l'ús en VHF/UHF;
• SIDELOBE CONTROL — control dels lòbuls laterals;
• DECODE FILTERS — filtres sobre les descodificacions (vegeu l'apartat 12.4).

10. Live Map, Astro i Time Sync

10.1 Live Map

El Live Map mostra les estacions descodificades i els camins entre la teva estació i les seves, amb marcadors de color per direcció i estat. Es posa a zero automàticament al canviar de banda o de mode i quan buides les llistes de descodificació, de manera que no queda al mapa activitat que ja no és vàlida.

Durant la transmissió l'actualització del mapa s'alenteix a propòsit: és una decisió de prioritats, perquè el fil gràfic no ha de robar temps a la transmissió.

Si no necessites el mapa, tancar-lo allibera GPU i memòria: és el primer plafó que cal sacrificar en maquinari modest.

10.2 Astro

El plafó Astro proporciona les dades astronòmiques útils per a EME i per a l'activitat en VHF/UHF: posició de la Lluna, azimut i elevació, Doppler, degradació. El directori de dades AzEl es configura a Setup > Audio > DIRECTORY.

10.3 Time Sync (DecoSyncTime)

El plafó DecoSyncTime reuneix tot el que fa referència al temps:

• estat de NTP i desplaçament aplicat;
• DT mitjà calculat sobre les descodificacions rebudes;
• latència de descodificació;
• nombre de mostres emprades per a l'estimació.

Com llegir-lo:

També hi ha una estimació de la deriva de la targeta de so en ppm, amb indicador verd/ambre/roig: una deriva elevada desplaça progressivament la temporització dels intervals i és típica dels còdecs USB econòmics.

11. Registre, serveis en línia i integracions

11.1 Registre local de QSO

Decodium manté el registre ADIF local i la finestra QSO Log, amb introducció i edició de QSO. Les opcions de comportament són a Setup > Reporting > LOGGING: confirmació abans de registrar, camps obligatoris, format dels informes.

11.2 PSK Reporter

Decodium envia les observacions a PSK Reporter i permet cercar els teus propis spots des del plafó corresponent. L'enviament funciona per cua: quan no hi ha observacions pendents, no es manté cap trànsit de fons cap al servei.

11.3 QRZ Logbook, Cloudlog i LoTW

Per a Cloudlog, Decodium normalitza el punt final de l'API i distingeix als missatges d'error els problemes d'HTTP, d'autenticació i de proxy: si la càrrega falla, el missatge indica quin dels tres és.

Les dades de LoTW serveixen també per ressaltar els usuaris de LoTW a Full Spectrum (color LoTW marker).

11.4 DX Cluster

El plafó DX Cluster es connecta a un node telnet i mostra els spots, amb possibilitat de filtratge. La configuració és a Setup > Reporting > DX CLUSTER (amfitrió, port, indicatiu d'accés, filtres).

11.5 Integració amb programes externs

Si fas servir JTAlert o GridTracker, l'UDP Server ha de ser actiu i el port ha de coincidir amb el configurat al programa extern.

11.6 Enregistrament d'àudio

Setup > Reporting > RECORDING gestiona l'enregistrament de l'àudio rebut, útil per a anàlisis posteriors i per adjuntar mostres reals a un informe d'error.

12. Historial de descodificacions, filtres i alertes

12.1 Decode History

Decodium desa les descodificacions en una base de dades SQLite consultable des de la finestra History. Pots cercar per:

• indicatiu;
• banda;
• mode;
• interval de dates UTC;
• límit de resultats.

Els resultats es poden exportar a ADIF. L'historial sobreviu al tancament del programa i permet anàlisis posteriors a l'activitat: comprovació de la propagació, control de l'activitat a la banda, reconstrucció d'un QSO dubtós.

Les vistes en directe a la memòria estan limitades perquè el consum de RAM no creixi durant sessions llargues; l'historial complet queda a la base de dades.

12.2 Alertes d'àudio

Setup > Alerts > AUDIO ALERTS permet associar un so a esdeveniments concrets: nou DXCC, nou locator, un indicatiu que busques, una trucada directa. És la manera de treballar en segon pla sense mirar fixament la pantalla.

12.3 Filtres: blacklist, whitelist i territoris

Setup > Filters conté:

ALWAYS PASS té prioritat: és el lloc adequat per a l'indicatiu d'un amic que no vols perdre mai, encara que estiguis filtrant de manera agressiva.

12.4 Filtres de descodificació

Setup > Decode > DECODE FILTERS actua més amunt, sobre la feina del descodificador i sobre el que es publica a les llistes. Fet servir amb criteri, redueix la càrrega de CPU en una banda concorreguda.

13. Tauler web remot i FT2-Link

13.1 Tauler web remot (iPad, mòbil, PWA)

Decodium inclou un servidor web intern que permet controlar l'estació des d'un altre dispositiu de la mateixa xarxa local.

Activació

1. Obre Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) o Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Habilita el servidor i configura el port i les credencials d'accés.
3. Esbrina l'adreça IP de l'ordinador de l'estació.
4. Des de la tauleta o el mòbil obre http://ADRECA-IP:PORT al navegador.
5. Afegeix la pàgina a la pantalla d'inici per fer-la servir com a aplicació (PWA).

Seguretat — llegir abans d'activar-lo

• Fes servir el servidor només a la xarxa local. No l'exposis a internet i no obris ports al router.
• Posa una contrasenya no trivial: qui arribi al tauler pot manar sobre la teva estació i, per tant, sobre la teva transmissió.
• A xarxes compartides (hotels, radioclubs, fires) mantén el servidor apagat quan no el facis servir.

La guia pas a pas per a principiants és al fitxer doc/WEBAPP_SETUP_GUIDE.en-GB.md del codi font, amb la secció de resolució de problemes i la descripció dels punts finals de l'API per a usos avançats.

13.2 FT2-Link (experimental)

FT2-Link és un protocol obert per a xat i missatges fiables, en desenvolupament dins de Decodium. Està documentat públicament i és independent del mòdem: el mateix ARQ pot funcionar sobre formes d'ona diferents.

El funcionament previst és: beacon o CQ en NARROW, resposta HELLO, negociació del millor perfil comú, pas a W500 o W2300 per a les dades, i retorn a NARROW si el perfil ample no aguanta.

El període de treball de FT2-Link és de 15 segons, diferent dels 3,75 s de FT2.

Atenció. FT2-Link és material experimental i els perfils W500/W2300 no són FT2 estàndard i no s'han de presentar com a tals. Comprova la normativa aplicable a l'amplada de banda que pretens fer servir, a la teva banda i a la teva regió IARU, abans de transmetre.

Part III — Referència

14. Referència dels paràmetres

Els paràmetres estan organitzats en tretze pestanyes. A continuació s'enumeren totes les seccions, en l'ordre en què apareixen, amb la seva funció.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

Els perfils a punt apliquen d'un sol cop un conjunt coherent de paràmetres:

El perfil actiu s'indica amb ● active. Pots partir d'un perfil i després modificar opcions concretes: els teus canvis continuen sent teus i no se sobreescriuen fins que apliquis un altre perfil.

14.4.2 Watchdog

Mantén el watchdog actiu. És la protecció que evita una portadora oblidada a la banda quan surts de l'habitació.

14.5 Display

Prioritat del procés. High (recommended) és l'opció aconsellada. Realtime està marcada amb un avís: en alguns sistemes pot deixar l'ordinador poc reactiu o inestable. No la facis servir si no estàs fent mesures específiques.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Gestió de les freqüències de treball: llista per banda i mode, addició, modificació, càrrega i desat en fitxers .qrg / .qrg.json, amb la possibilitat de fusionar (Merge Working Frequencies) una llista externa amb la pròpia en lloc de substituir-la.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — associació de sons a esdeveniments (nou DXCC, nou locator, indicatiu cercat, trucada directa).

14.12 Filters

BLACKLIST, WHITELIST, ALWAYS PASS, EXCLUDE TERRITORY, FILTER OPTIONS (apartat 12.3).

14.13 UI Buttons

TOP TOOLBAR (visibilitat dels botons) i TOOLBAR BUTTON ORDER (ordre, amb restabliment dels valors per defecte per a la barra i per al plafó TX).

15. Dreceres de teclat

Transmissió

Controls (Ctrl)

Accions (Alt)

Altres

La llista completa es pot consultar dins del programa a Keyboard Shortcuts.

16. Diagnòstic i resolució de problemes

16.1 No descodifico res

Segueix aquest ordre:

1. Monitor està actiu? El botó ha d'indicar STOP.
2. El waterfall es desplaça? Si està aturat, el problema és el dispositiu d'entrada d'àudio, no el descodificador.
3. El nivell de RX és raonable? Un soroll de fons massa baix, o el retall, impedeixen la descodificació.
4. El rellotge està sincronitzat? Revisa el plafó Time Sync. En FT2 i FT4 unes dècimes de segon són prou per perdre-ho tot.
5. El mode és el correcte per a aquella freqüència? FT8 en una freqüència de FT4 no descodifica.
6. El canal d'àudio és el correcte? Amb un còdec estèreo, el canal equivocat equival al silenci.

16.2 Transmeto però ningú em contesta

• Comprova que el PTT funcioni i que la ràdio passi realment a transmissió.
• Revisa la telemetria a Setup > Radio > DIAGNOSTICS: la potència ha de correspondre a l'esperada i l'ALC ha de romandre en repòs. El valor ALC -- significa que la dada no està disponible, mentre que 0 és un valor vàlid: són dues situacions diferents.
• Comprova la ROE: Check SWR no bloqueja el Tune, així pots mesurar i corregir, però sí que protegeix la transmissió real i l'Auto CQ.
• Assegura't de no estar transmetent fora de l'interval: en FT2 la finestra de TX conservadora (apartat 6.3) rebutja les transmissions tardanes, i aquest és el comportament correcte.

16.3 Problemes gràfics i de rendiment

L'indicador de pressió de CPU a Setup > Display > UI — PERFORMANCE compta els esdeveniments de sobrecàrrega de la sessió: si el comptador severe creix, l'ordinador no dóna la talla i cal alleugerir la configuració.

16.4 Àudio bloquejat o portadora després de transmetre

Decodium inclou un watchdog d'àudio de TX pensat precisament per a aquest cas. Si el problema es presenta:

1. fes servir Halt (o Esc);
2. comprova que el PTT s'hagi alliberat a la ràdio;
3. revisa el dispositiu de sortida d'àudio a Setup > Audio;
4. si passa de manera sistemàtica, captura un registre de diagnòstic i informa'n.

16.5 Ports CAT que canvien o apareixen duplicats

A Linux fes servir els camins /dev/serial/by-id/..., que es mantenen estables entre reinicis. Si el mateix dispositiu apareix dues vegades (com /dev/ttyUSB0 i com a camí by-id), tria el camí by-id i no tots dos: són el mateix dispositiu físic.

16.6 Informar d'un error de manera útil

Decodium inclou una finestra d'informe d'errors. Un informe útil conté:

• la versió exacta del programa (About Decodium);
• el sistema operatiu i la plataforma;
• la ràdio i el motor CAT en ús;
• el mode d'operació i la freqüència;
• la descripció dels passos per reproduir el problema;
• el registre de diagnòstic i, si el problema afecta la descodificació, un fitxer WAV del senyal;
• per als problemes de seqüència de FT2: activa FT2 state transition census (log only) i adjunta la traça.

17. Fitxers, carpetes i dades d'usuari

Decodium fa servir les carpetes estàndard del sistema previstes per Qt per a:

• els paràmetres de configuració;
• la memòria cau de QML;
• la base de dades SQLite de l'historial de descodificacions (db.sqlite);
• CTY.DAT i les dades de DXCC;
• el registre ADIF;
• els registres de diagnòstic;
• els enregistraments d'àudio.

Les ubicacions exactes depenen de la plataforma. La manera més fiable de trobar-les és llegir el registre d'arrencada, on Decodium imprimeix els camins principals (AppDataLocation, CacheLocation, camí de la base de dades).

Per a una còpia de seguretat completa de la configuració calen: la carpeta de paràmetres, el registre ADIF i la base de dades de l'historial.

Decodium inclou també una migració de l'emmagatzematge: quan l'estructura de les dades canvia entre versions, els fitxers existents es converteixen en la primera arrencada. Abans d'una actualització important, una còpia de la carpeta de dades continua sent la precaució més sensata.

18. Compilar des del codi font

18.1 Dependències

Segons la plataforma calen:

• CMake (3.20 o superior) i un compilador C/C++ recent;
• Qt 6 amb els mòduls Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql i WebSockets;
• Hamlib;
• un compilador Fortran (gfortran) per als components heretats que encara hi són;
• Boost i la resta de dependències indicades als fitxers de compilació.

18.2 Scripts de compilació

El repositori conté scripts a punt per a les plataformes principals:

Les notes específiques de Windows són a doc/building on MS Windows.txt i als fitxers adjacents; la migració a macOS està documentada a doc/MACOS_PORTING_v1.2.0.md.

18.3 Proves

El directori tests/ conté les proves unitàries i les comparacions entre les implementacions dels descodificadors, incloses les proves dedicades a FT2 i a FT2-Link. Per executar-les:

ctest --output-on-failure

Les proves de comparació entre etapes de descodificació són l'eina adequada per verificar que un canvi al descodificador no introdueix una regressió de sensibilitat.

19. Glossari

20. Crèdits, llicència i contactes

El projecte

• Martino Merola — IU8LMC — creador de FT2, lead developer de DECODIUM
• Salvatore Raccampo — 9H1SR — nucli C++, compilacions i paquets de macOS i Linux
• Els provadors i col·laboradors de la comunitat FT2, els informes dels quals han guiat gran part de la feina de les versions recents
• Els traductors de la comunitat, que mantenen les traduccions del programa

Origen del codi

Decodium descendeix de la línia WSJT-X, desenvolupada per Joe Taylor K1JT, Steve Franke K9AN, Bill Somerville G4WJS i la resta d'autors del projecte, i distribuïda sota GPL. Els fitxers AUTHORS, THANKS i COPYING inclosos amb el codi font recullen les atribucions i la llicència completes. Les aportacions pròpies d'aquest projecte — el protocol FT2, els descodificadors i moduladors reescrits, la interfície QML, els serveis integrats — estan documentades a l'historial de commits i a CHANGELOG.md.

Llicència

Decodium 4.0 Core Shannon és programari lliure distribuït sota la GNU General Public License versió 3. Pots fer-lo servir, estudiar-lo, modificar-lo i redistribuir-lo segons els termes d'aquesta llicència. El programa es lliura sense cap garantia, dins dels límits que permeti la legislació aplicable.

On trobar ajuda

• Web del projecte: ft2.it
• Comunitat i suport: community.ft2.it
• Canal de Telegram FT2 Digital Mode
• Informes tècnics: secció Issues del repositori de GitHub

Nota operativa final

Decodium controla un transmissor. La responsabilitat del que surt a l'aire —banda, amplada, potència, horaris, autoritzacions— és de l'operador titular de la llicència. Les funcions experimentals del programa, en particular els perfils amples de FT2-Link i els modes multi-stream, s'han de fer servir només després de comprovar la normativa aplicable a la teva banda i a la teva regió IARU.

73 de IU8LMC