MACROs, Hot Keys and Programmable Buttons

Randy Tipton, WA5UFH, Geoff Anderson, G3NPA, and Hew Lines VA7HU

Overview

What are Macros, Programmable Buttons and Hotkeys?

Logger32 is user-friendly and can be customized to your own personalized likes by using the program's built-in MACRO commands.  These commands can be used to "program" up to 36 programmable buttons in the Sound Card Data window, the Data Terminal window and the CW Machine.

Each button can be programmed using MACROs and/or text and can be given a label and color.  By using your imagination, and working with the available list of MACROs, you can create files that will make operating PSK, RTTY and CW more enjoyable and easier.

This section is intended to be a reference document for details on how to program the buttons using the MACRO language. Specific details on selecting the number of buttons to display and some suggested functionality to assign to those buttons for each of the windows can be found in the sections on the Sound Card Data window, Data Terminal window, and the CW Machine.

Programming the Buttons

Default Hot Keys

The programmable buttons can be displayed in up to three rows of 12 buttons. Each button has a default hot key assigned to it as follows:

·         The top or first row of buttons defaults to the F-keys, (F1 through F12)

·         The middle row of buttons defaults to Alt-F-keys (hold down Alt and press the function key)

·         The bottom row of buttons corresponds to Ctrl-F-keys (hold down Ctrl and press the function key)

Pressing any of the Hot Key combinations will execute any script programmed for the corresponding button.

The default Hot Keys may be changed as part of the button programming process if you wish.

In addition to the user-definable Hot Keys, the following Hot Keys have fixed functionality within the Sound Card Data window.

ESC - Change from Transmit to Receive. In order for this functionality to work correctly, the focus must be in the Sound Card Data window.

INS - Toggle the reception of data on and off to allow scrolling back in the RX window possible. The RX window background will turn white while data input is suspended.

PAUSE/BREAK - Toggle between transmit and receive. In order for this functionality to work correctly, the focus must be in the Sound Card Data window.

Programming the Routine

To start, simply right-click on the button you wish to program and the Macro Setup window will be displayed.

MHKPB_1

The Hot Key currently assigned to that button will be displayed in the Title bar (Macro Setup for F2 - the second button on the top or first row).  To program the button, click in the text window and enter any macro commands (those beginning and ending with $) and the text required to execute the functionality required for this button.

MHKPB_2

In order to enter a character that is not available on your keyboard, you must enter the ASCII code for that character. This is done by pressing the <Alt> key while you type the four digit code for the character on the numeric keypad. For example, to type the character "¿", hold the ALT key down and type 0191 on the numeric keypad (you must be in Num Lock to do this).  When you release the ALT key, the ¿ will be displayed.   When you type a character this way, you must enter a four-digit number, so for the ASCII character 191, you must type 0191.

After entering the routine, enter a name into the Button Caption edit box at the lower right. This is the text that will be displayed on the button itself.

MHKPB_3

You can also program the following features of each macro button:

Back color - This displays a standard Windows color selection dialog box allowing you to select the color of the background of the button.

Fore color - This displays a standard Windows font selection dialog box allowing you to select the type, style and color of the font to be used on the button. Note that even though the position of the text on the button in this window is not correct, it will be on the button in the Sound Card Data window, Data Terminal window or CW Machine.

MHKPB_4

Mouseover Back color - This displays a standard Windows color selection dialog box allowing you to select the color to which the background will change when you drag the cursor over it.

Mouseover Fore color - This displays a standard Windows font selection dialog box allowing you to select the type, style and color to which the font will change when you drag the cursor over it. Note that even though the position of the text on the button in this window is not correct, it will be on the button in the Sound Card Data window, Data Terminal window or CW Machine.

MHKPB_5

You can also restore the default background colors (a delightful shade of gray) using the Default Back Colors button. 

When the Macro Setup is completed, and you are ready to save it, press the OK button.

Pressing the Cancel button will cause the Macro Setup window to close without saving your work.

Delete/Cancel all settings will restore the button to the way it was before you began editing. If it had a script, that script will be restored; if it was blank, it will return to blank.

User Assigned Hot Keys

In order to make your buttons more user friendly, consider the use of 'User Defined Hot Keys".  It may be easier to remember that the simultaneous combination of Alt -C (rather than F1) is the routine for calling CQ.

User Defined Hot Keys are assigned to a button by using an ampersand (&) in the Button Caption immediately preceding the character you wish to use as the Hot Key. For example, entering "&CQ" in the Button Caption field will cause the button text to show "CQ" and allow the pressing of <Alt-C> to be used as the Hot Key for that button. Note that the underline under the "C" indicates the Hot Key visually.

MHKPB_6

 A Button Caption of "Msg &1" would display as "Msg 1" on the button and use <Ctrl-1> as the Hot Key.

An extension of this feature allows the use of special characters on the Macro buttons.  During Macro Setup, entering the ASCII code of any special character will display that character as part of the caption text. For example, entering caption of a button as chr$(191) would display "¿" as the caption of the button.

Testing the Buttons

It is strongly recommended that you test each button after it has been programmed. With the radio turned off, and with either the Sound Card Data window, Data Terminal window or CW Machine open, click on the button to execute the macro and observe its operation in the transmit and receive windows. If the button has commands to switch the radio to receive or transmit, observe that those operate properly by watching the TX/RX indication in the appropriate window.  If there is a problem with a button's operation you can edit it by right-clicking on the button and making whatever changes are necessary. Also execute the button by pressing the assigned Hot Key to ensure that the Hot Key is correctly programmed. It is better to find out about problems before sending the contents of the macro in a live QSO!

MACRO COMMANDS

 

A number of these commands require a radio controlled by Logger32 via a serial port for their effective operation. These commands are colored red in the table below. For those who operate a software controlled radio, please see the section "MACROs for Software Controlled Radios".

 

Note: The following list details the MACRO commands for the individual Logger32 modules and modes.

 

CW applies to the CW Machine

DATA applies to the Data Terminal window

MMTTY applies to the Sound Card Data window  to all profiles in the MMTTY Engine

MMVARI applies to the Sound Card Data window  to all modes in the MMVARI Engine

 

$afc$                                                    RTTY                MMVari

 

Toggles the AFC function on and off.

 

$align$                                                RTTY                MMVari

 

Re-tunes the radio so the captured signal appears at the default audio frequency. Details of the operation of the align functions using mouse clicks are contained in the Sound Card Data window section. 

 

$ascii(n)nnn$                                       RTTY    Data     MMVari

 

Inserts the ASCII code ((n)nnn) of a character than cannot be entered from a keyboard into the output text string (if the first digit is a zero, it is optional. see the section on More Difficult Macros).

 

$band$                         CW                  RTTY    Data     MMVari                 Local Host

 

Inserts the current band displayed in the Logbook Entry window into the output text string.

 

$bookmark$                 CW                  RTTY    Data     MMVari

 

Inserts a pseudo DXSpot into the DXSpot table and the Bandmap. See Pseudo DXSpot section.

 

$call$                           CW                  RTTY    Data     MMVari                    Local Host

 

Inserts the callsign currently displayed in the Logbook Entry window into the output text string.

 

$callchanged$               CW

This macro is the same as $call$, but ONLY sends something if the call has changed since it was last sent. This macro is useful when correcting an erroneous callsign. It must be embedded into a macro and it must be preceded and followed by a space.

 

$CallsignGetsFocus$      CW

 

At the end of a transmission, sets the focus on the Callsign field in the CW Machine window.

 

$clear$                         CW                  RTTY    Data     MMVari

 

An immediate command to clear the TX Buffer and callsign panel. ONLY works if keyer is in a Manual TX. [see Note 2].

 

$clearbuffers$                                      RTTY

 

Clears the TX Window and Buffer as well as the RX Window. Stops transmission but DOES NOT return to RX. [see Note 2]

 

$clearlog$                    CW                  RTTY    Data     MMVari                   RCP

 

Clears the Logbook Entry window.

 

$cleartxbuffer$                                    RTTY

 

Clears the TX Buffer. [see Note 2]

 

$ClearCallsignOnQSYOn$                                                                             RCP

 

Checks the CLEAR CALLSIGN ON QSY menu

 

$ClearCallsignOnQSYOff$                                                                             RCP


Unchecks the CLEAR CALLSIGN ON QSY menu

 

$ClearQSYMarker$                                                                                        RCP

 

Clears the current CLEAR CALLSIGN ON QSY frequency from memory.

 

control_<x>                                                     Data

 

Where <x> is a control character (usually an upper case letter to be sent to the TNC to issue whatever command is needed). [Note: there are no "$" symbols enclosing this macro].

 

$command$                 CW                     RTTY    Data     MMVari

 

Sends the text string following the command to a radio controlled by Logger32 in the format $command xxxx$ where xxxx is a string. 

 

If used from the CW machine, it is recommended that only ONE control instruction be given at a time.

 

If used under SO2R conditions, the macro can accept the format $command[radio1text]|[radio2text]$ where [text] is an optional parameter and the "[" and "]" are NOT part of the parameter. Further information on this can be found in the helpfile section SO2R.

 

As the Ten Tec OMNI VII command set requires both ASCII characters and hex numbers, a further modifier has been introduced. Hex numbers can be passed in this macro if enclosed in "<" and ">".

 

Thus a macro such as $command *A<xx>$ where xx is a hex number is acceptable. For more information see the Ten Tec OMNI VII section.

 

$cw$                                                                            MMVari

 

Sends the text string following the command  (up to 40 characters) on CW, then switches to RX.

 

$cwid$                                                                         MMVari

 

Transmits a CW ID string at the end of the current transmission, then switches to RX.

 

$CWspeeddn$              CW

 

Permanently decreases the keying speed by one WPM.

 

$CWspeedup$              CW

Permanently increases the keying speed by one WPM.

$CWTextGetsFocus$     CW

At the end of a transmission, sets the focus on the Text field in the CW Machine window.

 

$delay$      

                                                                  Data

Pauses 250 ms before sending the next character to the TNC. This is typically used after sending control codes to the TNC to change modes.

 

$down$                                                                        MMVari

 

Moves the main passband down 1 Hz. If AFC is locked on, this command will have no effect.

 

$endtime$                                   PSK     RTTY Data     MMVari

 

Records the current time as the QSO end time.

 

$escape$                                                         Data

 

Sends the ESC character (chr$(27)) to the TNC.


$file$                                                     RTTY    Data    
MMVari

 

When followed on the same line with a fully qualified textfile name ($file$C:\LOGGER32\MYFILE.TXT), this command will load the contents of that file into the TX buffer. If only the filename is used, the command will default to the Logger32 directory. Note: The $file$ macro in the Data Terminal window does NOT show the text being loaded into the RX field in the window until load is complete. This is necessary because the software must make sure that any <ESC> characters that may be embedded in the text are stripped out and that an appropriate delay is inserted into the string. The same applies to any $CONTROL_x strings in the text.

 

$greeting$                   CW                    RTTY    Data     MMVari

Send a greeting appropriate top the local time of the QSO partner. If Logger32 cannot determine the distant end time, then the default greeting will be sent. See section below for information on setting up the default greetings.

 

$hexcommand$           CW                   RTTY    Data     MMVari

 

Sends the hexadecimal string following the command to the radio. When used from the CW Machine, it is recommended that only ONE command be issued.

 

$IcomVFOB$                                                                                      RCP

 

Reads and displays VFO B on late model ICOM radios when in split operation. See par 6.4 for setup details.

 

$lastqsoband$                                       RTTY   Data     MMVari 

          

Inserts the last QSO band for the station being worked into the output text string.

 

$lastqsodate$                                         RTTY  Data     MMVari

 

Inserts the last QSO date for the station being worked into the output text string in the same format as that of the log.

 

$lastqsotime$                                        RTTY  Data     MMVari  

         

Inserts the last QSO time for the station being worked into the output text string in the same format as that of the log.

 

$lastqsomode$                                     RTTY   Data     MMVari

 

Inserts the last QSO mode for the station being worked into the output text string.

 

$log$                            CW                  RTTY    Data     MMVari

 

Enters the data currently displayed in the Logbook Entry window into the Log. NOTE: $log$ is not a standalone macro but is to be used embedded into text macros.

 

$logimmediate$           CW                  RTTY                MMVari

Logs the QSO and clears the buffer immediately.

$longdate$                                          RTTY    Data     MMVari

 

Inserts the current date into the output text string in the form dd-mm-yyyy UTC.

 

$longdateandtime$                             RTTY    Data     MMVari

 

Inserts the current date and time into the output text string in the form dd-mm-yyyy, hh:mm:ss UTC.

 

$longtime$                                          RTTY    Data     MMVari    

                                                       

Inserts the current time into the output text string in the form hh:mm:ss.

 

$loop$                          CW                  RTTY                MMVari

 

Causes a five (5) second delay after the macro has completed, then re-starts the macro (see the section on More Difficult Macros). 

 

$loop x$                       CW                  RTTY                MMVari

Causes a user defined delay after the macro has completed, then restarts the macro. "x" is in seconds..

$mode$                                               RTTY    Data     MMVari

 

Inserts the mode currently displayed in the Logbook Entry window into the output text string.

 

$msg(x)$                      CW (WinKey2 ONLY)

 

Macros $msg1$...$msg6$ are for sending WinKey2 internal memories. These Macros are valid for a WinKey2 only and is an immediate Macro.

 

$MultiRX$                                                                     MMVari


This macro activates the multiple receive channels of the MMVari engine. See the MultiRX topic.

 

$mycall$                      CW                   RTTY    Data     MMVari

 

Inserts the current "operator" value into the output text stream. Usually this would be a callsign.

 

$name$                        CW                  RTTY    Data     MMVari

 

Inserts the contents of the Name field currently displayed in the Logbook Entry window into the output text stream.

 

$NameGetsFocus$         CW

 

At the end of a transmission, sets the focus on the Name field in the CW Machine window.

 

$net$                                                    RTTY                MMVari

 

Toggles the Net function on or off

 

$numqsos$                                          RTTY    Data     MMVari

 

Inserts the total number of QSOs logged for the station being worked.

 

$qsx+/-nnnn$                                      RTTY                MMVari

 

Shifts the transmit frequency of the radio up or down by nnnn Hz. $qsx-2000$ shifts the frequency transmit frequency down by 2 kHz, $qsx+1500$ shifts it up by 1.5 kHz. This shift is terminated by the $simplex$ command.

 

$qsy(nn)nnn.(nn)$                               RTTY    Data     MMVari           

 

Immediately changes the radio frequency to the specified value (nnnnn.nn). For example - $qsy7070$ or $qsy14070.22$. See Note 1.

 

$qth$                                                   RTTY                MMVari

 

Inserts the contents of the QTH field currently displayed in the Logbook Entry window into the output text string.

 

$radioandtone$                                   RTTY                MMVari  

 

Returns the RF center frequency (radio carrier frequency plus audio tone frequency) when in PSK mode. Returns the RF frequency of the Mark tone (radio frequency plus the mark tone audio frequency) in RTTY mode (see the section on More Difficult Macros). See also Note 5. 

$radio1$

Selects Radio #1. Does nothing if Radio #1 is already active.

$radio2$

Selects Radio #2. Does nothing if Radio #2 is already active

$radio1->radio2$.

Transfers frequency and mode of Radio 1 to radio 2

$radio2->radio1$.

Transfers frequency and mode of radio 2 to radio 1

$radiofreq$                                          RTTY    Data     MMVari

 

For radios controlled by Logger32, returns the nominal RF carrier frequency of the radio (see the section on More Difficult Macros).

 

$receive$                     CW                   RTTY                MMVari 

 

Switches the radio from transmit to receive.

 

$receivedrst$               CW                   RTTY    Data     MMVari

 

Inserts the contents of the RST received field of the Logbook Entry window into the output text string. The default is 599 if nothing is entered.

 

$receivedrstn$             CW

 

Inserts the contents of the RST received field of the Logbook Entry window into the output text string. Any figure 9 is sent as the character "N". The default is 5NN if nothing is entered.

 

$receivedgrid$                                     RTTY    Data     MMVari           

 

Inserts the received Grid Square if entered into the Logbook Entry window.

 

$reset$                        CW

 

Allow the operator to reset LPT pin 16 & 17 (CW key line) to a LO.

 

$rotor$                           CW                 RTTY    Data     MMVari     

      

This macro rotates the antenna to the computed short path azimuth after a callsign is entered into the Logbook Entry window. It is the same as the CTRL_A command in that window.

 

$rotorlp$                        CW                 RTTY    Data     MMVari

 

This macro rotates the antenna to the computed long path azimuth after a callsign is entered into the Logbook Entry window. It is the same as the ALT_A command in that window.

 

$rtty$                                                    RTTY MMVari

 

Changes the operational mode of the Sound Card Data window to MMTTY.

.

$rttybpfoff$                                           RTTY (MMTTY only)

 

Turns the receive bandpass filter off.

$rttybpfon$                                           RTTY (MMTTY only)

 

Turns the receive bandpass filter on

 

$rttyfigures$                                         RTTY (MMTTY only)

 

Shifts the RTTY transmission into Figures mode.

 

$rttyletters$                                          RTTY (MMTTY only)

 

Shifts the RTTY transmission into Letters mode.

 

$rttymarkfrequency$                            RTTY (MMTTY only)

 

Returns the RTTY Mark frequency. This frequency will change depending on the commands $rttynormal$ or $rttyreverse$.

 

$rttynormal$                                        RTTY (MMTTY only)

 

Operate RTTY using normal shift (LSB).

 

$rttyreverse$                                        RTTY (MMTTY only)

 

Operate RTTY using reverse shift (USB).

 

$rttysetup$                                           RTTY (MMTTY only)

 

Display the MMTTY setup dialog box. This is the equivalent of selecting the "Setup" button of the RTTY Toolbar.

 

$rttyshift$                                             RTTY (MMTTY only)

 

Returns the current setting of the RTTY Shift (normal or reverse).

 

$rttysquelchoff$                                   RTTY (MMTTY only)

 

Turns the RTTY Squelch off.

 

$rttysquelchon$                                   RTTY (MMTTY only)

 

Turns the RTTY Squelch on.

 

$rxtonefreq$                                       RTTY                MMVari 

 

Returns the Mark tone currently displayed in the second panel of the Sound Card Data Window Statusbar (see the section on More Difficult Macros).  See also Note 5 below

 

$selcal$                                                                       Data

 

Inserts the contents of the SELCAL field (top left corner of the Data Terminal window).

 

$sentrst$                       CW                 RTTY    Data     MMVari

 

Inserts the contents of the RST Sent field of the Logbook Entry window into the output text stream. The default is 599 if nothing is set in the Logbook Entry window.

 

$sentrstn$                    CW

 

Inserts the contents of the RST Sent field of the Logbook Entry window into the output text stream. Any figure 9 is sent as the letter "N". The default is 5NN if nothing is set in the Logbook Entry window.

 

$serialnum$                 CW                  RTTY    Data     MMVari    

       

Inserts the serial number of this QSO.

 

$serialnum-1$              CW                  RTTY    Data     MMVari

 

Inserts the serial number of the previous QSO.

 

$shortdate$                                         RTTY    Data     MMVari   

        

Inserts the current date into the output text string in the form dd/mm/yy UTC.

 

$shortdateandtime$                           RTTY    Data     MMVari

 

Inserts the current date and time into the output text string in the form dd/mm/yy hh:mm UTC.

 

$shorttime$                                        RTTY    Data     MMVari

 

Inserts the current time into the output text string in the form hh:mm UTC.

 

$simplex$                                          RTTY                MMVari

 

Restores simplex operation by returning the Transmit frequency to the Receive frequency after a $qsx$ command.

$so2r$

Opens the SO2R RCP Panel. If it is already open, it does nothing.


$so2v$

Opens the SO2V RCP Panel. If it is already open, it does nothing.

$so2von$

Opens the SO2V RCP window

$so2voff$

Closes the SO2V RCP window

NOTE: The above 2 macros can be used standalone or included as part of the split/unsplit macro commands

$speed-$                      CW                                                                                 

 

Temporarily decreases the keying speed by two WPM. This macro is temporary, and only has effect within the current transmission. The macro is reset at the end of the current transmission.

 

$splitaudioalert$                                                                                                   RCP

 

Sounds the split audio alert when the radio is placed into split mode using a manual macro.

 

$splitvisualalerton$                                                                                              RCP

 

Turns on Visual split alert when radio is placed in split mode with a manual macro command.

 

$splitvisualalertoff$                                                                                              RCP

 

Turns off visual alert when radio is placed in simplex using a manual macro.

 

 

$SRXGetsFocus$          CW

 

At the end of a transmission, sets the focus on the SRX field in the CW Machine window.

 

$speed+$                     CW

 

Temporarily increases the keying speed by two WPM. This macro is temporary, and only has effect within the current transmission. The macro is reset at the end of the current transmission

 

$starttime$                                         RTTY              MMVari             Data

 

Records the current time as the QSO start time.

 

$srx$                                         RTTY              MMVari             Data

 

The content of this field in the Log Entry window will be transmitted.

 

$stx$                                         RTTY              MMVari             Data

 

The content of this field in the Log Entry window will be transmitted.

 

$tncdate$                                                                                           Data

 

Sends the UTC date and time as yymmddhhmmss.   Note: this is actually the computer date/time but it is intended for use in the setting of the TNC time. Some TNCs may require a command to prefix this macro (e.g. "DATE $tnctime$").

 

$toggleradios$          CW                  RTTY                 MMVari            Data

 

An immediate Macro to toggle the (SO2R) radios in use. The same action as keystroke CTL_T (see notes 2 and 4 below).

 

$transmit$                                          RTTY                MMVari

 

Turns the transmitter on and transmit any text in the TXWindow

 

$transmit$                   CW

 

Raise the CW PTT. Can be used when MOX and/or slow typing modes are in use.

 

$tune$                          CW

 

In the CW machine widnow this MACRO acts as a toggle to transmit a carrier to tune the transceiver. The first instance turns the carrier on, the second instance turns the carrier off.

 

$twohexbytes xx xx xx$                                                                     Data

 

Macro to send hex characters to the TNC

$uham xx$                                                                                                       RCP

Set op command without the need for the <CR> where xx is the appropriate microHAM control op command.

 

$up$                                                    RTTY                MMVari

 

Moves the main passband up 1 Hz. If AFC is locked on, this command will have no effect.

 

$upperorlower$                                  RTTY                MMVari

 

Returns a plus sign (+) if the radio is in USB mode or a minus sign (-) if the radio is in LSB mode (see the section on More Difficult Macros). See also Note 5.

 

$version$                                            RTTY    Data     MMVari

 

Enters the version number of Logger32 into the output text stream.

$wait x$ 

Inserts a delay time between radio commands. “x” equal seconds.

 

$winkeymergedletters$  CW 

To send concatenated letters with a Winkey enter a macro like this ... $winkeymergedletters$BT This sends <ESC>BT to the Winkey

 

 

 

MODE SELECTION MACROS

  

$mmvarimodexx$                                                 MMVari

 

Changes the operational mode of the Sound Card Data window to MMVARI modes

 

where xx is the menu index number of the MMVARI modes as shown in the table below

               Mode          Index #

GMSK MBCS        0                  

FSK MBCS           1                  

FSK-W MBCS       2                  

BPSK31 MBCS     3                  

BPSK63 MBCS     4

BPSK125 MBCS   5                  

BPSK31               6                  

BPSK63               7

BPSK125             8                  

RTTY-L                 9                  

RTTY-U                10                  

MFSK-L4             11                  

MFSK-L8             12                  

MFSK-L11           13                  

MFSK-L16           14                  

MFSK-L22           15                  

MFSK-L32           16                  

MFSK-L64           17                  

MFSK-U4            18

MFSK-U8            19

MFSK-U11          20

MFSK-U16          21

MFSK-U22          22

MFSK-U32          23

MFSK-U64          24

QPSK-L 31          25

QPSK-L 63          26

QPSK-L 125        27

QPSK-U 31         28

QPSK-U 63         29

QPSK-U 125       30    

Notes:-

1) For version 3.29.0 the modes MFSK-L and MFSK-U have been replaced with MFSK-L xx and MFSK-U xx where xx defines the mode speed. If the original mode name of MFSK-L or MFSK-U was an operational mode for the user and the shortcut keys had been set up then the MMvarisoundcardmacros.ini file will need to be modified to regain the use of the original shortcuts. With Logger32 closed down, open the file MMvarisoundcardmacros.ini and look for [MFSK-L ] or [MFSK-U] including the brackets and change this header to read [MFSK-L 16]] or MFSK-U 16] as appropriate. On reopening Logger32 the original macro set will appear.


2) All the mode index numbers greater than 10 have been changed. If the macro $mmvarimode x$ (where x is an mmvari mode index number) has been used within a shortcut then it may need to be recoded if it is to point at the correct mode.

Additional Macros

[                                                           RTTY (MMTTY only)

 

Turn RTTY diddle off. This command also works if typed into the TXWindow.

 

]                                                           RTTY (MMTTY only)

 

Turn RTTY diddle on. This command also works if typed into the TXWindow.

 

^          Concatenation of adjacent letters. [see Note 3].

 

----------------------------------------

 

Note 1: These commands are designed to change the operation of a radio controlled by Logger32. Since these commands change mode, they can be invoked from any other mode. They are ignored if the radio is transmitting so they cannot be used if in a macro statement that is meant to execute while the radio is transmitting (e.g. "Fred – QSY to 14080",$RTTY$,$qsy 14080.00$).

 

Note 2: This command can be used ONLY as a standalone MACRO. NO other text can be included in the command.

 

Note 3: Concatenated CW letters like AR, SK, BK, etc, are simulated by MACRO text with a ^ (caret) between the letters to be joined, i.e., A^R, S^K.

 

Note 4: MACRO commands are only available via the buttons. They may not be typed manually in the TX Windows.

 

Note 5: MMVARI shows the RTTY RX freq as the middle of the mark and space (unlike MMTTY).

 

Note 6: For those users who are familiar with Zakanaka, the following Zakanaka Macros have not been included in the Logger32 Sound Card module:

 

$cd$

$comment$

$page$

$previous$

The following Zakanaka Macros have been re-named in Logger32

$myrst$ to $receivedrst$

$hisrst$ to $sentrst$

This macro will 'log' the QSO, clear the Logbook Entry window and revert the system back to receive mode.

73 $name$ TNX for the nice PSK QSO.
Hope to catch you on the 'waterfall' again soon...
$call$ de $mycall$ SK SK
$log$

Note 7: This is not a standalone macro and is to be used embedded in a text macro. See the example below.

The $greeting$ macro

To setup the greetings of your choice, Right-click on any Macro Button (just like you wanted to setup a Macro) and see the new option. Times listed on the Greeting Setup Window are local times of the station you are in QSO with. The default greeting is used if Logger32 cannot determine the time zone of the station you are in QSO with. Please note that there are separate set up panels for the CW machine and the digital modes

MHKPB_7 

As an example - this macro will send both callsigns, send the greeting and then the name of the QSO partner.

$call$ de $mycall$ $greeting$ $name$ nice to hear you again

MMTY Macros

A few MMTTY macros work in the RTTY mode of the Sound Card Data window:

]                       diddle on

[                       diddle off

~                      pause

%T                    UTC time

%t                     UTC time

%D                   UTC date

More Difficult Macros

This section provides examples of how to use some of the more difficult or unusual Macro commands.

$asciinnn$ - This command inserts the ASCII code (n)nnn of a character than cannot be entered from a keyboard into the output text string. For example, the ASCII code 191 will display the symbol  "¿". So the macro command $ascii191$Que pasa?  Will insert "¿Que pasa?" into the output text string. If the first digit is a zero, it is optional with this command, you can use either three or four characters.  In other words, $ascii0191$ or $ascii191$, entered in a macro command, will both generate the character "¿".

The character, tilde (~) cannot be typed into a macro, but if you need the tilde character, use $ascii0126$ in its place, and the tilde character will appear.

Example 1:

Set up a Macro button (say F12) that has the command $ascii0176$ and a button caption of chr$(0176) and save it. Simple enough!

Now, with the cursor in the TxWindow, enter the text "The temp here today is 90<F12>F." (Bet you're wondering how I did that ...)

$upperorlower$, $radiofreq$, $rxtonefreq$, and $radioandtone$

These commands are applicable to both PSK and RTTY.

Here is an example of how to use these them in PSK:

The following text is entered into the text window for Hot Key <F5>

Your exact frequency is $radioandtone$.  Here's how I figure that out ... My receiver is on  $radiofreq$.  I am receiving your signal at $rxtonefreq$.  Therefore your actual signal is $radiofreq$ $upperorlower$ $rxtonefreq$ = $radioandtone$.

The Button caption is set to "FREQ IN" and the Back color is set to blue.

Pressing the F5 key or clicking on the button titled "FREQ IN" will now insert the following text into the TX Window for transmission:

If you wanted to send the same message using RTTY, you need only change $rxtonefreq$ to $rttymarkfrequency$ in the macro text.

$command$ and $hexcommand$

These commands are used to send strings of commands to the radio serial port in either ASCII ($command$) or hexadecimal ($hexcommand$). You can see these codes being sent to the radio in the Radio Debug window.  The topic Direct Control of Radios shows how to use these codes for some radios. 

Normally, control of the radio is handled by Logger32, but these commands can be used to implement functions not already present in Logger32. Program them into macro buttons so you can invoke a command sequence with a script assigned to a single macro button.  For example, you could program a macro button to select filters in your radio.

$log$ 

This macro will 'log' the QSO, clear the Logbook Entry Window and revert the system back to receive mode.

73 $name$ TNX for the nice PSK QSO.
Hope to catch you on the 'waterfall' again soon...
$call$ de $mycall$ SK SK
$log$
$receive$

MACROs for Software Controlled Radios

$qsy$ and $command$ MACRO support has been added for software controlled radios.

The format is $command 14000.123 CW$

The space(s) at the beginning and end of the string are optional. The space(s) between the frequency and the mode are NOT optional. The format of the frequency is in KHz, and the string can use either a "," (comma) or a "." (period) as the decimal separator. The mode must be a valid mode for the radio in use. The only valid $command$ is to change the radio frequency and/or mode.

A Warning About Callsigns

When you use macros to send your callsign at the end of a transmission, especially in RTTY mode, it is wise to put some spaces and the letter K after your callsign. When the receiving station displays or prints your transmission, there may be "garbage" characters that appear immediately after you end your transmission.  This is because the receiving station's squelch could take a second or two to adjust to the no-signal condition.  If your callsign was sent as the last item of text before you turn off the carrier, the other station may add some "garbage" characters to it.  For example, "... de KX2A" may become "... de KX2AP" because a "garbage" P was displayed when the carrier went off.  However, "... de KX2A    K" would be displayed as "...de KX2A    KP," and it is unlikely that the receiving station will confuse the callsign.

System Time Adjustment

If you decide to use a time stamp (some contests even require this) then you may want to be sure that your computer system clock is correct. See the section describing the Atomic Clock.