# Command Tester/KX3 Macros

This page may be used to try out KX3 remote control commands. You can save commands as reusable macros, and execute them from their assigned buttons. You can even send macros to the KX3, where they can be assigned to programmable function switches. See below for sample macros and instructions for using them. Complete details on KX3 remote control commands can be found in the K3 and KX3 Programmer's Reference revision E6 or later.

Commands are shown in green, responses are shown in black.

Some command responses may contain unprintable characters. The command tester converts unprintable characters (those outside the range from \x20 to \x7E) into a hexadecimal representation. See the K3 and KX3 Programmer's Reference for a description of KX3 commands and their responses.

#### Macro Buttons

There are several rows of Macro buttons between the input and output areas. The Macro buttons may be configured by selecting the "Edit Macros" button to display the Edit Command Testers/KX3 Macros dialog.

## Edit Command Tester/KX3 Macros

The first eight macros may be stored in the KX3 and assigned to KX3 front panel switches for single-switch execution. Each KX3 macro may have up to 7 characters of Macro Label and 120 characters of associated Macro Commands. The 7-character Macro Label length limitation corresponds to the length of the KX3 VFO B display area.

Prepare and test your KX3 macros in the Command Tester, then click "Write Macros 1-8 to KX3".

The Save button stores Macro Labels and Macro Commands on your Personal Computer. Click "Write Macros 1-8 to KX3" to send macros to your KX3.

See the Firmware Release Notes and the K3 and KX3 Programmer's Reference for information on writing macros and how to assign a macro to a specific KX3 front panel button.

The remaining macros, 9-16, are not stored within the KX3. They may be executed by clicking the corresponding button on the Command Tester page.

#### Macro assignment procedure overview

Macro assignment to KX3 function keys was introduced in KX3 MCU version 1.38.

- Start the KX3 Utility.
- Select the Command Tester/KX3 Macros tab.
- Click Edit Macros.
- Enter a short (up to 7 character) label in one of the first eight Macro Label text boxes. This label will appear in the KX3's VFO B display area when you invoke the macro.
- Enter the sequence of KX3 commands in the corresponding Macro Commands text box. You may use the Windows copy and paste functions to copy Macro Commands from source documents (such as the sample macros below) into the text boxes of the Edit Command Tester/KX3 Macros dialog.
- Click "Send Macros 1-8 to KX3" to store the macros in your KX3.
- Leave the Edit Macros dialog by clicking Save or Cancel.
- On the KX3 front panel, hold MENU and then adjust VFO B until the word "MACROS" appears in the VFO B area.
- Tap 1-8 on the KX3 numeric keypad to choose one of the 8 macros you wish to assign to a function switch.
- Assign this macro to a function switch by holding PF1 or PF2.
- Tap DISP/MENU to exit the menu.
- Try out your macro execution by holding the assigned function switch, PF1 or PF2.

#### Sample Macros

Refer to the K3 and KX3 Programmer's Reference "Command Examples" and "Creating and Using Macros" sections for a further introduction.

Note that the K3 and KX3 use different SWT and SWH numbers.

Macro Label | Macro Commands | Description
--- | --- | ---
SPLIT+2 | SWT25;SWT25;FT1;UPB5;RT0;XT0; | CW Split starting point (UP 2) SWT25; is a switch emulation command that has the same effect as tapping A>B to copy VFO A frequency to VFO B SWT25; taps A>B again to copy all other settings to VFO B FT1; enters Split mode UPB5; moves VFO B up 2 kHz. The number 5 in UPB5 an index into a table of sizes. See the K3 and KX3 Programmer's Reference description of DN for full details. RT0; turns RIT off XT0; turns XIT off
SPLIT+5 | SWT25;SWT25;FT1;UPB7;RT0;XT0; | CW Split starting point (UP 5) SWT25; taps A>B once to copy VFO A frequency to VFO B SWT25; taps A>B again to copy all other settings to VFO B FT1; enters Split mode UPB7; moves VFO B up 5 kHz RT0; turns RIT off XT0; turns XIT off
NOSPLIT | FT0;RT0;XT0;SQ000; | Turns split, RIT, XIT and squelch off FT0; turns Split mode off RT0; turns RIT off XT0; turns XIT off SQ000; turns squelch off
WWV 10 | FA00010000000;MD5;BW0300; | Tune to WWV FA00010000000; tunes VFO A to 10 MHz. The FA command sets the frequency in Hertz and requires exactly 11 digits. MD5; enters AM mode BW0300; sets the filter bandwith to 3 kHz
LOCKA | LK1; | Lock VFO A LK1; locks VFO A Note: Tap RATE to unlock VFO A. Swap VFO A and B to lock or unlock VFO B.
599FAST | KS040;KYW5NN;KS025;KYWTEST; | Sends "5NN" at 40 WPM, then "TEST" at 25 WPM KS040; sets the keyer speed to 40 WPM KYW5NN; sends "5NN" and waits for the characters to all be transmitted KS025; sets the keyer speed to 25 WPM KYWTEST sends "TEST"
MUTE AF | AG000; | Sets AF gain to zero (Move the AF gain knob slightly to use its potentiometer value). AG000; sets the receiver AF gain to zero
UP 25K | UP7;UP7;UP7;UP7;UP7; | QSY up 25 kHz Each UP7; moves VFO A up 5 kHz Repeating UP7; 5 times moves VFO A up 25 kHz UP1; moves VFO A up 10 Hz UP2; moves VFO A up 20 Hz UP3; moves VFO A up 50 Hz UP4; moves VFO A up 1 kHz UP5; moves VFO A up 2 kHz UP6; moves VFO A up 3 kHz UP7; moves VFO A up 5 kHz UP8; moves VFO A up 100 Hz UP9; moves VFO A up 200 Hz DN1; thru DN9; move VFO A down by the same amounts