Amateur Data Interchange Format

from Wikipedia, the free encyclopedia
Amateur Data Interchange Format
File extension : .adi .adx
MIME type : application, text
Developed by: Raymond R. Ortgiesen IV
Initial release: 1996
Current version: 3.0.8 (as of February 3, 2018)
Standard (s) : ASCII , Unicode , UTF-8 , XML
Website : adif.org


The Amateur Data Interchange Format ( ADIF for short ) is a file format that describes the structure of a file for storing or exchanging logbooks in the amateur radio service . The filename extensions are .adi and .adx .

It is the de facto standard for storing and exchanging general logbooks using amateur radio software.

Based on the discussion about the development intention of a uniform standard for the exchange of logbooks, the developer and radio amateur Raymond R. Ortgiesen IV presented the Amateur Data Interface Format ( ADIF ) in version 1.0 with the filename extension .adi during the Dayton Hamvention 1996 in Dayton . Within a year this format was adapted into many amateur radio programs.

In 2010 the file format was defined with the filename extension .adx to support international characters using Unicode with UTF-8 . The ADX format is based on XML .

File structure

ADI

The ADI format consists of four components:

  • Physical structure : Each attribute is operationally defined by a preceding tag . The tags are case insensitive . The tag consists of the field name and the character length of the attribute, separated by a colon. The end of a data record is also <eor>defined.
Example:
<call:6>DL1XYZ<band:3>80M<mode:4>RTTY<qso_date:8>20170224<time_on:4>1709<eor>
  • As day find in addition to the mandatory information on call sign of the other station, amateur band , mode , date and time other optional data such. B. Country (defined by the numeric DXCC entity), location information, e.g. B. by QTH-Locator or amateur radio diploma program references such as SOTA or IOTA as well as user-defined variants use.
  • Defined mandatory attributes are date (format YYYYMMDD) and time in UTC (format HHMMSS) and amateur band (format NNM, where N is an integer wavelength and M is a metric unit of measurement with a unit prefix; example:) .<band:4>70cm
  • File structure : Optional header with information about the ADIF version and any software used, closed with <eoh>, followed by data records as defined in the physical structure.
Example:
<adif_ver:5>3.0.5<programid:9>SampleLog<eoh>

ADX

The ADX format uses the XML with UTF-8. The hierarchical structure consists of the root tag <ADX> , which contains a <HEADER>tag and at least one <RECORDS>tag with zero or more <RECORD>elements. The tag names and attributes are identical to those of the ADI format.
Example of an ADX file 

<?xml version="1.0" encoding="UTF-8"?>
<ADX>
    <HEADER>
           <ADIF_VER>3.0.5</ADIF_VER>
           <PROGRAMID>SampleLog</PROGRAMID>
           <USERDEF FIELDID="1" TYPE="N">EPC</USERDEF>
    </HEADER>
    <RECORDS>
           <RECORD>
                  <QSO_DATE>20170224</QSO_DATE>
                  <TIME_ON>1709</TIME_ON>
                  <CALL>DL1XYZ</CALL>
                  <BAND>80M</BAND>
                  <MODE>RTTY</MODE>
                  <USERDEF FIELDNAME="EPC">123456789</USERDEF>
          </RECORD>
    </RECORDS>
</ADX>

use

In addition to the use of the ADIF standard by logbook software, it is also used in other amateur radio applications, such as programs for coding and decoding digital operating modes (e.g. WSJT , ROS ). Contest software also offers the option of importing and exporting data sets in ADI format, but the Cabrillo format, or more rarely the Stützerbach format , is used for the evaluation of the logbooks by the contest organizer . The Amateur Radio Ordinance (AfuV) prescribes keeping a station diary (logbook) during training radio operations in accordance with Section 12 (4) AfuV or in special cases in accordance with Section 17 (1) AfuV . This can also be done in digital form.

Individual evidence

  1. ↑ Amateur Data Interchange Format (ADIF) Specification. Arve Olaussen, February 3, 2018, accessed on September 19, 2018 .
  2. ↑ a b Amateur Data Interchange Format (ADIF) Specification; I. Introduction. Arve Olaussen, February 24, 2017, accessed on June 1, 2017 .
  3. ↑ Amateur Data Interchange Format 1.0 (ADIF) Specifications. Arve Olaussen, July 11, 2003, accessed September 10, 2014 .
  4. ↑ a b Amateur Data Interchange Format (ADIF) Specification; IV.B. ADX File Format. Arve Olaussen, February 24, 2017, accessed on June 1, 2017 .
  5. ↑ Amateur Data Interchange Format (ADIF) Specification; IV.A. ADI file format. Arve Olaussen, February 24, 2017, accessed on June 1, 2017 .
  6. ↑ Trey Garlough: Cabrillo V2.0 FAQ. (No longer available online.) January 31, 2000, archived from the original on September 24, 2014 ; accessed on September 10, 2014 .
  7. ↑ Sean Kutzko: Submitting an Electronic Contest “What's this Cabrillo Log Format I've been hearing about?” (PDF) Retrieved September 10, 2014 (English).
  8. ↑ Contest FAQ, Section: What is the STF format? In: BCCWiki. Bavarian Contest Club (BCC), accessed September 10, 2014 .
  9. ↑ The "STützerbach Format" - STF. DARC eV , May 1, 2004, accessed on September 10, 2014 .
  10. ↑ BG108 What should you watch out for when creating a “computer logbook” when the logbook is arranged? (PDF) In: Examination questions in the examination sections "Operational Knowledge" and "Knowledge of Regulations" for examinations for the acquisition of amateur radio certificates of classes A and E. Federal Network Agency , October 2006, p. 27 , accessed on September 10, 2014 .

Web links