Difference between revisions of "Contest configuration"

From DXLog.net
Jump to navigation Jump to search
(Message macros)
Line 22: Line 22:
 
The following commands when entered into a message macro enables automated functions as listed<br><br>
 
The following commands when entered into a message macro enables automated functions as listed<br><br>
  
   $AILOCK: allow interlock blocking<br>
+
  $!ABCD : Execute script with name ABCD.
   $ALTERNATECQ: (or $ACQ) swaps primary and secondary radios and sends CQ on the secondary radio<br>
+
  $!DISABLE! : Disable execution of scripts in macro.
   $BANDOR: returns the band of the opposite radio in SO2R<br>
+
  $!ENABLE! : Enable execution of scripts in macro.
   $CHECK: send license year (ARRL SS only)<br>
+
   $AILOCK : Enable interlock blocking.
   $CHECKCALL: - move focus to callsign and press spacebar<br>
+
   $ALTERNATECQ : (or $ACQ) swaps radio focus and sends CQ.
   $CORRECT: send a call correction, if any<br>
+
  $BANDID : Returns band of focused radio.
   $CQ: same as $ALTERNATECQ but does not swap radios<br>
+
   $BANDOR : Returns band of non focused radio.
   $CR: works like hitting [Enter] (log QSO)<br>
+
   $CHECK : send license year.
   $CTRLPLUS: - same as $LOGQSO<br>
+
   $CHECKCALL : - move focus to callsign.
   $CURRENT (or $CURRENTCALL): Sends the callsign of the current QSO despite the presence of a $CR later in the message.
+
  $CLEARRIT  : Set RIT to zero on supported radios.
   The $CR (carriage return) is always executed on message keypress. It is also useful in ESM (Enter Sends Message) mode in lieu of $LOGGEDCALL.<br>
+
   $CORRECT : Corrected callsign, Nothing if callsign not corrected.
   $FOCUS1: change Focused radio to Radio 1<br>
+
   $CQ : Send CQ on focused radio.
   $FOCUS2: change Focused radio to Radio 2<br>
+
  $CQZONE : Own CQ Zone from Station Data.
   $FOCUSCALL: move entry focus to Callsign field<br>
+
   $CR : Execute [Enter] operation.
   $FOCUSRCVD: move entry focus to Rcvd field<br>
+
   $CTRLPLUS : Silent log QSO.
   $FOCUSREC1: move entry focus to RecInfo field<br>
+
   $CURRENT : Sends current callsign even if $CR present later in the macro.
   $FOCUSREC2: move entry focus to RecInfo2 field<br>
+
   $CURRENTCALL : Sends current callsign even if $CR present later in the macro.
   $FOCUSREC3: move entry focus to RecInfo3 field<br>
+
  $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.
 
   $FREQnn: Where nn is a band (e.g. $FREQ160, $FREQ80 etc.). Useful in a multi-op as a canned message "PSE QSY $FREQ15".
 
   $FREQnn: Where nn is a band (e.g. $FREQ160, $FREQ80 etc.). Useful in a multi-op as a canned message "PSE QSY $FREQ15".
 
   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>
 
   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>
Line 45: Line 52:
 
   $FREQP: contains the frequency of the primary radio (useful for passing mults)<br>
 
   $FREQP: contains the frequency of the primary radio (useful for passing mults)<br>
 
   $FREQS: contains  frequency of the secondary radio (useful for passing mults)<br>
 
   $FREQS: contains  frequency of the secondary radio (useful for passing mults)<br>
   $F1...$F7: send the message associated with F1 ... F7 function key<br>
+
   $F1...$F7 : send the message associated to the function key
 
   $GRABPARTNER: grabs the first callsign from the Partner window and inserts it in the callsign field.<br>
 
   $GRABPARTNER: grabs the first callsign from the Partner window and inserts it in the callsign field.<br>
 
   $GRABSPOT: grabs spot on the current frequency<br>
 
   $GRABSPOT: grabs spot on the current frequency<br>
Line 94: Line 101:
 
WAEDC QTC related<br>
 
WAEDC QTC related<br>
  
  $CALLSIGN: send callsign of the current QTC·<br>
+
   $DONE : if all QTC are sent: send the [+] key·
   $DONE: if all QTC are sent: mimic the [+] key·<br> 
 
 
   $FIELD: this variable takes the value "GROUP", "TIME", "CL" or "NR", depending on the kind of QTC field where the cursor is located<br>
 
   $FIELD: this variable takes the value "GROUP", "TIME", "CL" or "NR", depending on the kind of QTC field where the cursor is located<br>
 
   $GRNR: sends group & number of the received QTC·<br>
 
   $GRNR: sends group & number of the received QTC·<br>

Revision as of 16:49, 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.
 $FREQnn: Where nn is a band (e.g. $FREQ160, $FREQ80 etc.). Useful in a multi-op as a canned message "PSE QSY $FREQ15".
 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+.
$FREQOR: returns the frequency of the opposite radio in SO2R
$FREQP: contains the frequency of the primary radio (useful for passing mults)
$FREQS: contains frequency of the secondary radio (useful for passing mults)
$F1...$F7 : send the message associated to the function key $GRABPARTNER: grabs the first callsign from the Partner window and inserts it in the callsign field.
$GRABSPOT: grabs spot on the current frequency
$GRNR: sends gr/num of the received QTC
$GUESSZONE: fill in exchange field(s) if possible, but cursor remains in the same edit field
$GUESSEXCH: (or $GUESSEXCHANGE) mimics a space bar hit, filling the exchange field(s) if possible, but the cursor remains in the same edit field.
$INSERT: sends message in the [Ins] key
$ISLAND: sends IOTA Reference (i.e. EU001, AF001, ...) (IOTA Contest)
$LATCH: sets latch mode
$LOGGED: (or $LOGGEDCALL): sends what is typed in the callsign field of the current QSO, or if blank, the previous QSO
$LOGQSO: silently saves QSO (useful in ESM + S&P mode)
$MK2R=cmd: send a specific MK2R command to the microHAM MK2R SO2R box.
$MSG1...$MSG12: send additional CW messages (see Alt + C)
$MYCALL: sends callsign set in contest configuration
$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)