Sådan bruger du denne manual

Manualen er delt i tre dele:

Navnene på betjeningselementerne er angivet, som de står i den engelsksprogede brugerflade (Monitor, Setup > Radio, Halt), fordi det er kodens referencesprog. Bruger du Decodium på dansk, italiensk, lettisk eller et af de øvrige tilgængelige sprog, sidder betjeningselementerne på præcis de samme steder, og oversættelsen er anført, hvor den kan skabe tvivl.

Bemærkning om tilgængelige funktioner. Decodium bygges til Windows, macOS og Linux med forskellige dekoder-backends og biblioteker. Nogle af de funktioner, der beskrives her, kan mangle eller være slået fra, afhængigt af platformen, den tilsluttede radio og build-indstillingerne i den pakke, du har hentet. Manualen gør opmærksom på det, hvor det har betydning.

Del I — Installation og konfiguration

1. Indledning

1.1 Hvad Decodium 4 er

Decodium 4.0 Core Shannon er en komplet digital station til svagsignaltilstandene. Programmet stammer fra linjen WSJT-X / Decodium og fører den over på en anden arkitektur: Qt 6 / QML-brugerflade, dekodere og modulatorer, der trinvis er skrevet om i C++, integreret CAT-styring med flere backends, GPU-accelereret waterfall og panadapter, live-kort, DX Cluster, PSK Reporter, QSO-log og en afkodningshistorik i en database.

Med Decodium 4 kan du:

• modtage og sende i FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W og WSPR;
• styre radioen via CAT (Hamlib, native backends, Ham Radio Deluxe, OmniRig, TCI);
• køre manuelle QSO'er, Auto Sequence, Auto CQ, Multi Answer Mode og DX-Pedition-tilstandene;
• sende spots og QSO'er til PSK Reporter, QRZ Logbook, Cloudlog, LoTW og til eksterne programmer via UDP, ADIF TCP eller N1MM;
• betjene stationen fra en tablet eller en telefon med det fjernbetjente webdashboard.

Navnet Core Shannon henviser til Claude Shannon og til projektets grundtanke: at behandle svag digital kommunikation som et spørgsmål om information, synkronisering, robusthed og driftssikkerhed — ikke som en øvelse i modulation.

1.2 Hvad der er ændret siden Decodium 3

Kommer du fra Decodium 3 "Raptor", er tre ting væsentligt anderledes:

1. Ny brugerflade. Qt Widgets-brugerfladen er erstattet af en QML-brugerflade med paneler, du kan sætte fast, løsne og omarrangere, og med en opstilling, der bevares mellem sessioner.
2. Motor i C++. Dekoderne og modulatorerne i FTx-familien er flyttet til C++, med sammenligningstest mod de tidligere rutiner. Der er stadig ældre komponenter til nogle specialiserede VHF/UHF-tilstande.
3. Integrerede tjenester. Afkodningshistorik i SQLite, webdashboard, DX Cluster, PWR/SWR/ALC-telemetri og stationsdiagnose er en del af programmet og kræver ingen eksterne værktøjer.

Filen CHANGELOG.md i kildekoden beskriver ændringerne udgivelse for udgivelse.

1.3 FT2 på to linjer

FT2 (Fast Track 2) er den digitale tilstand, der er skabt i dette projekt, og som er certificeret i ADIF med MODE=MFSK og SUBMODE=FT2.

Kapitel 6 er helt viet til FT2 og programmets FT2-indstillinger.

1.4 Licens og kildekode

Decodium 4 udbredes under GPL-3.0. Den fulde licenstekst ligger i filen COPYING, som følger med kildekoden og pakkerne. Kildekoden er offentlig på GitHub, med den fulde commit-historik og udgivelser til download.

2. Systemkrav og installation

2.1 Systemkrav

Understøttede operativsystemer

• Windows 10 / 11, 64 bit
• macOS på Apple Silicon (og på Intel, hvor pakken findes)
• Linux x86_64 og aarch64, som AppImage

Anbefalet minimumshardware

• En nyere firekernet CPU til FT2-drift med asynkron afkodning
• 4 GB RAM (8 GB anbefales med Live Map og panadapter aktive)
• En GPU med opdaterede drivere: Decodium bruger Qt Quick/RHI og udnytter hardwareacceleration til waterfall, panadapter og kort
• Et lydkort eller radioens USB-grænseflade
• En internetforbindelse til NTP, DX Cluster, PSK Reporter og opdateringer

På mere beskedne maskiner findes Slow-PC-tilstanden (afsnit 4.9), der nedsætter den grafiske belastning og brugerfladens opdateringsfrekvens.

2.2 Hent pakken

1. Åbn siden Releases i det officielle repository.
2. Hent pakken til dit system: - Windows: x64-installationsprogram; - macOS Apple Silicon / Intel: .dmg-fil; - Linux: AppImage til x86_64 eller aarch64.
3. Installér pakken, eller gør filen eksekverbar, og start Decodium.

2.3 Windows

Kør installationsprogrammet og følg guiden. Ved første start kan Windows bede om netværksadgang: den skal gives, hvis du vil bruge NTP, DX Cluster, PSK Reporter, webdashboardet eller automatiske opdateringer.

Windows-pakkerne er digitalt underskrevet; bemærkningerne om kodesignatur står i filen CODE_SIGNING_POLICY.md i kildekoden.

2.4 macOS

Blokerer macOS programmet på grund af karantæne, så fjern attributten fra det installerede program:

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

Programmets præcise navn kan afvige afhængigt af den byggede pakke.

macOS beder om tilladelse til mikrofonen, første gang Decodium åbner lydindgangen: uden den tilladelse når intet signal frem til dekoderen.

2.5 Linux (AppImage)

Gør AppImage eksekverbar og start den:

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

På nogle distributioner kræves libfuse2, eller du kan udpakke indholdet manuelt:

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

For at få adgang til serielle porte skal brugeren være medlem af den rigtige gruppe (dialout på Debian/Ubuntu, uucp på Arch). Efter tilføjelsen skal du logge ind igen.

2.6 Opdateringer

Decodium har en opdateringskontrol (Setup > Advanced > DATA UPDATES). Findes der en nyere version, vises et vindue med udgivelsesnoterne og linket til pakken. Opdateringen sletter hverken indstillinger, logs eller afkodningshistorik.

3. Første konfiguration

Dette kapitel dækker det mindstemål, der skal til for det første QSO. Det fulde opslag over alle indstillinger står i kapitel 14.

Åbn indstillingerne med knappen ⚙ Setup i den øverste bjælke.

3.1 Station — Setup > Station

Udfyld felterne i afsnittet STATION DETAILS:

Afsnittet STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) har ingen indflydelse på udsendelsen: det leverer data til ADIF-loggen og til de eksterne tjenester. Udfylder du det nu, undgår du ufuldstændige logs senere.

3.2 Radio og CAT — Setup > Radio

Vælg i afsnittet BACKEND CAT, hvordan Decodium taler med radioen:

Derudover kan Decodium arbejde sammen med Ham Radio Deluxe, når radioen allerede er under HRD's kontrol.

Indstil i afsnittet CAT CONTROL den serielle port, hastigheden, stopbits, handshake og PTT-metoden (CAT, RTS, DTR, VOX). På Linux er de stabile stier /dev/serial/by-id/... at foretrække frem for /dev/ttyUSB*, som kan ændre sig ved hver genstart.

Vælg i afsnittet SPLIT OPERATION split-tilstanden:

• None — ingen split, sendetonen bliver inden for lydbåndet;
• Rig — split styret af radioen;
• Fake It — Decodium forskyder VFO-frekvensen for at holde sendetonen i et rent område af filteret.

Fake It er det bedste valg på de fleste moderne radioer, fordi sendetonen holdes væk fra filterets flanker, og forvrængningen ved udsendelse mindskes.

Kontrollér forbindelsen med afsnittet DIAGNOSTICS: du skal kunne se radioens faktiske frekvens, båndskift skal virke i begge retninger, og PTT skal sætte radioen på sending med Tune.

Datatilstande. Decodium forsøger at bevare tilstandene DATA/PKT på Icom-, Yaesu- og Kenwood-radioer, så radioen ikke tvinges over på USB/LSB, når den rigtige indstilling er DATA-U. Falder radioen ud af datatilstanden, når Decodium skifter frekvens, så kontrollér den tilstand, der er valgt i dette afsnit.

CAT-profiler. Du kan gemme flere CAT-konfigurationer som profiler og hente dem frem fra menuen Profile. Det er den hurtigste måde at skifte mellem to radioer, eller mellem opstillingen hjemme og den portable.

3.3 Lyd — Setup > Audio

Vælg i afsnittet AUDIO DEVICES:

• Input: den enhed, der modtager lyden fra radioen (USB-codec eller lydkort);
• Output: den enhed, der sender lyden til radioen;
• Kanal: Mono, Left, Right eller Both, alt efter kabelføringen.

Indstil i afsnittet LEVELS RX- og TX-niveauerne. Decodium har en automatisk RX-niveauregulering, som er slået til som standard, og som beskytter mod klipning uden at du skal jagte skyderen: slår du den fra, så sigt efter et modtageniveau, der holder støjgulvet omkring 30–50 dB på viseren.

Ved udsendelse gælder de digitale tilstandes regel fortsat: ingen kompression, ingen behandling, ALC i hvile. Skru TX-niveauet op til den ønskede effekt og ikke længere. Afsnit 16.2 forklarer, hvordan du læser ALC-telemetrien som kontrol.

På Windows genstartes lydvejen bevidst kraftigt efter udsendelsen for at undgå buffere, der ikke er tømt, og bærebølger, der hænger. Bemærker du en kort stilhed efter hver udsendelse, er det den mekanisme, der arbejder korrekt.

3.4 Ursynkronisering

For FT8, FT4 og — endnu mere afgørende — for FT2 er tidssynkronisering forskellen mellem at afkode og slet ikke at afkode noget.

Decodium indeholder:

• en intern NTP-klient (Setup > Advanced > NTP TIME SYNC);
• panelet DecoSyncTime, der viser forskydningen, synkroniseringsstatus, gennemsnitlig DT for afkodningerne og afkodningsforsinkelsen.

Slå Enable NTP til og kontrollér, at panelet melder synkroniseret tilstand. En gennemsnitlig DT, der systematisk afviger fra nul på mange stationer, peger på et problem med det lokale ur, ikke på udbredelsen.

3.5 Driftstilstand

Vælg tilstanden i vælgeren i den øverste bjælke. Til det første QSO:

1. Begynd med FT8 på en standardfrekvens; så kontrollerer du lyd, CAT og tid under kendte forhold.
2. Kontrollér, at der kommer afkodninger i Full Spectrum inden for en eller to perioder.
3. Skift først derefter til FT2, som er langt mindre overbærende over for fejl i timing og lydkonfiguration.

4. Brugerfladen

4.1 Vinduets opbygning

Decodium 4's hovedvindue består af:

4.2 Den øverste bjælke

Knapperne i den øverste bjælke kan indstilles (Setup > UI Buttons), både hvad synlighed og rækkefølge angår:

Omarrangér knapperne ved at holde nede og trække. Tilbage til den oprindelige opstilling med Restore default button order i Setup > UI Buttons.

4.3 Waterfall og panadapter

Waterfall viser spektrets udvikling over tid; panadapteren viser det øjeblikkelige spektrum med lydfrekvensskalaen nederst.

Vigtigste handlinger:

• venstreklik i waterfall: flytter lydfrekvensen for modtagelse;
• klik med modifikatortast (efter konfigurationen): flytter lydfrekvensen for udsendelse;
• musehjul: zoom eller panorering, afhængigt af området;
• paletter: kan vælges og tilpasses i Setup > Colors > SPECTRUM.

Waterfall kan løsnes i sit eget vindue, sættes fast igen eller minimeres. I kompakt opstilling bruger den en lavere historiktærskel og sparer dermed hukommelse og teksturer uden at miste den synlige del.

4.4 Full Spectrum

Full Spectrum viser alle afkodninger i den aktuelle periode. De synlige kolonner indstilles i Setup > Display > DECODES og omfatter blandt andet afstand (Dist), azimut (Az) og frekvens.

• dobbeltklik på en linje: vælger den station som modstation i QSO'et og klargør meddelelserne;
• Clear: tømmer listen;
• knappen til slutningen af listen (Go to the latest decode) fører visningen tilbage nedad, når du har rullet opad.

Linjerne farves efter reglerne i Setup > Colors > DECODE COLORS: nyt DXCC, nyt kontinent, ny CQ- eller ITU-zone, ny locator, nyt kaldesignal, CQ i meddelelsen, 73/RR73, stationer der allerede er kørt (B4), LoTW-brugere og udsendte meddelelser.

4.5 Signal RX

Signal RX er den kirurgiske visning: den viser kun det, der angår det igangværende QSO og de stationer, der kalder dig. Under et pile-up er det panelet, man holder øje med, for Full Spectrum bliver ulæseligt.

4.6 TX-panel

TX-panelet indeholder:

• meddelelserne TX1…TX7, som kan dannes og redigeres;
• QSO'ets og modstationens status;
• betjeningselementerne: Auto (Auto Sequence), Call, Hold, Tune, Halt;
• sendeeffekten og hurtigbetjeningen til udsendelse.

Rækkefølgen af knapperne i TX-panelet kan også tilpasses, med nulstilling via Restore default TX panel order.

Halt (eller Esc) afbryder udsendelsen med det samme: det er den kommando, du skal kunne udenad.

4.7 Opstilling: sætte fast, løsne, nulstille

Hvert hovedpanel kan:

• løsnes i et selvstændigt vindue (Detach), praktisk med flere skærme;
• sættes fast i opstillingen igen (Dock);
• skjules og derefter gendannes (Restore …);
• flyttes mellem kolonnerne ved at trække;
• føres tilbage til udgangstilstanden med Reset Layout.

Opstillingen gemmes, når du lukker programmet, og indlæses igen ved næste start, inklusive løsnede vinduer og deres placering.

4.8 Kompakt tilstand

Den kompakte tilstand mindsker højden på overskrifter og linjer, så der er plads til flere afkodninger på skærmen. På bærbare og små skærme er det det rigtige valg.

4.9 Slow-PC-tilstand

Slow-PC mode nedsætter belastningen på brugerflade og grafik: lavere opdateringsfrekvens for waterfall, færre animationer, mindre arbejde i den grafiske tråd. Slå den til, hvis du oplever hak i brugerfladen eller forsinket afkodning på ældre maskiner: i FT2 kan en brugerflade, der ikke følger med, koste dig sendeslottet.

4.10 Temaer og udseende

I Setup > Display > ASPETTO / TEMA vælger du temaet (også det mørke tema), brugerfladens farver og skrifttyperne. I Setup > Display > FONT indstilles afkodningernes skrift: brug en skrift med fast bredde, ellers står meddelelsernes kolonner ikke under hinanden.

Del II — Drift

5. QSO'et: fra modtagelse til log

5.1 Start modtagelsen

1. Tryk på Monitor: knappen skifter til STOP, og waterfall begynder at løbe.
2. Kontrollér, at RX-niveauet ikke klipper.
3. Vent en eller to perioder: afkodningerne kommer frem i Full Spectrum ved slutningen af hvert slot.

Afkoder du ingenting, mens waterfall viser signaler, ligger problemet næsten altid i uret (afsnit 3.4) eller i den forkerte tilstand til den frekvens.

5.2 Kald en station

1. Dobbeltklik på stationens linje i Full Spectrum eller Signal RX. Decodium sætter modstationen, danner meddelelserne og vælger det rigtige slot.
2. Kontrollér lydfrekvensen for udsendelse: i FTx-tilstandene er god praksis at sende i et frit område af spektret og ikke oven i den station, du kalder.
3. Se meddelelserne i TX-panelet igennem.
4. Slå udsendelsen til.
5. Med Auto Sequence aktiv fører Decodium QSO'et til ende af sig selv: rapport, bekræftelse, RR73/73.

5.3 Kald CQ

1. Vælg TX6 (CQ-meddelelsen).
2. Slå udsendelsen til, eller brug Auto CQ til at kalde gentagne gange.
3. Følg Signal RX for direkte svar.
4. Lad Auto Sequence arbejde, eller grib ind manuelt.

Med Auto CQ aktiv begynder Decodium at kalde CQ igen efter hvert QSO, med de beskyttelser du har indstillet (watchdog, SWR-kontrol, grænser for gentagelser).

5.4 Auto Sequence og indstillingerne

Setup > TX > AUTO SEQUENCE samler de regler, der styrer automatikken:

Quick QSO er tænkt til contester og højt tempo: det skærer QSO'et ned til fire vekslinger og giver alligevel en gyldig logpost.

5.5 Gentagelser og afslutning af QSO'et

Setup > TX > FT2 UTILITY indeholder parametrene for afslutningen af QSO'et, med særskilte værdier for FT2, FT4 og FT8:

Disse indstillinger har tilsammen et klart formål: at få svage QSO'er afsluttet uden at optage frekvensen i det uendelige. Kører du marginalt DX, så hæv tillægget for de meget svage modstationer; kører du contest, så hold gentagelserne lavt.

5.6 Skriv QSO'et i loggen

Når QSO'et afsluttes, åbner Decodium bekræftelsesvinduet for loggen (hvis Prompt to log QSO er aktiv i Setup > Reporting > LOGGING). QSO'et skrives i den lokale ADIF-log og sendes, hvis det er konfigureret, videre til QRZ Logbook, Cloudlog, LoTW og de tilsluttede eksterne programmer.

Med Alt+L logger du det igangværende QSO uden at bruge musen.

5.7 Worked-before (B4)

Decodium genkender stationer, du allerede har kørt, ud fra kaldesignal, bånd og tilstand tilsammen. Et QSO på 20 m FT2 markerer ikke det samme kaldesignal som kørt på 20 m FT8 eller på 40 m FT2. Farven B4 i Full Spectrum betegner altså en virkelig dublet, og markeringerne "nyt DXCC / locator / zone" er fortsat til at stole på, også når du skifter tilstand under sessionen.

6. Drift i FT2

FT2 er den tilstand, dette projekt begyndte med, og den er fortsat hovedformålet. Dette kapitel samler alt om FT2 på ét sted.

6.1 Hvad du kan forvente af FT2

FT2-slottet er på 3,75 sekunder, og udsendelsen varer omkring 2,52 sekunder. Det betyder to ting:

1. QSO-tempoet er langt højere end i FT8 og mærkbart højere end i FT4: det er fordelen i contester, pile-ups og DX-ekspeditioner, hvor flaskehalsen er tiden pr. QSO og ikke følsomheden.
2. Tiden til at afkode, beslutte og forberede udsendelsen er kort. Lydkonfiguration, urets nøjagtighed og CPU-belastning vejer langt tungere end i FT8.

FT2 er ikke et "bedre FT8": det er en hurtig tilstand, optimeret til forhold, hvor signalet er der, og hvor tid er den knappe ressource.

6.2 Asynkron afkodning

Decodium afkoder FT2 asynkront: i stedet for at vente på slottets slutning og behandle alt på én gang, arbejder programmet på overlappende blokke, mens signalet stadig kommer ind. Det forkorter forsinkelsen mellem afslutningen af modstationens udsendelse og meddelelsens fremkomst på skærmen — tid, du i FT2 har brug for i fuldt omfang for at svare i det rigtige slot.

Status for den asynkrone afkodning ses med knappen Async FT2 (A) i den øverste bjælke.

6.3 Sendeplanlæggeren

TX-planlæggeren i FT2 følger en regel, der ikke er til forhandling: begynd aldrig en udsendelse, der ikke kan blive færdig inden for slottet. En afskåret udsendelse afkodes af ingen og forurener kun frekvensen.

Derfor findes følgende beskyttelser:

Ser du dine udsendelser begynde og derefter blive afskåret, er det første, du skal kontrollere, tidssynkroniseringen; det næste er det konservative TX-vindue.

6.4 FT2's robusthedsindstillinger

Disse indstillinger er til svage, ustabile signaler eller signaler med QSB. Slå dem ikke alle til "for en sikkerhed": hver enkelt koster CPU-tid eller forsinkelse.

Anbefalet udgangspunkt: lad standardværdierne stå, slå FT2 partner-memory til, hvis du kører DX med QSB, og slå Conservative FT2 til alene, når du jager signaler på grænsen.

6.5 Beskyttelser for log og meddelelser

Den sidste indstilling er nyttig, når du skal indberette et problem med sekvensen: den giver det præcise spor af de tilstande, der er gennemløbet, og netop det skal der til for at gengive fejlen.

6.6 Kaldesignaler og hashes

FT2 komprimerer kaldesignaler, ligesom FT8 og FT4. Lange eller sammensatte kaldesignaler sendes som hash og løses af modtageren ud fra kaldesignaler, der allerede er set. Decodium har beskyttelser mod ghost calls (kaldesignaler, der tilsyneladende afkodes, men ikke reelt er der) og mod uløste nyttelaster: kan en meddelelse ikke tilskrives med sikkerhed, bruges den ikke til at føre QSO-sekvensen videre.

Den adfærd er valgt med vilje: et ufuldendt QSO er at foretrække frem for et QSO, der er logget med det forkerte kaldesignal.

6.7 FT2 på begrænsede CPU'er

På langsomme maskiner:

1. slå Slow-PC mode til;
2. slå FT2: adaptive decode (CPU saver) til;
3. overvej FT2: skip redundant end-slot decode;
4. mindsk waterfalls højde og den synlige historik;
5. luk Live Map, hvis du ikke har brug for den.

Prioriteten i FT2 er altid den samme: først timingen, dernæst følsomheden, og til sidst brugerfladens udseende.

7. Multi Answer Mode og kø over kaldende stationer

7.1 Hvad det handler om

Multi Answer Mode (MAM) gør det muligt at betjene flere kaldende stationer på én gang og holde mere end ét QSO i gang. MAM-panelet viser de aktive strømme og lader dig tilføje stationer med dobbeltklik.

Ansvaret er fortsat operatørens: MAM organiserer arbejdet, det tillader det ikke. Sørg for, at dit signal og din konfiguration er i orden, før du bruger det på en travl frekvens.

7.2 Multi-stream

Setup > TX > FT2 UTILITY indeholder:

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — slår håndteringen af flere samtidige strømme til;
• MAM multi-stream: max stream simultanei — hvor mange strømme der tillades.

Indstillingen er mærket eksperimentel: den øger antallet af samtidige udsendelser og dermed også lejligheden til at begå fejl. Begynd med to strømme.

7.3 Kø over kaldende stationer

Panelet Caller Queue samler de stationer, der kalder dig, og lader dig ordne dem efter driftsmæssige kriterier. Det er det naturlige værktøj, når du kalder CQ fra en efterspurgt station, og svarene kommer hurtigere ind, end du kan afvikle dem.

8. DX-Pedition- og contesttilstande

8.1 Fox / Hound / SuperFox

I Setup > Advanced > OPERATING MODE:

OTP-indstillingerne (Setup > Advanced > OTP: OTP Enabled, OTP Seed, OTP Interval, OTP URL) angår dannelsen og udbredelsen af de koder, en aktivitet kontrolleres med: de vedrører den, der arrangerer en ekspedition, ikke den enkelte kaldende station.

8.2 DX-Pedition Workspace

DX-Pedition Workspace er en særlig opstilling, der i én visning stiller Full Spectrum · Decode, Signal RX · QSO Lock og Log · QSO Entry side om side, med UTC-tid og operatørens kaldesignal. Den er tænkt til operatørvagter på en efterspurgt station, hvor båndaktivitet, det igangværende QSO og logindtastningen skal være for øje på samme tid.

8.3 Contest

Setup > Advanced > CONTEST fastsætter den igangværende aktivitet:

• Activity: None, Field Day, Fox, Hound;
• FD Exchange og RTTY Exchange: de udvekslinger, reglementet kræver;
• Contest Name, Indiv Name, NCCC Sprint: parametre til de enkelte formater.

Valget af aktivitet ændrer dannelsen af meddelelserne: kontrollér altid TX-meddelelserne, før du begynder at sende i en contest.

9. Avanceret afkodning

Setup > Advanced > ADV DECODING samler tre redningsteknikker, som kan slås til enkeltvis eller styres automatisk:

Med Auto Mode aktiv slår Decodium de tre teknikker til kun når der er brug for dem, ud fra de målte forhold; feltet Live state viser, hvilke der er aktive på et givet tidspunkt.

Prisen for disse indstillinger er CPU-tid. På langsomme maskiner gør det tilstanden værre, ikke bedre, at slå dem alle til i hånden: Auto Mode er det fornuftigste valg i de fleste tilfælde.

Andre afkodningsindstillinger findes i Setup > Decode:

• DECODE PARAMETERS — dybde og almindelige parametre for afkodningen;
• JT65 VHF/UHF — parametre særligt til brug på VHF/UHF;
• SIDELOBE CONTROL — styring af sidelobberne;
• DECODE FILTERS — filtre på afkodningerne (se afsnit 12.4).

10. Live Map, Astro og Time Sync

10.1 Live Map

Live Map viser de afkodede stationer og vejene mellem din station og deres, med markører farvet efter retning og tilstand. Kortet nulstilles automatisk ved skift af bånd eller tilstand og når du tømmer afkodningslisterne, så aktivitet, der ikke længere gælder, ikke bliver stående på kortet.

Under udsendelse opdateres kortet med vilje langsommere: det er en prioritering, for den grafiske tråd må ikke tage tid fra udsendelsen.

Har du ikke brug for kortet, frigør det GPU og hukommelse at lukke det — det er det første panel, man giver op på beskeden hardware.

10.2 Astro

Panelet Astro leverer de astronomiske data, der er nyttige til EME og til VHF/UHF-drift: Månens position, azimut og elevation, doppler, degradation. Mappen med AzEl-data indstilles i Setup > Audio > DIRECTORY.

10.3 Time Sync (DecoSyncTime)

Panelet DecoSyncTime samler alt om tid:

• NTP-status og den anvendte forskydning;
• gennemsnitlig DT beregnet over de modtagne afkodninger;
• afkodningsforsinkelse;
• antal målinger, der er brugt til vurderingen.

Sådan læses det:

Der er også en vurdering af lydkortets drift i ppm med en grøn/gul/rød visning: en stor drift forskyder efterhånden slottenes timing og er typisk for billige USB-codecs.

11. Log, onlinetjenester og integrationer

11.1 Lokal QSO-log

Decodium fører den lokale ADIF-log og vinduet QSO Log med indtastning og redigering af QSO'er. Indstillingerne for adfærd findes i Setup > Reporting > LOGGING: bekræftelse før logning, obligatoriske felter, rapporternes format.

11.2 PSK Reporter

Decodium sender iagttagelserne til PSK Reporter og lader dig søge efter dine egne spots i det tilhørende panel. Afsendelsen sker via en kø: er der ingen iagttagelser at sende, holdes der ingen baggrundstrafik i gang mod tjenesten.

11.3 QRZ Logbook, Cloudlog og LoTW

For Cloudlog normaliserer Decodium API-endepunktet og skelner i fejlmeddelelserne mellem problemer med HTTP, godkendelse og proxy: fejler upload, siger meddelelsen, hvilket af de tre det er.

LoTW-dataene bruges også til at fremhæve LoTW-brugere i Full Spectrum (farven LoTW marker).

11.4 DX Cluster

Panelet DX Cluster forbinder til en telnet-node og viser spots med mulighed for filtrering. Konfigurationen findes i Setup > Reporting > DX CLUSTER (vært, port, kaldesignal til login, filtre).

11.5 Integration med eksterne programmer

Bruger du JTAlert eller GridTracker, skal UDP-serveren være aktiv, og porten skal svare til den, der er indstillet i det eksterne program.

11.6 Lydoptagelse

Setup > Reporting > RECORDING styrer optagelsen af den modtagne lyd — nyttigt til senere analyse og til at vedlægge virkelige prøver til en fejlindberetning.

12. Afkodningshistorik, filtre og alarmer

12.1 Decode History

Decodium gemmer afkodningerne i en SQLite-database, som du kan søge i fra vinduet History. Du kan søge på:

• kaldesignal;
• bånd;
• tilstand;
• UTC-datointerval;
• grænse for antal resultater.

Resultaterne kan eksporteres til ADIF. Historikken overlever, at programmet lukkes, og gør analyse bagefter mulig: kontrol af udbredelsen, gennemgang af aktiviteten på båndet, rekonstruktion af et tvivlsomt QSO.

De direkte visninger i hukommelsen er begrænsede, så RAM-forbruget ikke vokser under lange sessioner; den fulde historik forbliver i databasen.

12.2 Lydalarmer

Setup > Alerts > AUDIO ALERTS lader dig knytte en lyd til bestemte hændelser: nyt DXCC, ny locator, et kaldesignal du søger, et direkte kald. Det er måden at arbejde i baggrunden uden at stirre på skærmen.

12.3 Filtre: blacklist, whitelist og territorier

Setup > Filters indeholder:

ALWAYS PASS har forrang: det er stedet til kaldesignalet på en ven, du aldrig vil gå glip af, også når du filtrerer hårdt.

12.4 Afkodningsfiltre

Setup > Decode > DECODE FILTERS griber ind tidligere, i dekoderens arbejde og i det, der offentliggøres på listerne. Brugt med omtanke nedsætter det CPU-belastningen på et travlt bånd.

13. Fjernbetjent webdashboard og FT2-Link

13.1 Fjernbetjent webdashboard (iPad, telefon, PWA)

Decodium indeholder en intern webserver, som lader dig betjene stationen fra en anden enhed på samme lokalnet.

Sådan slås det til

1. Åbn Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) eller Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Slå serveren til og fastsæt port og loginoplysninger.
3. Find stationscomputerens IP-adresse.
4. Åbn http://IP-ADRESSE:PORT i browseren på tabletten eller telefonen.
5. Føj siden til hjemmeskærmen for at bruge den som app (PWA).

Sikkerhed — læs dette, før du slår det til

• Brug serveren kun på lokalnettet. Gør den ikke tilgængelig fra internettet og åbn ikke porte på routeren.
• Vælg en adgangskode, der ikke er triviel: den, der kan nå dashboardet, kan styre din station og dermed din udsendelse.
• På delte net (hoteller, klubstationer, messer) lad serveren være slukket, når du ikke bruger den.

Vejledningen trin for trin til begyndere ligger i filen doc/WEBAPP_SETUP_GUIDE.en-GB.md i kildekoden, med afsnittet om fejlfinding og beskrivelsen af API-endepunkterne til avanceret brug.

13.2 FT2-Link (eksperimentel)

FT2-Link er en åben protokol til pålidelig chat og meddelelser, under udvikling inde i Decodium. Den er offentligt dokumenteret og uafhængig af modemmet: samme ARQ kan køre over forskellige signalformer.

Det tænkte forløb er: beacon eller CQ på NARROW, svaret HELLO, forhandling om den bedste fælles profil, skift til W500 eller W2300 til dataene, og tilbagefald til NARROW, hvis den brede profil ikke holder.

FT2-Links arbejdsperiode er 15 sekunder, i modsætning til FT2's 3,75 s.

Bemærk. FT2-Link er eksperimentelt materiale, og profilerne W500/W2300 er ikke standard-FT2 og må ikke fremstilles som sådan. Kontrollér de bestemmelser, der gælder for den båndbredde, du agter at bruge, i dit bånd og din IARU-region, før du sender.

Del III — Opslag

14. Opslag over indstillinger

Indstillingerne er ordnet i tretten faneblade. Nedenfor er alle afsnit opregnet i den rækkefølge, de står i, med deres funktion.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

De færdige profiler sætter i én handling et sammenhængende sæt parametre:

Den aktive profil er markeret med ● active. Du kan tage udgangspunkt i en profil og derefter ændre enkelte indstillinger: dine ændringer bliver stående og overskrives først, når du anvender en anden profil.

14.4.2 Watchdog

Lad watchdoggen være slået til. Det er den beskyttelse, der forhindrer en glemt bærebølge på båndet, når du forlader lokalet.

14.5 Display

Procesprioritet. High (recommended) er den anbefalede indstilling. Realtime er forsynet med en advarsel: på nogle systemer kan computeren blive langsom eller ustabil. Brug den ikke, hvis du ikke foretager særlige målinger.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Styring af arbejdsfrekvenserne: liste pr. bånd og tilstand, tilføjelse, ændring, indlæsning og lagring i filerne .qrg / .qrg.json, med mulighed for at flette (Merge Working Frequencies) en ekstern liste ind i din egen i stedet for at erstatte den.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — tilknytning af lyde til hændelser (nyt DXCC, ny locator, søgt kaldesignal, direkte kald).

14.12 Filters

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

14.13 UI Buttons

TOP TOOLBAR (knappernes synlighed) og TOOLBAR BUTTON ORDER (rækkefølge, med nulstilling til standardværdierne for både bjælken og TX-panelet).

15. Tastaturgenveje

Udsendelse

Betjening (Ctrl)

Handlinger (Alt)

Andet

Den fulde liste kan ses i programmet under Keyboard Shortcuts.

16. Diagnose og fejlfinding

16.1 Jeg afkoder ingenting

Gå punkterne igennem i denne rækkefølge:

1. Kører Monitor? Knappen skal vise STOP.
2. Løber waterfall? Står den stille, ligger problemet i lydindgangsenheden og ikke i dekoderen.
3. Er RX-niveauet fornuftigt? Et alt for lavt støjgulv og klipning forhindrer afkodningen lige meget.
4. Er uret synkroniseret? Kontrollér Time Sync-panelet. I FT2 og FT4 er få tiendedele sekund nok til at miste alt.
5. Passer tilstanden til frekvensen? FT8 på en FT4-frekvens afkoder ingenting.
6. Er lydkanalen den rigtige? Med en stereo-codec svarer den forkerte kanal til stilhed.

16.2 Jeg sender, men ingen svarer

• Kontrollér, at PTT virker, og at radioen virkelig går på sending.
• Kontrollér telemetrien i Setup > Radio > DIAGNOSTICS: effekten skal svare til den forventede, og ALC skal blive i hvile. Visningen ALC -- betyder, at værdien ikke er tilgængelig, mens 0 er en gyldig værdi: det er to forskellige situationer.
• Kontrollér SWR: Check SWR blokerer ikke Tune, så du kan måle og rette, men den beskytter den faktiske udsendelse og Auto CQ.
• Sørg for, at du ikke sender uden for slottet: i FT2 afviser det konservative TX-vindue (afsnit 6.3) sene udsendelser, og det er den rigtige adfærd.

16.3 Grafik- og ydelsesproblemer

Visningen af CPU-pres i Setup > Display > UI — PERFORMANCE tæller sessionens overbelastningshændelser: stiger tælleren severe, følger computeren ikke med, og konfigurationen skal lettes.

16.4 Lyden hænger, eller der står en bærebølge efter udsendelsen

Decodium har en TX-lydwatchdog, som netop er tænkt til dette tilfælde. Sker det:

1. brug Halt (eller Esc);
2. kontrollér, at PTT er frigivet på radioen;
3. kontrollér lydudgangsenheden i Setup > Audio;
4. sker det hver gang, så tag en diagnoselog og indberet tilfældet.

16.5 CAT-porte, der skifter eller optræder dobbelt

Brug på Linux stierne /dev/serial/by-id/..., som er stabile hen over genstarter. Optræder den samme enhed to gange (som /dev/ttyUSB0 og som by-id-sti), så vælg by-id-stien og ikke begge: det er den samme fysiske enhed.

16.6 Sådan indberetter du en fejl brugbart

Decodium har et vindue til fejlindberetning. En brugbar indberetning indeholder:

• programmets præcise version (About Decodium);
• operativsystem og platform;
• den anvendte radio og CAT-backend;
• driftstilstand og frekvens;
• beskrivelsen af de trin, der gengiver problemet;
• diagnoseloggen og, hvis problemet angår afkodningen, en WAV-fil med signalet;
• ved problemer med FT2-sekvensen: slå FT2 state transition census (log only) til og vedlæg sporet.

17. Filer, mapper og brugerdata

Decodium bruger systemets standardmapper, som Qt foreskriver, til:

• konfigurationsindstillingerne;
• QML-cachen;
• SQLite-databasen med afkodningshistorikken (db.sqlite);
• CTY.DAT og DXCC-dataene;
• ADIF-loggen;
• diagnoselogfilerne;
• lydoptagelserne.

De præcise placeringer afhænger af platformen. Den mest pålidelige måde at finde dem er at læse startloggen, hvor Decodium udskriver de vigtigste stier (AppDataLocation, CacheLocation, databasens sti).

Til en fuld sikkerhedskopi af konfigurationen skal du have: mappen med indstillinger, ADIF-loggen og databasen med historikken.

Decodium har også en migrering af lagringen: ændrer datastrukturen sig mellem versioner, omdannes de eksisterende filer ved første start. Før en større opdatering er en kopi af datamappen alligevel den fornuftige forsigtighed.

18. Byg fra kildekoden

18.1 Afhængigheder

Afhængigt af platformen skal du have:

• CMake (3.20 eller nyere) og en nyere C/C++-compiler;
• Qt 6 med modulerne Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql og WebSockets;
• Hamlib;
• en Fortran-compiler (gfortran) til de ældre komponenter, der stadig er der;
• Boost og de øvrige afhængigheder, der er nævnt i build-filerne.

18.2 Build-scripts

Repositoryet indeholder færdige scripts til de vigtigste platforme:

Bemærkningerne særligt til Windows står i doc/building on MS Windows.txt og de tilstødende filer; overførslen til macOS er beskrevet i doc/MACOS_PORTING_v1.2.0.md.

18.3 Test

Mappen tests/ indeholder unit-testene og sammenligningerne mellem dekodernes implementeringer, herunder testene til FT2 og FT2-Link. Kør dem med:

ctest --output-on-failure

Sammenligningstestene mellem afkodningstrin er det rette værktøj til at kontrollere, at en ændring i dekoderen ikke har givet en forringelse af følsomheden.

19. Ordliste

20. Tak, licens og kontakt

Projektet

• Martino Merola — IU8LMC — ophavsmand til FT2, lead developer på DECODIUM
• Salvatore Raccampo — 9H1SR — C++-kerne, builds og pakker til macOS og Linux
• Testerne og bidragyderne i FT2-fællesskabet, hvis indberetninger har styret en stor del af arbejdet med de seneste udgivelser
• Fællesskabets oversættere, som vedligeholder programmets oversættelser

Kodens oprindelse

Decodium nedstammer fra linjen WSJT-X, udviklet af Joe Taylor K1JT, Steve Franke K9AN, Bill Somerville G4WJS og projektets øvrige forfattere og udbredt under GPL. Filerne AUTHORS, THANKS og COPYING i kildekoden indeholder de fulde krediteringer og licensen. Dette projekts egne bidrag — FT2-protokollen, de omskrevne dekodere og modulatorer, QML-brugerfladen, de integrerede tjenester — er beskrevet i commit-historikken og i CHANGELOG.md.

Licens

Decodium 4.0 Core Shannon er fri software, udbredt under GNU General Public License version 3. Du må bruge, undersøge, ændre og videregive programmet på licensens betingelser. Programmet leveres uden nogen garanti, i det omfang gældende ret tillader det.

Hvor du finder hjælp

• Projektets websted: ft2.it
• Fællesskab og støtte: community.ft2.it
• Telegram-kanalen FT2 Digital Mode
• Tekniske indberetninger: afsnittet Issues i GitHub-repositoryet

Afsluttende bemærkning om driften

Decodium styrer en sender. Ansvaret for det, der går i luften — bånd, båndbredde, effekt, tider, tilladelser — ligger hos den operatør, der har licensen. Programmets eksperimentelle funktioner, især FT2-Links brede profiler og multi-stream-tilstandene, bør først bruges, når du har kontrolleret de bestemmelser, der gælder i dit bånd og din IARU-region.

73 de IU8LMC