Difference between revisions of "Contest configuration"

From DXLog.net
Jump to navigation Jump to search
(Message macros)
(Message macros)
Line 47: Line 47:
 
   $FOCUSREC2 : move focus to RecInfo2 field.
 
   $FOCUSREC2 : move focus to RecInfo2 field.
 
   $FOCUSREC3 : move focus to RecInfo3 field.
 
   $FOCUSREC3 : move focus to RecInfo3 field.
   $FREQnn: Where nn is a band (e.g. $FREQ160, $FREQ80 etc.). Useful in a multi-op as a canned message "PSE QSY $FREQ15".
+
   $FREQID : Unknown function.
   Sends the frequency of the primary radio of the first networked station found on this band with the following priority: R, R+, M, and M+.<br>
+
  $FREQmmm : Sends the frequency of the networked primary radio found on this band. Band nnn is 50, 144, etc.
   $FREQOR: returns the frequency of the opposite radio in SO2R<br>
+
   $FREQnnn : Sends the frequency of the networked primary radio found on this band. Band nnn is 50, 144, etc.
   $FREQP: contains the frequency of the primary radio (useful for passing mults)<br>
+
   $FREQOR : Frequency of the other radio in SO2R.
   $FREQS: contains  frequency of the secondary radio (useful for passing mults)<br>
+
   $FREQP : Frequency of Radio 1.
   $F1...$F7 : send the message associated to the function key
+
  $FREQPASSmmm : Unknown Function.
   $GRABPARTNER: grabs the first callsign from the Partner window and inserts it in the callsign field.<br>
+
  $FREQPASSnnn : Unknown Function.
   $GRABSPOT: grabs spot on the current frequency<br>
+
   $FREQS : Frequency of Radio 1.
   $GRNR: sends gr/num of the received QTC<br>
+
   $F1...$F7 : send the message associated to the function key.
  $GUESSZONE: fill in exchange field(s) if possible, but cursor remains in the same edit field<br>
+
   $GRABPARTNER : Grabs first callsign from the Partner stack.
  $GUESSEXCH: (or $GUESSEXCHANGE) mimics a space bar hit, filling the exchange field(s) if possible, but the cursor remains in the same edit field.<br>
+
   $GRABSPOT : Grabs spot from the bandmap on the current frequency.
   $INSERT: sends message in the [Ins] key<br>
+
   $GRID : Maidenhead Locator from Station Data.
   $ISLAND: sends IOTA Reference (i.e. EU001, AF001, ...) (IOTA Contest)<br>
+
   $INSERT : Send message associated with the [INS] key.
  $LATCH: sets latch mode<br>
+
   $ITUZONE : ITU Zone from Station Data.
  $LOGGED: (or $LOGGEDCALL): sends what is typed in the callsign field of the current QSO, or if blank, the previous QSO<br>
+
   $LOGQSO : Silently log QSO.
   $LOGQSO: silently saves QSO (useful in ESM + S&P mode)<br>
+
   $MK2R=cmd : Send command to MK2R.  
   $MK2R=cmd: send a specific MK2R command to the microHAM MK2R SO2R box.<br>
+
   $MSG1...$MSG12 : Additional CW messages.
   $MSG1...$MSG12: send additional CW messages (see Alt + C)<br>
+
   $MYCALL: Callsign set in Station Data.
   $MYCALL: sends callsign set in contest configuration<br>
+
  $MYDXCC : Own DXCC Prefix.
   $MYNAME: sends operator name, set in contest configuration<br>
+
  $MYITUZONE : ITU Zone from Station Data.
 +
   $MYNAME: sends operator name, set in contest configuration.
 +
 
   $NEXT: (or $NEXTCALL): sends the callsign of the next QSO line when a $CR is included in the message.<br>
 
   $NEXT: (or $NEXTCALL): sends the callsign of the next QSO line when a $CR is included in the message.<br>
 
   $NEXTSERIAL: sends next QSO serial number (current QSO serial number plus 1)<br>
 
   $NEXTSERIAL: sends next QSO serial number (current QSO serial number plus 1)<br>

Revision as of 17:07, 8 May 2019

Configuration

Contest configuration

File:DXL ContestConfig.png

 * Callsign - The Callsign which will be used during the contest
 * Grid square - your Maidenhead gridsquare (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
 * 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

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.net 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).

Message macros

The following commands when entered into a message macro enables automated functions as listed

 $!ABCD : Execute script with name ABCD.
 $!DISABLE! : Disable execution of scripts in macro.
 $!ENABLE! : Enable execution of scripts in macro.
 $AILOCK : Enable interlock blocking.
 $ALTERNATECQ : (or $ACQ) swaps radio focus and sends CQ.
 $BANDID : Returns band of focused radio.
 $BANDOR : Returns band of non focused radio.
 $CHECK : send license year.
 $CHECKCALL : - move focus to callsign.
 $CLEARRIT  : Set RIT to zero on supported radios.
 $CORRECT : Corrected callsign, Nothing if callsign not corrected.
 $CQ : Send CQ on focused radio.
 $CQZONE : Own CQ Zone from Station Data.
 $CR : Execute [Enter] operation.
 $CTRLPLUS : Silent log QSO.
 $CURRENT : Sends current callsign even if $CR present later in the macro.
 $CURRENTCALL : Sends current callsign even if $CR present later in the macro.
 $DELAY=### : Wait ### Milliseconds.
 $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.
 $FREQID : Unknown function.
 $FREQmmm : Sends the frequency of the networked primary radio found on this band. Band nnn is 50, 144, etc.
 $FREQnnn : Sends the frequency of the networked primary radio found on this band. Band nnn is 50, 144, etc.
 $FREQOR : Frequency of the other radio in SO2R.
 $FREQP : Frequency of Radio 1.
 $FREQPASSmmm : Unknown Function.
 $FREQPASSnnn : Unknown Function.
 $FREQS : Frequency of Radio 1.
 $F1...$F7 : send 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 : Maidenhead Locator from Station Data.
 $INSERT : Send message associated with the [INS] key.
 $ITUZONE : ITU Zone from Station Data.
 $LOGQSO : Silently 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: (or $NEXTCALL): sends the callsign of the next QSO line when a $CR is included in the message.
$NEXTSERIAL: sends next QSO serial number (current QSO serial number plus 1)
$PILOCK: Forbid interlock blocking
$PLUS: send messages in the [+] key
$PREV: (or $PREVCALL): sends the callsign on the previous QSO line.
$PREVSERIAL: sends previous QSO serial number (current QSO serial number minus 1)
$QQSLC: sends Quick QSL message based QSOs made (see Intelligent Quick QSL)·
$QQSLT: sends Quick QSL message based on time passed (see Intelligent Quick QSL)·
$QQSLRESET: reset the timer or the counter like if the long QSL message were just sent.·
$QSOB4: sends the QSOB4 message and cancels the remainder of the current message, if the current QSO is a dupe, otherwise sends nothing
$REPEAT: restarts the automatic repeating CQ sequence (if enabled), after pausing for the specified interval. Most useful at the end of the [Plus] key message to avoid having to press [F1] to start CQing again.
$RESET: cancels any manual change made in the audio control
$RST: sends report from RST Sent field (normally 5NN)
$RSTEXCHSENT: Resets the "exchangeSent" flag of the active QSO (useful only for ESM scripts)
$R1R1, $R1R2, $R2R1, $R2R2: which can be entered in the predefined CW messages to set the headphone
$SERIAL: sends current QSO Serial Number, or previous serial number if the line with the cursor is blank.
$SETEXCHSENT: Sets the "exchangeSent" flag of the active QSO (useful only for ESM scripts)
$SPACEBAR: same as $SPACE (press spacebar in currently active field, move to next field)
$STATE: sends State/Province set in contest configuration (Exchange)
$SWAPFOCUS: - change Focused radio to opposite Radio
$TAB: works like hitting [Tab] (move cursor to next field)
$TR1 and $TR2: primary radio or secondary radio tx
$YEAR: sends year nr set in contest configuration (i.e. EUHFC, AA)
$ZONE: sends zone nr set in contest configuration
$13: RTTY send carriage return character (start print on a new line)·
&xy: sends a Morse prosign where xy represents the two characters forming the prosign, e.g. &AS, &AR, &BK, &BT, &CL, &KN, &SK, etc.
+: increase speed by 4 wpm
-: decrease speed by 4 wpm
^: the halfspace character with 1/2 dot duration
~: (tilde) at the end of a variable means "no space" will be inserted, e.g. $NEXT~? sends the next callsign followed by a question mark, with no space in between


WAEDC QTC related

 $DONE : if all QTC are sent: send the [+] key·
 $FIELD: this variable takes the value "GROUP", "TIME", "CL" or "NR", depending on the kind of QTC field where the cursor is located
$GRNR: sends group & number of the received QTC·
$NEXT: move focus to the next QTC line·
$QTC: sends group & number of the transmitted QTC·
$QTCROW: Row number of cursor location in the QTC window. Very useful to create a function key sending the message PSE RPT QTC NR $QTCROW $QTCROW in WAEDC RTTY to request repetition of a specific QTC.
$SERIAL: send serial number of the current QTC·
$SERIE: send the complete QTC block (specific to RTTY)·
$TIME: send time of the current QTC·
$VALID: save everything and close the window·


Setup for NOW message on RTTY

 $13 $CORRECT TU $CR $GRABPARTNER NOW $LOGGEDCALL (EXCH)