Difference between revisions of "Contest configuration"
(→Message macros) |
(→Message macros) |
||
Line 439: | Line 439: | ||
|} | |} | ||
− | '''Location of macro values in the contest configuration panel.''' | + | '''Location of macro values and contest configuration keys in the contest configuration panel.''' |
[[image:Configurationpaneltagged.png|800px]] | [[image:Configurationpaneltagged.png|800px]] |
Revision as of 16:24, 21 April 2020
Contents
Contest configuration
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 | 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
$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. |
$13 $CORRECT TU $CR $GRABPARTNER $LOGGEDCALL (relevant contest exchange) |
Location of macro values and contest configuration keys in the contest configuration panel.
Supported contests
List of supported contests (version 2.4.0)
HF CW/SSB Contest
- 7th Call Area QSO Party (7QP)
- 9A CW
- 9KCC 15-m Contest
- A.R.I. International DX Contest
- A.R.I. Sezioni
- AGB Party Contest
- AGCW Happy New Year Contest
- AGCW QRP Contest
- AGCW YL-CW Party
- All Asian
- Arktika Cup
- ARRL 10-Meter Contest
- ARRL 160-Meter Contest
- ARRL DX
- ARRL Sweepstakes
- ASIA-PACIFIC Sprint Contest
- BALKAN HF CONTEST
- Baltic Contest
- Black Sea Cup International (BSCC)
- British Columbia QSO Party (BCQP)
- Bucuresti HF Contest
- California QSO Party (CQP)
- CQ World Wide
- CQ WPX
- CQ WW 160-Meter Contest
- CQ-M International DX Contest
- CQMM DX (CQ Manchester Mineira DX) Contest
- CQ-WE (Western Electric) Contest
- CWOps - CW Open
- CWOps - CWT
- DARC 10m Contest
- DARC XMAS-Contest
- DIG QSO PARTY
- DTC - German Telegraphy Contest
- ES Open Championship
- EU HF Championship
- EU Sprint
- EUCW 160m CW party
- EUCW Fraternizing CW QSO Party
- EURO 2012 QSO Party
- Florida QSO Party (FQP)
- FOC BW QSO PARTY
- Georgia QSO Party (GQP)
- Goes hunting for wolves
- Greek Telegraphy Club (GTC) CW Cup
- Helvetia Contest
- His Majesty The King of Spain
- Holyland Contest
- HSC Contest
- Hungarian DX Contest
- IARU HF Championship
- IARU Region 1 Fieldday (DARC)
- IARU Region 1 Fieldday (RUS)
- Indiana QSO Party (INQP)
- INORC Contest
- International Naval Contest
- IOTA Contest
- Iron Ham Contest
- IRTS HF Counties Contest
- Japan International DX Contest
- KCJ Contest
- KCJ Topband Contest
- LZ DX
- LZ HF FIELD
- LZ HF FIELD 40M
- LZ MILARA
- LZ Open 20M Contest
- LZ Open Contest
- Marconi Memorial HF
- NA Sprint
- NA Sprint SSB
- NAQP - North American QSO Party
- Nauryz DX Contest
- NCCC Sprint (NS)
- New England QSO Party (NEQP)
- NRAU - Baltic Contest
- NRAU NAC 10m Contest
- NRRL Field Day
- Oceania DX
- OK-OM DX Contest
- OK-OM DX SSB Contest
- Old New Year Contest
- PACC Contest
- Polar Radioman Contest
- POPOV Memorial Contest
- Portugal Day Contest
- QRP-QRP-Party
- RAC Canada Day Contest
- RAC Canada Winter Contest
- RAEM International Contest
- RCC Fieldday
- RCC-CUP
- RCWC Mini-test
- RDA Contest
- REF contest
- RSGB 21 / 28MHz Contest
- RSGB 80m Club Championship
- RSGB 80m Sprint Contest
- RSGB Affiliated Societies Contests
- RSGB Club Calls Contest (1.8MHz AFS)
- RSGB CW National Field Day
- RSGB First 1.8MHz Contest
- RSGB International DX Contest
- RSGB International Sprint Contest
- RSGB Low Power Contest
- RSGB RoPoCo Contest
- RSGB RoLo Contest
- RSGB Second 1.8MHz Contest
- RSGB SSB Field Day
- Russian 160m contest
- Russian DX contest
- Russian Radio Team Championship
- Russian WW MultiMode Contest
- Scottish DX Contest
- Scandinavian Activity Contest (SAC)
- RSGB RoPoCo Contest
- SP DX Contest
- Stew Perry Top Band Distance Challenge
- TAC
- TESLA Memorial HF CW Contest
- TRC-DX
- Triathlon DX contest
- UA1DZ Memorial Cup
- UA2 QSO Party
- UBA Contest
- UKEICC 80m Contest
- UKEIDX Contest
- Ukrainian DX Contest (URDXC)
- Ukrainian Radio Sport Team Championship
- UN DX CONTEST
- Ural Cup
- Volga Federal District Radio Team Championatship
- VU International DX Contest
- WAPC - Worked All Provinces of China DX Contest
- Wednesday mini-contest
- Worked All Europe DX
- Worked All Germany
- WW Green Party
- WW PMC Contest
- WWSA CW
- YO DX
- YU DX
- Yuri Gagarin International DX Contest
HF Digital Mode Contests
- Aegean RTTY Contest
- ARRL RTTY Roundup
- BARTG HF RTTY Contest
- BARTG RTTY SPRINT Contest
- BARTG RTTY SPRINT75 Contest
- BDM RTTY WW Contest
- CIS DX PSK Contest
- CQ World Wide RTTY
- CQ WPX RTTY Contest
- DARC 10m DIGITAL Contest (Corona)
- DL-DX RTTY
- DMC RTTY Contest
- DRCG World Wide RTTY
- EA PSK63 Contest
- EA RTTY Contest
- EPC PSK63 QSO Party
- EPC Russia DX Contest
- EPC Ukraine DX Contest
- EPC WW DX Contest
- EU PSK DX Contest
- JARTS WW RTTY CONTEST
- Makrothen Contest
- NAQP RTTY - North American QSO Party, RTTY
- OK DX RTTY Contest
- Open Ukraine RTTY Championship
- PODXS 160 Meter Great Pumpkin Sprint
- PODXS 31 Flavors Contest
- PODXS 40 Meter Firecracker Sprint
- PODXS 80 Meter Jay Hudak Memorial Sprint
- PODXS Ă7Ă Club PSKFest
- PODXS Valentine Sprint
- Polska WW BPSK63 Contest
- QRP HF RTTY Contest
- RSGB 80m Club Championship Data
- Russian «RADIO» RTTY WW Contest
- Russian WW Digital Contest
- Russian WW PSK Contest
- SARTG New Year RTTY Contest
- SARTG WW RTTY Contest
- SCC RTTY Contest
- SPDX RTTY Contest
- SRR Digital Cup
- TARA RTTY Melee Contest
- Ten-Meter RTTY Contest
- TRC Digi Contest
- UBA PSK63 Prefix Contest
- UK DX BPSK63 Contest
- Ukrainian DX Classic RTTY Contest
- Ukrainian DX D\IGI Contest
- VOLTA RTTY DX Contest
- WAEDC RTTY
- XE RTTY International Contest
- YO International PSK31 Contest
VHF/UHF/SHF
- EU VHF/UHF/SHF Contest
- NAC Open
DXPedition mode
- DXPedition mode
- HF+VHF/UHF DXPedition mode
9A local contest
- Hrvatski radioamaterski kup
- Kup Jadrana
- Zimski KV Kup
E7 local contest
- 21 decembar
- KT KUP SRRS
EA local contest
- CN de Sufijos
- CNCW
- Naranja CW
- SPRINT VGE
ES local contest
- ES-LL-KV
HB local contest
- HB Xmas
Italian local contest
- ARI 40/80
- CQ Bande Basse Italia
LA local contest
- NRRL Vintertest
OH local contest
- Sainio CW Contest
- Sainio RTTY Contest
- Sainio SSB Contest
- Viitosten Syysottelu CW Contest
- Viitosten Syysottelu RTTY Contest
- Viitosten Syysottelu SSB Contest
OK local contest
- OK1WC Memorial HF Contest
RSGB local contest
- RSGB UKAC 6/4/2m & 70/23cms
Russian local contest
- Kirov Region Cup
- Russian Championship
- Russian Championship CW
S5 local contest
- KV Prvenstvo ZRS
SP local contest
- PGA Test
- PGA-DIGI
YU local contest
- CQ Vojvodina
- KT KUP Srbije
- KT SCWC
- Novi Beograd
- Sumadija kup
- Sumadija kup PSK
- Tesla Memorijal V/U/SHF Contest
- Veteran
- Vidovdan
- YU KT Maraton