So verwenden Sie dieses Handbuch

Das Handbuch ist in drei Teile gegliedert:

Die Bezeichnungen der Bedienelemente werden so angegeben, wie sie in der englischsprachigen Oberfläche erscheinen (Monitor, Setup > Radio, Halt), denn Englisch ist die Referenzsprache des Programmcodes. Wenn Sie Decodium auf Deutsch, Italienisch, Lettisch oder in einer der anderen verfügbaren Sprachen betreiben, befinden sich die Bedienelemente an genau denselben Stellen; die Übersetzung wird dort angegeben, wo Verwechslungen möglich sind.

Hinweis zur Verfügbarkeit von Funktionen. Decodium wird für Windows, macOS und Linux mit unterschiedlichen Decoder-Backends und Bibliotheken erstellt. Einzelne hier beschriebene Funktionen können fehlen oder deaktiviert sein — je nach Plattform, angeschlossenem Funkgerät und Build-Optionen des Pakets, das Sie heruntergeladen haben. Das Handbuch weist darauf hin, wo es relevant ist.

Teil I — Installation und Konfiguration

1. Einführung

1.1 Was Decodium 4 ist

Decodium 4.0 Core Shannon ist eine vollständige Digitalstation für Schwachsignal-Betriebsarten. Es entstand aus der Linie WSJT-X / Decodium und überführt sie in eine andere Architektur: Qt 6 / QML-Oberfläche, schrittweise nach C++ portierte Decoder und Modulatoren, integrierte CAT-Steuerung mit mehreren Backends, GPU-beschleunigter Wasserfall und Panadapter, Live-Karte, DX-Cluster, PSK Reporter, QSO-Log und eine dauerhafte Decode-Historie in einer Datenbank.

Mit Decodium 4 können Sie:

• in FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W und WSPR empfangen und senden;
• das Funkgerät über CAT steuern (Hamlib, native Backends, Ham Radio Deluxe, OmniRig, TCI);
• manuelle QSOs, Auto Sequence, Auto CQ, Multi Answer Mode und die DX-Pedition-Modi betreiben;
• Spots und Logs an PSK Reporter, QRZ Logbook, Cloudlog, LoTW sowie an externe Programme über UDP, ADIF TCP oder N1MM senden;
• die Station über das Web-Dashboard von einem Tablet oder Smartphone aus bedienen.

Der Name Core Shannon verweist auf Claude Shannon und auf den Grundgedanken des Projekts: schwache digitale Kommunikation als Problem von Information, Synchronisation, Robustheit und Betriebssicherheit zu behandeln — nicht als Modulationsübung.

1.2 Was sich gegenüber Decodium 3 geändert hat

Wer von Decodium 3 "Raptor" kommt, findet drei wesentliche Unterschiede:

1. Neue Oberfläche. Die Qt-Widgets-Oberfläche wurde durch eine QML-Oberfläche ersetzt, deren Panels angedockt, abgedockt und umgeordnet werden können und deren Layout über Sitzungen hinweg erhalten bleibt.
2. C++-Motor. Decoder und Modulatoren der FTx-Familie wurden nach C++ migriert, mit Vergleichstests gegen die früheren Routinen. Für einige spezialisierte VHF/UHF-Betriebsarten bestehen Legacy-Komponenten weiter.
3. Integrierte Dienste. Decode-Historie in SQLite, Web-Dashboard, DX-Cluster, PWR/SWR/ALC-Telemetrie und Stationsdiagnose sind Teil des Programms und benötigen keine externen Werkzeuge.

Die Datei CHANGELOG.md im Quellcode beschreibt die Änderungen Release für Release.

1.3 FT2 in zwei Zeilen

FT2 (Fast Track 2) ist die in diesem Projekt entstandene digitale Betriebsart, in ADIF zertifiziert mit MODE=MFSK und SUBMODE=FT2.

Kapitel 6 ist vollständig FT2 und seinen Optionen gewidmet.

1.4 Lizenz und Quellcode

Decodium 4 wird unter GPL-3.0 verbreitet. Der vollständige Lizenztext liegt in der Datei COPYING, die dem Quellcode und den Paketen beigefügt ist. Der Quellcode ist auf GitHub öffentlich, mit vollständiger Commit-Historie und herunterladbaren Releases.

2. Voraussetzungen und Installation

2.1 Voraussetzungen

Unterstützte Betriebssysteme

• Windows 10 / 11, 64 Bit
• macOS auf Apple Silicon (und auf Intel, wo das Paket verfügbar ist)
• Linux x86_64 und aarch64, als AppImage

Empfohlene Mindestausstattung

• Aktuelle Vierkern-CPU für FT2-Betrieb mit asynchroner Dekodierung
• 4 GB RAM (8 GB empfohlen bei aktiver Live Map und aktivem Panadapter)
• GPU mit aktuellen Treibern: Decodium nutzt Qt Quick/RHI und die Hardwarebeschleunigung für Wasserfall, Panadapter und Karte
• Soundkarte oder USB-Schnittstelle des Funkgeräts
• Internetverbindung für NTP, DX-Cluster, PSK Reporter und Aktualisierungen

Auf schwächeren Rechnern steht der Slow-PC-Modus zur Verfügung (Abschnitt 4.9), der Grafiklast und Aktualisierungsrate der Oberfläche reduziert.

2.2 Paket herunterladen

1. Öffnen Sie die Seite Releases des offiziellen Repositorys.
2. Laden Sie das Paket für Ihr System herunter: - Windows: x64-Installer; - macOS Apple Silicon / Intel: .dmg-Datei; - Linux: AppImage für x86_64 oder aarch64.
3. Installieren Sie das Paket oder machen Sie die Datei ausführbar und starten Sie Decodium.

2.3 Windows

Führen Sie den Installer aus und folgen Sie dem Assistenten. Beim ersten Start kann Windows nach Netzwerkzugriff fragen: Er muss erteilt werden, wenn Sie NTP, DX-Cluster, PSK Reporter, das Web-Dashboard oder automatische Aktualisierungen nutzen wollen.

Die Windows-Pakete sind digital signiert; die Hinweise zur Codesignatur stehen in der Datei CODE_SIGNING_POLICY.md im Quellcode.

2.4 macOS

Wenn macOS die Anwendung wegen Quarantäne blockiert, entfernen Sie das Attribut von der installierten App:

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

Der genaue Name der App kann je nach erzeugtem Paket abweichen.

macOS fragt beim ersten Öffnen des Audioeingangs nach der Mikrofonberechtigung: ohne diese Berechtigung erreicht kein Signal den Decoder.

2.5 Linux (AppImage)

Machen Sie das AppImage ausführbar und starten Sie es:

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

Bei manchen Distributionen wird libfuse2 benötigt, andernfalls können Sie den Inhalt manuell entpacken:

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

Für den Zugriff auf serielle Schnittstellen muss der Benutzer der richtigen Gruppe angehören (dialout unter Debian/Ubuntu, uucp unter Arch). Nach dem Hinzufügen ist eine neue Anmeldung erforderlich.

2.6 Aktualisierungen

Decodium enthält eine Aktualisierungsprüfung (Setup > Advanced > DATA UPDATES). Ist eine neuere Version verfügbar, erscheint ein Fenster mit den Release-Notes und dem Link zum Paket. Die Aktualisierung löscht weder Einstellungen noch Logs noch die Decode-Historie.

3. Erste Konfiguration

Dieses Kapitel behandelt das Mindestmaß, das für das erste QSO nötig ist. Die vollständige Referenz aller Einstellungen steht in Kapitel 14.

Öffnen Sie die Einstellungen mit der Schaltfläche ⚙ Setup in der oberen Leiste.

3.1 Station — Setup > Station

Füllen Sie die Felder im Abschnitt STATION DETAILS aus:

Der Abschnitt STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) beeinflusst die Aussendung nicht: er versorgt das ADIF-Log und die externen Dienste. Wenn Sie ihn jetzt ausfüllen, ersparen Sie sich später unvollständige Logs.

3.2 Funkgerät und CAT — Setup > Radio

Wählen Sie im Abschnitt BACKEND CAT, wie Decodium mit dem Funkgerät spricht:

Darüber hinaus arbeitet Decodium mit Ham Radio Deluxe zusammen, wenn das Funkgerät bereits unter HRD-Kontrolle steht.

Stellen Sie im Abschnitt CAT CONTROL die serielle Schnittstelle, die Geschwindigkeit, die Stoppbits, das Handshake und die PTT-Methode ein (CAT, RTS, DTR, VOX). Unter Linux sind die stabilen Pfade /dev/serial/by-id/... den Pfaden /dev/ttyUSB* vorzuziehen, die sich bei jedem Neustart ändern können.

Wählen Sie im Abschnitt SPLIT OPERATION die Split-Betriebsart:

• None — kein Split, der Sendeton bleibt im Audiobereich;
• Rig — Split wird vom Funkgerät verwaltet;
• Fake It — Decodium verschiebt die VFO-Frequenz, damit der Sendeton in einem sauberen Bereich des Filters bleibt.

Fake It ist bei den meisten modernen Geräten die beste Wahl, weil der Sendeton von den Filterflanken fernbleibt und Sendeverzerrungen reduziert werden.

Prüfen Sie die Verbindung mit dem Abschnitt DIAGNOSTICS: Sie müssen die tatsächliche Frequenz des Funkgeräts sehen, der Bandwechsel muss in beide Richtungen funktionieren und PTT muss das Gerät mit Tune auf Sendung schalten.

Datenbetriebsarten. Decodium versucht, die Betriebsarten DATA/PKT von Icom-, Yaesu- und Kenwood-Geräten zu erhalten, damit das Gerät nicht auf USB/LSB gezwungen wird, wenn DATA-U die richtige Einstellung ist. Fällt Ihr Gerät beim Frequenzwechsel durch Decodium aus der Datenbetriebsart, prüfen Sie die in diesem Abschnitt eingestellte Betriebsart.

CAT-Profile. Sie können mehrere CAT-Konfigurationen als Profile speichern und über das Menü Profile aufrufen. Das ist der schnellste Weg, zwischen zwei Funkgeräten oder zwischen Heim- und Portabelaufbau zu wechseln.

3.3 Audio — Setup > Audio

Wählen Sie im Abschnitt AUDIO DEVICES:

• Input: das Gerät, das das Audio vom Funkgerät empfängt (USB-Codec oder Soundkarte);
• Output: das Gerät, das das Audio zum Funkgerät sendet;
• Kanal: Mono, Left, Right oder Both, je nach Verkabelung.

Stellen Sie im Abschnitt LEVELS die RX- und TX-Pegel ein. Decodium besitzt eine automatische RX-Pegelregelung, standardmäßig aktiv, die vor Übersteuerung schützt, ohne dass Sie ständig am Schieber nachregeln müssen. Wenn Sie sie abschalten, streben Sie einen Empfangspegel an, der das Grundrauschen bei etwa 30–50 dB in der Anzeige hält.

Für die Aussendung gilt weiterhin die Regel der digitalen Betriebsarten: keine Kompression, keine Bearbeitung, ALC in Ruhe. Erhöhen Sie den TX-Pegel bis zur gewünschten Leistung, nicht weiter. Abschnitt 16.2 erklärt, wie Sie die ALC-Telemetrie zur Kontrolle lesen.

Unter Windows wird der Audiopfad nach dem Senden bewusst aggressiv neu gestartet, um nicht geleerte Puffer und hängende Träger zu vermeiden. Wenn Sie nach jedem TX eine kurze Stille bemerken, arbeitet dieser Mechanismus korrekt.

3.4 Uhrsynchronisation

Für FT8, FT4 und — noch kritischer — für FT2 entscheidet die Zeitsynchronisation darüber, ob überhaupt dekodiert wird.

Decodium enthält:

• einen internen NTP-Client (Setup > Advanced > NTP TIME SYNC);
• das Panel DecoSyncTime, das Offset, Synchronisationszustand, mittleres DT der Dekodierungen und Decode-Latenz anzeigt.

Aktivieren Sie Enable NTP und prüfen Sie, dass das Panel einen synchronisierten Zustand meldet. Ein systematisch von Null abweichendes mittleres DT über viele Stationen deutet auf ein Problem der lokalen Uhr hin, nicht auf die Ausbreitung.

3.5 Betriebsart

Wählen Sie die Betriebsart im Auswahlfeld der oberen Leiste. Für das erste QSO:

1. Beginnen Sie mit FT8 auf einer Standardfrequenz, so prüfen Sie Audio, CAT und Zeit unter bekannten Bedingungen.
2. Kontrollieren Sie, dass innerhalb von ein bis zwei Perioden Dekodierungen in Full Spectrum erscheinen.
3. Wechseln Sie erst danach zu FT2, das gegenüber Zeit- und Audiokonfigurationsfehlern deutlich weniger nachsichtig ist.

4. Die Oberfläche

4.1 Aufbau des Fensters

Das Hauptfenster von Decodium 4 besteht aus:

4.2 Die obere Leiste

Die Schaltflächen der oberen Leiste sind konfigurierbar (Setup > UI Buttons), sowohl in der Sichtbarkeit als auch in der Reihenfolge:

Zum Umordnen der Schaltflächen: lang drücken und ziehen. Um zur ursprünglichen Anordnung zurückzukehren, verwenden Sie Restore default button order in Setup > UI Buttons.

4.3 Wasserfall und Panadapter

Der Wasserfall zeigt den zeitlichen Verlauf des Spektrums, der Panadapter das Momentanspektrum mit der Audiofrequenzskala am unteren Rand.

Wesentliche Bedienschritte:

• Linksklick im Wasserfall: verschiebt die Empfangs-Audiofrequenz;
• Klick mit Modifikatortaste (je nach Konfiguration): verschiebt die Sende-Audiofrequenz;
• Mausrad: Zoom oder Verschieben, je nach Bereich;
• Paletten: wählbar und anpassbar unter Setup > Colors > SPECTRUM.

Der Wasserfall kann in ein eigenes Fenster abgedockt, wieder angedockt oder minimiert werden. In einem kompakten Layout verwendet er eine geringere Historientiefe und reduziert so Speicher- und Texturbedarf, ohne den sichtbaren Bereich zu verlieren.

4.4 Full Spectrum

Full Spectrum listet alle Dekodierungen der laufenden Periode auf. Die sichtbaren Spalten werden unter Setup > Display > DECODES konfiguriert und umfassen unter anderem Entfernung (Dist), Azimut (Az) und Frequenz.

• Doppelklick auf eine Zeile: wählt diese Station als QSO-Partner und erzeugt die Nachrichten;
• Clear: leert die Liste;
• die Schaltfläche für das Listenende (Go to the latest decode) bringt die Ansicht zurück nach unten, wenn Sie nach oben gescrollt haben.

Die Zeilen werden nach den Regeln unter Setup > Colors > DECODE COLORS eingefärbt: neues DXCC, neuer Kontinent, neue CQ- oder ITU-Zone, neues Grid, neues Rufzeichen, CQ in der Nachricht, 73/RR73, bereits gearbeitete Stationen (B4), LoTW-Nutzer und gesendete Nachrichten.

4.5 Signal RX

Signal RX ist die chirurgische Ansicht: sie zeigt nur, was das laufende QSO und die Stationen betrifft, die Sie rufen. Während eines Pile-ups ist dies das Panel, das man beobachtet, denn Full Spectrum wird unlesbar.

4.6 TX-Panel

Das TX-Panel enthält:

• die Nachrichten TX1…TX7, die erzeugt und bearbeitet werden können;
• den Zustand des QSO und des Partners;
• die Bedienelemente: Auto (Auto Sequence), Call, Hold, Tune, Halt;
• die Sendeleistung und die Schnellbedienung der Aussendung.

Auch die Reihenfolge der Schaltflächen im TX-Panel ist anpassbar und lässt sich mit Restore default TX panel order zurücksetzen.

Halt (oder Esc) bricht die Aussendung sofort ab: dieses Kommando sollten Sie im Kopf haben.

4.7 Layout: andocken, abdocken, zurücksetzen

Jedes Hauptpanel kann:

• in ein eigenständiges Fenster abgedockt werden (Detach), praktisch bei mehreren Monitoren;
• wieder ins Layout angedockt werden (Dock);
• ausgeblendet und später wiederhergestellt werden (Restore …);
• durch Ziehen zwischen den Spalten verschoben werden;
• mit Reset Layout in den Ausgangszustand zurückgesetzt werden.

Das Layout wird beim Schließen gespeichert und beim nächsten Start wieder geladen, einschließlich abgedockter Fenster und ihrer Positionen.

4.8 Kompaktmodus

Der Kompaktmodus verringert die Höhe von Kopfzeilen und Zeilen, sodass mehr Dekodierungen auf den Bildschirm passen. Auf Notebooks und kleinen Displays ist das die richtige Wahl.

4.9 Slow-PC-Modus

Slow-PC mode reduziert Oberflächen- und Grafiklast: geringere Wasserfall-Aktualisierungsrate, weniger Animationen, weniger Arbeit im Grafik-Thread. Aktivieren Sie ihn, wenn Sie auf älteren Rechnern ruckelnde Oberfläche oder verzögerte Dekodierung feststellen: in FT2 kann eine überlastete Oberfläche dazu führen, dass Sie den Sende-Slot verpassen.

4.10 Themes und Erscheinungsbild

Unter Setup > Display > ASPETTO / TEMA wählen Sie das Theme (einschließlich des dunklen Themes), die Farben der Oberfläche und die Schriftarten. Unter Setup > Display > FONT wird die Schrift der Dekodierungen eingestellt: verwenden Sie eine Festbreitenschrift, sonst stehen die Spalten der Nachrichten nicht untereinander.

Teil II — Betrieb

5. Das QSO: vom Empfang bis zum Log

5.1 Empfang starten

1. Drücken Sie Monitor: die Schaltfläche wechselt auf STOP und der Wasserfall beginnt zu laufen.
2. Prüfen Sie, dass der RX-Pegel nicht übersteuert.
3. Warten Sie eine oder zwei Perioden: die Dekodierungen erscheinen am Ende jedes Slots in Full Spectrum.

Wenn nichts dekodiert wird, der Wasserfall aber Signale zeigt, liegt das Problem fast immer an der Uhr (Abschnitt 3.4) oder an der falschen Betriebsart für diese Frequenz.

5.2 Eine Station rufen

1. Doppelklick auf die Zeile der Station in Full Spectrum oder Signal RX. Decodium setzt den Partner, erzeugt die Nachrichten und wählt den richtigen Slot.
2. Prüfen Sie die Sende-Audiofrequenz: in den FTx-Betriebsarten ist es gute Praxis, in einem freien Bereich des Spektrums zu senden und nicht auf der Station, die Sie rufen.
3. Kontrollieren Sie die im TX-Panel erzeugten Nachrichten.
4. Schalten Sie die Aussendung ein.
5. Mit aktivem Auto Sequence führt Decodium das QSO selbst zu Ende: Rapport, Bestätigung, RR73/73.

5.3 CQ rufen

1. Wählen Sie TX6 (die CQ-Nachricht).
2. Schalten Sie die Aussendung ein oder verwenden Sie Auto CQ für wiederkehrende Anrufe.
3. Beobachten Sie Signal RX auf direkte Antworten.
4. Lassen Sie Auto Sequence arbeiten oder greifen Sie manuell ein.

Mit aktivem Auto CQ ruft Decodium am Ende jedes QSO erneut CQ, vorbehaltlich der eingestellten Schutzmechanismen (Watchdog, SWR-Prüfung, Wiederholungsgrenzen).

5.4 Auto Sequence und ihre Optionen

Setup > TX > AUTO SEQUENCE bündelt die Regeln, die die Automatik steuern:

Quick QSO ist für Contests und hohe Betriebsgeschwindigkeit gedacht: es verkürzt das QSO auf vier Durchgänge und liefert dennoch einen gültigen Logeintrag.

5.5 Wiederholungen und Abschluss des QSO

Setup > TX > FT2 UTILITY enthält die Parameter für den QSO-Abschluss, mit getrennten Werten für FT2, FT4 und FT8:

Diese Optionen haben zusammen einen klaren Zweck: schwache QSOs abschließen, ohne die Frequenz endlos zu belegen. Wer marginales DX arbeitet, erhöht den Boost für sehr schwache Partner; wer Contest fährt, hält die Wiederholungen niedrig.

5.6 Das QSO ins Log eintragen

Beim Abschluss des QSO öffnet Decodium das Bestätigungsfenster für das Log (wenn Prompt to log QSO unter Setup > Reporting > LOGGING aktiv ist). Das QSO wird in das lokale ADIF-Log geschrieben und, sofern konfiguriert, an QRZ Logbook, Cloudlog, LoTW und die angebundenen externen Programme weitergegeben.

Mit Alt+L tragen Sie das laufende QSO ohne Mausbedienung ein.

5.7 Worked-before (B4)

Decodium erkennt bereits gearbeitete Stationen anhand von Rufzeichen, Band und Betriebsart zusammen. Ein QSO auf 20 m FT2 markiert dasselbe Rufzeichen nicht als gearbeitet auf 20 m FT8 oder auf 40 m FT2. Die Farbe B4 in Full Spectrum kennzeichnet damit ein echtes Duplikat, und die Hervorhebungen "neues DXCC / Grid / Zone" bleiben verlässlich, auch wenn Sie während der Sitzung die Betriebsart wechseln.

6. Betrieb in FT2

FT2 ist die Betriebsart, mit der dieses Projekt begonnen hat, und bleibt sein Hauptziel. Dieses Kapitel fasst alles zu FT2 an einer Stelle zusammen.

6.1 Was FT2 leistet

Der FT2-Slot beträgt 3,75 Sekunden, die Aussendung dauert etwa 2,52 Sekunden. Das bedeutet zwei Dinge:

1. Die QSO-Rate ist wesentlich höher als bei FT8 und deutlich höher als bei FT4: das ist der Vorteil in Contests, Pile-ups und DX-Expeditionen, wo der Engpass die Zeit pro QSO und nicht die Empfindlichkeit ist.
2. Die verfügbare Zeit zum Dekodieren, Entscheiden und Vorbereiten der Aussendung ist knapp. Audiokonfiguration, Uhrgenauigkeit und CPU-Last zählen deutlich mehr als bei FT8.

FT2 ist keine "bessere Variante von FT8": es ist eine schnelle Betriebsart, optimiert für Bedingungen, in denen das Signal vorhanden und die Zeit die knappe Ressource ist.

6.2 Asynchrone Dekodierung

Decodium dekodiert FT2 asynchron: statt das Ende des Slots abzuwarten und alles auf einmal zu verarbeiten, arbeitet es auf überlappenden Blöcken, während das Signal noch eintrifft. Das verkürzt die Verzögerung zwischen dem Ende der Aussendung der Gegenstation und dem Erscheinen der Nachricht auf dem Bildschirm — Zeit, die man in FT2 vollständig benötigt, um im richtigen Slot zu antworten.

Den Zustand der asynchronen Dekodierung zeigt die Schaltfläche Async FT2 (A) in der oberen Leiste.

6.3 Der Sende-Scheduler

Der TX-Scheduler von FT2 folgt einer nicht verhandelbaren Regel: niemals eine Aussendung beginnen, die innerhalb des Slots nicht abgeschlossen werden kann. Eine abgeschnittene Aussendung wird von niemandem dekodiert und belastet nur die Frequenz.

Deshalb gibt es die folgenden Schutzmechanismen:

Wenn Ihre Aussendungen beginnen und abgeschnitten werden, ist zuerst die Zeitsynchronisation zu prüfen, dann das konservative TX-Fenster.

6.4 Die Robustheitsoptionen von FT2

Diese Optionen sind für schwache, instabile oder von QSB betroffene Signale gedacht. Aktivieren Sie nicht alle "zur Sicherheit": jede kostet CPU-Zeit oder Latenz.

Empfohlener Einstieg: Standardwerte belassen, FT2 partner-memory aktivieren, wenn Sie DX mit QSB arbeiten, und Conservative FT2 nur einschalten, wenn Sie Signalen an der Grenze nachgehen.

6.5 Schutzmechanismen für Log und Nachrichten

Die letzte Option ist nützlich, wenn Sie ein Sequenzproblem melden müssen: sie liefert die genaue Spur der durchlaufenen Zustände, und genau die braucht man, um den Fehler zu reproduzieren.

6.6 Rufzeichen und Hashes

FT2 komprimiert Rufzeichen, wie FT8 und FT4. Lange oder zusammengesetzte Rufzeichen werden als Hash übertragen und vom Empfänger anhand bereits gesehener Rufzeichen aufgelöst. Decodium enthält Schutzmechanismen gegen Ghost Calls (Rufzeichen, die scheinbar dekodiert werden, aber nicht wirklich vorhanden sind) und gegen nicht aufgelöste Nutzlasten: kann eine Nachricht nicht zweifelsfrei zugeordnet werden, wird sie nicht zum Fortschreiten der QSO-Sequenz verwendet.

Dieses Verhalten ist beabsichtigt: ein unvollständiges QSO ist einem QSO mit falschem Rufzeichen im Log vorzuziehen.

6.7 FT2 auf leistungsschwachen CPUs

Auf langsamen Rechnern:

1. Slow-PC mode aktivieren;
2. FT2: adaptive decode (CPU saver) aktivieren;
3. FT2: skip redundant end-slot decode erwägen;
4. Wasserfallhöhe und sichtbare Historie verkleinern;
5. Live Map schließen, wenn sie nicht gebraucht wird.

Die Priorität in FT2 ist immer dieselbe: erst das Timing, dann die Empfindlichkeit, zuletzt die Optik der Oberfläche.

7. Multi Answer Mode und Anruferliste

7.1 Worum es geht

Multi Answer Mode (MAM) erlaubt es, mehrere Anrufer parallel zu bedienen und mehr als ein QSO gleichzeitig aktiv zu halten. Das MAM-Panel zeigt die aktiven Ströme und erlaubt es, Stationen per Doppelklick hinzuzufügen.

Die Verantwortung bleibt beim Operator: MAM organisiert die Arbeit, es erlaubt sie nicht. Bevor Sie es auf einer belegten Frequenz einsetzen, stellen Sie sicher, dass Ihr Signal und Ihre Konfiguration saubere Arbeit leisten.

7.2 Multi-Stream

Setup > TX > FT2 UTILITY enthält:

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — aktiviert die Verwaltung mehrerer gleichzeitiger Ströme;
• MAM multi-stream: max stream simultanei — wie viele Ströme zugelassen sind.

Die Option ist als experimentell gekennzeichnet: sie erhöht die Zahl der gleichzeitigen Aussendungen und damit auch die Gelegenheiten, Fehler zu machen. Beginnen Sie mit zwei Strömen.

7.3 Anruferliste

Das Panel Caller Queue sammelt die Stationen, die Sie rufen, und erlaubt es, sie nach betrieblichen Kriterien zu ordnen. Es ist das naturgemäße Werkzeug, wenn Sie von einer gesuchten Station CQ rufen und die Antworten schneller eintreffen, als Sie sie abarbeiten können.

8. DX-Pedition- und Contest-Modi

8.1 Fox / Hound / SuperFox

Unter Setup > Advanced > OPERATING MODE:

Die OTP-Einstellungen (Setup > Advanced > OTP: OTP Enabled, OTP Seed, OTP Interval, OTP URL) betreffen die Erzeugung und Verteilung der Codes, mit denen eine Aktivität überprüft wird: sie richten sich an den Veranstalter einer Expedition, nicht an den einzelnen Anrufer.

8.2 DX-Pedition Workspace

Der DX-Pedition Workspace ist ein eigenes Layout, das Full Spectrum · Decode, Signal RX · QSO Lock und Log · QSO Entry in einer einzigen Ansicht nebeneinanderstellt, mit UTC-Zeit und Rufzeichen des Operators. Er ist für Operatorschichten an einer gesuchten Station gedacht, bei denen Bandaktivität, laufendes QSO und Logeingabe gleichzeitig im Blick sein müssen.

8.3 Contest

Setup > Advanced > CONTEST legt die laufende Aktivität fest:

• Activity: None, Field Day, Fox, Hound;
• FD Exchange und RTTY Exchange: die von der Ausschreibung geforderten Austausche;
• Contest Name, Indiv Name, NCCC Sprint: Parameter für die jeweiligen Formate.

Die Wahl der Aktivität verändert die Nachrichtenerzeugung: prüfen Sie im Contest stets die TX-Nachrichten, bevor Sie mit dem Senden beginnen.

9. Erweiterte Dekodierung

Setup > Advanced > ADV DECODING bündelt drei Rettungsverfahren, die einzeln aktiviert oder automatisch verwaltet werden können:

Mit aktivem Auto Mode schaltet Decodium die drei Verfahren nur dann ein, wenn sie gebraucht werden, gemessen an den aktuellen Bedingungen; das Feld Live state zeigt, welche gerade aktiv sind.

Der Preis dieser Optionen ist CPU-Zeit. Auf langsamen Rechnern verschlechtert es die Lage, sie alle von Hand einzuschalten: Auto Mode ist in den meisten Fällen die sinnvollste Wahl.

Weitere Dekodieroptionen finden sich unter Setup > Decode:

• DECODE PARAMETERS — Tiefe und allgemeine Parameter der Dekodierung;
• JT65 VHF/UHF — spezifische Parameter für den VHF/UHF-Betrieb;
• SIDELOBE CONTROL — Kontrolle der Nebenzipfel;
• DECODE FILTERS — Filter auf den Dekodierungen (siehe Abschnitt 12.4).

10. Live Map, Astro und Time Sync

10.1 Live Map

Die Live Map zeigt die dekodierten Stationen und die Wege zwischen Ihrer Station und diesen Stationen, mit nach Richtung und Zustand gefärbten Markierungen. Sie wird bei Band- oder Betriebsartwechsel und beim Leeren der Dekodierlisten automatisch zurückgesetzt, damit keine nicht mehr gültige Aktivität auf der Karte stehen bleibt.

Während der Aussendung wird die Karte bewusst langsamer aktualisiert: das ist eine Prioritätsentscheidung, denn der Grafik-Thread darf der Aussendung keine Zeit wegnehmen.

Wenn Sie die Karte nicht brauchen, gibt ihr Schließen GPU und Speicher frei — sie ist das erste Panel, auf das man bei schwacher Hardware verzichtet.

10.2 Astro

Das Panel Astro liefert die astronomischen Daten für EME und den VHF/UHF- Betrieb: Mondposition, Azimut und Elevation, Doppler, Degradation. Das Verzeichnis der AzEl-Daten wird unter Setup > Audio > DIRECTORY konfiguriert.

10.3 Time Sync (DecoSyncTime)

Das Panel DecoSyncTime fasst alles Zeitbezogene zusammen:

• NTP-Status und angewandter Offset;
• mittleres DT, berechnet über die empfangenen Dekodierungen;
• Decode-Latenz;
• Anzahl der für die Schätzung verwendeten Messwerte.

So lesen Sie es:

Zusätzlich gibt es eine Schätzung der Drift der Soundkarte in ppm mit grün/gelb/rot-Anzeige: eine hohe Drift verschiebt das Slot-Timing zunehmend und ist typisch für preisgünstige USB-Codecs.

11. Log, Onlinedienste und Schnittstellen

11.1 Lokales QSO-Log

Decodium führt das lokale ADIF-Log und das Fenster QSO Log mit Eingabe und Bearbeitung der QSOs. Die Verhaltensoptionen stehen unter Setup > Reporting > LOGGING: Bestätigung vor dem Eintragen, Pflichtfelder, Format der Rapporte.

11.2 PSK Reporter

Decodium sendet Beobachtungen an PSK Reporter und erlaubt die Suche nach eigenen Spots im zugehörigen Panel. Der Versand arbeitet über eine Warteschlange: liegen keine Beobachtungen an, wird kein dauerhafter Hintergrundverkehr zum Dienst gehalten.

11.3 QRZ Logbook, Cloudlog und LoTW

Für Cloudlog normalisiert Decodium den API-Endpunkt und unterscheidet in den Fehlermeldungen zwischen HTTP-, Authentisierungs- und Proxy-Problemen: schlägt der Upload fehl, sagt die Meldung, welches der drei es ist.

Die LoTW-Daten dienen auch der Hervorhebung von LoTW-Nutzern in Full Spectrum (Farbe LoTW marker).

11.4 DX Cluster

Das Panel DX Cluster verbindet sich mit einem Telnet-Knoten und zeigt die Spots, mit Filtermöglichkeit. Die Konfiguration steht unter Setup > Reporting > DX CLUSTER (Host, Port, Login-Rufzeichen, Filter).

11.5 Anbindung externer Programme

Wenn Sie JTAlert oder GridTracker verwenden, muss der UDP Server aktiv sein und der Port mit dem im externen Programm eingestellten übereinstimmen.

11.6 Audioaufzeichnung

Setup > Reporting > RECORDING verwaltet die Aufzeichnung des empfangenen Audios — nützlich für spätere Analysen und um einer Fehlermeldung echte Proben beizulegen.

12. Decode-Historie, Filter und Alarme

12.1 Decode History

Decodium speichert die Dekodierungen in einer SQLite-Datenbank, die über das Fenster History durchsucht werden kann. Sie können suchen nach:

• Rufzeichen;
• Band;
• Betriebsart;
• UTC-Zeitraum;
• Ergebnisgrenze.

Die Ergebnisse lassen sich nach ADIF exportieren. Die Historie übersteht das Beenden des Programms und erlaubt Auswertungen im Nachhinein: Prüfung der Ausbreitung, Kontrolle der Bandaktivität, Rekonstruktion eines zweifelhaften QSO.

Die Live-Ansichten im Speicher sind begrenzt, damit der RAM-Bedarf in langen Sitzungen nicht wächst; die vollständige Historie bleibt in der Datenbank.

12.2 Akustische Alarme

Setup > Alerts > AUDIO ALERTS erlaubt es, bestimmten Ereignissen einen Klang zuzuordnen: neues DXCC, neues Grid, ein gesuchtes Rufzeichen, ein direkter Anruf. So kann man im Hintergrund arbeiten, ohne auf den Bildschirm zu starren.

12.3 Filter: Blacklist, Whitelist und Territorien

Setup > Filters enthält:

ALWAYS PASS hat Vorrang: dort steht das Rufzeichen des Freundes, den Sie nie verpassen wollen, auch wenn Sie sonst aggressiv filtern.

12.4 Dekodierfilter

Setup > Decode > DECODE FILTERS greift weiter vorn ein, an der Arbeit des Decoders und an dem, was in die Listen veröffentlicht wird. Mit Verstand eingesetzt senkt es die CPU-Last auf einem belegten Band.

13. Fernsteuerung über Web-Dashboard und FT2-Link

13.1 Web-Dashboard (iPad, Smartphone, PWA)

Decodium enthält einen internen Webserver, mit dem sich die Station von einem anderen Gerät im selben lokalen Netz bedienen lässt.

Aktivierung

1. Öffnen Sie Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) oder Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Aktivieren Sie den Server und legen Sie Port und Zugangsdaten fest.
3. Ermitteln Sie die IP-Adresse des Stationsrechners.
4. Öffnen Sie auf dem Tablet oder Smartphone http://IP-ADRESSE:PORT im Browser.
5. Fügen Sie die Seite dem Startbildschirm hinzu, um sie als App zu nutzen (PWA).

Sicherheit — vor der Aktivierung lesen

• Nutzen Sie den Server nur im lokalen Netz. Machen Sie ihn nicht aus dem Internet erreichbar und öffnen Sie keine Ports im Router.
• Setzen Sie ein nicht triviales Passwort: wer das Dashboard erreicht, kann Ihre Station und damit Ihre Aussendung steuern.
• In gemeinsam genutzten Netzen (Hotels, Clubstationen, Messen) lassen Sie den Server ausgeschaltet, wenn Sie ihn nicht brauchen.

Die Schritt-für-Schritt-Anleitung für Einsteiger steht in der Datei doc/WEBAPP_SETUP_GUIDE.en-GB.md im Quellcode, mit dem Abschnitt zur Fehlersuche und der Beschreibung der API-Endpunkte für fortgeschrittene Anwendungen.

13.2 FT2-Link (experimentell)

FT2-Link ist ein offenes Protokoll für zuverlässigen Chat und Nachrichtenübertragung, das innerhalb von Decodium entwickelt wird. Es ist öffentlich dokumentiert und unabhängig vom Modem: dasselbe ARQ-Verfahren kann über verschiedene Signalformen laufen.

Der vorgesehene Ablauf: Beacon oder CQ auf NARROW, Antwort HELLO, Aushandlung des besten gemeinsamen Profils, Wechsel auf W500 oder W2300 für die Daten und Rückfall auf NARROW, wenn das breite Profil nicht trägt.

Die Arbeitsperiode von FT2-Link beträgt 15 Sekunden, abweichend von den 3,75 s von FT2.

Achtung. FT2-Link ist experimentelles Material, und die Profile W500/W2300 sind nicht das Standard-FT2 und dürfen nicht als solches dargestellt werden. Prüfen Sie vor dem Senden die für die vorgesehene Bandbreite geltenden Bestimmungen in Ihrem Band und Ihrer IARU-Region.

Teil III — Referenz

14. Referenz der Einstellungen

Die Einstellungen sind in dreizehn Registerkarten gegliedert. Nachstehend sind alle Abschnitte in der Reihenfolge ihres Erscheinens aufgeführt, mit ihrer Funktion.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

Die vorbereiteten Profile setzen in einem Schritt einen in sich stimmigen Parametersatz:

Das aktive Profil ist mit ● active gekennzeichnet. Sie können von einem Profil ausgehen und einzelne Optionen anpassen: Ihre Änderungen bleiben bestehen und werden erst überschrieben, wenn Sie ein anderes Profil anwenden.

14.4.2 Watchdog

Lassen Sie den Watchdog aktiv. Er ist der Schutz, der einen vergessenen Träger auf dem Band verhindert, wenn Sie den Raum verlassen.

14.5 Display

Prozesspriorität. High (recommended) ist die empfohlene Einstellung. Realtime ist mit einem Warnhinweis versehen: auf manchen Systemen kann der Rechner dadurch träge oder instabil werden. Verwenden Sie sie nicht, sofern Sie keine gezielten Messungen durchführen.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Verwaltung der Arbeitsfrequenzen: Liste je Band und Betriebsart, Hinzufügen, Ändern, Laden und Speichern in Dateien .qrg / .qrg.json, mit der Möglichkeit, eine externe Liste in die eigene einzufügen (Merge Working Frequencies) statt sie zu ersetzen.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — Zuordnung von Klängen zu Ereignissen (neues DXCC, neues Grid, gesuchtes Rufzeichen, direkter Anruf).

14.12 Filters

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

14.13 UI Buttons

TOP TOOLBAR (Sichtbarkeit der Schaltflächen) und TOOLBAR BUTTON ORDER (Reihenfolge, mit Zurücksetzen auf die Standardwerte für Toolbar und TX-Panel).

15. Tastaturkürzel

Aussendung

Steuerung (Ctrl)

Aktionen (Alt)

Sonstiges

Die vollständige Liste kann im Programm unter Keyboard Shortcuts eingesehen werden.

16. Diagnose und Fehlersuche

16.1 Ich dekodiere nichts

Arbeiten Sie die Punkte in dieser Reihenfolge ab:

1. Läuft Monitor? Die Schaltfläche muss STOP anzeigen.
2. Läuft der Wasserfall? Steht er still, liegt das Problem am Audioeingang und nicht am Decoder.
3. Ist der RX-Pegel sinnvoll? Ein viel zu niedriges Grundrauschen und Übersteuerung verhindern die Dekodierung gleichermaßen.
4. Ist die Uhr synchronisiert? Prüfen Sie das Time-Sync-Panel. In FT2 und FT4 genügen wenige Zehntelsekunden, um alles zu verlieren.
5. Passt die Betriebsart zur Frequenz? FT8 auf einer FT4-Frequenz dekodiert nichts.
6. Stimmt der Audiokanal? Bei einem Stereo-Codec ist der falsche Kanal gleichbedeutend mit Stille.

16.2 Ich sende, aber niemand antwortet

• Prüfen Sie, dass PTT arbeitet und das Funkgerät tatsächlich auf Sendung geht.
• Prüfen Sie die Telemetrie unter Setup > Radio > DIAGNOSTICS: die Leistung muss dem Erwarteten entsprechen und das ALC muss in Ruhe bleiben. Die Anzeige ALC -- bedeutet, dass der Wert nicht verfügbar ist, während 0 ein gültiger Wert ist: das sind zwei verschiedene Situationen.
• Prüfen Sie das SWR: Check SWR blockiert Tune nicht, sodass Sie messen und korrigieren können; die tatsächliche Aussendung und Auto CQ bleiben jedoch geschützt.
• Stellen Sie sicher, dass Sie nicht außerhalb des Slots senden: in FT2 verwirft das konservative TX-Fenster (Abschnitt 6.3) verspätete Aussendungen, und das ist das richtige Verhalten.

16.3 Grafik- und Leistungsprobleme

Die Anzeige der CPU-Belastung unter Setup > Display > UI — PERFORMANCE zählt die Überlastereignisse der Sitzung: steigt der Zähler severe an, kommt der Rechner nicht mit und die Konfiguration sollte entlastet werden.

16.4 Audio blockiert oder Träger nach der Aussendung

Decodium enthält einen TX-Audio-Watchdog, der genau für diesen Fall gedacht ist. Wenn das Problem auftritt:

1. Halt (oder Esc) verwenden;
2. prüfen, dass PTT am Funkgerät freigegeben wurde;
3. das Audioausgabegerät unter Setup > Audio prüfen;
4. tritt es regelmäßig auf, ein Diagnoseprotokoll erstellen und den Fall melden.

16.5 CAT-Ports, die wechseln oder doppelt erscheinen

Verwenden Sie unter Linux die Pfade /dev/serial/by-id/..., die über Neustarts hinweg stabil bleiben. Erscheint dasselbe Gerät zweimal (als /dev/ttyUSB0 und als by-id-Pfad), wählen Sie den by-id-Pfad und nicht beide: es ist dasselbe physische Gerät.

16.6 Einen Fehler sinnvoll melden

Decodium enthält ein Fenster für Fehlermeldungen. Eine brauchbare Meldung enthält:

• die genaue Programmversion (About Decodium);
• Betriebssystem und Plattform;
• verwendetes Funkgerät und CAT-Backend;
• Betriebsart und Frequenz;
• die Beschreibung der Schritte, die das Problem reproduzieren;
• das Diagnoseprotokoll und, wenn das Problem die Dekodierung betrifft, eine WAV-Datei des Signals;
• bei FT2-Sequenzproblemen: FT2 state transition census (log only) aktivieren und die Spur beilegen.

17. Dateien, Ordner und Benutzerdaten

Decodium verwendet die von Qt vorgesehenen Standardordner des Systems für:

• die Konfigurationseinstellungen;
• den QML-Cache;
• die SQLite-Datenbank der Decode-Historie (db.sqlite);
• CTY.DAT und die DXCC-Daten;
• das ADIF-Log;
• die Diagnoseprotokolle;
• die Audioaufzeichnungen.

Die genauen Orte hängen von der Plattform ab. Der zuverlässigste Weg, sie zu finden, ist das Startprotokoll, in dem Decodium die wichtigsten Pfade ausgibt (AppDataLocation, CacheLocation, Pfad der Datenbank).

Für eine vollständige Sicherung der Konfiguration benötigen Sie: den Einstellungsordner, das ADIF-Log und die Datenbank der Historie.

Decodium enthält außerdem eine Migration des Datenbestands: ändert sich der Aufbau der Daten zwischen Versionen, werden vorhandene Dateien beim ersten Start umgewandelt. Vor einer größeren Aktualisierung bleibt eine Kopie des Datenordners dennoch die sinnvolle Vorsichtsmaßnahme.

18. Aus dem Quellcode bauen

18.1 Abhängigkeiten

Je nach Plattform benötigt werden:

• CMake (3.20 oder neuer) und ein aktueller C/C++-Compiler;
• Qt 6 mit den Modulen Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql und WebSockets;
• Hamlib;
• ein Fortran-Compiler (gfortran) für die noch vorhandenen Legacy-Komponenten;
• Boost und die weiteren in den Build-Dateien genannten Abhängigkeiten.

18.2 Build-Skripte

Das Repository enthält fertige Skripte für die wichtigsten Plattformen:

Die Hinweise speziell für Windows stehen in doc/building on MS Windows.txt und den benachbarten Dateien; die macOS-Portierung ist in doc/MACOS_PORTING_v1.2.0.md dokumentiert.

18.3 Tests

Das Verzeichnis tests/ enthält die Unit-Tests und die Vergleiche zwischen den Decoder-Implementierungen, einschließlich der Tests für FT2 und FT2-Link. Zum Ausführen:

ctest --output-on-failure

Die Vergleichstests zwischen Dekodierstufen sind das richtige Werkzeug, um zu prüfen, dass eine Änderung am Decoder keine Empfindlichkeitsregression eingeführt hat.

19. Glossar

20. Danksagung, Lizenz und Kontakt

Das Projekt

• Martino Merola — IU8LMC — Urheber von FT2, Lead Developer von DECODIUM
• Salvatore Raccampo — 9H1SR — C++-Kern, Builds und Pakete für macOS und Linux
• Die Tester und Mitwirkenden der FT2-Community, deren Berichte einen großen Teil der Arbeit an den letzten Releases geleitet haben
• Die Übersetzer der Community, die die Lokalisierungen des Programms pflegen

Herkunft des Codes

Decodium stammt aus der Linie WSJT-X, entwickelt von Joe Taylor K1JT, Steve Franke K9AN, Bill Somerville G4WJS und den weiteren Autoren des Projekts und unter der GPL verbreitet. Die dem Quellcode beigefügten Dateien AUTHORS, THANKS und COPYING enthalten die vollständigen Nennungen und die Lizenz. Die eigenen Beiträge dieses Projekts — das FT2-Protokoll, die neu geschriebenen Decoder und Modulatoren, die QML-Oberfläche, die integrierten Dienste — sind in der Commit-Historie und in CHANGELOG.md dokumentiert.

Lizenz

Decodium 4.0 Core Shannon ist freie Software und wird unter der GNU General Public License Version 3 verbreitet. Sie dürfen sie nach den Bedingungen dieser Lizenz verwenden, untersuchen, verändern und weitergeben. Das Programm wird ohne jede Gewährleistung bereitgestellt, soweit das anwendbare Recht dies zulässt.

Wo Sie Hilfe finden

• Projektwebsite: ft2.it
• Community und Support: community.ft2.it
• Telegram-Kanal FT2 Digital Mode
• Technische Meldungen: Bereich Issues im GitHub-Repository

Abschließender Betriebshinweis

Decodium steuert einen Sender. Die Verantwortung für das, was auf die Luft geht — Band, Bandbreite, Leistung, Zeiten, Genehmigungen — liegt beim lizenzierten Operator. Die experimentellen Funktionen des Programms, insbesondere die breiten FT2-Link-Profile und die Multi-Stream-Modi, sollten erst nach Prüfung der in Ihrem Band und Ihrer IARU-Region geltenden Bestimmungen verwendet werden.

73 de IU8LMC