Difference between revisions of "Contest configuration"

From DXLog.net
Jump to navigation Jump to search
(Message macros)
(Message macros)
Line 439: Line 439:
 
|}
 
|}
  
'''Location of macro values and contest configuration keys in the contest configuration panel.'''
+
'''Location of macro values in the contest configuration panel.'''
  
[[image:Configurationpaneltagged.png|800px]]
+
[[image:Configurationpaneltaggedmacros.png|800px]]
  
 
==Supported contests==
 
==Supported contests==

Revision as of 16:30, 21 April 2020

Contest configuration

DXL ContestConfig1.png

Station
Callsign The Callsign which will be used during the contest
Grid square Your Maidenhead grid square (6 letters) which will be used in VHF/UHF/SHF contests for QRB calculations
Exchange Contest specific exchange field
DXCC prefix your DXCC standard prefix
WAZ zone Your CQ zone number
ITU zone Your ITU zone number
State/Province/Other Your US state, Canadian province or DX for all other countries
Name The name which will be inserted in the final Cabrillo file
Address The address which will be inserted in the final Cabrillo file
Club The name of your club for club competitions
Contest
Contest Select the relevant contest or dxpedition template
Category Select the stations contest operation category
Overlay Select the stations contest overlay category (if required).
Class Select the stations contest power class.
Mode Select the mode of operation for the Contest
Op. name Enter the operators name (if required)
Power Enter the station's power level (if required). Can be set to 1TT, KW, etc. if used for contest exchange.
Operators Enter a comma separated list of callsigns of the station operators.

NB. There is no band category setting. Some contest definitions include categories which also include bands but most do not.
Lacking an explicit band category, DXLog will automatically determine it.
If your log contains QSO on more than band, exported Cabrillo file will say CATEGORY-BAND: ALL.
If your log contains QSO only on one band, say 20m, the exported Cabrillo file will say CATEGORY-BAND: 20M
All X-QSO are ignored in this process, so if you accidentally make a QSO on the "wrong" band, simply mark it invalid using [Ctrl][X].

After pressing enter (or mouse click on OK button) all fields are checked against contest rules defined in contest config file.
If any fields contain incorrect data, DXLog will supply a warning with instructions on how to correct the data,
It may also show possible links to the contest rules (if link is defined in contest config file).

Irregular contest configurations

Since the contest configuration panel in DXLog is fixed and some contests have very non-standard
exchanges, the information sometimes has to be entered in a non-intuitive way.

The contests listed below use the configuration panel entry fields in a non-standard way.

Contest Exchange State/Province/Other Power Name
ARRL Sweepstakes The last 2 digits of the year of first license
for either the operator or the station.
ARRL/RAC Section. “Q” for Single Op QRP (5 Watts output or less).
“A” for Single Op Low Power (150W output or less).
“B” for Single Op High Power (more than 150W output).
“U” for Single Op Unlimited (Regardless of power class).
“M” for Multi-Op (Regardless of power class).
“S” for School Club.
SSA MT CW/SSB First four characters of grid square
CWOps CWT Member number or country prefix (e.g. G for UK, SM for Sweden) Operator's first name

The following contests have deviations from the standard operating procedure:

Contest Special instructions
YO PSK31 Contest Due to limitations in DXLog's contest rule logic you can not log the received DXCC prefix from non-YO stations.
There is however no need to do this. Cabrillo export will be correct.

Contest definition files

The behavior and functionality of DXLog for a particular contest is controlled
by a contest definition file, often accompanied by support files.

A contest definition file is always of the type .TXT.

There are four types of support files: prefill databases, warning files, regular expression
files and points files.

Prefill data bases (sometimes referred to as call history files) can be of three different
types: .TXT, .DTB, and .CSV.

  • .TXT is the default, plain text DXLog format.
  • .DTB is a binary, legacy format compatible with Win-Test.
  • .CSV is a plain text format, compatible with N1MM Logger+.

Warning files, regular expression files, and points files are always of the type .TXT.

Contest files and support files are part of the installation binary but are copied to a secondary
folder to allow user modification.

Contest files are copied to %appdata%\DXLog\Contest and support files are copied to
%appdata%\DXLog\Database.

The %appdata%\DXLog folder is hidden but these folders are reachable by typing the full path
in either the path text box in Windows Explorer or using Windows' Run command, [Win][R] or
using the menu File|Open configuration folder.

At startup, DXLog compares the age of all contest related files in the installation binary with
the age of the files in the secondary folder. If a file in the installation binary has a more
recent modification date, the file in the secondary folder is overwritten. Otherwise, it is left untouched.
The purpose of this approach is to allow the user to make modifications while still receiving updates to the files.

Between releases, contest related files are sometimes published on the DXLog support reflector.
To install them, you need to manually copy such files to the right folder.

  • Contest definition files should be copied to the ...\DXLog\Contest folder.
  • Call history or prefill database files should be copied to the ...\DXLog\Database folder.
  • Warning files should be copied to the ...\DXLog\Database folder.
  • Regular expression files should be copied to the ...\DXLog\Database folder.
  • Points files should be copied to the ...\DXLog\Database folder.

Message macros

The following commands when entered into a message macro enables automated functions as listed
$13 Send carriage return character. (Data modes only)
$!ABCD Execute script with name ABCD.
$!DISABLE!ABCD Disable script with name "ABCD".
$!ENABLE!ABCD Enable script with name "ABCD".
$ACQ swaps radio focus and sends CQ.
$AILOCK Enable interlock blocking.
$ALTERNATECQ same as $ACQ.
$BANDIDpppp Send band of Radio 1 of station pppp in the network. E.g. $BANDIDRUN1 will send band of radio 1 of station with ID RUN1.
$BANDOR Send band of non focused radio.
$CHECK Function unclear.
$CHECKCALL Check validity of entered callsign (against general and contest rules).
$CLEARRIT Set RIT to zero on supported radios.
$CORRECT Send corrected callsign. Send nothing if callsign not corrected.
$CQ Send CQ on focused radio. (Creates infinite loop if used with key F1.)
$CQZONE Own CQ Zone from Station Data.
$CR Log QSO.
$CTRLPLUS Silently log QSO.
$CURRENT Sends current callsign even if $CR present later in the macro.
$CURRENTCALL Equivalent to $CURRENT.
$DELAY=### Wait ### milliseconds.
$EXCHANGE Exchange as entered in the configuration panel.
$FOCUS1 Change Focus to Radio 1.
$FOCUS2 Change Focus to Radio 2.
$FOCUSCALL Move focus to Callsign field.
$FOCUSRCVD Move focus to Rcvd field.
$FOCUSREC1 Move focus to RecInfo field.
$FOCUSREC2 Move focus to RecInfo2 field.
$FOCUSREC3 Move focus to RecInfo3 field.
$FREQIDpppp Send frequency of Radio 1 of station pppp in the network. E.g. $FREQIDRUN1 will send frequency of radio 1 of station with ID RUN1.
$FREQnnn Sends the frequency of the networked primary radio found on this band. Band nnn is 160, 80...15, 10, 50, 144, etc.
$FREQOR Sends frequency of the other radio in SO2R.
$FREQP Frequency of Radio 1.
$FREQPASSnnn Function unclear
$FREQS Frequency of Radio 2.
$F1-$F7 Send or play back the message associated to the function key.
$GRABPARTNER Grabs first callsign from the Partner stack.
$GRABSPOT Grabs spot from the bandmap on the current frequency.
$GRID The full Maidenhead Locator from Station Data.
$GRID4 The first four characters of the Maidenhead Locator from Station Data.
$INSERT Send message associated with the [INS] key.
$ITUZONE ITU Zone from Station Data.
$LOGQSO Log QSO.
$MK2R=cmd Send command to MK2R.
$MSG1-$MSG12 Additional CW messages.
$MYCALL Callsign set in Station Data.
$MYDXCC Own DXCC Prefix.
$MYITUZONE ITU Zone from Station Data.
$MYNAME Sends operator name, set in contest configuration.
$NEXT Sends the callsign of the next QSO line when a $CR is included in the message.
$NEXTCALL Sends the callsign of the next QSO line when a $CR is included in the message.
$NEXTSERIAL Sends next QSO serial number.
$OPNAME Equivalent to $MYNAME.
$OTRSP=cmd Send command to connected OTRSP device.
$PBINS Plays back DVK memory associated with INSERT key. On ICOM and microHAM this is #8.
$PBPLUS Plays back DVK memory associated with PLUS key. On microHAM this is #9.
$PILOCK Disable interlock blocking.
$PLUS Sends message associated with the [+] key.
$PREV_RCVD Previous received serial.
$PREVSERIAL Previous QSO serial number.
$QQSLRESET Reset Quick QSL timer.
$QSOB4 Sends the QSOB4 message if "Work Dupes" is not enabled.
$QSOB4WIPE Sends the QSOB4 message if "Work Dupes" is not enable and wipes entry field.
$R1R1 Sets the headphone audio routing to radio 1 in both ears. (Only usable in SO2R scenarios.)
$R1R2 Sets the headphone audio routing to radio 1 in left ear and radio 2 in right ear. (Only usable in SO2R scenarios.)
$R2R1 Sets the headphone audio routing to radio 2 in left ear and radio 1 in right ear. (Only usable in SO2R scenarios.)
$R2R2 Sets the headphone audio routing to radio 2 in both ears. (Only usable in SO2R scenarios.)
$RCVD Sends received exchange without RST.
$RECINFO Sends second part of received exchange, if applicable.
$REPEAT Restarts the repeating CQ sequence.
$RESERVENR Sends reservation request for serial number to number server.
$RESET Cancels any manual change made in the audio control.
$RST Sends report from RST Sent field (normally 5NN).
$SERIAL sends current QSO Serial Number, or previous serial number if the log entry field is empty. Obeys abbreviation settings for CW.
$SERIALNOAB sends unabbreviated, current QSO Serial Number, or previous serial number if the log entry field is empty.
$SPACE Step Focus (Same as pressing space bar).
$SPACEBAR Step Focus (Same as pressing space bar).
$STATE Sends State/Province set in contest configuration.
$SWAPFOCUS Swap radio focus.
$TR1 Transmit Radio 1. (Only usable in SO2R scenarios.)
$TR2 Transmit Radio 2. (Only usable in SO2R scenarios.)
$TRS Transmit on radio opposite to focus. (Only usable in SO2R scenarios.)
$TU Sends "TU".
$WAZZONE Own WAZ/CQ zone from station configuration.
$WIPE Wipe entry field.
&xy CW prosign where xy are merged to one character.
+ increase CW speed by 4 wpm.
- decrease CW speed by 4 wpm.
^ Half wordspace character in CW.
~ At the end of a variable means "no space" will be inserted.
Setup for "NOW" message on RTTY
$13 $CORRECT TU $CR $GRABPARTNER $LOGGEDCALL (relevant contest exchange)

Location of macro values in the contest configuration panel.

Configurationpaneltaggedmacros.png

Supported contests

List of supported contests (version 2.4.0)

HF CW/SSB Contest

  1. 7th Call Area QSO Party (7QP)
  2. 9A CW
  3. 9KCC 15-m Contest
  4. A.R.I. International DX Contest
  5. A.R.I. Sezioni
  6. AGB Party Contest
  7. AGCW Happy New Year Contest
  8. AGCW QRP Contest
  9. AGCW YL-CW Party
  10. All Asian
  11. Arktika Cup
  12. ARRL 10-Meter Contest
  13. ARRL 160-Meter Contest
  14. ARRL DX
  15. ARRL Sweepstakes
  16. ASIA-PACIFIC Sprint Contest
  17. BALKAN HF CONTEST
  18. Baltic Contest
  19. Black Sea Cup International (BSCC)
  20. British Columbia QSO Party (BCQP)
  21. Bucuresti HF Contest
  22. California QSO Party (CQP)
  23. CQ World Wide
  24. CQ WPX
  25. CQ WW 160-Meter Contest
  26. CQ-M International DX Contest
  27. CQMM DX (CQ Manchester Mineira DX) Contest
  28. CQ-WE (Western Electric) Contest
  29. CWOps - CW Open
  30. CWOps - CWT
  31. DARC 10m Contest
  32. DARC XMAS-Contest
  33. DIG QSO PARTY
  34. DTC - German Telegraphy Contest
  35. ES Open Championship
  36. EU HF Championship
  37. EU Sprint
  38. EUCW 160m CW party
  39. EUCW Fraternizing CW QSO Party
  40. EURO 2012 QSO Party
  41. Florida QSO Party (FQP)
  42. FOC BW QSO PARTY
  43. Georgia QSO Party (GQP)
  44. Goes hunting for wolves
  45. Greek Telegraphy Club (GTC) CW Cup
  46. Helvetia Contest
  47. His Majesty The King of Spain
  48. Holyland Contest
  49. HSC Contest
  50. Hungarian DX Contest
  51. IARU HF Championship
  52. IARU Region 1 Fieldday (DARC)
  53. IARU Region 1 Fieldday (RUS)
  54. Indiana QSO Party (INQP)
  55. INORC Contest
  56. International Naval Contest
  57. IOTA Contest
  58. Iron Ham Contest
  59. IRTS HF Counties Contest
  60. Japan International DX Contest
  61. KCJ Contest
  62. KCJ Topband Contest
  63. LZ DX
  64. LZ HF FIELD
  65. LZ HF FIELD 40M
  66. LZ MILARA
  67. LZ Open 20M Contest
  68. LZ Open Contest
  69. Marconi Memorial HF
  70. NA Sprint
  71. NA Sprint SSB
  72. NAQP - North American QSO Party
  73. Nauryz DX Contest
  74. NCCC Sprint (NS)
  75. New England QSO Party (NEQP)
  76. NRAU - Baltic Contest
  77. NRAU NAC 10m Contest
  78. NRRL Field Day
  79. Oceania DX
  80. OK-OM DX Contest
  81. OK-OM DX SSB Contest
  82. Old New Year Contest
  83. PACC Contest
  84. Polar Radioman Contest
  85. POPOV Memorial Contest
  86. Portugal Day Contest
  87. QRP-QRP-Party
  88. RAC Canada Day Contest
  89. RAC Canada Winter Contest
  90. RAEM International Contest
  91. RCC Fieldday
  92. RCC-CUP
  93. RCWC Mini-test
  94. RDA Contest
  95. REF contest
  96. RSGB 21 / 28MHz Contest
  97. RSGB 80m Club Championship
  98. RSGB 80m Sprint Contest
  99. RSGB Affiliated Societies Contests
  100. RSGB Club Calls Contest (1.8MHz AFS)
  101. RSGB CW National Field Day
  102. RSGB First 1.8MHz Contest
  103. RSGB International DX Contest
  104. RSGB International Sprint Contest
  105. RSGB Low Power Contest
  106. RSGB RoPoCo Contest
  107. RSGB RoLo Contest
  108. RSGB Second 1.8MHz Contest
  109. RSGB SSB Field Day
  110. Russian 160m contest
  111. Russian DX contest
  112. Russian Radio Team Championship
  113. Russian WW MultiMode Contest
  114. Scottish DX Contest
  115. Scandinavian Activity Contest (SAC)
  116. RSGB RoPoCo Contest
  117. SP DX Contest
  118. Stew Perry Top Band Distance Challenge
  119. TAC
  120. TESLA Memorial HF CW Contest
  121. TRC-DX
  122. Triathlon DX contest
  123. UA1DZ Memorial Cup
  124. UA2 QSO Party
  125. UBA Contest
  126. UKEICC 80m Contest
  127. UKEIDX Contest
  128. Ukrainian DX Contest (URDXC)
  129. Ukrainian Radio Sport Team Championship
  130. UN DX CONTEST
  131. Ural Cup
  132. Volga Federal District Radio Team Championatship
  133. VU International DX Contest
  134. WAPC - Worked All Provinces of China DX Contest
  135. Wednesday mini-contest
  136. Worked All Europe DX
  137. Worked All Germany
  138. WW Green Party
  139. WW PMC Contest
  140. WWSA CW
  141. YO DX
  142. YU DX
  143. Yuri Gagarin International DX Contest


HF Digital Mode Contests

  1. Aegean RTTY Contest
  2. ARRL RTTY Roundup
  3. BARTG HF RTTY Contest
  4. BARTG RTTY SPRINT Contest
  5. BARTG RTTY SPRINT75 Contest
  6. BDM RTTY WW Contest
  7. CIS DX PSK Contest
  8. CQ World Wide RTTY
  9. CQ WPX RTTY Contest
  10. DARC 10m DIGITAL Contest (Corona)
  11. DL-DX RTTY
  12. DMC RTTY Contest
  13. DRCG World Wide RTTY
  14. EA PSK63 Contest
  15. EA RTTY Contest
  16. EPC PSK63 QSO Party
  17. EPC Russia DX Contest
  18. EPC Ukraine DX Contest
  19. EPC WW DX Contest
  20. EU PSK DX Contest
  21. JARTS WW RTTY CONTEST
  22. Makrothen Contest
  23. NAQP RTTY - North American QSO Party, RTTY
  24. OK DX RTTY Contest
  25. Open Ukraine RTTY Championship
  26. PODXS 160 Meter Great Pumpkin Sprint
  27. PODXS 31 Flavors Contest
  28. PODXS 40 Meter Firecracker Sprint
  29. PODXS 80 Meter Jay Hudak Memorial Sprint
  30. PODXS Ø7Ø Club PSKFest
  31. PODXS Valentine Sprint
  32. Polska WW BPSK63 Contest
  33. QRP HF RTTY Contest
  34. RSGB 80m Club Championship Data
  35. Russian «RADIO» RTTY WW Contest
  36. Russian WW Digital Contest
  37. Russian WW PSK Contest
  38. SARTG New Year RTTY Contest
  39. SARTG WW RTTY Contest
  40. SCC RTTY Contest
  41. SPDX RTTY Contest
  42. SRR Digital Cup
  43. TARA RTTY Melee Contest
  44. Ten-Meter RTTY Contest
  45. TRC Digi Contest
  46. UBA PSK63 Prefix Contest
  47. UK DX BPSK63 Contest
  48. Ukrainian DX Classic RTTY Contest
  49. Ukrainian DX D\IGI Contest
  50. VOLTA RTTY DX Contest
  51. WAEDC RTTY
  52. XE RTTY International Contest
  53. YO International PSK31 Contest


VHF/UHF/SHF

  1. EU VHF/UHF/SHF Contest
  2. NAC Open


DXPedition mode

  1. DXPedition mode
  2. HF+VHF/UHF DXPedition mode


9A local contest

  1. Hrvatski radioamaterski kup
  2. Kup Jadrana
  3. Zimski KV Kup


E7 local contest

  1. 21 decembar
  2. KT KUP SRRS


EA local contest

  1. CN de Sufijos
  2. CNCW
  3. Naranja CW
  4. SPRINT VGE

ES local contest

  1. ES-LL-KV


HB local contest

  1. HB Xmas


Italian local contest

  1. ARI 40/80
  2. CQ Bande Basse Italia


LA local contest

  1. NRRL Vintertest


OH local contest

  1. Sainio CW Contest
  2. Sainio RTTY Contest
  3. Sainio SSB Contest
  4. Viitosten Syysottelu CW Contest
  5. Viitosten Syysottelu RTTY Contest
  6. Viitosten Syysottelu SSB Contest


OK local contest

  1. OK1WC Memorial HF Contest


RSGB local contest

  1. RSGB UKAC 6/4/2m & 70/23cms


Russian local contest

  1. Kirov Region Cup
  2. Russian Championship
  3. Russian Championship CW


S5 local contest

  1. KV Prvenstvo ZRS


SP local contest

  1. PGA Test
  2. PGA-DIGI


YU local contest

  1. CQ Vojvodina
  2. KT KUP Srbije
  3. KT SCWC
  4. Novi Beograd
  5. Sumadija kup
  6. Sumadija kup PSK
  7. Tesla Memorijal V/U/SHF Contest
  8. Veteran
  9. Vidovdan
  10. YU KT Maraton