ADIF

ADIF (Amateur Data Interchange Format) – Umfassender Leitfaden

Einführung

ADIF ist ein standardisiertes Dateiformat, das speziell für den Amateurfunk entwickelt wurde. Es dient dem Austausch von Logbuch-Daten zwischen verschiedenen Amateurfunk-Programmen und -Plattformen. Das Format wurde 1996 eingeführt und hat sich seitdem zum De-facto-Standard für den Datenaustausch im Amateurfunk entwickelt.

Technische Spezifikation

Grundstruktur

Ein ADIF-File besteht aus zwei Hauptteilen:

  1. Header (optional)
  2. Datensätze (Records)

Dateiformat

  • Dateierweiterung: .adi oder .adif
  • Zeichenkodierung: ASCII oder UTF-8
  • Zeilenende: CR, LF oder CR+LF (plattformunabhängig)

Header-Format

Der Header enthält Metainformationen über die Datei und wird durch <EOH> (End Of Header) abgeschlossen. Beispiel:

ADIF Export from [Programm]
<ADIF_VER:5>3.1.0
<PROGRAMID:7>WSJT-X
<PROGRAMVERSION:5>2.5.4
<EOH>

Feldformat

Jedes Feld folgt diesem Format: <Feldname:Länge:Typ>Daten

  • Feldname: Name des Feldes in Großbuchstaben
  • Länge: Länge der Daten in Bytes
  • Typ: Datentyp (optional)
  • Daten: Die eigentlichen Daten

Wichtige Datentypen

  • N: Nummer
  • S: String
  • D: Datum (YYYYMMDD)
  • T: Zeit (HHMMSS)
  • B: Boolean
  • M: Mehrzeiliger String
  • E: Aufzählung

Pflichtfelder

Jeder ADIF-Record muss mindestens diese Felder enthalten:

  • CALL: Rufzeichen der Gegenstation
  • QSO_DATE: Datum der Verbindung
  • TIME_ON: Startzeit der Verbindung
  • BAND oder FREQ: Frequenzband oder genaue Frequenz
  • MODE: Betriebsart

Beispiel eines vollständigen QSO-Eintrags

<CALL:5>DL1AB
<QSO_DATE:8>20240215
<TIME_ON:6>143000
<BAND:3>20m
<MODE:3>SSB
<RST_SENT:3>599
<RST_RCVD:3>579
<COMMENT:20>Gute Signalqualität
<EOR>

Beispiel mit erweiterten Infos:

<band:3>20m
<call:4>KK9A
<cnty:12>NC, Cabarrus
<cont:2>NA
<contest_id:10>CQ-WPX-SSB
<country:13>United States
<dxcc:3>291
<freq:6>14.282
<gridsquare:6>EM95re
<lotw_qsl_rcvd:1>Y
<lotw_qsl_sent:1>Y
<lotw_qslrdate:8>20200402
<lotw_qslsdate:8>20200406
<mode:3>SSB
<my_city:11>Westminster
<my_cnty:13>CO, Jefferson
<my_country:13>United States
<my_gridsquare:6>DM79lv
<my_name:20>Christopher C Keller
<my_state:2>CO
<name:12>JOHN P BAYNE
<qrzcom_qso_upload_date:8>20200329
<qrzcom_qso_upload_status:1>Y
<qsl_via:6>WD9DZV
<qso_date:8>20200329
<qso_date_off:8>20200329
<qth:7>MIDLAND
<rst_rcvd:2>59
<rst_sent:2>59
<srx:4>1592
<state:2>NC
<station_callsign:5>K0SWE
<stx:1>1
<time_off:4>0034
<time_on:4>0034
<tx_pwr:3>100
<eor>

Häufig verwendete Felder

  • OPERATOR: Rufzeichen des Operators
  • MY_GRIDSQUARE: eigener Gridlocator
  • GRIDSQUARE: Gridlocator der Gegenstation
  • FREQ: Frequenz in MHz
  • TX_PWR: Sendeleistung in Watt
  • COMMENT: Kommentare zum QSO
  • QSL_SENT: QSL-Status gesendet
  • QSL_RCVD: QSL-Status empfangen

Best Practices

Dateneingabe

  1. Verwende standardisierte Formate für:
    • Datum (YYYYMMDD)
    • Zeit (HHMMSS)
    • Frequenzen (MHz mit Dezimalpunkt)
    • Rufzeichen (ohne zusätzliche Spaces)
  2. Achte auf korrekte Feldlängen:
    • Die Längenangabe muss exakt der Byte-Länge der Daten entsprechen
    • Bei UTF-8-Zeichen die korrekte Byte-Länge beachten

Datenvalidierung

  • Überprüfe Pflichtfelder
  • Validiere Datumsformate
  • Stelle sicher, dass Aufzählungsfelder gültige Werte enthalten
  • Prüfe die Konsistenz von zusammenhängenden Feldern

Software und Tools

Logbuch-Programme mit ADIF-Unterstützung

  • Log4OM
  • N1MM+ Logger
  • DXKeeper
  • HAM Radio Deluxe
  • WSJT-X
  • ACLog
  • Logger32

ADIF-Validierungswerkzeuge

  • ADIF Validator (online)
  • ADIFmaster
  • ADIF Parser Libraries für verschiedene Programmiersprachen

Anwendungsfälle

QSO-Datenaustausch

  • Import/Export zwischen verschiedenen Logbuch-Programmen
  • Upload zu Online-Logbüchern (LoTW, eQSL, ClubLog)
  • Backup von Logbuch-Daten
  • Zusammenführen von Logs verschiedener Operator

Wettbewerbe und Diplome

  • Export von Contest-Logs
  • Einreichung von Diplom-Anträgen
  • Auswertung von Wettbewerbsergebnissen
  • Validierung von QSOs für Auszeichnungen

Zukunft von ADIF

Aktuelle Entwicklungen

  • Integration von digitalen Betriebsarten
  • Erweiterung für neue Technologien
  • Verbesserung der Datensicherheit
  • Standardisierung von Contest-spezifischen Feldern

Geplante Verbesserungen

  • Bessere UTF-8-Unterstützung
  • Neue Felder für moderne Betriebsarten
  • Erweiterte Metadaten-Unterstützung
  • Verbesserte Validierungsmöglichkeiten

Wichtigste Felder

TQSLInfo as contained in ADIF 3.1.2 spec
FieldReq/OptField NameData TypeEnumerationDescription
CALLReqCALLStringN/Athe contacted station’s Callsign
BANDOpt1BANDEnumerationBandQSO Band
MODEReqMODEEnumerationModeQSO Mode
SUBMODEOptSUBMODEStringSubmodeQSO Submode – use enumeration values for interoperability
QSO_DATEReqQSO_DATEDateN/Adate on which QSO started
TIME_ONReqTIME_ONTimeN/AHHMM or HHMMSS in UTC
FREQOpt1FREQNumberN/A 7QSO frequency in Megahertz
FREQ_RXOptFREQ_RXNumberN/A 7in a split frequency QSO, the logging station’s receiving frequency in Megahertz
BAND_RXOptBAND_RXEnumerationBand 
SAT_NAMEOptSAT_NAMEString name of satellite
PROP_MODEOpt2PROP_MODEEnumerationPropagation ModeQSO propagation mode
MY_CNTYOptMY_CNTYEnumeration(Secondary Administrative Subdivision, function of MY_DXCC field’s value)the logging station’s Secondary Administrative Subdivision (e.g. US county, JA Gun), in the specified format
MY_COUNTRYOptMY_COUNTRYStringCountrythe logging station’s DXCC entity name
MY_CQ_ZONE OptMY_CQ_ZONEPositiveInteger the logging station’s CQ Zone in the range 1 to 40 (inclusive)
MY_DXCCOptMY_DXCCEnumerationDXCC Entity Codethe logging station’s DXCC Entity Code 3
MY_GRIDSQUAREOptMY_GRIDSQUAREGridSquarethe logging station’s 2-character, 4-character, 6-character, or 8-character Maidenhead Grid Square
MY_IOTAOptMY_IOTAIOTARefNoN/A 
MY_ITU_ZONEOptMY_ITU_ZONEPositiveIntegerN/Athe logging station’s ITU zone in the range 1 to 90 (inclusive)
MY_STATEOptMY_STATEEnumeration(Primary Administrative Subdivision, function of MY_DXCC field’s value)the code for the logging station’s Primary Administrative Subdivision (e.g. US State, JA Island, VE Province)
MY_VUCC_GRIDSOptMY_VUCC_GRIDSGridSquareListN/Atwo or four adjacent Maidenhead grid locators, each four characters long, representing the logging station’s grid squares that the contacted station may claim for the ARRL VUCC award program.  E.g. EN98,FM08,EM97,FM07
OPERATOROptOPERATORStringN/Athe logging operator’s callsign 4
STATION_CALLSIGNOptSTATION_CALLSIGNStringN/Athe logging station’s callsign (the callsign used over the air) 5
OWNER_CALLSIGNOptOWNER_CALLSIGNStringN/Athe callsign of the owner of the station used to log the contact (the callsign of the OPERATOR’s host)

Bemerkung:
1 Entweder Band oder Freq müssen bereitgestellt werden. Wenn nur FREQ bereitgestellt wird, wird die Band abgeleitet. Wenn beide bereitgestellt werden, wird die Band verwendet.
2 Wenn SAT_NAME bereitgestellt wird, muss Prop_Mode auf SAT gesetzt werden.

3 0 bedeutet, dass die Protokollierungsstation bekannt ist, dass sie sich nicht innerhalb einer DXCC -Entität befindet.

4 Wenn nicht in Owner_callsign vorhanden ist, wird station_callsign als sowohl als Rufzeichen der Protokollierungsstation als auch als Rufzeichen des Eigentümers der Station behandelt

5 Wenn station_callsign vorhanden ist, wird der Betreiber sowohl als Rufzeichen der Protokollierungsstation als auch als Rufzeichen des Protokollierungsbetreibers behandelt

6 Wenn nicht in Owner_callsign vorhanden ist, wird station_callsign als sowohl als Rufzeichen der Protokollierungsstation als auch als Rufzeichen des Eigentümers der Station behandelt

7 Die Frequenz muss mit einem Eintrag in die Bandaufzählung übereinstimmen.

Alle Definitionen der Felder der Version 3.15 findest du hier: https://adif.org/315/ADIF_315.htm

Fazit

ADIF hat sich als robuster und flexibler Standard für den Austausch von Amateurfunk-Logbuchdaten etabliert. Die kontinuierliche Weiterentwicklung und breite Unterstützung in der Software-Landschaft machen es zum unverzichtbaren Werkzeug für moderne Funkamateure. Die klare Struktur und gute Dokumentation ermöglichen sowohl eine einfache manuelle Bearbeitung als auch eine programmatische Verarbeitung der Daten.

Weitere Links

Link https://qslworld.com/

http://analyzer.adventureradio.de/

Wichtige Links und Ressourcen

Offizielle Dokumentation und Standards

Logbuch-Software mit ADIF-Unterstützung

Kostenlose Software

Kommerzielle Software

Online-Logbücher und Dienste

Entwickler-Ressourcen

Organisationen

Contest-Ressourcen mit ADIF-Support

Support-Communities

Hinweise

Einige Ressourcen können eine Registrierung oder Lizenzierung erfordern
Alle Links wurden im Februar 2024 auf Funktionalität überprüft
Die Software-Links führen zu den offiziellen Webseiten der jeweiligen Anbieter
Bei kommerzieller Software sind aktuelle Preise auf den jeweiligen Webseiten zu finden