Difference between revisions of "Menu Tools"

From DXLog.net
Jump to navigation Jump to search
(Data entry)
(Data entry)
 
(111 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
==Repeat loop==
 
==Repeat loop==
  
Text command: <b><code>RPT / NORPT</code></b><br>
+
Text command: <code>RPT</code> and <code>NORPT</code><br>
 +
Keyboard shortcut: <code>[Ctrl][R]</code>
  
Turns on or off the CQ repeat loop function.
+
Toggles the the CQ repeat function.
After pressing F1 (CQ memory) and when message is transmitted, loop will wait for n seconds (default is 3 seconds) and if there isn't any key pressed in qso callsign field (or esc key), after n sec period is exceeded, content of F1 memory will be transmitted again automatically.
 
The setting time window appears like:
 
  
[[File:repeat.jpg]]
+
After pressing F1 (CQ message in ''Run'') the repeat function will wait for ''n''<br>
 +
seconds (default is 3) and then repeat. Any keyboard action will pause the repetition<br>
 +
and it will not restart until <code>[F1]</code> (or the equivalent) is pressed.
 +
 
 +
 
 +
[[File:repeat.jpg]]<br>
 +
Repeat time setting pop-up.
 +
 
 +
The ''Repeat loop'' status is visible in ''Rate'' and ''Operating info'' windows.
  
Repeat loop status function is visible in Rate window, if it is activated.
 
Repeat loop timing function is visible in "Operating info" window.
 
  
 
[[File:repeat_time.jpg]]
 
[[File:repeat_time.jpg]]
  
  
Also, if during transmitting of message any key is pressed in callsign QSO field (or ESCAPE key is pressed), transmission stops immediately and repeat loop is deactivated. It is automatically restored when F1 key is pressed.<br>
+
Also, with ''Repeat loop'' enabled, if any character is entered into the callsign field<br>
 +
during transmission, transmission stops and repeat is paused.
  
 
==Intelligent Quick QSL==
 
==Intelligent Quick QSL==
  
Shortcut: <code>ALT+Q</code>
+
Shortcut: <code>[Alt][Q]</code>
 +
 
 +
Intelligent Quick QSL (IQQSL) is a function that allows the use of short QSL<br>
 +
messages in a heavy pile-up while still sending a complete one with callsign<br>
 +
at a selected interval.
 +
 
 +
IQQSL automatically overrides the PLUS message in your standard messages with<br>
 +
alternatively a short or a long QSL message. It works with or without ESM.
 +
 
 +
It has two alternative mechanics; QSO number based or rate based.
 +
 
 +
 
 +
[[File:IQQSL.png|none|frame]]
 +
 
 +
 
 +
'''QSO count based IQQSL'''
 +
 
 +
: This is the simplest method. With this mechanic selected and set to ''N'', the short QSL message<br>
 +
: will be sent for ''N-1'' QSO and then followed by a long QSL message for the following QSO.<br>
 +
: The cycle will then repeat.
 +
 
 +
: The only parameter to set is the number of QSO per cycle.
 +
 
 +
: [[File:IQQSL-count.png|none|frame]]
 +
 
  
Intelligent Quick QSL (IQQSL) is a tool for generating QSL messages depending on QSO criteria, based on 2 main choices:-
+
'''Rate based IQQSL'''
1. Basic QSO Number based<br>
 
2. Adaptive QSO rate Based
 
  
[[File:IQQSL.png]]
+
: Using a rate based method you will have better control of the frequency of long QSL messages.<br>
 +
: At low rate, you can send it for every QSO. At medium rate, perhaps every third QSO. At high rates,<br>
 +
: perhaps every 6th or 8th QSO. This is particularly valuable for DX-peditions.
  
IQQSL automatically replaces the PLUS message in your message macros without having to change the PLUS macro.
+
: With the default settings, as the instantaneous rate calculated using the time between the 3 most recent<br>
 +
: QSO increases, the long QSO message is sent gradually more rarely. The default settings are suitable in<br>
 +
: most cases but can be set more aggressively (for e.g. a DX-pedition) or less agressively (for e.g. a<br>
 +
: special event station).
  
Choice 1. Basic QSO numbers:-
+
: [[File:IQQSL-rate.png|none|frame]]
This is the simplest option and will replace the PLUS message with the information set in the SHORT MESSAGE, then every X number of qso's, which is user set with the "send long qsl message after qso count" option, the LONG MESSAGE will be sent.
 
To enable, select this option and set the QSO count required.
 
  
[[File:IQQSL1.png]] [[File:IQQSL2.png]]<br><br>
 
  
Choice 2. QSO rate based adaptive IQQSL:-<br>
+
The three modes; CW, SSB and Digital each have their individual short and long QSL messages.  
Using the QSO rate based option we can have more control over when the LONG QSL message is sent.
 
Criteria is set for 5 different calculated QSO rates, the number of QSO's used for the calculation can also be altered, the default is 3.
 
Using the default settings, as the instantaneous rate calculated by the last 3 QSO's increases, the long QSO message is sent if "Send long QSO every" X Seconds or  "Send long QSO count of" X number is exceeded.
 
To enable, select this option and adjust the settings to suit your LONG QSL message requirements.
 
  
[[File:IQQSL3.png]] [[File:IQQSL2.png]]<br><br>
+
[[File:IQQSL2.png|none|frame]] [[File:IQQSL4.png|none|frame]] [[File:IQQSL5.png|none|frame]]
  
QSL Message macros can be set for CW SSB or DATA modes
 
  
[[File:IQQSL2.png]] [[File:IQQSL4.png]] [[File:IQQSL5.png]]<br><br>
+
'''Important:''' <tt>$QQSLRESET</tt> resets the timer/counter and is required in the long QSL message. 
  
Adding $QQSLRESET to the CQ message will reset the Intelligent Quick QSL counters, this should be used.
+
IQQSL uses a separate counter for each radio in SO2R.
Intelligent Quick QSL has separate counters when using SO2R mode for R1 and R2.
 
  
 
==Redefine keyboard keys==
 
==Redefine keyboard keys==
  
::Text command: <code>DEFINEKEYS</code>
+
Text command: <code>DEFINEKEYS</code>
 +
 
 +
 
 +
[[image:redefine_keys.png]]
 +
 
 +
 
 +
All keys on the keyboard can be redefined to act as another key or key combination.
 +
 
 +
'''Important:''' When pressing a redefined key, DXLog creates a system keyboard event just as if the<br>
 +
key was actually pressed. This means that key definition conflicts between the operating<br>
 +
system and DXLog (such as <code>[Ctrl][Alt][F8]</code> being used to reset the graphics<br>
 +
card on some computers) unfortunately can not be resolved using this function.
 +
 
 +
To add a key alias, open the ''Redefine keyboard keys'' panel and click ''Add''.<br>
 +
Press the the key that you want to give a new meaning, then press the key or key<br>
 +
combination you want it to mean. You can also map to keys not available on your current<br>
 +
keyboard, such as when using a special language keyboard or a laptop computer.<br>
 +
To do this, select the wanted key in the drop down menu, click the desired modifiers,<br>
 +
and click <i>OK</i>.
 +
 
 +
A key redefinition can be removed by selecting it and clicking ''Delete''.
 +
 
 +
 
 +
[[image:Mappingunavailablekeys.png]]
 +
 
  
[[image:redefine_keys.png]]<br>
+
'''Example:''' You want <code>§</code> to toggle stereo audio in SO2V.  
DXL commands can be assigned to any of the keyboard keys (or combination of keys) using the functions in this window.<br>
+
: Open the ''Redefine keyboard keys'' panel. Click ''Add''.
Once the '''redefine keyboard keys''' window is open, select the new key from the keyboard (or combination of keys) that you want to assign to a DXL command then press the original DXL command key (or combination of keys) you want to
+
: Press <code>§</code> and then press <code>[Ctrl][Alt][S]</code>.
re-assign.
+
: This will make the <code>§</code> act as if you press <code>[Ctrl][Alt][S]</code>.  
Once OK has been clicked and the '''redefine keyboard keys''' window has closed the new key (or combination of keys) will execute the DXL command along with to the old key (or combination of keys).
+
: <code>[Ctrl][Alt][S]</code> will still mean the same.
NOTE: This function does not remove the DXL command from the original key (or combination of keys), so keys that are already mapped in the DXL coding cannot be used as a redefined key (or combination of keys).
 
  
 
==Data entry==
 
==Data entry==
  
[[image:Tools_data_entry_menu2.png]]
+
<br>[[image:Tools_data_entry_menu3.png]]
<br>
+
 
<br>
+
===Entry settings===
* '''Exchange guessing''' (not valid for serial #).<br>
+
 
: If you have a specific exchange database available for a specific contest, the pre-fill to the report field action can be:
+
* '''Exchange guessing''' (only enabled for static exchanges).
:* Pressing the space bar - the exchange field is filled when you press the spacebar. (Best for ESM)
+
: If you have a specific exchange database available for a specific contest, the pre-fill to the report field action can be:<br>
:* Automatically - the exchange field is filled as you type callsign.
+
:* Pressing the space bar - Old school, the exchange field is filled when you press the spacebar.
:* After timeout - the exchange field is filled about two seconds after typing has stopped. Useful for slow computers.
+
:* Automatically - Convenient, the exchange field is filled as you type callsign.
 +
:* After timeout - The exchange field is filled about two seconds after typing has stopped. Useful for old, slow computers.
 +
: '''Important: ''' this setting will also affect dupe checking and partial/N+1 checking.  
  
 
* '''Enable ESM mode'''
 
* '''Enable ESM mode'''
:Text command: <code>ESM</code> or <code>ESMON</code> and <code>NOESM</code> or <code>ESMOFF</code>
+
: Text command: <code>ESM</code> or <code>ESMON</code> and <code>NOESM</code> or <code>ESMOFF</code>
:Shortcut: <code>ALT+Q</code> to toggle ESM on and off.  
+
: Shortcut: <code>[Ctrl][M]</code>  
 +
 
 +
: The function "Enter Sends Message", better known as ''ESM'', enables the relevant CW/Digital mode message
 +
: to be sent by <code>[Enter]</code>. Correctly used it is a great convencience feature.
 +
 
 +
: DXLog has a very straightforward and predictable ESM. It is stateless which means that it
 +
: does not try to guess the intentions of the operator based on past actions.
 +
 
 +
: The message sent by <code>[Enter]</code> only depends on three factors: Operating state (''Run'' or ''S&P''),
 +
: the location of the cursor and whether the field is filled or not. This makes DXLog's ESM very predictable
 +
: and easy to learn.
 +
 
 +
: The function is the following:
 +
 
 +
:: '''Run'''
  
: The function "Enter Sends Message", better known as "ESM", enables the relevant CW/RTTY message to be sent by only using the "Enter" key.<br>
+
::* With the cursor in an empty callsign field, <code>[Enter]</code> sends ''Run'' F1, typically CQ
 +
::* With the cursor in a partially or correctly filled callsign field, <code>[Enter]</code> sends the RUN INSERT message
 +
::* With the cursor in the exchange field, <code>[Enter]</code> sends the ''Run'' PLUS message which (typically) concludes the QSO and logs.
  
      '''Run mode'''<br>
+
:: When the other station has received the exchange correctly, focus is shifted to the exchange<br>field by pressing <code>[Space]</code>
      When in Run mode ESM sends messages from the Run section of CW messages. Message logic is as follows:
 
   
 
      * With cursor in an empty log callsign entry field - [Enter] will send F1 message.
 
      * With cursor in a filled log callsign entry field - [Enter] will send INSERT message.
 
        After this, to prepare entering the exchange, you need to move the cursor to the exchange  
 
        field by pressing the space bar, or activate the option '''Tools->Data entry->ESM mode change focus on $LOGGEDCALL macro'''
 
        which will advance focus to the exchange field automatically.
 
      * If the exchange is not correctly received, you can either press F6 or leave the exchange field
 
        empty and press [Enter] which sends the F6 message (typically "NR?").
 
      * When the exchange field is complete and correct - [Enter] will send PLUS message, which normally includes logging the QSO.
 
  
      '''S&P mode'''<br>
+
:: For a large station, where correct reception of the exchange is (almost) guaranteed, you can automatically shift focus to the exchange field<br>after having sent the exchange by enabling the menu option <code>Tools|Data entry|Focus recevied exchange after sending exchange in Run</code>.
      When in S&P mode ESM sends messages from the Search & Pounce section of CW messages. Message send logic is as follows:
+
 
 
+
:: '''Search & Pounce'''
      * If the call sign field is focused - [Enter] will send F1 message.
+
 
      * If exchange field is focused and filled - [Enter] will send INSERT message. The default INSERT message includes logging the QSO.
+
::* With the cursor in the callsign field, <code>[Enter]</code> sends ''S&P'' F1, typically your own callsign
 +
::* With the cursor in an empty exchange field, <code>[Enter]</code> sends ''S&P'' F6, which is typically a request to repeat the exchange.  
 +
::* With the cursor in a filled exchange field, <code>[Enter]</code> sends ''S&P'' INSERT, which is typically a confirmation and semi-CQ, and logs.
 +
 
 +
:: For a large station, where correct reception of the exchange is (almost) guaranteed, you can automatically shift focus to the exchange field<br>after having called the station by adding the <tt>$SPACE</tt> macro to the ''S&P'' F1 message.
 +
 
 +
: '''Important:''' If a number server is used, a serial number reservation will automatically occur at the beginning of the RUN INSERT or S&P INSERT messages.
 
      
 
      
* '''ESM mode change focus on LOGGEDCALL macro'''
+
* '''Focus received exchange after sending exchange in Run'''
: If checked, focus will be shifted one step right when $LOGGEDCALL macro is sent and ESM mode is active.
+
: If checked, focus will be shifted to the first received exchange field after sending the Run Insert message
: Typically used to remove the need for hitting SPACE after sending the exchange in Run.
+
: with a non-empty callsign field. It does not matter if the Run Insert message is sent by pressing the Insert key,
 +
: by pressing Enter in ESM, or by auto-cw. Used to reduce the number of necessary key presses when running.  
 +
 
 +
* '''Check minimum field length for RECINFO fields in ESM'''
 +
: Sends F6 message on <code>[Enter]</code> if all RECINFO fields do not have the correct length.
 +
 
 +
* '''Disable ESM on Phone'''
 +
: If checked, ESM will only be active for CW and digital modes. You typically want this.
 +
 
 +
* '''Enable Run/S&P switching'''
 +
: Text command: <code>RUNSP</code> or <code>RUNSPON</code> and <code>NORUNSP</code> or <code>RUNSPOFF</code>
 +
: Enables toggling between ''Run'' and ''S&P'' with <code>[Ctrl][Tab]</code>.
  
* '''Enable Run/SP switching'''
+
* '''Enable automatic Run/S&P selection'''
::Text command: <code>RUNSP</code> and <code>NORUNSP</code>
+
: Text command: <code>AUTORSP</code> or <code>AUTORSPON</code> and <code>NOAUTORSP</code> or <code>AUTORSPOFF</code>
::Text command: <code>RUNSPON</code> and <code>RUNSPOFF</code>
+
: Automatic Run / Search & Pounce switching mode, if frequency changed away
: Activate run / Search & pounce switching with CTRL-TAB key command.
+
: from CQ (''Run'') frequency DXLog will switch to ''S&P''.
 +
: Returning to the CQ frequency by tuning will not switch back to ''Run''.
 +
: Instead, to automatically return to the CQ frequency and switch to ''Run'', press <code>[Alt][F4]</code>.
 +
: '''Important:''' The automatic switch to S&P when moving the VFO after having enabled Run will only happen
 +
: after you have transmitted at least once in Run mode.
 +
: This intentional since it means you can switch to Run with <code>[Ctrl][Tab]</code>  
 +
: and search for a good CQ frequency without automatically being forced back to S&P.  
  
* '''Enable Automatic Run/SP selection'''
+
* '''Enable translation of cut CW numbers'''
::Text command: <code>AUTORSP</code> and <code>NOAUTORSP</code>
+
: If cut numbers are entered into the exchange field, DXLog will automatically
::Text command: <code>AUTORSPON</code> and <code>AUTORSPOFF</code>
+
: change the cut numbers (T, N, O, etc.) into their numerical equivalent.
: Automatic Run / Search & Pounce switching mode, if frequency changed away from CQ (run) frequency DXlog.net will switch to search & pounce mode.
 
: Returning to the CQ frequency by tuning will not reactivate Run, to do this, use Alt-F4.
 
  
* '''Enable CW Cut Numbers Translation'''
+
* '''Use insert style editing first received exchange'''
: If cut numbers are entered into the exchange field, DXlog.net will automatically change the cut numbers to the numerical equivalent.
+
: Switch to INSERT mode instead of OVERWRITE mode for all log RCVD fields.
  
* '''Use INSERT mode in RCVD fields'''
+
* '''Clear exchange field when typing'''
:Switch to INSERT mode instead of OVERWRITE mode for all log RCVD fields.
+
: Disables the normal overwrite editing in the exchange fields and instead clears
 +
: the field when a first character is typed into it.
 +
: When the function is enabled, the focused exchange field is underlined.  
  
* '''Enable Morse Runner simulation'''
+
: [[image:Clearfieldwhentyping.png]]
: Enables linking to Morse Runner for QSO and Contest training purposes.
 
: Morse Runner will be started automatically when this option is selected. A full SO2R simulation is available,
 
: and a special version of Morse Runner is shipped with the standard DXLog.net installation.
 
: If you use SO2R mode, two copies of Morse Runner will be started. When the simulation is disabled or
 
: the active log is closed the Morse Runner process(es) will be closed.
 
: <b>NB</b>: The Morse Runner screens are not visible by default when the simulation is started.
 
: If a CQ WW log is open, the CQ WW configuration will be used. If any other contest is used, the
 
: default Morse Runner simulation is used. Additionally, the F1 and F2 CW messages defined
 
: in DXLog.net are now used by Morse Runner instead of the default messages.<br>
 
  
:The following special keyboard shortcuts are available in the simulation:
+
* '''Separate RST and received exchange'''
:* <b><code>CTRL+ALT(or AltGR)+PAGEUP/PAGEDOWN</code></b> changes the monitor volume.
+
: Treat RST and exchange fields as separate. Prevents e.g. accidental change of RST when using [Backspace].
:* <b><code>CTRL+ALT(or AltGR)+LEFT/RIGHT</code></b> changes the receiver bandwidth.
 
:* <b><code>SHIFT+UP/DOWN</code></b> changes the RIT.
 
:* <b><code>CTRL+Shift+Left/Right</code></b> changes pitch level down/up.
 
  
* '''Prefill field values - callsign'''  
+
* '''Enable grab call from decoder window in Digital'''
: Entering something in this window will prefill the callsign field with the entry automatically.
+
: When checked, DXLog will automatically grab the last known (highlighted) callsign from the RTTY decoder window.
: This is used in some local country contests (9A especially) where the callsign prefix will always be the prefilled value.
 
  
* '''Enable grab call from decoder window in digi mode'''
+
* '''Space key reserves serial number'''  
: When checked, DXlog.net will automatically grab the last known (highlighted) callsign from the RTTY decoder window.
+
: When checked, pressing space will request a serial number from the [[Additional_Information#Using_a_number_server|number server]].
  
* '''Spacebar Reserve Serial Number'''  
+
* '''Insert and F2 messages reserve serial number [Available in 2.5.47 on]'''
: In contests where a multi transmitter station requires a serial number sequence, and the serial number server is enabled in the networking options,  
+
: When checked, sending the Insert or F2 message, with the callsign field not empty, will will request a serial number from the [[Additional_Information#Using_a_number_server|number server]].<br>Works regardless of how the message is sent; by pressing the key, pressing <code>[Enter]</code> in ESM, or with Auto Sending.
: this option will enable DXL to reserve a serial number on pressing the space bar. If this option is un-ticked then only the macro command $RESERVENR will reserve a serial number from the server.
 
  
 
* '''Cancel serial number reservation only if callsign field is empty'''  
 
* '''Cancel serial number reservation only if callsign field is empty'''  
: When serial number reservation is used and this option is checked, it will cancel serial number reservation during wipe qso function only if callsign field is empty.
+
: When serial number reservation is used and this option is checked, it will cancel serial number  
 +
: reservation during wipe qso function only if callsign field is empty.
 +
 
 +
* '''F1 key forces Run mode'''
 +
: If checked, pressing F1 (normally the CQ key) will switch to RUN mode before sending the F1 message.
 +
 
 +
* '''F1 key does not override ongoing message'''
 +
: Changes the behavior of the F1 key in Phone and CW when checked. When checked, the F1 key will:
 +
:* append the F1 message to a message currently being sent instead of replacing it
 +
:* do nothing if pressed during an automatic CQ transmission
 +
: For digital modes, this option has no effect. The F1 messages always stack.
 +
: For DXLog's built in voice keyer, pressing another F-key interrupts playback.
 +
 
 +
* '''Run F1 message self-spots when permitted'''
 +
: Calling CQ (either via ESM, pressing the F1 key or executing the $F1 macro in Run) will also
 +
: create a self-spot if DXLog is connected to a cluster node and the contest permits it.
 +
: No spotting will happen earlier than 15 seconds after the first attempt on a new frequency.
 +
: Self spotting will only be repeated as frequent as the contest permits.
 +
 
 +
* '''Clear CQ frequency on band change'''
 +
: Clears the CQ frequency on band changes.
  
* '''Log QSO immediately when CR macro found'''  
+
* '''Log QSO immediately if message contains $CR'''  
 
: When checked the QSO will be logged before executing the rest of the message if the $CR macro is included in the message.  
 
: When checked the QSO will be logged before executing the rest of the message if the $CR macro is included in the message.  
  
* '''Don't prefill exchange in ESM mode when spot is clicked'''
+
* '''Refresh multiplier list on entry focus change'''
: If checked, prefill database info will not be entered when in ESM mode and selecting a spot from the bandmap or DX cluster announcements window.
+
: Makes the Worked multiplier window update not only with transmit focus changes
: This is no longer necessary. It is a legacy option from an older version of DXLog.  
+
: but also with receive/keyboard focus changes.
  
* '''F1 key returns to RUN mode always'''
+
* '''Disable Shift+ message edit function for CW'''
: If checked, pressing F1 (normally the CQ key) will switch to RUN mode before sending the F1 message.
+
: Disables the message edit function for the <code>[Shift][+]</code> (which is ? on many European keyboards)
 +
: thereby allowing the use of the question mark character.
 +
 
 +
===Contest simulation===
 +
 
 +
* '''Enable Morse Runner simulation'''
 +
: Also accessible via the <tt>MORSERUNNER</tt> or <tt>MRUNNER</tt> text commands.
 +
: Enables linking to Morse Runner for training purposes.
 +
: Morse Runner will be started automatically when this option is selected. A full SO2R simulation is available,
 +
: and a special version of Morse Runner is included in the standard DXLog installation.
 +
: If you use SO2R mode, two copies of Morse Runner will be started. When the simulation is disabled or
 +
: the active log is closed the Morse Runner process(es) will be closed.
 +
: '''Important:''' The Morse Runner screens are not visible by default when the simulation is started.
 +
: If a CQ WW, CQ WPX or 9A CW contest log is open, its configuration will be used.
 +
: If any other contest is used, the default Morse Runner simulation is used.
 +
: Additionally, the F1 and F2 CW messages defined in DXLog are now used by
 +
: Morse Runner instead of the default messages.
 +
: Please note that only a subset of macros and functions supported in Morse Runner simulation.
 +
: (E.g. focus shift is not supported)
 +
 
 +
:The following keys have a special function in the simulation:
 +
 
 +
: * <code>[F1]</code> sends the F1/CQ message as defined in DXLog's settings
 +
: * <code>[F2]</code> sends the F2 message/contest exchange as defined in DXLog's settings
 +
: * <code>[F3]</code> sends TU and own call
 +
: * <code>[F4]</code> sends own call
 +
: * <code>[F5]</code> sends the call in the entry line
 +
: * <code>[F6]</code> sends QSO B4
 +
: * <code>[F7]</code> sends ?
 +
: * <code>[+]</code> (or the equivalent in ESM) sends the defined Plus message
 +
: * <code>[Ins]</code> (or the equivalent in ESM) sends the callsign in the radio's entry line followed by the F2 message
 +
 
 +
: * <code>[Ctrl][Alt][PageUp/PageDown]</code> or <code>[AltGr][PageUp/PageDown]</code> adjusts the monitor volume.
 +
: * <code>[Ctrl][Alt][Left/Right]</code> or <code>[AltGr][Left/Right]</code> adjusts the receiver bandwidth.
 +
: * <code>[Shift][Up/Down]</code> adjusts the RIT. RIT works as if using the lower sideband, i.e. up means lower pitch.
 +
: * <code>[Shift][Delete]</code> clears the RIT.
 +
: * <code>[Ctrl][Shift][Left/Right]</code> adjusts the pitch.  
  
* '''Refresh multiplier list on focused radio change'''
+
: '''Important:''' The function to show current and previous messages will <u>not</u> work as with a normal keyer.
:Update the worked multiplier window at radio focus change. (Comment: It is unclear why this option exist since it seems to happen regardless.)
+
: The text will appear immediately, not successively as with a keyer.
 +
: The call sign of the party station will <u>only</u> show when sending the INS message. <tt>$CORRECT</tt> will not show.
 +
: Under certain conditions macros may show as <tt><nowiki><!></nowiki></tt>.
 +
: One example is <tt>$WAZZONE</tt> which will not send the zone in DXLog's contest configuration but a zone automatically
 +
: determined by Morse Runner based on own call sign.  
  
* '''Disable RCVD field autoskip'''
+
* '''Enable Contest Super Simulator'''
:Disables the automatic skipping of the RCVD field (when pressing the space bar) defined in a few contests.
+
: Also accessible via the <tt>SUPERSIM</tt> or <tt>SUPERS</tt> text commands.
 +
: Enables linking to Contest Super Simulator for training purposes.
  
 
==Message editors==
 
==Message editors==
Line 170: Line 295:
  
 
* '''On the fly editor focus on scenario line'''
 
* '''On the fly editor focus on scenario line'''
: If checked, when on the fly editor window is shown, the line with focus will be radio 1 or radio 2 scenario (depends if the user  
+
: If checked, when the on the fly editor window is shown, the line with focus will be radio 1 or radio 2 scenario (depends if the user  
: pressed SHIFT+F key when radio 1 or radio 2 had focus). If not checked, standard cw message line will be the focus.  
+
: pressed <code>[Shift][F-key]</code> when radio 1 or radio 2 had focus). If not checked, standard message line will be the focus.  
: The user can change the focus in the editor screen by pressing the TAB or SHIFT/TAB key.
+
: The user can change the focus in the editor screen by pressing the <code>[Tab]</code> or <code>[Shift][Tab]</code>.
  
 
==Scripts Manager==
 
==Scripts Manager==
Line 180: Line 305:
 
Support for custom written C# scripts, this enables additional functionality.
 
Support for custom written C# scripts, this enables additional functionality.
 
    
 
    
Custom scripts are written in C# language and they are compiled during DXlog.net runtime.<br>
+
Custom scripts are written in C# language and they are compiled during DXlog runtime.<br>
 
Scripts can be assigned to shortcuts and will be executed when the shortcut key is pressed.<br>
 
Scripts can be assigned to shortcuts and will be executed when the shortcut key is pressed.<br>
 
Scripts can be called by name from CW/Digi message as macro command prefixed with "$!".<br>
 
Scripts can be called by name from CW/Digi message as macro command prefixed with "$!".<br>
For example, if CW/Digi message contains $!SCRIPT1, it will execute script with name SCRIPT1.
+
For example, if CW/Digi message contains <tt>$!SCRIPT1</tt>, it will execute script with name SCRIPT1.
 
   
 
   
Scripts can be enabled and disabled from macros using the $!ENABLE!SCRIPTNAME and $!DISABLE!SCRIPTNAME syntax.<br>
+
Scripts can be enabled and disabled from macros using the <tt>$!ENABLE!SCRIPTNAME</tt> and <tt>$!DISABLE!SCRIPTNAME</tt> syntax.<br>
 
However, be aware that event handlers in scripts will not be disabled using only this mechanic but requires<br>
 
However, be aware that event handlers in scripts will not be disabled using only this mechanic but requires<br>
a subsequent RELOAD or restart of DXLog.net to stop.
+
a subsequent ''RELOAD'' or restart of DXLog to stop.
  
 
==Additional==
 
==Additional==
  
* '''Load a targets file'''
+
* '''Check zones'''
: Use this option load a rates target file for the contest you are operating in, file extension *.OBF is used.
+
: Creates a tab-delimited text file listing all QSO where the expected zone (CQ or ITU depending on contest)
 +
: for the call's DXCC entity differs from the received exchange.
 +
: E.g. a QSO with SM7IUN where the received exchange is 599 11. Also QSO with uncertain or
 +
: indeterminable DXCC (such as /MM stations) are listed.
 +
 
 +
==Load a targets file==
 +
Load a .OBF rates target file for the current contest.
 +
 
 +
==Export a targets file==
 +
Create a .OBF rates target file for the current contest.
 +
 
 +
Should only be done after a completed contest.
 +
 
 +
==Debug==
 +
 
 +
* '''Serial Communications'''
 +
: Logs all serial communication. For development and diagnostics use only.
 +
 
 +
* '''Network'''
 +
: Logs all network communication. For development and diagnostics use only.
  
* '''Export a targets file'''
+
==Reset Interfaces==
: Use this option to create a rates target file from the currently loaded contest, file extension *.OBF is used
+
Shortcut: <code>Ctrl+Alt+R</code><br>
 +
Text command: <code>RESET</code>
  
* '''Reset Interfaces'''
+
Closes and re-opens serial port and pipe connections to radios, keyers, SO2R devices etc.<br>
: Shortcut: <code>Ctrl+Alt+R</code>
+
Same as entering Configure Interfaces and clicking OK.<br>
:Text command: <code>RESET</code>
+
Helpful when e.g. connecting or disconnecting equipment or to temporarily resolve RFI issues.
: Closes and re-opens serial port and pipe connections to radios, keyers, SO2R devices etc.
 
: Same as entering Configure Interfaces and clicking OK.
 

Latest revision as of 15:54, 14 March 2024

Repeat loop

Text command: RPT and NORPT
Keyboard shortcut: [Ctrl][R]

Toggles the the CQ repeat function.

After pressing F1 (CQ message in Run) the repeat function will wait for n
seconds (default is 3) and then repeat. Any keyboard action will pause the repetition
and it will not restart until [F1] (or the equivalent) is pressed.


Repeat.jpg
Repeat time setting pop-up.

The Repeat loop status is visible in Rate and Operating info windows.


Repeat time.jpg


Also, with Repeat loop enabled, if any character is entered into the callsign field
during transmission, transmission stops and repeat is paused.

Intelligent Quick QSL

Shortcut: [Alt][Q]

Intelligent Quick QSL (IQQSL) is a function that allows the use of short QSL
messages in a heavy pile-up while still sending a complete one with callsign
at a selected interval.

IQQSL automatically overrides the PLUS message in your standard messages with
alternatively a short or a long QSL message. It works with or without ESM.

It has two alternative mechanics; QSO number based or rate based.


IQQSL.png


QSO count based IQQSL

This is the simplest method. With this mechanic selected and set to N, the short QSL message
will be sent for N-1 QSO and then followed by a long QSL message for the following QSO.
The cycle will then repeat.
The only parameter to set is the number of QSO per cycle.
IQQSL-count.png


Rate based IQQSL

Using a rate based method you will have better control of the frequency of long QSL messages.
At low rate, you can send it for every QSO. At medium rate, perhaps every third QSO. At high rates,
perhaps every 6th or 8th QSO. This is particularly valuable for DX-peditions.
With the default settings, as the instantaneous rate calculated using the time between the 3 most recent
QSO increases, the long QSO message is sent gradually more rarely. The default settings are suitable in
most cases but can be set more aggressively (for e.g. a DX-pedition) or less agressively (for e.g. a
special event station).
IQQSL-rate.png


The three modes; CW, SSB and Digital each have their individual short and long QSL messages.

IQQSL2.png
IQQSL4.png
IQQSL5.png


Important: $QQSLRESET resets the timer/counter and is required in the long QSL message.

IQQSL uses a separate counter for each radio in SO2R.

Redefine keyboard keys

Text command: DEFINEKEYS


Redefine keys.png


All keys on the keyboard can be redefined to act as another key or key combination.

Important: When pressing a redefined key, DXLog creates a system keyboard event just as if the
key was actually pressed. This means that key definition conflicts between the operating
system and DXLog (such as [Ctrl][Alt][F8] being used to reset the graphics
card on some computers) unfortunately can not be resolved using this function.

To add a key alias, open the Redefine keyboard keys panel and click Add.
Press the the key that you want to give a new meaning, then press the key or key
combination you want it to mean. You can also map to keys not available on your current
keyboard, such as when using a special language keyboard or a laptop computer.
To do this, select the wanted key in the drop down menu, click the desired modifiers,
and click OK.

A key redefinition can be removed by selecting it and clicking Delete.


Mappingunavailablekeys.png


Example: You want § to toggle stereo audio in SO2V.

Open the Redefine keyboard keys panel. Click Add.
Press § and then press [Ctrl][Alt][S].
This will make the § act as if you press [Ctrl][Alt][S].
[Ctrl][Alt][S] will still mean the same.

Data entry


Tools data entry menu3.png

Entry settings

  • Exchange guessing (only enabled for static exchanges).
If you have a specific exchange database available for a specific contest, the pre-fill to the report field action can be:
  • Pressing the space bar - Old school, the exchange field is filled when you press the spacebar.
  • Automatically - Convenient, the exchange field is filled as you type callsign.
  • After timeout - The exchange field is filled about two seconds after typing has stopped. Useful for old, slow computers.
Important: this setting will also affect dupe checking and partial/N+1 checking.
  • Enable ESM mode
Text command: ESM or ESMON and NOESM or ESMOFF
Shortcut: [Ctrl][M]
The function "Enter Sends Message", better known as ESM, enables the relevant CW/Digital mode message
to be sent by [Enter]. Correctly used it is a great convencience feature.
DXLog has a very straightforward and predictable ESM. It is stateless which means that it
does not try to guess the intentions of the operator based on past actions.
The message sent by [Enter] only depends on three factors: Operating state (Run or S&P),
the location of the cursor and whether the field is filled or not. This makes DXLog's ESM very predictable
and easy to learn.
The function is the following:
Run
  • With the cursor in an empty callsign field, [Enter] sends Run F1, typically CQ
  • With the cursor in a partially or correctly filled callsign field, [Enter] sends the RUN INSERT message
  • With the cursor in the exchange field, [Enter] sends the Run PLUS message which (typically) concludes the QSO and logs.
When the other station has received the exchange correctly, focus is shifted to the exchange
field by pressing [Space]
For a large station, where correct reception of the exchange is (almost) guaranteed, you can automatically shift focus to the exchange field
after having sent the exchange by enabling the menu option Tools|Data entry|Focus recevied exchange after sending exchange in Run.
Search & Pounce
  • With the cursor in the callsign field, [Enter] sends S&P F1, typically your own callsign
  • With the cursor in an empty exchange field, [Enter] sends S&P F6, which is typically a request to repeat the exchange.
  • With the cursor in a filled exchange field, [Enter] sends S&P INSERT, which is typically a confirmation and semi-CQ, and logs.
For a large station, where correct reception of the exchange is (almost) guaranteed, you can automatically shift focus to the exchange field
after having called the station by adding the $SPACE macro to the S&P F1 message.
Important: If a number server is used, a serial number reservation will automatically occur at the beginning of the RUN INSERT or S&P INSERT messages.
  • Focus received exchange after sending exchange in Run
If checked, focus will be shifted to the first received exchange field after sending the Run Insert message
with a non-empty callsign field. It does not matter if the Run Insert message is sent by pressing the Insert key,
by pressing Enter in ESM, or by auto-cw. Used to reduce the number of necessary key presses when running.
  • Check minimum field length for RECINFO fields in ESM
Sends F6 message on [Enter] if all RECINFO fields do not have the correct length.
  • Disable ESM on Phone
If checked, ESM will only be active for CW and digital modes. You typically want this.
  • Enable Run/S&P switching
Text command: RUNSP or RUNSPON and NORUNSP or RUNSPOFF
Enables toggling between Run and S&P with [Ctrl][Tab].
  • Enable automatic Run/S&P selection
Text command: AUTORSP or AUTORSPON and NOAUTORSP or AUTORSPOFF
Automatic Run / Search & Pounce switching mode, if frequency changed away
from CQ (Run) frequency DXLog will switch to S&P.
Returning to the CQ frequency by tuning will not switch back to Run.
Instead, to automatically return to the CQ frequency and switch to Run, press [Alt][F4].
Important: The automatic switch to S&P when moving the VFO after having enabled Run will only happen
after you have transmitted at least once in Run mode.
This intentional since it means you can switch to Run with [Ctrl][Tab]
and search for a good CQ frequency without automatically being forced back to S&P.
  • Enable translation of cut CW numbers
If cut numbers are entered into the exchange field, DXLog will automatically
change the cut numbers (T, N, O, etc.) into their numerical equivalent.
  • Use insert style editing first received exchange
Switch to INSERT mode instead of OVERWRITE mode for all log RCVD fields.
  • Clear exchange field when typing
Disables the normal overwrite editing in the exchange fields and instead clears
the field when a first character is typed into it.
When the function is enabled, the focused exchange field is underlined.
Clearfieldwhentyping.png
  • Separate RST and received exchange
Treat RST and exchange fields as separate. Prevents e.g. accidental change of RST when using [Backspace].
  • Enable grab call from decoder window in Digital
When checked, DXLog will automatically grab the last known (highlighted) callsign from the RTTY decoder window.
  • Space key reserves serial number
When checked, pressing space will request a serial number from the number server.
  • Insert and F2 messages reserve serial number [Available in 2.5.47 on]
When checked, sending the Insert or F2 message, with the callsign field not empty, will will request a serial number from the number server.
Works regardless of how the message is sent; by pressing the key, pressing [Enter] in ESM, or with Auto Sending.
  • Cancel serial number reservation only if callsign field is empty
When serial number reservation is used and this option is checked, it will cancel serial number
reservation during wipe qso function only if callsign field is empty.
  • F1 key forces Run mode
If checked, pressing F1 (normally the CQ key) will switch to RUN mode before sending the F1 message.
  • F1 key does not override ongoing message
Changes the behavior of the F1 key in Phone and CW when checked. When checked, the F1 key will:
  • append the F1 message to a message currently being sent instead of replacing it
  • do nothing if pressed during an automatic CQ transmission
For digital modes, this option has no effect. The F1 messages always stack.
For DXLog's built in voice keyer, pressing another F-key interrupts playback.
  • Run F1 message self-spots when permitted
Calling CQ (either via ESM, pressing the F1 key or executing the $F1 macro in Run) will also
create a self-spot if DXLog is connected to a cluster node and the contest permits it.
No spotting will happen earlier than 15 seconds after the first attempt on a new frequency.
Self spotting will only be repeated as frequent as the contest permits.
  • Clear CQ frequency on band change
Clears the CQ frequency on band changes.
  • Log QSO immediately if message contains $CR
When checked the QSO will be logged before executing the rest of the message if the $CR macro is included in the message.
  • Refresh multiplier list on entry focus change
Makes the Worked multiplier window update not only with transmit focus changes
but also with receive/keyboard focus changes.
  • Disable Shift+ message edit function for CW
Disables the message edit function for the [Shift][+] (which is ? on many European keyboards)
thereby allowing the use of the question mark character.

Contest simulation

  • Enable Morse Runner simulation
Also accessible via the MORSERUNNER or MRUNNER text commands.
Enables linking to Morse Runner for training purposes.
Morse Runner will be started automatically when this option is selected. A full SO2R simulation is available,
and a special version of Morse Runner is included in the standard DXLog installation.
If you use SO2R mode, two copies of Morse Runner will be started. When the simulation is disabled or
the active log is closed the Morse Runner process(es) will be closed.
Important: The Morse Runner screens are not visible by default when the simulation is started.
If a CQ WW, CQ WPX or 9A CW contest log is open, its configuration will be used.
If any other contest is used, the default Morse Runner simulation is used.
Additionally, the F1 and F2 CW messages defined in DXLog are now used by
Morse Runner instead of the default messages.
Please note that only a subset of macros and functions supported in Morse Runner simulation.
(E.g. focus shift is not supported)
The following keys have a special function in the simulation:
* [F1] sends the F1/CQ message as defined in DXLog's settings
* [F2] sends the F2 message/contest exchange as defined in DXLog's settings
* [F3] sends TU and own call
* [F4] sends own call
* [F5] sends the call in the entry line
* [F6] sends QSO B4
* [F7] sends ?
* [+] (or the equivalent in ESM) sends the defined Plus message
* [Ins] (or the equivalent in ESM) sends the callsign in the radio's entry line followed by the F2 message
* [Ctrl][Alt][PageUp/PageDown] or [AltGr][PageUp/PageDown] adjusts the monitor volume.
* [Ctrl][Alt][Left/Right] or [AltGr][Left/Right] adjusts the receiver bandwidth.
* [Shift][Up/Down] adjusts the RIT. RIT works as if using the lower sideband, i.e. up means lower pitch.
* [Shift][Delete] clears the RIT.
* [Ctrl][Shift][Left/Right] adjusts the pitch.
Important: The function to show current and previous messages will not work as with a normal keyer.
The text will appear immediately, not successively as with a keyer.
The call sign of the party station will only show when sending the INS message. $CORRECT will not show.
Under certain conditions macros may show as <!>.
One example is $WAZZONE which will not send the zone in DXLog's contest configuration but a zone automatically
determined by Morse Runner based on own call sign.
  • Enable Contest Super Simulator
Also accessible via the SUPERSIM or SUPERS text commands.
Enables linking to Contest Super Simulator for training purposes.

Message editors

  • Enable SO2R scenario on the fly editor
If checked and operating mode is advanced SO2R, the editor for a standard message (SHIFT+F key) will also show
the active SO2R macro lines for radio1 and radio2, this allows quick edit of messages without opening the full scenario editor.
  • On the fly editor focus on scenario line
If checked, when the on the fly editor window is shown, the line with focus will be radio 1 or radio 2 scenario (depends if the user
pressed [Shift][F-key] when radio 1 or radio 2 had focus). If not checked, standard message line will be the focus.
The user can change the focus in the editor screen by pressing the [Tab] or [Shift][Tab].

Scripts Manager

Scripts manager.png

Support for custom written C# scripts, this enables additional functionality.

Custom scripts are written in C# language and they are compiled during DXlog runtime.
Scripts can be assigned to shortcuts and will be executed when the shortcut key is pressed.
Scripts can be called by name from CW/Digi message as macro command prefixed with "$!".
For example, if CW/Digi message contains $!SCRIPT1, it will execute script with name SCRIPT1.

Scripts can be enabled and disabled from macros using the $!ENABLE!SCRIPTNAME and $!DISABLE!SCRIPTNAME syntax.
However, be aware that event handlers in scripts will not be disabled using only this mechanic but requires
a subsequent RELOAD or restart of DXLog to stop.

Additional

  • Check zones
Creates a tab-delimited text file listing all QSO where the expected zone (CQ or ITU depending on contest)
for the call's DXCC entity differs from the received exchange.
E.g. a QSO with SM7IUN where the received exchange is 599 11. Also QSO with uncertain or
indeterminable DXCC (such as /MM stations) are listed.

Load a targets file

Load a .OBF rates target file for the current contest.

Export a targets file

Create a .OBF rates target file for the current contest.

Should only be done after a completed contest.

Debug

  • Serial Communications
Logs all serial communication. For development and diagnostics use only.
  • Network
Logs all network communication. For development and diagnostics use only.

Reset Interfaces

Shortcut: Ctrl+Alt+R
Text command: RESET

Closes and re-opens serial port and pipe connections to radios, keyers, SO2R devices etc.
Same as entering Configure Interfaces and clicking OK.
Helpful when e.g. connecting or disconnecting equipment or to temporarily resolve RFI issues.