Comment utiliser ce manuel

Le manuel est divisé en trois parties :

Les noms des commandes sont donnés tels qu'ils apparaissent dans l'interface en anglais (Monitor, Setup > Radio, Halt), car c'est la langue de référence du code. Si vous utilisez Decodium en français, en italien, en letton ou dans l'une des autres langues disponibles, les commandes se trouvent exactement aux mêmes endroits, et la traduction est indiquée là où elle peut créer un doute.

Note sur la disponibilité des fonctions. Decodium est compilé pour Windows, macOS et Linux avec des moteurs de décodage et des bibliothèques différents. Certaines fonctions décrites ici peuvent ne pas apparaître, ou apparaître désactivées, selon la plateforme, la radio raccordée et les options de compilation du paquet que vous avez téléchargé. Le manuel le signale là où c'est important.

Partie I — Installer et configurer

1. Introduction

1.1 Ce qu'est Decodium 4

Decodium 4.0 Core Shannon est une station numérique complète pour les modes à signal faible. Il est issu de la lignée WSJT-X / Decodium et la transpose sur une architecture différente : interface Qt 6 / QML, décodeurs et modulateurs progressivement réécrits en C++, gestion CAT intégrée avec plusieurs moteurs, waterfall et panadapter accélérés par le GPU, carte en temps réel, DX Cluster, PSK Reporter, journal de QSO et historique des décodages en base de données.

Avec Decodium 4 vous pouvez :

• recevoir et émettre en FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W et WSPR ;
• piloter la radio en CAT (Hamlib, moteurs natifs, Ham Radio Deluxe, OmniRig, TCI) ;
• mener des QSO manuels, Auto Sequence, Auto CQ, Multi Answer Mode et les modes DX-Pedition ;
• envoyer spots et QSO vers PSK Reporter, QRZ Logbook, Cloudlog, LoTW et vers des logiciels externes via UDP, ADIF TCP ou N1MM ;
• piloter la station depuis une tablette ou un téléphone grâce au tableau de bord web distant.

Le nom Core Shannon renvoie à Claude Shannon et à l'idée de fond du projet : traiter la communication numérique faible comme un problème d'information, de synchronisation, de robustesse et de fiabilité opérationnelle, et non comme un exercice de modulation.

1.2 Ce qui change par rapport à Decodium 3

Celui qui vient de Decodium 3 « Raptor » trouve trois différences de fond :

1. Une nouvelle interface. L'interface Qt Widgets a été remplacée par une interface QML dont les panneaux peuvent être ancrés, détachés et réorganisés, avec une disposition qui persiste d'une session à l'autre.
2. Un moteur en C++. Les décodeurs et modulateurs de la famille FTx ont été portés en C++, avec des tests de comparaison face aux anciennes routines. Des composants historiques subsistent pour certains modes VHF/UHF spécialisés.
3. Des services intégrés. Historique des décodages en SQLite, tableau de bord web, DX Cluster, télémétrie PWR/SWR/ALC et diagnostic de station font partie du programme et ne demandent aucun outil externe.

Le fichier CHANGELOG.md fourni avec les sources détaille les changements version par version.

1.3 FT2 en deux lignes

FT2 (Fast Track 2) est le mode numérique créé au sein de ce projet et certifié en ADIF avec MODE=MFSK et SUBMODE=FT2.

Le chapitre 6 est entièrement consacré à FT2 et à ses options.

1.4 Licence et sources

Decodium 4 est distribué sous GPL-3.0. Le texte complet de la licence figure dans le fichier COPYING fourni avec les sources et les paquets. Le code source est public sur GitHub, avec l'historique complet des commits et les versions téléchargeables.

2. Prérequis et installation

2.1 Prérequis

Systèmes d'exploitation pris en charge

• Windows 10 / 11 64 bits
• macOS sur Apple Silicon (et sur Intel là où le paquet est disponible)
• Linux x86_64 et aarch64, sous forme d'AppImage

Matériel minimum conseillé

• Un processeur quatre cœurs récent pour trafiquer en FT2 avec décodage asynchrone
• 4 Go de RAM (8 Go conseillés avec Live Map et panadapter actifs)
• Un GPU avec pilotes à jour : Decodium utilise Qt Quick/RHI et exploite l'accélération matérielle pour le waterfall, le panadapter et la carte
• Une carte son ou l'interface USB de la radio
• Une connexion internet pour NTP, DX Cluster, PSK Reporter et les mises à jour

Sur les machines plus modestes, le mode Slow-PC est disponible (section 4.9) : il réduit la charge graphique et la fréquence de rafraîchissement de l'interface.

2.2 Télécharger le paquet

1. Ouvrez la page Releases du dépôt officiel.
2. Téléchargez le paquet correspondant à votre système : - Windows : installeur x64 ; - macOS Apple Silicon / Intel : fichier .dmg ; - Linux : AppImage pour x86_64 ou aarch64.
3. Installez le paquet ou rendez le fichier exécutable, puis lancez Decodium.

2.3 Windows

Lancez l'installeur et suivez l'assistant. Au premier démarrage, Windows peut demander l'autorisation d'accès au réseau : elle est nécessaire si vous voulez utiliser NTP, DX Cluster, PSK Reporter, le tableau de bord web ou les mises à jour automatiques.

Les paquets Windows sont signés numériquement ; les notes sur la signature de code sont dans le fichier CODE_SIGNING_POLICY.md des sources.

2.4 macOS

Si macOS bloque l'application pour cause de quarantaine, retirez l'attribut de l'application installée :

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

Le nom exact de l'application peut varier selon le paquet produit.

macOS demande l'autorisation d'utiliser le microphone la première fois que Decodium ouvre l'entrée audio : sans cette autorisation, aucun signal n'atteint le décodeur.

2.5 Linux (AppImage)

Rendez l'AppImage exécutable et lancez-le :

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

Sur certaines distributions, libfuse2 est nécessaire ; vous pouvez aussi extraire le contenu manuellement :

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

Pour accéder aux ports série, l'utilisateur doit appartenir au bon groupe (dialout sur Debian/Ubuntu, uucp sur Arch). Une nouvelle ouverture de session est nécessaire après l'ajout.

2.6 Mises à jour

Decodium comporte une vérification des mises à jour (Setup > Advanced > DATA UPDATES). Lorsqu'une version plus récente est disponible, une fenêtre affiche les notes de version et le lien vers le paquet. La mise à jour n'efface ni les réglages, ni les journaux, ni l'historique des décodages.

3. Première configuration

Ce chapitre couvre le minimum indispensable pour faire le premier QSO. La référence complète de tous les réglages se trouve au chapitre 14.

Ouvrez les réglages avec le bouton ⚙ Setup de la barre supérieure.

3.1 Station — Setup > Station

Remplissez les champs de la section STATION DETAILS :

La section STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) n'a aucun effet sur l'émission : elle alimente le journal ADIF et les services externes. La remplir maintenant vous évite des journaux incomplets par la suite.

3.2 Radio et CAT — Setup > Radio

Dans la section BACKEND CAT, choisissez la façon dont Decodium dialogue avec la radio :

À cela s'ajoute Ham Radio Deluxe : Decodium peut fonctionner avec HRD lorsque la radio est déjà sous son contrôle.

Dans la section CAT CONTROL, réglez le port série, la vitesse, les bits de stop, le contrôle de flux et la méthode de PTT (CAT, RTS, DTR, VOX). Sous Linux, il est préférable d'utiliser les chemins stables /dev/serial/by-id/... plutôt que /dev/ttyUSB*, qui peuvent changer à chaque redémarrage.

Dans la section SPLIT OPERATION, choisissez le mode split :

• None — pas de split, le ton d'émission reste dans la bande audio ;
• Rig — split géré par la radio ;
• Fake It — Decodium décale la fréquence du VFO pour maintenir le ton d'émission dans une zone propre du filtre.

Fake It est le meilleur choix avec la plupart des radios modernes, car il tient le ton d'émission loin des flancs du filtre et réduit la distorsion à l'émission.

Vérifiez la liaison avec la section DIAGNOSTICS : vous devez voir la fréquence réelle de la radio, le changement de bande doit fonctionner dans les deux sens et le PTT doit faire passer la radio en émission avec Tune.

Modes data. Decodium s'efforce de préserver les modes DATA/PKT des radios Icom, Yaesu et Kenwood, afin de ne pas forcer la radio sur USB/LSB quand le réglage correct est DATA-U. Si vous constatez que la radio sort du mode data lorsque Decodium change de fréquence, vérifiez le mode configuré dans cette section.

Profils CAT. Vous pouvez enregistrer plusieurs configurations CAT sous forme de profils et les rappeler depuis le menu Profile. C'est le moyen le plus rapide de passer d'une radio à l'autre, ou de l'installation fixe à l'installation portable.

3.3 Audio — Setup > Audio

Dans la section AUDIO DEVICES, sélectionnez :

• Input : le périphérique qui reçoit l'audio de la radio (codec USB ou carte son) ;
• Output : le périphérique qui envoie l'audio vers la radio ;
• Canal : Mono, Left, Right ou Both, selon le câblage.

Dans la section LEVELS, réglez les niveaux RX et TX. Decodium dispose d'un ajustement automatique du niveau RX, actif par défaut, qui protège de l'écrêtage sans vous obliger à courir après le curseur : si vous le désactivez, visez un niveau de réception qui maintient le bruit de fond autour de 30 à 50 dB sur l'indicateur.

À l'émission, la règle des modes numériques reste valable : pas de compression, pas de traitement, ALC au repos. Montez le niveau TX jusqu'à la puissance souhaitée, et pas au-delà. La section 16.2 explique comment lire la télémétrie ALC pour le vérifier.

Sous Windows, le redémarrage du chemin audio après l'émission est volontairement énergique, afin d'éviter les tampons non vidés et les porteuses bloquées. Si vous remarquez un bref silence après chaque émission, c'est ce mécanisme qui fonctionne correctement.

3.4 Synchronisation de l'horloge

Pour FT8, FT4 et, de façon encore plus critique, pour FT2, la synchronisation du temps fait la différence entre décoder et ne rien décoder du tout.

Decodium comprend :

• un client NTP interne (Setup > Advanced > NTP TIME SYNC) ;
• le panneau DecoSyncTime, qui affiche le décalage, l'état de synchronisation, le DT moyen des décodages et la latence de décodage.

Activez Enable NTP et vérifiez que le panneau indique un état synchronisé. Un DT moyen systématiquement différent de zéro sur de nombreuses stations révèle un problème d'horloge locale, non de propagation.

3.5 Mode de trafic

Choisissez le mode dans le sélecteur de la barre supérieure. Pour le premier QSO :

1. Commencez par FT8 sur une fréquence standard : vous vérifiez ainsi l'audio, le CAT et le temps dans des conditions connues.
2. Vérifiez que des décodages apparaissent dans Full Spectrum en une ou deux périodes.
3. Passez seulement ensuite à FT2, beaucoup moins indulgent envers les erreurs de synchronisation et de configuration audio.

4. L'interface

4.1 Structure de la fenêtre

La fenêtre principale de Decodium 4 comprend :

4.2 La barre supérieure

Les boutons de la barre supérieure sont configurables (Setup > UI Buttons), à la fois en visibilité et en ordre :

Pour réordonner les boutons : appui prolongé puis glisser. Pour revenir à la disposition d'origine, utilisez Restore default button order dans Setup > UI Buttons.

4.3 Waterfall et panadapter

Le waterfall montre l'évolution du spectre dans le temps ; le panadapter montre le spectre instantané, avec l'échelle des fréquences audio en bas.

Principales manipulations :

• clic gauche sur le waterfall : déplace la fréquence audio de réception ;
• clic avec modificateur (selon la configuration) : déplace la fréquence audio d'émission ;
• molette : zoom ou défilement, selon la zone ;
• palettes : sélectionnables et personnalisables dans Setup > Colors > SPECTRUM.

Le waterfall peut être détaché dans sa propre fenêtre, rattaché ou minimisé. En disposition compacte, il utilise un seuil d'historique plus bas, ce qui réduit la mémoire et les textures sans perdre la partie visible.

4.4 Full Spectrum

Full Spectrum liste tous les décodages de la période en cours. Les colonnes affichées se configurent dans Setup > Display > DECODES et comprennent notamment la distance (Dist), l'azimut (Az) et la fréquence.

• double clic sur une ligne : sélectionne cette station comme correspondant du QSO et prépare les messages ;
• Clear : vide la liste ;
• le bouton de fin de liste (Go to the latest decode) ramène la vue en bas lorsque vous avez fait défiler vers le haut.

Les lignes sont colorées selon les règles de Setup > Colors > DECODE COLORS : nouveau DXCC, nouveau continent, nouvelle zone CQ ou ITU, nouveau locator, nouvel indicatif, CQ dans le message, 73/RR73, stations déjà contactées (B4), utilisateurs LoTW et messages émis.

4.5 Signal RX

Signal RX est la vue chirurgicale : elle n'affiche que ce qui concerne le QSO en cours et les stations qui vous appellent. Pendant un pile-up, c'est le panneau à surveiller, car Full Spectrum devient illisible.

4.6 Panneau TX

Le panneau TX contient :

• les messages TX1…TX7, que l'on peut générer et modifier ;
• l'état du QSO et du correspondant ;
• les commandes de trafic : Auto (Auto Sequence), Call, Hold, Tune, Halt ;
• la puissance TX et les commandes rapides d'émission.

L'ordre des boutons du panneau TX est également personnalisable, avec réinitialisation par Restore default TX panel order.

Halt (ou Échap) interrompt l'émission immédiatement : c'est la commande à connaître par cœur.

4.7 Disposition : ancrer, détacher, réinitialiser

Chaque panneau principal peut être :

• détaché dans une fenêtre indépendante (Detach), utile avec plusieurs écrans ;
• rattaché à la disposition (Dock) ;
• masqué puis restauré (Restore …) ;
• déplacé d'une colonne à l'autre par glissement ;
• ramené à son état initial avec Reset Layout.

La disposition est enregistrée à la fermeture et rechargée au démarrage suivant, y compris les fenêtres détachées et leur position.

4.8 Mode compact

Le mode compact réduit la hauteur des en-têtes et des lignes afin d'afficher plus de décodages à l'écran. C'est le bon choix sur les portables et les petits écrans.

4.9 Mode Slow-PC

Slow-PC mode réduit la charge d'interface et de graphisme : rafraîchissement du waterfall moins fréquent, moins d'animations, moins de travail dans le fil graphique. Activez-le si vous constatez des saccades dans l'interface ou des retards de décodage sur des machines anciennes : en FT2, une interface à la peine peut vous faire manquer le créneau d'émission.

4.10 Thèmes et apparence

Dans Setup > Display > ASPETTO / TEMA, vous choisissez le thème (y compris le thème sombre), les couleurs de l'interface et les polices. Dans Setup > Display > FONT, on règle la police des décodages : utilisez une police à largeur fixe, sinon les colonnes des messages ne s'alignent pas.

Partie II — Trafic

5. Le QSO : de la réception au journal

5.1 Démarrer la réception

1. Appuyez sur Monitor : le bouton passe à STOP et le waterfall commence à défiler.
2. Vérifiez que le niveau RX n'écrête pas.
3. Attendez une ou deux périodes : les décodages apparaissent dans Full Spectrum à la fin de chaque créneau.

Si vous ne décodez rien alors que le waterfall montre des signaux, le problème vient presque toujours de l'horloge (section 3.4) ou d'un mode inadapté à la fréquence.

5.2 Appeler une station

1. Double clic sur la ligne de la station dans Full Spectrum ou Signal RX. Decodium fixe le correspondant, génère les messages et choisit le bon créneau.
2. Vérifiez la fréquence audio d'émission : dans les modes FTx, la bonne pratique est d'émettre dans une zone libre du spectre, et non sur la station que vous appelez.
3. Contrôlez les messages générés dans le panneau TX.
4. Activez l'émission.
5. Avec Auto Sequence actif, Decodium mène le QSO à son terme tout seul : report, confirmation, RR73/73.

5.3 Appeler CQ

1. Sélectionnez TX6 (le message de CQ).
2. Activez l'émission, ou Auto CQ pour appeler de façon cyclique.
3. Suivez Signal RX pour les réponses directes.
4. Laissez travailler Auto Sequence ou intervenez manuellement.

Avec Auto CQ actif, Decodium se remet à appeler CQ à la fin de chaque QSO, sous réserve des protections configurées (watchdog, contrôle du ROS, limites de répétitions).

5.4 Auto Sequence et ses options

Setup > TX > AUTO SEQUENCE rassemble les règles qui gouvernent l'automatisme :

Quick QSO est conçu pour les concours et le trafic à cadence élevée : il réduit le QSO à quatre échanges tout en produisant un journal valable.

5.5 Répétitions et clôture du QSO

Setup > TX > FT2 UTILITY contient les paramètres de clôture du QSO, avec des valeurs distinctes pour FT2, FT4 et FT8 :

L'ensemble de ces options a un but précis : clôturer les QSO faibles sans occuper la fréquence indéfiniment. Si vous chassez du DX marginal, augmentez le renfort pour les correspondants très faibles ; si vous faites du concours, gardez les répétitions basses.

5.6 Enregistrer le QSO au journal

À la clôture du QSO, Decodium ouvre la fenêtre de confirmation du journal (si Prompt to log QSO est actif dans Setup > Reporting > LOGGING). Le QSO est écrit dans le journal ADIF local et, si les services sont configurés, transmis à QRZ Logbook, Cloudlog, LoTW et aux logiciels externes raccordés.

Alt+L enregistre le QSO en cours sans passer par la souris.

5.7 Worked-before (B4)

Decodium reconnaît les stations déjà contactées en distinguant indicatif, bande et mode ensemble. Un QSO en FT2 sur 20 m ne marque pas comme déjà contacté le même indicatif en FT8 sur 20 m ni en FT2 sur 40 m. La couleur B4 dans Full Spectrum signale donc un véritable doublon, et les mises en évidence « nouveau DXCC / locator / zone » restent fiables même si vous changez de mode en cours de session.

6. Trafiquer en FT2

FT2 est le mode autour duquel ce projet est né et reste son objectif principal. Ce chapitre rassemble en un seul endroit tout ce qui concerne FT2.

6.1 Ce qu'il faut attendre de FT2

Le créneau FT2 est de 3,75 secondes et l'émission dure environ 2,52 secondes. Cela signifie deux choses :

1. La cadence des QSO est bien plus élevée qu'en FT8 et sensiblement plus élevée qu'en FT4 : c'est son avantage en concours, en pile-up et en expédition, là où le goulot d'étranglement est le temps par QSO et non la sensibilité.
2. Le temps disponible pour décoder, décider et préparer l'émission est réduit. La configuration audio, l'exactitude de l'horloge et la charge du processeur comptent bien davantage qu'en FT8.

FT2 n'est pas un mode « meilleur que FT8 » : c'est un mode rapide, optimisé pour des conditions où le signal est présent et où le temps est la ressource rare.

6.2 Décodage asynchrone

Decodium décode FT2 de façon asynchrone : au lieu d'attendre la fin du créneau pour tout traiter d'un bloc, il travaille sur des lots qui se recouvrent pendant que le signal arrive encore. Cela réduit le délai entre la fin de l'émission de la station correspondante et l'apparition du message à l'écran — un temps dont on a besoin en totalité, en FT2, pour répondre dans le bon créneau.

L'état du décodage asynchrone est visible avec le bouton Async FT2 (A) de la barre supérieure.

6.3 L'ordonnanceur d'émission

L'ordonnanceur TX de FT2 suit une règle non négociable : ne jamais commencer une émission qui ne peut pas se terminer dans le créneau. Une émission tronquée n'est décodée par personne et ne fait que polluer la fréquence.

D'où les protections suivantes :

Si vous voyez vos émissions démarrer puis se faire couper, la première chose à vérifier est la synchronisation du temps ; la seconde, la fenêtre d'émission conservatrice.

6.4 Les options de robustesse FT2

Ces options s'adressent aux signaux faibles, instables ou soumis au QSB. Ne les activez pas toutes « au cas où » : chacune coûte du processeur ou de la latence.

Configuration conseillée pour débuter : laissez les valeurs par défaut, activez FT2 partner-memory si vous travaillez du DX en QSB, et n'activez Conservative FT2 que lorsque vous poursuivez des signaux à la limite.

6.5 Protections du journal et des messages

Cette dernière option est utile lorsqu'il faut signaler un problème de séquence : elle produit la trace exacte des états parcourus, ce qui est précisément ce dont on a besoin pour reproduire l'anomalie.

6.6 Gestion des indicatifs et des empreintes

FT2, comme FT8 et FT4, comprime les indicatifs. Les indicatifs longs ou composés circulent sous forme d'empreinte (hash) et sont résolus par le récepteur à partir des indicatifs déjà vus. Decodium comporte des protections contre les ghost calls (indicatifs apparemment décodés mais réellement absents) et contre les charges utiles non résolues : si un message ne peut pas être attribué avec certitude, il ne sert pas à faire avancer la séquence du QSO.

Ce comportement est délibéré : mieux vaut un QSO non terminé qu'un QSO enregistré avec le mauvais indicatif.

6.7 FT2 sur processeurs limités

Sur les machines lentes :

1. activez Slow-PC mode ;
2. activez FT2: adaptive decode (CPU saver) ;
3. envisagez FT2: skip redundant end-slot decode ;
4. réduisez la hauteur du waterfall et l'historique visible ;
5. fermez Live Map si vous n'en avez pas besoin.

La priorité en FT2 est toujours la même : d'abord la synchronisation, ensuite la sensibilité, et en dernier l'esthétique de l'interface.

7. Multi Answer Mode et file d'attente des appelants

7.1 De quoi il s'agit

Multi Answer Mode (MAM) permet de traiter plusieurs appelants en parallèle, en maintenant plus d'un QSO actif à la fois. Le panneau MAM affiche les flux actifs et permet d'ajouter des stations par double clic.

L'opérateur reste responsable : MAM organise le travail, il ne l'autorise pas. Avant de l'utiliser sur une fréquence chargée, assurez-vous que votre signal et votre configuration sont propres.

7.2 Multi-flux

Setup > TX > FT2 UTILITY contient :

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — active la gestion de plusieurs flux simultanés ;
• MAM multi-stream: max stream simultanei — combien de flux autoriser.

L'option est marquée expérimentale : elle augmente le nombre d'émissions simultanées, et donc aussi les occasions de se tromper. Commencez par deux flux.

7.3 File d'attente des appelants

Le panneau Caller Queue rassemble les stations qui vous appellent et permet de les ordonner selon des critères de trafic. C'est l'outil naturel lorsque vous appelez CQ depuis une station recherchée et que les réponses arrivent plus vite que vous ne pouvez les traiter.

8. Modes DX-Pedition et concours

8.1 Fox / Hound / SuperFox

Dans Setup > Advanced > OPERATING MODE :

Les réglages OTP (Setup > Advanced > OTP : OTP Enabled, OTP Seed, OTP Interval, OTP URL) concernent la production et la diffusion des codes servant à vérifier une activité : ils intéressent l'organisateur d'une expédition, non l'appelant individuel.

8.2 DX-Pedition Workspace

Le DX-Pedition Workspace est une disposition dédiée qui place côte à côte, dans une seule vue, Full Spectrum · Decode, Signal RX · QSO Lock et Log · QSO Entry, avec l'heure UTC et l'indicatif de l'opérateur. Il est conçu pour les tours d'opérateur sur une station recherchée, où il faut garder sous les yeux en même temps l'activité de la bande, le QSO en cours et la saisie du journal.

8.3 Concours

Setup > Advanced > CONTEST définit l'activité en cours :

• Activity : None, Field Day, Fox, Hound ;
• FD Exchange et RTTY Exchange : les échanges prévus par le règlement ;
• Contest Name, Indiv Name, NCCC Sprint : paramètres des formats particuliers.

Le choix de l'activité modifie la génération des messages : vérifiez toujours les messages TX avant de commencer à émettre en concours.

9. Décodage avancé

Setup > Advanced > ADV DECODING rassemble trois techniques de récupération, activables séparément ou gérées automatiquement :

Avec Auto Mode actif, Decodium n'active les trois techniques que lorsqu'elles sont nécessaires, d'après les conditions mesurées ; le champ Live state indique lesquelles sont actives à un instant donné.

Le coût de ces options est le temps processeur. Sur les machines lentes, les activer toutes à la main aggrave la situation au lieu de l'améliorer : Auto Mode est le choix le plus raisonnable dans la plupart des cas.

D'autres options de décodage se trouvent dans Setup > Decode :

• DECODE PARAMETERS — profondeur et paramètres généraux de décodage ;
• JT65 VHF/UHF — paramètres propres à l'usage VHF/UHF ;
• SIDELOBE CONTROL — contrôle des lobes secondaires ;
• DECODE FILTERS — filtres sur les décodages (voir section 12.4).

10. Live Map, Astro et Time Sync

10.1 Live Map

La Live Map affiche les stations décodées et les trajets entre votre station et les leurs, avec des marqueurs colorés selon la direction et l'état. Elle se réinitialise automatiquement au changement de bande ou de mode et lorsque vous videz les listes de décodage, afin qu'aucune activité périmée ne subsiste sur la carte.

Pendant l'émission, la carte est volontairement rafraîchie plus lentement : c'est un choix de priorité, car le fil graphique ne doit pas voler du temps à l'émission.

Si la carte ne vous sert pas, la fermer libère du GPU et de la mémoire — c'est le premier panneau à sacrifier sur un matériel modeste.

10.2 Astro

Le panneau Astro fournit les données astronomiques utiles à l'EME et au trafic VHF/UHF : position de la Lune, azimut et élévation, Doppler, dégradation. Le répertoire des données AzEl se configure dans Setup > Audio > DIRECTORY.

10.3 Time Sync (DecoSyncTime)

Le panneau DecoSyncTime réunit tout ce qui touche au temps :

• état NTP et décalage appliqué ;
• DT moyen calculé sur les décodages reçus ;
• latence de décodage ;
• nombre d'échantillons utilisés pour l'estimation.

Comment le lire :

Il existe aussi une estimation de la dérive de la carte son en ppm, avec un indicateur vert/orange/rouge : une dérive importante décale progressivement la synchronisation des créneaux et est typique des codecs USB bon marché.

11. Journal, services en ligne et intégrations

11.1 Journal de QSO local

Decodium tient le journal ADIF local et la fenêtre QSO Log, avec saisie et modification des QSO. Les options de comportement se trouvent dans Setup > Reporting > LOGGING : confirmation avant enregistrement, champs obligatoires, format des reports.

11.2 PSK Reporter

Decodium envoie les observations à PSK Reporter et permet de rechercher vos propres spots depuis le panneau dédié. L'envoi fonctionne par file d'attente : lorsqu'il n'y a pas d'observation à transmettre, aucun trafic de fond n'est maintenu vers le service.

11.3 QRZ Logbook, Cloudlog et LoTW

Pour Cloudlog, Decodium normalise le point d'accès de l'API et distingue dans ses messages d'erreur les problèmes HTTP, d'authentification et de proxy : si l'envoi échoue, le message indique lequel des trois est en cause.

Les données LoTW servent aussi à la mise en évidence des utilisateurs LoTW dans Full Spectrum (couleur LoTW marker).

11.4 DX Cluster

Le panneau DX Cluster se connecte à un nœud telnet et affiche les spots, avec possibilité de filtrage. La configuration se trouve dans Setup > Reporting > DX CLUSTER (hôte, port, indicatif de connexion, filtres).

11.5 Intégration avec des logiciels externes

Si vous utilisez JTAlert ou GridTracker, le serveur UDP doit être actif et le port doit correspondre à celui configuré dans le programme externe.

11.6 Enregistrement audio

Setup > Reporting > RECORDING gère l'enregistrement de l'audio reçu, utile pour des analyses ultérieures et pour joindre des échantillons réels à un rapport d'anomalie.

12. Historique des décodages, filtres et alertes

12.1 Decode History

Decodium enregistre les décodages dans une base SQLite consultable depuis la fenêtre History. Vous pouvez chercher par :

• indicatif ;
• bande ;
• mode ;
• intervalle de dates UTC ;
• limite de résultats.

Les résultats sont exportables en ADIF. L'historique survit à la fermeture du programme et permet des analyses après coup : vérification de la propagation, contrôle de l'activité sur la bande, reconstitution d'un QSO douteux.

Les vues en direct conservées en mémoire sont plafonnées afin que la consommation de RAM ne croisse pas au cours des longues sessions ; l'historique complet reste dans la base.

12.2 Alertes sonores

Setup > Alerts > AUDIO ALERTS permet d'associer un son à des événements précis : nouveau DXCC, nouveau locator, indicatif recherché, appel direct. C'est la façon de travailler en arrière-plan sans fixer l'écran.

12.3 Filtres : liste noire, liste blanche et territoires

Setup > Filters contient :

ALWAYS PASS a la priorité : c'est l'endroit où mettre l'indicatif d'un ami que vous ne voulez jamais manquer, même lorsque vous filtrez agressivement.

12.4 Filtres de décodage

Setup > Decode > DECODE FILTERS agit plus en amont, sur le travail du décodeur et sur ce qui est publié dans les listes. Utilisé avec discernement, il réduit la charge processeur sur une bande chargée.

13. Tableau de bord web distant et FT2-Link

13.1 Tableau de bord web distant (iPad, téléphone, PWA)

Decodium comprend un serveur web interne qui permet de piloter la station depuis un autre appareil du même réseau local.

Activation

1. Ouvrez Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) ou Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Activez le serveur et définissez le port et les identifiants d'accès.
3. Relevez l'adresse IP de l'ordinateur de station.
4. Depuis la tablette ou le téléphone, ouvrez http://ADRESSE-IP:PORT dans le navigateur.
5. Ajoutez la page à l'écran d'accueil pour l'utiliser comme une application (PWA).

Sécurité — à lire avant d'activer

• Utilisez le serveur sur le réseau local uniquement. Ne l'exposez pas à internet et n'ouvrez pas de ports sur le routeur.
• Choisissez un mot de passe non trivial : qui atteint le tableau de bord peut commander votre station, donc votre émission.
• Sur les réseaux partagés (hôtels, radio-clubs, salons), laissez le serveur éteint quand vous ne l'utilisez pas.

Le guide pas à pas pour débutants se trouve dans le fichier doc/WEBAPP_SETUP_GUIDE.en-GB.md des sources, avec la section de dépannage et la description des points d'accès de l'API pour les usages avancés.

13.2 FT2-Link (expérimental)

FT2-Link est un protocole ouvert de messagerie et de dialogue fiable, en développement au sein de Decodium. Il est documenté publiquement et indépendant du modem : le même ARQ peut fonctionner sur des formes d'onde différentes.

Le fonctionnement prévu est le suivant : balise ou CQ en NARROW, réponse HELLO, négociation du meilleur profil commun, passage à W500 ou W2300 pour les données, et retour à NARROW si le profil large ne tient pas.

La période de travail de FT2-Link est de 15 secondes, contrairement aux 3,75 s de FT2.

Attention. FT2-Link est un matériel expérimental, et les profils W500/W2300 ne sont pas du FT2 standard et ne doivent pas être présentés comme tels. Vérifiez la réglementation applicable à la largeur de bande que vous comptez employer, dans votre bande et dans votre région IARU, avant d'émettre.

Partie III — Référence

14. Référence des réglages

Les réglages sont organisés en treize onglets. Toutes les sections sont énumérées ci-dessous, dans l'ordre où elles apparaissent, avec leur fonction.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

Les profils prêts à l'emploi appliquent d'un seul geste un ensemble cohérent de paramètres :

Le profil actif est signalé par ● active. Vous pouvez partir d'un profil puis modifier certaines options : vos modifications restent les vôtres et ne sont pas écrasées jusqu'à ce que vous appliquiez un autre profil.

14.4.2 Watchdog

Laissez le watchdog actif. C'est la protection qui évite une porteuse oubliée sur la bande quand vous quittez la pièce.

14.5 Display

Priorité du processus. High (recommended) est le réglage conseillé. Realtime porte un avertissement : sur certains systèmes, il peut rendre l'ordinateur peu réactif ou instable. Ne l'utilisez pas si vous ne faites pas de mesures particulières.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Gestion des fréquences de travail : liste par bande et par mode, ajout, modification, chargement et enregistrement dans des fichiers .qrg / .qrg.json, avec la possibilité de fusionner (Merge Working Frequencies) une liste externe avec la vôtre au lieu de la remplacer.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — association de sons à des événements (nouveau DXCC, nouveau locator, indicatif recherché, appel direct).

14.12 Filters

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

14.13 UI Buttons

TOP TOOLBAR (visibilité des boutons) et TOOLBAR BUTTON ORDER (ordre, avec retour aux valeurs par défaut pour la barre et pour le panneau TX).

15. Raccourcis clavier

Émission

Commandes (Ctrl)

Actions (Alt)

Divers

La liste complète est consultable dans le programme, à la rubrique Keyboard Shortcuts.

16. Diagnostic et dépannage

16.1 Je ne décode rien

Procédez dans cet ordre :

1. Monitor est-il actif ? Le bouton doit afficher STOP.
2. Le waterfall défile-t-il ? S'il est figé, le problème vient du périphérique d'entrée audio, non du décodeur.
3. Le niveau RX est-il raisonnable ? Un bruit de fond beaucoup trop faible, comme l'écrêtage, empêche le décodage.
4. L'horloge est-elle synchronisée ? Vérifiez le panneau Time Sync. En FT2 et FT4, quelques dixièmes de seconde suffisent à tout perdre.
5. Le mode correspond-il à la fréquence ? FT8 sur une fréquence FT4 ne décode rien.
6. Le canal audio est-il le bon ? Avec un codec stéréo, le mauvais canal équivaut au silence.

16.2 J'émets mais personne ne me répond

• Vérifiez que le PTT fonctionne et que la radio passe réellement en émission.
• Vérifiez la télémétrie dans Setup > Radio > DIAGNOSTICS : la puissance doit correspondre à celle attendue et l'ALC doit rester au repos. L'affichage ALC -- signifie que la donnée n'est pas disponible, tandis que 0 est une valeur valable : ce sont deux situations différentes.
• Vérifiez le ROS : Check SWR ne bloque pas le Tune, ce qui permet de mesurer et de corriger, mais protège bien l'émission réelle et l'Auto CQ.
• Assurez-vous de ne pas émettre en dehors du créneau : en FT2, la fenêtre d'émission conservatrice (section 6.3) refuse les émissions tardives, et c'est le comportement correct.

16.3 Problèmes graphiques et de performance

L'indicateur de pression processeur dans Setup > Display > UI — PERFORMANCE compte les événements de surcharge de la session : si le compteur severe augmente, l'ordinateur ne suit pas et il faut alléger la configuration.

16.4 Audio bloqué ou porteuse après l'émission

Decodium comporte un watchdog audio TX prévu précisément pour ce cas. Si le problème survient :

1. utilisez Halt (ou Esc) ;
2. vérifiez que le PTT a bien été relâché à la radio ;
3. vérifiez le périphérique de sortie audio dans Setup > Audio ;
4. si cela se produit systématiquement, relevez un journal de diagnostic et signalez le cas.

16.5 Ports CAT qui changent ou apparaissent en double

Sous Linux, utilisez les chemins /dev/serial/by-id/..., qui restent stables d'un redémarrage à l'autre. Si le même appareil apparaît deux fois (comme /dev/ttyUSB0 et comme chemin by-id), choisissez le chemin by-id et non les deux : il s'agit du même matériel.

16.6 Signaler une anomalie utilement

Decodium comporte une fenêtre de signalement d'anomalie. Un signalement utile contient :

• la version exacte du programme (About Decodium) ;
• le système d'exploitation et la plateforme ;
• la radio et le moteur CAT utilisés ;
• le mode de trafic et la fréquence ;
• la description des étapes qui reproduisent le problème ;
• le journal de diagnostic et, si le problème concerne le décodage, un fichier WAV du signal ;
• pour les problèmes de séquence FT2 : activez FT2 state transition census (log only) et joignez la trace.

17. Fichiers, dossiers et données utilisateur

Decodium utilise les dossiers système standard prévus par Qt pour :

• les réglages de configuration ;
• le cache QML ;
• la base SQLite de l'historique des décodages (db.sqlite) ;
• CTY.DAT et les données DXCC ;
• le journal ADIF ;
• les journaux de diagnostic ;
• les enregistrements audio.

Les emplacements exacts dépendent de la plateforme. Le moyen le plus fiable de les trouver est de lire le journal de démarrage, où Decodium affiche les chemins principaux (AppDataLocation, CacheLocation, chemin de la base de données).

Pour une sauvegarde complète de la configuration, il faut : le dossier des réglages, le journal ADIF et la base de l'historique.

Decodium comporte également une migration du stockage : lorsque la structure des données change entre deux versions, les fichiers existants sont convertis au premier démarrage. Avant une mise à jour importante, une copie du dossier de données reste tout de même la précaution raisonnable.

18. Compiler depuis les sources

18.1 Dépendances

Selon la plateforme, il faut :

• CMake (3.20 ou plus récent) et un compilateur C/C++ récent ;
• Qt 6 avec les modules Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql et WebSockets ;
• Hamlib ;
• un compilateur Fortran (gfortran) pour les composants historiques encore présents ;
• Boost et les autres dépendances indiquées dans les fichiers de compilation.

18.2 Scripts de compilation

Le dépôt contient des scripts prêts à l'emploi pour les principales plateformes :

Les notes propres à Windows sont dans doc/building on MS Windows.txt et les fichiers voisins ; le portage macOS est documenté dans doc/MACOS_PORTING_v1.2.0.md.

18.3 Tests

Le répertoire tests/ contient les tests unitaires et les comparaisons entre les implémentations des décodeurs, y compris les tests dédiés à FT2 et à FT2-Link. Pour les exécuter :

ctest --output-on-failure

Les tests de comparaison entre étages de décodage sont l'outil adapté pour vérifier qu'une modification du décodeur n'a pas introduit de régression de sensibilité.

19. Glossaire

20. Crédits, licence et contacts

Le projet

• Martino Merola — IU8LMC — créateur de FT2, lead developer de DECODIUM
• Salvatore Raccampo — 9H1SR — cœur C++, compilations et paquets macOS et Linux
• Les testeurs et contributeurs de la communauté FT2, dont les rapports ont guidé une grande part du travail sur les versions récentes
• Les traducteurs de la communauté, qui maintiennent les localisations du programme

Origine du code

Decodium descend de la lignée WSJT-X, développée par Joe Taylor K1JT, Steve Franke K9AN, Bill Somerville G4WJS et les autres auteurs du projet, et distribuée sous GPL. Les fichiers AUTHORS, THANKS et COPYING fournis avec les sources donnent les attributions et la licence complètes. Les apports propres à ce projet — le protocole FT2, les décodeurs et modulateurs réécrits, l'interface QML, les services intégrés — sont documentés dans l'historique des commits et dans CHANGELOG.md.

Licence

Decodium 4.0 Core Shannon est un logiciel libre distribué sous GNU General Public License version 3. Vous pouvez l'utiliser, l'étudier, le modifier et le redistribuer selon les termes de cette licence. Le programme est fourni sans aucune garantie, dans les limites autorisées par le droit applicable.

Où trouver de l'aide

• Site du projet : ft2.it
• Communauté et assistance : community.ft2.it
• Canal Telegram FT2 Digital Mode
• Signalements techniques : section Issues du dépôt GitHub

Note finale de trafic

Decodium pilote un émetteur. La responsabilité de ce qui passe en l'air — bande, largeur, puissance, horaires, autorisations — appartient à l'opérateur titulaire de la licence. Les fonctions expérimentales du programme, en particulier les profils larges de FT2-Link et les modes multi-flux, ne doivent être employées qu'après vérification de la réglementation applicable dans votre bande et votre région IARU.

73 de IU8LMC