Cómo usar este manual

El manual está dividido en tres partes:

Los nombres de los comandos aparecen tal como se muestran en la interfaz en inglés (Monitor, Setup > Radio, Halt), porque es el idioma de referencia del código. Si usas Decodium en español, italiano, letón o cualquiera de los otros idiomas disponibles, los comandos están exactamente en los mismos sitios, y la traducción se indica allí donde pueda generar dudas.

Nota sobre la disponibilidad de las funciones. Decodium se compila para Windows, macOS y Linux con distintos backends de decodificación y bibliotecas. Algunas funciones descritas aquí pueden no aparecer, o aparecer desactivadas, según la plataforma, la radio conectada y las opciones de compilación del paquete que hayas descargado. El manual lo señala donde resulta relevante.

Parte I — Instalar y configurar

1. Introducción

1.1 Qué es Decodium 4

Decodium 4.0 Core Shannon es una estación digital completa para los modos de señal débil. Nace de la línea WSJT-X / Decodium y la lleva a una arquitectura distinta: interfaz Qt 6 / QML, decodificadores y moduladores reescritos progresivamente en C++, gestión CAT integrada con varios backends, waterfall y panadapter acelerados por GPU, mapa en vivo, DX Cluster, PSK Reporter, log de QSO y un histórico de decodificaciones en base de datos.

Con Decodium 4 puedes:

• recibir y transmitir en FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W y WSPR;
• controlar la radio por CAT (Hamlib, backends nativos, Ham Radio Deluxe, OmniRig, TCI);
• gestionar QSO manuales, Auto Sequence, Auto CQ, Multi Answer Mode y los modos DX-Pedition;
• enviar spots y logs a PSK Reporter, QRZ Logbook, Cloudlog, LoTW y a programas externos mediante UDP, ADIF TCP o N1MM;
• controlar la estación desde una tableta o un móvil a través del panel web remoto.

El nombre Core Shannon remite a Claude Shannon y a la idea de fondo del proyecto: tratar la comunicación digital débil como un problema de información, sincronización, robustez y fiabilidad operativa, no como un ejercicio de modulación.

1.2 Qué cambia respecto a Decodium 3

Quien viene de Decodium 3 "Raptor" encuentra tres diferencias sustanciales:

1. Interfaz nueva. La interfaz Qt Widgets ha sido sustituida por una interfaz QML con paneles que se pueden acoplar, desacoplar y reordenar, y con un diseño que persiste entre sesiones.
2. Motor en C++. Los decodificadores y moduladores de la familia FTx se han migrado a C++, con pruebas de comparación frente a las rutinas anteriores. Quedan componentes heredados para algunos modos especializados de VHF/UHF.
3. Servicios integrados. El histórico de decodificaciones en SQLite, el panel web remoto, el DX Cluster, la telemetría PWR/SWR/ALC y el diagnóstico de estación forman parte del programa y no requieren herramientas externas.

El archivo CHANGELOG.md incluido en el código fuente detalla los cambios versión por versión.

1.3 FT2 en dos líneas

FT2 (Fast Track 2) es el modo digital creado dentro de este proyecto y certificado en ADIF con MODE=MFSK y SUBMODE=FT2.

El capítulo 6 está dedicado íntegramente a FT2 y a sus opciones.

1.4 Licencia y código fuente

Decodium 4 se distribuye bajo GPL-3.0. El texto completo de la licencia está en el archivo COPYING incluido con el código fuente y con los paquetes. El código fuente es público en GitHub, con el historial completo de commits y las versiones descargables.

2. Requisitos e instalación

2.1 Requisitos

Sistemas operativos compatibles

• Windows 10 / 11 de 64 bits
• macOS con Apple Silicon (y con Intel donde el paquete esté disponible)
• Linux x86_64 y aarch64, como AppImage

Hardware mínimo recomendado

• CPU de cuatro núcleos reciente para operar en FT2 con decodificación asíncrona
• 4 GB de RAM (8 GB recomendados con Live Map y panadapter activos)
• GPU con controladores actualizados: Decodium usa Qt Quick/RHI y aprovecha la aceleración por hardware para el waterfall, el panadapter y el mapa
• Tarjeta de sonido o interfaz USB de la radio
• Conexión a internet para NTP, DX Cluster, PSK Reporter y actualizaciones

En máquinas más modestas está disponible el modo Slow-PC (apartado 4.9), que reduce la carga gráfica y la frecuencia de refresco de la interfaz.

2.2 Descargar el paquete

1. Abre la página Releases del repositorio oficial.
2. Descarga el paquete correspondiente a tu sistema: - Windows: instalador x64; - macOS Apple Silicon / Intel: archivo .dmg; - Linux: AppImage para x86_64 o aarch64.
3. Instala el paquete o haz ejecutable el archivo, y arranca Decodium.

2.3 Windows

Ejecuta el instalador y sigue el asistente. En el primer arranque Windows puede pedir permiso de acceso a la red: hay que concederlo si quieres usar NTP, DX Cluster, PSK Reporter, el panel web o las actualizaciones automáticas.

Los paquetes de Windows están firmados digitalmente; las notas sobre la firma de código están en el archivo CODE_SIGNING_POLICY.md del código fuente.

2.4 macOS

Si macOS bloquea la aplicación por cuarentena, elimina el atributo de la aplicación instalada:

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

El nombre exacto de la aplicación puede variar según el paquete generado.

macOS pide autorización para usar el micrófono la primera vez que Decodium abre la entrada de audio: sin esa autorización no llega ninguna señal al decodificador.

2.5 Linux (AppImage)

Haz ejecutable el AppImage y arráncalo:

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

En algunas distribuciones hace falta libfuse2, o bien puedes extraer el contenido manualmente:

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

Para acceder a los puertos serie el usuario debe pertenecer al grupo correcto (dialout en Debian/Ubuntu, uucp en Arch). Después de añadirte hace falta volver a iniciar sesión.

2.6 Actualizaciones

Decodium incluye una comprobación de actualizaciones (Setup > Advanced > DATA UPDATES). Cuando hay una versión más reciente aparece una ventana con las notas de la versión y el enlace al paquete. La actualización no borra los ajustes, los logs ni el histórico de decodificaciones.

3. Primera configuración

Este capítulo cubre lo mínimo indispensable para hacer el primer QSO. La referencia completa de todos los ajustes está en el capítulo 14.

Abre los ajustes con el botón ⚙ Setup de la barra superior.

3.1 Estación — Setup > Station

Rellena los campos de la sección STATION DETAILS:

La sección STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) no influye en la transmisión: alimenta el log ADIF y los servicios externos. Rellenarla ahora te evita logs incompletos después.

3.2 Radio y CAT — Setup > Radio

En la sección BACKEND CAT elige cómo habla Decodium con la radio:

Además de estos, Decodium puede funcionar con Ham Radio Deluxe cuando la radio ya está bajo el control de HRD.

En la sección CAT CONTROL configura el puerto serie, la velocidad, los bits de parada, el handshake y el método de PTT (CAT, RTS, DTR, VOX). En Linux conviene usar las rutas estables /dev/serial/by-id/... en lugar de /dev/ttyUSB*, que pueden cambiar en cada reinicio.

En la sección SPLIT OPERATION elige el modo split:

• None — sin split, el tono de TX queda dentro de la banda de audio;
• Rig — split gestionado por la radio;
• Fake It — Decodium desplaza la frecuencia del VFO para mantener el tono de TX en una zona limpia del filtro.

Fake It es la mejor opción con la mayoría de radios modernas, porque mantiene el tono de transmisión lejos de los bordes del filtro y reduce la distorsión de transmisión.

Verifica el enlace con la sección DIAGNOSTICS: debes ver la frecuencia real de la radio, el cambio de banda debe funcionar en ambos sentidos y el PTT debe llevar la radio a transmisión con Tune.

Modos de datos. Decodium intenta preservar los modos DATA/PKT de las radios Icom, Yaesu y Kenwood, para no forzar la radio a USB/LSB cuando la configuración correcta es DATA-U. Si notas que la radio sale del modo de datos cuando Decodium cambia de frecuencia, revisa el modo configurado en esta sección.

Perfiles CAT. Puedes guardar varias configuraciones CAT como perfiles y recuperarlas desde el menú Profile. Es la forma más rápida de pasar de una radio a otra, o del montaje de casa al portátil.

3.3 Audio — Setup > Audio

En la sección AUDIO DEVICES selecciona:

• Input: el dispositivo que recibe el audio de la radio (códec USB o tarjeta de sonido);
• Output: el dispositivo que envía el audio a la radio;
• Canal: Mono, Left, Right o Both, según el cableado.

En la sección LEVELS ajusta los niveles de RX y TX. Decodium tiene un nivelado automático de RX, activo por defecto, que protege del recorte sin obligarte a perseguir el deslizador: si lo desactivas, busca un nivel de recepción que mantenga el ruido de fondo en torno a 30–50 dB en el indicador.

Para la transmisión sigue valiendo la regla de los modos digitales: sin compresión, sin procesado, ALC en reposo. Sube el nivel de TX hasta la potencia deseada, y no más. El apartado 16.2 explica cómo leer la telemetría de ALC para comprobarlo.

En Windows el reinicio del camino de audio después de transmitir es deliberadamente agresivo, para evitar búferes sin vaciar y portadoras atascadas. Si notas un breve silencio después de cada TX, es ese mecanismo funcionando correctamente.

3.4 Sincronización del reloj

Para FT8, FT4 y, de forma aún más crítica, para FT2, la sincronización del tiempo es la diferencia entre decodificar y no decodificar nada.

Decodium incluye:

• un cliente NTP interno (Setup > Advanced > NTP TIME SYNC);
• el panel DecoSyncTime, que muestra el desplazamiento, el estado de sincronización, el DT medio de las decodificaciones y la latencia de decodificación.

Activa Enable NTP y comprueba que el panel indique un estado sincronizado. Un DT medio sistemáticamente distinto de cero en muchas estaciones apunta a un problema del reloj local, no a la propagación.

3.5 Modo de operación

Elige el modo en el selector de la barra superior. Para el primer QSO:

1. Empieza por FT8 en una frecuencia estándar, así verificas audio, CAT y tiempo en condiciones conocidas.
2. Comprueba que aparezcan decodificaciones en Full Spectrum en uno o dos periodos.
3. Solo después pasa a FT2, que es mucho menos indulgente con los errores de temporización y de configuración de audio.

4. La interfaz

4.1 Estructura de la ventana

La ventana principal de Decodium 4 está compuesta por:

4.2 La barra superior

Los botones disponibles en la barra superior son configurables (Setup > UI Buttons), tanto en visibilidad como en orden:

Para reordenar los botones: pulsación prolongada y arrastre. Para volver a la disposición original usa Restore default button order en Setup > UI Buttons.

4.3 Waterfall y panadapter

El waterfall muestra la evolución del espectro en el tiempo; el panadapter muestra el espectro instantáneo, con la escala de frecuencia de audio en la parte inferior.

Operaciones principales:

• clic izquierdo en el waterfall: mueve la frecuencia de audio de recepción;
• clic con modificador (según la configuración): mueve la frecuencia de audio de transmisión;
• rueda del ratón: zoom o desplazamiento, según la zona;
• paletas: seleccionables y personalizables en Setup > Colors > SPECTRUM.

El waterfall se puede desacoplar en su propia ventana, acoplar de nuevo o minimizar. En diseño compacto usa un umbral de historia menor, reduciendo memoria y texturas sin perder la parte visible.

4.4 Full Spectrum

Full Spectrum lista todas las decodificaciones del periodo actual. Las columnas visibles se configuran en Setup > Display > DECODES e incluyen, entre otras, la distancia (Dist), el azimut (Az) y la frecuencia.

• doble clic en una fila: selecciona esa estación como interlocutor del QSO y prepara los mensajes;
• Clear: vacía la lista;
• el botón de cola (Go to the latest decode) devuelve la vista al final cuando te has desplazado hacia arriba.

Las filas se colorean según las reglas de Setup > Colors > DECODE COLORS: nuevo DXCC, nuevo continente, nueva zona CQ o ITU, nuevo grid, nuevo indicativo, CQ en el mensaje, 73/RR73, estaciones ya trabajadas (B4), usuarios de LoTW y mensajes transmitidos.

4.5 Signal RX

Signal RX es la vista quirúrgica: muestra solo lo que afecta al QSO en curso y a las estaciones que te están llamando. Durante un pile-up es el panel que hay que mirar, porque Full Spectrum se vuelve ilegible.

4.6 Panel TX

El panel TX contiene:

• los mensajes TX1…TX7, que se pueden generar y editar;
• el estado del QSO y del interlocutor;
• los mandos operativos: Auto (Auto Sequence), Call, Hold, Tune, Halt;
• la potencia de TX y los controles rápidos de transmisión.

El orden de los botones del panel TX también es personalizable, con restablecimiento mediante Restore default TX panel order.

Halt (o Esc) interrumpe la transmisión de inmediato: es el mando que hay que tener memorizado.

4.7 Diseño: acoplar, desacoplar, restablecer

Cada panel principal puede:

• desacoplarse en una ventana independiente (Detach), útil con varios monitores;
• volver a acoplarse en el diseño (Dock);
• ocultarse y luego restaurarse (Restore …);
• moverse entre columnas arrastrándolo;
• volver a su estado inicial con Reset Layout.

El diseño se guarda al cerrar el programa y se recarga en el arranque siguiente, incluidas las ventanas desacopladas y su posición.

4.8 Modo compacto

El modo compacto reduce la altura de los encabezados y de las filas para mostrar más decodificaciones en pantalla. Es la opción adecuada en portátiles y pantallas pequeñas.

4.9 Modo Slow-PC

Slow-PC mode reduce la carga de interfaz y de gráficos: menor frecuencia de refresco del waterfall, menos animaciones, menos trabajo en el hilo gráfico. Actívalo si notas tirones en la interfaz o retrasos en la decodificación en máquinas más antiguas: en FT2 una interfaz que va justa puede hacerte perder la ranura de transmisión.

4.10 Temas y aspecto

En Setup > Display > ASPETTO / TEMA puedes elegir el tema (incluido el tema oscuro), los colores de la interfaz y las fuentes. En Setup > Display > FONT se configura la fuente de las decodificaciones: usa una fuente monoespaciada, o las columnas de los mensajes no quedarán alineadas.

Parte II — Operar

5. El QSO: de la recepción al log

5.1 Iniciar la recepción

1. Pulsa Monitor: el botón pasa a STOP y el waterfall empieza a desplazarse.
2. Comprueba que el nivel de RX no esté recortando.
3. Espera uno o dos periodos: las decodificaciones aparecen en Full Spectrum al final de cada ranura.

Si no decodificas nada pero el waterfall muestra señales, el problema es casi siempre el reloj (apartado 3.4) o un modo equivocado para esa frecuencia.

5.2 Llamar a una estación

1. Doble clic en la fila de la estación en Full Spectrum o en Signal RX. Decodium fija el interlocutor, genera los mensajes y elige la ranura correcta.
2. Comprueba la frecuencia de audio de TX: en los modos FTx la buena práctica es transmitir en una zona libre del espectro, no encima de la estación a la que llamas.
3. Revisa los mensajes generados en el panel TX.
4. Activa la transmisión.
5. Con Auto Sequence activo, Decodium completa el QSO por sí solo: informe, confirmación, RR73/73.

5.3 Llamar CQ

1. Selecciona TX6 (el mensaje de CQ).
2. Activa la transmisión, o Auto CQ para llamar de forma cíclica.
3. Sigue Signal RX para ver las respuestas directas.
4. Deja trabajar a Auto Sequence o intervén manualmente.

Con Auto CQ activo Decodium vuelve a llamar CQ al terminar cada QSO, salvo por las protecciones que hayas configurado (watchdog, comprobación de SWR, límites de reintentos).

5.4 Auto Sequence y sus opciones

Setup > TX > AUTO SEQUENCE reúne las reglas que gobiernan el automatismo:

Quick QSO está pensado para concursos y actividad de ritmo alto: reduce el QSO a cuatro pasos manteniendo un log válido.

5.5 Reintentos y cierre del QSO

Setup > TX > FT2 UTILITY contiene los parámetros de cierre del QSO, con valores separados para FT2, FT4 y FT8:

El conjunto de estas opciones tiene un objetivo preciso: cerrar los QSO débiles sin ocupar la frecuencia indefinidamente. Si trabajas DX marginal, sube el refuerzo para los interlocutores muy débiles; si operas en concurso, mantén los reintentos bajos.

5.6 Registrar el QSO en el log

Al cerrarse el QSO, Decodium abre la ventana de confirmación del log (si Prompt to log QSO está activo en Setup > Reporting > LOGGING). El QSO se escribe en el log ADIF local y, si están configurados, se reenvía a QRZ Logbook, Cloudlog, LoTW y a los programas externos conectados.

Con Alt+L registras el QSO actual sin tocar el ratón.

5.7 Worked-before (B4)

Decodium reconoce las estaciones ya trabajadas distinguiendo indicativo, banda y modo. Un QSO en 20 m FT2 no marca como ya trabajado el mismo indicativo en 20 m FT8 ni en 40 m FT2. Por tanto el color B4 en Full Spectrum indica un duplicado real, y los resaltados de "nuevo DXCC / grid / zona" siguen siendo fiables aunque cambies de modo durante la sesión.

6. Operar en FT2

FT2 es el modo con el que nació este proyecto y sigue siendo su objetivo principal. Este capítulo reúne en un solo lugar todo lo relativo a FT2.

6.1 Qué esperar de FT2

La ranura de FT2 es de 3,75 segundos y la transmisión dura unos 2,52 segundos. Esto significa dos cosas:

1. El ritmo de QSO es mucho más alto que en FT8 y apreciablemente más alto que en FT4: es su ventaja en concursos, pile-ups y DXpediciones, donde el cuello de botella es el tiempo por QSO y no la sensibilidad.
2. El margen de tiempo para decodificar, decidir y preparar la transmisión es reducido. La configuración de audio, el reloj y la carga de CPU cuentan mucho más que en FT8.

FT2 no es un modo "mejor que FT8": es un modo rápido, optimizado para condiciones en las que la señal está y el tiempo es el recurso escaso.

6.2 Decodificación asíncrona

Decodium decodifica FT2 de forma asíncrona: en lugar de esperar el final de la ranura para procesarlo todo de golpe, trabaja sobre lotes solapados mientras la señal está llegando. Así se reduce la latencia entre el final de la transmisión de la estación interlocutora y la aparición del mensaje en pantalla, tiempo que en FT2 se necesita íntegro para responder en la ranura correcta.

El estado de la decodificación asíncrona se ve con el botón Async FT2 (A) de la barra superior.

6.3 El planificador de transmisión

El planificador de TX de FT2 tiene una regla no negociable: no iniciar una transmisión que no pueda concluir dentro de la ranura. Una transmisión truncada no la decodifica nadie y solo ensucia la frecuencia.

Por eso existen las siguientes protecciones:

Si ves que tus transmisiones arrancan y se cortan, lo primero que hay que comprobar es la sincronización del tiempo; lo segundo, la ventana de TX conservadora.

6.4 Las opciones de robustez de FT2

Estas opciones son para señales débiles, inestables o con QSB. No las actives todas "por si acaso": cada una cuesta CPU o latencia.

Configuración recomendada para empezar: deja los valores por defecto, activa FT2 partner-memory si trabajas DX con QSB y activa Conservative FT2 solo cuando persigas señales al límite.

6.5 Protecciones del log y de los mensajes

La última opción es útil cuando hay que informar de un problema de secuencia: produce la traza exacta de los estados recorridos, que es lo que se necesita para reproducir el fallo.

6.6 Gestión de indicativos y hashes

FT2, igual que FT8 y FT4, comprime los indicativos. Los indicativos largos o compuestos viajan como hash y el receptor los resuelve usando los indicativos ya vistos. Decodium incluye protecciones contra las ghost call (indicativos aparentemente decodificados pero que no están realmente presentes) y contra las cargas útiles no resueltas: si un mensaje no se puede atribuir con certeza, no se usa para hacer avanzar la secuencia del QSO.

Este comportamiento es deliberado: es preferible un QSO sin completar que un QSO registrado con el indicativo equivocado.

6.7 FT2 en CPU limitadas

En máquinas lentas:

1. activa Slow-PC mode;
2. activa FT2: adaptive decode (CPU saver);
3. valora FT2: skip redundant end-slot decode;
4. reduce la altura del waterfall y la historia visible;
5. cierra Live Map si no lo necesitas.

La prioridad en FT2 es siempre la misma: primero la temporización, luego la sensibilidad, y por último la estética de la interfaz.

7. Multi Answer Mode y cola de llamantes

7.1 Qué es

Multi Answer Mode (MAM) permite gestionar varios llamantes en paralelo, manteniendo más de un QSO activo a la vez. El panel MAM muestra los flujos activos y permite añadir estaciones con doble clic.

El operador sigue siendo el responsable: MAM organiza el trabajo, no lo autoriza. Antes de usarlo en una frecuencia concurrida, asegúrate de que tu señal y tu configuración están limpias.

7.2 Multi-stream

Setup > TX > FT2 UTILITY contiene:

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — habilita la gestión de varios flujos simultáneos;
• MAM multi-stream: max stream simultanei — cuántos flujos permitir.

La opción está marcada como experimental: aumenta el número de transmisiones simultáneas y, con él, las ocasiones de equivocarse. Empieza con dos flujos.

7.3 Cola de llamantes

El panel Caller Queue recoge las estaciones que te están llamando y permite ordenarlas según criterios operativos. Es la herramienta natural cuando llamas CQ desde una estación solicitada y las respuestas llegan más rápido de lo que puedes trabajarlas.

8. Modos DX-Pedition y concurso

8.1 Fox / Hound / SuperFox

En Setup > Advanced > OPERATING MODE:

Los ajustes de OTP (Setup > Advanced > OTP: OTP Enabled, OTP Seed, OTP Interval, OTP URL) gobiernan la generación y distribución de los códigos usados para verificar una actividad: conciernen a quien organiza una expedición, no al llamante individual.

8.2 DX-Pedition Workspace

El DX-Pedition Workspace es un diseño específico que coloca en una sola vista Full Spectrum · Decode, Signal RX · QSO Lock y Log · QSO Entry, con la hora UTC y el indicativo del operador. Está pensado para turnos de operador en una estación solicitada, donde hace falta tener a la vista al mismo tiempo la actividad de la banda, el QSO en curso y la introducción en el log.

8.3 Concurso

Setup > Advanced > CONTEST establece la actividad en curso:

• Activity: None, Field Day, Fox, Hound;
• FD Exchange y RTTY Exchange: los intercambios previstos por las bases;
• Contest Name, Indiv Name, NCCC Sprint: parámetros para los formatos específicos.

La elección de la actividad modifica la generación de los mensajes: revisa siempre los mensajes de TX antes de empezar a transmitir en un concurso.

9. Decodificación avanzada

Setup > Advanced > ADV DECODING reúne tres tecnologías de recuperación, que se pueden activar por separado o dejar en gestión automática:

Con Auto Mode activo, Decodium habilita las tres tecnologías solo cuando hacen falta, según las condiciones medidas; el campo Live state muestra cuáles están activas en cada momento.

El coste de estas opciones es CPU. En máquinas lentas, activarlas todas a mano empeora la situación en lugar de mejorarla: Auto Mode es la opción más sensata en la mayoría de los casos.

Otras opciones de decodificación están en Setup > Decode:

• DECODE PARAMETERS — profundidad y parámetros generales de decodificación;
• JT65 VHF/UHF — parámetros específicos para el uso en VHF/UHF;
• SIDELOBE CONTROL — control de los lóbulos laterales;
• DECODE FILTERS — filtros sobre las decodificaciones (véase el apartado 12.4).

10. Live Map, Astro y Time Sync

10.1 Live Map

El Live Map muestra las estaciones decodificadas y los trayectos entre tu estación y las suyas, con marcadores de color por dirección y estado. Se pone a cero automáticamente al cambiar de banda o de modo y cuando vacías las listas de decodificación, de modo que no queda en el mapa actividad que ya no es válida.

Durante la transmisión la actualización del mapa se ralentiza a propósito: es una decisión de prioridades, porque el hilo gráfico no debe robar tiempo a la transmisión.

Si no necesitas el mapa, cerrarlo libera GPU y memoria: es el primer panel que hay que sacrificar en hardware modesto.

10.2 Astro

El panel Astro proporciona los datos astronómicos útiles para EME y para la actividad en VHF/UHF: posición de la Luna, azimut y elevación, Doppler, degradación. El directorio de datos AzEl se configura en Setup > Audio > DIRECTORY.

10.3 Time Sync (DecoSyncTime)

El panel DecoSyncTime reúne todo lo relativo al tiempo:

• estado de NTP y desplazamiento aplicado;
• DT medio calculado sobre las decodificaciones recibidas;
• latencia de decodificación;
• número de muestras usadas para la estimación.

Cómo leerlo:

También hay una estimación de la deriva de la tarjeta de sonido en ppm, con indicador verde/ámbar/rojo: una deriva elevada desplaza progresivamente la temporización de las ranuras y es típica de los códecs USB económicos.

11. Log, servicios en línea e integraciones

11.1 Log local de QSO

Decodium mantiene el log ADIF local y la ventana QSO Log, con introducción y edición de QSO. Las opciones de comportamiento están en Setup > Reporting > LOGGING: confirmación antes de registrar, campos obligatorios, formato de los informes.

11.2 PSK Reporter

Decodium envía las observaciones a PSK Reporter y permite buscar tus propios spots desde el panel correspondiente. El envío funciona por cola: cuando no hay observaciones pendientes, no se mantiene ningún tráfico de fondo hacia el servicio.

11.3 QRZ Logbook, Cloudlog y LoTW

Para Cloudlog, Decodium normaliza el endpoint de la API y distingue en los mensajes de error los problemas de HTTP, de autenticación y de proxy: si la carga falla, el mensaje indica cuál de los tres es.

Los datos de LoTW sirven también para resaltar a los usuarios de LoTW en Full Spectrum (color LoTW marker).

11.4 DX Cluster

El panel DX Cluster se conecta a un nodo telnet y muestra los spots, con posibilidad de filtrado. La configuración está en Setup > Reporting > DX CLUSTER (host, puerto, indicativo de login, filtros).

11.5 Integración con programas externos

Si usas JTAlert o GridTracker, el UDP Server debe estar activo y el puerto debe coincidir con el configurado en el programa externo.

11.6 Grabación de audio

Setup > Reporting > RECORDING gestiona la grabación del audio recibido, útil para análisis posteriores y para adjuntar muestras reales a un informe de fallo.

12. Histórico de decodificaciones, filtros y alertas

12.1 Decode History

Decodium guarda las decodificaciones en una base de datos SQLite consultable desde la ventana History. Puedes buscar por:

• indicativo;
• banda;
• modo;
• intervalo de fechas UTC;
• límite de resultados.

Los resultados se pueden exportar a ADIF. El histórico sobrevive al cierre del programa y permite análisis posteriores a la actividad: comprobación de la propagación, revisión de la actividad en banda, reconstrucción de un QSO dudoso.

Las vistas en vivo en memoria están limitadas para que el consumo de RAM no crezca durante sesiones largas; el histórico completo permanece en la base de datos.

12.2 Alertas de audio

Setup > Alerts > AUDIO ALERTS permite asociar un sonido a eventos concretos: nuevo DXCC, nuevo grid, un indicativo que estás buscando, una llamada directa. Es la forma de trabajar en segundo plano sin mirar fijamente la pantalla.

12.3 Filtros: blacklist, whitelist y territorios

Setup > Filters contiene:

ALWAYS PASS tiene prioridad: es el lugar adecuado para el indicativo de un amigo que no quieres perder nunca, incluso cuando estás filtrando de forma agresiva.

12.4 Filtros de decodificación

Setup > Decode > DECODE FILTERS actúa más arriba, sobre el trabajo del decodificador y sobre lo que se publica en las listas. Usado con criterio, reduce la carga de CPU en una banda concurrida.

13. Panel web remoto y FT2-Link

13.1 Panel web remoto (iPad, móvil, PWA)

Decodium incluye un servidor web interno que permite controlar la estación desde otro dispositivo de la misma red local.

Activación

1. Abre Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) o Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Habilita el servidor y configura el puerto y las credenciales de acceso.
3. Averigua la dirección IP del ordenador de la estación.
4. Desde la tableta o el móvil abre http://DIRECCION-IP:PUERTO en el navegador.
5. Añade la página a la pantalla de inicio para usarla como aplicación (PWA).

Seguridad — leer antes de activarlo

• Usa el servidor solo en la red local. No lo expongas a internet y no abras puertos en el router.
• Pon una contraseña no trivial: quien llegue al panel puede mandar sobre tu estación y, por tanto, sobre tu transmisión.
• En redes compartidas (hoteles, radioclubes, ferias) mantén el servidor apagado cuando no lo uses.

La guía paso a paso para principiantes está en el archivo doc/WEBAPP_SETUP_GUIDE.es.md del código fuente, con la sección de resolución de problemas y la descripción de los endpoints de la API para usos avanzados.

13.2 FT2-Link (experimental)

FT2-Link es un protocolo abierto para chat y mensajes fiables, en desarrollo dentro de Decodium. Está documentado públicamente y es independiente del módem: el mismo ARQ puede funcionar sobre distintas formas de onda.

El funcionamiento previsto es: beacon o CQ en NARROW, respuesta HELLO, negociación del mejor perfil común, paso a W500 o W2300 para los datos, y regreso a NARROW si el perfil ancho no aguanta.

El periodo de trabajo de FT2-Link es de 15 segundos, distinto de los 3,75 s de FT2.

Atención. FT2-Link es material experimental y los perfiles W500/W2300 no son FT2 estándar y no deben presentarse como tales. Comprueba la normativa aplicable al ancho de banda que pretendes usar, en tu banda y en tu región IARU, antes de transmitir.

Parte III — Referencia

14. Referencia de los ajustes

Los ajustes están organizados en trece pestañas. A continuación se enumeran todas las secciones, en el orden en que aparecen, con la función de cada una.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

Los perfiles listos aplican de una sola vez un conjunto coherente de parámetros:

El perfil activo se indica con ● active. Puedes partir de un perfil y luego modificar opciones concretas: tus cambios siguen siendo tuyos y no se sobrescriben hasta que apliques otro perfil.

14.4.2 Watchdog

Mantén el watchdog activo. Es la protección que evita una portadora olvidada en la banda cuando sales de la habitación.

14.5 Display

Prioridad del proceso. High (recommended) es la opción aconsejada. Realtime está marcada con un aviso: en algunos sistemas puede dejar el ordenador poco reactivo o inestable. No la uses si no estás haciendo medidas específicas.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Gestión de las frecuencias de trabajo: lista por banda y modo, adición, modificación, carga y guardado en archivos .qrg / .qrg.json, con la posibilidad de fusionar (Merge Working Frequencies) una lista externa con la propia en lugar de sustituirla.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — asociación de sonidos a eventos (nuevo DXCC, nuevo grid, indicativo buscado, llamada directa).

14.12 Filters

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

14.13 UI Buttons

TOP TOOLBAR (visibilidad de los botones) y TOOLBAR BUTTON ORDER (orden, con restablecimiento de los valores por defecto para la barra y para el panel TX).

15. Atajos de teclado

Transmisión

Controles (Ctrl)

Acciones (Alt)

Otros

La lista completa se puede consultar dentro del programa en Keyboard Shortcuts.

16. Diagnóstico y resolución de problemas

16.1 No decodifico nada

Sigue este orden:

1. ¿Está activo Monitor? El botón debe estar en STOP.
2. ¿Se desplaza el waterfall? Si está parado, el problema es el dispositivo de entrada de audio, no el decodificador.
3. ¿El nivel de RX es razonable? Un ruido de fondo demasiado bajo, o el recorte, impiden la decodificación.
4. ¿Está sincronizado el reloj? Revisa el panel Time Sync. En FT2 y FT4 unas décimas de segundo bastan para perderlo todo.
5. ¿El modo es el correcto para esa frecuencia? FT8 en una frecuencia de FT4 no decodifica.
6. ¿El canal de audio es el correcto? Con un códec estéreo, el canal equivocado equivale al silencio.

16.2 Transmito pero nadie me contesta

• Comprueba que el PTT funcione y que la radio pase realmente a transmisión.
• Revisa la telemetría en Setup > Radio > DIAGNOSTICS: la potencia debe corresponder a la esperada y el ALC debe permanecer en reposo. El valor ALC -- significa que el dato no está disponible, mientras que 0 es un valor válido: son dos situaciones distintas.
• Comprueba el SWR: Check SWR no bloquea el Tune, así puedes medir y corregir, pero sí protege la transmisión real y el Auto CQ.
• Asegúrate de no estar transmitiendo fuera de la ranura: en FT2 la ventana de TX conservadora (apartado 6.3) rechaza las transmisiones tardías, y ese es el comportamiento correcto.

16.3 Problemas gráficos y de rendimiento

El indicador de presión de CPU en Setup > Display > UI — PERFORMANCE cuenta los eventos de sobrecarga de la sesión: si el contador severe crece, el ordenador no da la talla y conviene aligerar la configuración.

16.4 Audio bloqueado o portadora después de transmitir

Decodium incluye un watchdog de audio de TX que actúa precisamente en este caso. Si el problema se presenta:

1. usa Halt (o Esc);
2. comprueba que el PTT se haya liberado en la radio;
3. revisa el dispositivo de salida de audio en Setup > Audio;
4. si ocurre de forma sistemática, captura un log de diagnóstico e informa del caso.

16.5 Puertos CAT que cambian o aparecen duplicados

En Linux usa las rutas /dev/serial/by-id/..., que se mantienen estables entre reinicios. Si el mismo dispositivo aparece dos veces (como /dev/ttyUSB0 y como ruta by-id), elige la ruta by-id y no las dos: son el mismo dispositivo físico.

16.6 Informar de un fallo de forma útil

Decodium incluye una ventana de informe de fallos. Un informe útil contiene:

• la versión exacta del programa (About Decodium);
• el sistema operativo y la plataforma;
• la radio y el backend CAT en uso;
• el modo de operación y la frecuencia;
• la descripción de los pasos para reproducir el problema;
• el log de diagnóstico y, si el problema afecta a la decodificación, un archivo WAV de la señal;
• para los problemas de secuencia de FT2: activa FT2 state transition census (log only) y adjunta la traza.

17. Archivos, carpetas y datos del usuario

Decodium usa las carpetas estándar del sistema previstas por Qt para:

• los ajustes de configuración;
• la caché de QML;
• la base de datos SQLite del histórico de decodificaciones (db.sqlite);
• CTY.DAT y los datos de DXCC;
• el log ADIF;
• los logs de diagnóstico;
• las grabaciones de audio.

Las ubicaciones exactas dependen de la plataforma. La forma más fiable de encontrarlas es leer el log de arranque, donde Decodium imprime las rutas principales (AppDataLocation, CacheLocation, ruta de la base de datos).

Para una copia de seguridad completa de la configuración hacen falta: la carpeta de ajustes, el log ADIF y la base de datos del histórico.

Decodium incluye también una migración del almacenamiento: cuando la estructura de los datos cambia entre versiones, los archivos existentes se convierten en el primer arranque. Antes de una actualización importante, una copia de la carpeta de datos sigue siendo la precaución más sensata.

18. Compilar desde el código fuente

18.1 Dependencias

Según la plataforma hacen falta:

• CMake (3.20 o superior) y un compilador C/C++ reciente;
• Qt 6 con los módulos Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql y WebSockets;
• Hamlib;
• un compilador Fortran (gfortran) para los componentes heredados que siguen presentes;
• Boost y las demás dependencias indicadas en los archivos de compilación.

18.2 Scripts de compilación

El repositorio contiene scripts listos para las plataformas principales:

Las notas específicas de Windows están en doc/building on MS Windows.txt y en los archivos adyacentes; la migración a macOS está documentada en doc/MACOS_PORTING_v1.2.0.md.

18.3 Pruebas

El directorio tests/ contiene las pruebas unitarias y las comparaciones entre las implementaciones de los decodificadores, incluidas las pruebas dedicadas a FT2 y a FT2-Link. Para ejecutarlas:

ctest --output-on-failure

Las pruebas de comparación entre etapas de decodificación son la herramienta adecuada para verificar que un cambio en el decodificador no introduce una regresión de sensibilidad.

19. Glosario

20. Créditos, licencia y contactos

El proyecto

• Martino Merola — IU8LMC — creador de FT2, lead developer de DECODIUM
• Salvatore Raccampo — 9H1SR — núcleo C++, compilaciones y paquetes de macOS y Linux
• Los probadores y colaboradores de la comunidad FT2, cuyos informes han guiado gran parte del trabajo de las versiones recientes
• Los traductores de la comunidad, que mantienen las localizaciones del programa

Origen del código

Decodium desciende de la línea WSJT-X, desarrollada por Joe Taylor K1JT, Steve Franke K9AN, Bill Somerville G4WJS y los demás autores del proyecto, y distribuida bajo GPL. Los archivos AUTHORS, THANKS y COPYING incluidos con el código fuente recogen las atribuciones y la licencia completas. Las aportaciones propias de este proyecto — el protocolo FT2, los decodificadores y moduladores reescritos, la interfaz QML, los servicios integrados — están documentadas en el historial de commits y en CHANGELOG.md.

Licencia

Decodium 4.0 Core Shannon es software libre distribuido bajo la GNU General Public License versión 3. Puedes usarlo, estudiarlo, modificarlo y redistribuirlo según los términos de esa licencia. El programa se entrega sin ninguna garantía, dentro de los límites que permita la legislación aplicable.

Dónde encontrar ayuda

• Sitio del proyecto: ft2.it
• Comunidad y soporte: community.ft2.it
• Canal de Telegram FT2 Digital Mode
• Informes técnicos: sección Issues del repositorio de GitHub

Nota operativa final

Decodium controla un transmisor. La responsabilidad de lo que sale al aire —banda, ancho, potencia, horarios, autorizaciones— es del operador titular de la licencia. Las funciones experimentales del programa, en particular los perfiles anchos de FT2-Link y los modos multi-stream, deben usarse solo después de comprobar la normativa aplicable en tu banda y en tu región IARU.

73 de IU8LMC