Skip to content

K3/K3S/KX3/KX2 CAT Command Reference

This document is derived from Elecraft’s K3S/K3/KX3/KX2 Programmer’s Reference, Rev. G5 (February 20, 2019). It provides a complete reference for all CAT (Computer Aided Transceiver) serial control commands supported by the Elecraft K3, K3S, KX3, and KX2 transceivers. For change history, see the appendix at the end of this document.

All K3S/K3/KX3/KX2 remote control commands are listed in the table below. The KX3 and KX2 accept all K3 commands, though some have no functional effect on the KX3/KX2 (marked with *). Some commands are recognized only by the KX3 or KX2 (marked with **). For K2 commands, see the KIO2 Programmer’s Reference.

Commands marked with $ support a $ suffix to target VFO B / sub RX (VFO B / dual watch for KX3/KX2).

NameDescriptionNameDescriptionNameDescription
!, @*Direct DSP controlFTTX VFO selectPSPower-on/off control
AG $AF gainFW $Filter bandwidth and #RA $RX attenuator on/off
AIAuto-info modeGTAGC speed and on/offRCRIT/XIT offset clear
AK **ATU network valuesICIcon and misc. statusRDRIT down
ANAntenna selectionIDRadio identificationRG $RF gain
APCW APF on/offIFGeneral informationRORIT/XIT offset (abs)
AR *RX antenna on/offIO **Internal use onlyRTRIT on/off
BC **Internal use onlyISIF shiftRURIT up
BGBargraph readK2K2 command modeRVFirmware revisions
BN $Band numberK3K3 command modeRXEnter RX mode
BRBaud rate setKE **Internal use onlySBSub or dual watch
BW $Filter bandwidthKSKeyer speedSDQSK delay
CPSpeech compressionKT **Internal use onlySM $S-meter
CWCW sidetone pitchKYKeyboard CW/DATASMH *High-res S-meter
DBVFO B textLDInternal use onlySP *Internal use only
DE *Cmd processing delayLK $VFO lock (A or B)SQ $Squelch level
DLDSP command traceLN *Link VFOsSWSWR
DMInternal use onlyMCMemory channelSWT/SWHSwitch tap/hold
DN/DNBVFO move downMD $Operating modeTBBuffered text
DSVFO A text/iconsMGMic gainTETX EQ
DTData sub-modeMLMonitor levelTM *TX meter mode
DV *Diversity modeMNMenu entry numberTQTX query
EL **Error logging on/offMPMenu param read/setTTText-to-terminal
ERInternal use onlyMQ **Menu param read/setTXEnter TX mode
ESESSB modeNB $Noise blanker on/offUP/UPBVFO move up
EWInternal use onlyNL $Noise blanker levelVXVOX state
FAVFO A frequencyOMOption modulesXF $XFIL number
FBVFO B frequencyPA $RX preamp on/offXLInternal use only
FI *I.F. center frequencyPCPower ControlXTXIT on/off
FN *Internal use onlyPN *Internal use only
FRReceive VFO selectPO **Power output read

Some commands emulate controls and display elements. For example, the SWT/SWH commands emulate switch TAP/HOLD, MN accesses menus, DS, DB, and IC read VFO A / B and icons, and BA and BG read bargraphs. Other commands directly read or modify radio parameters, such as the VFO A and B frequencies (FA and FB). There is some overlap between emulation and parametric commands.

In the remainder of this document, K3 references apply to the KX3 and KX2 as well unless otherwise noted.

Commands sent from the computer to the K3 are considered either GETs or SETs.

  • GET commands are used by the computer to get information from the K3; the K3 will then provide an appropriate response message (RSP).
  • SET commands are sent by the computer to change the radio’s configuration or initiate an event. A SET can be followed by a GET to verify the new settings, or the auto-info mechanism can be used for confirmation that something has changed (see AI in the Meta-commands section).

SET commands use 2 or 3 characters, optional data fields, and a terminating semicolon (;). Examples:

KS020; Computer sets CW speed to 20 WPM (data = 020)
MD1; Computer selects LSB mode (data = 1)

Many SET commands have a corresponding GET command, which is just the command letters with no data. The data format of the response message from the K3 (RSP) is usually identical to the format of the SET data. Exceptions are noted in the command descriptions.

Characters sent to the K3 can use either upper or lower case. The K3 will always respond with upper case, except when a lower-case character is a place-holder for a special symbol (e.g., the VFO B display command, DB).

Some commands target VFO B (and the sub RX, in the case of the K3) if $ is added after the command prefix. Examples include AG$, RG$, MD$, BW$, FW$, LK$. This is indicated in the reference section by a $ in the command title. Some commands target VFO B itself and do not need the $, including FB, UPB, DNB, and DB.

If the VFOs are linked (see LN), commands that affect the VFO A frequency also change VFO B. This includes FA, UP, DN, RU, RD, and RC. In Diversity mode, BW, FW and MD match the VFO B/sub receiver filter and mode settings, respectively, to the main receiver.

Some commands have an extended data format which provides enhanced functionality or backward compatibility with older software applications. Such commands should be avoided in switch macros because of the need to use a meta-command to enable extended functionality (see Meta-commands section). Alternatives are available. For example, the BW (bandwidth) command should be used in macros rather than the legacy FW command, which depends on meta-command settings.

The K3 will typically respond in less than 10 milliseconds. General worst-case latency is around 100 ms, except for commands that change bands, which can take up to 500 ms.

Since the K3 provides a full-duplex interface, the computer can send the K3 commands at any time. Continuous, fast polling (< 100 ms per poll for bar graph data in transmit mode, for example) should be carefully tested to ensure that it is not affecting radio operation. Polling during transmit should not be used unless necessary.

Some commands cannot be safely handled when the K3 is in a busy state, such as transmit, or in a limited-access state, such as BSET or VFO A/B reverse (REV switch). If a command cannot respond due to such a condition, the K3 will return ?;.

You can use the TQ command to see if the K3 is in transmit mode, and the icon/status command (IC) to check for BSET mode (byte a, bit 6).

Meta-commands change the behavior of other commands to provide automatic responses or compatibility with older application software. In general they should not be embedded in K3 or KX3 front-panel switch macros, as they may adversely affect software applications that control meta-command modes. The Command Reference section explains when to use them with specific commands.

The AI meta-command can be used to enable automatic responses from the K3 to a computer in response to K3 front panel control changes by the operator. Application software may use AI1 or AI2 mode as an alternative to continuous polling. (Not appropriate for switch macros.)

  • AI0 (No Auto-info): This is the default. The PC must poll for all radio information using GET commands; the K3 will not send any information automatically.
  • AI1 (Auto-Info Mode 1): The K3 sends an IF (info) response within 1 second when any frequency or mode-related event occurs, either manually (at the radio itself) or when the PC sends commands. These events include: band change, mode change, VFO movement, RIT/XIT offset change or clear, and several additional switches (e.g., A/B, REV, A=B, SPLIT, CW REV, RIT, XIT). IF responses are suppressed during VFO movement. Notes: (1) putting the K3 into auto-info mode 1 (by sending AI1;) causes an initial IF response. (2) The K3 can be placed into AI1 mode without a PC by setting CONFIG:AUTOINF to AUTO1. The user may do this to support non-PC devices that make use of auto-info, such as a SteppIR antenna controller. Application software can check for unexpected IF responses and turn AI off if required.
  • AI2 (Auto-Info Mode 2): The K3 sends an appropriate response (FA, FB, IF, GT, MD, RA, PC, etc.) whenever any front-panel event occurs. This applies to all of the events mentioned for mode AI1, and ultimately to all rotary control changes and switch presses. At present only a subset of controls generate responses.
  • AI3 (Combination): This is similar to mode AI2 and is provided only for compatibility with existing programs.

The K2 meta-command modifies the set/response format of some commands. Avoid using this command in switch macros.

  • K20 (K2 Normal mode): This is the default; K2 command extensions are disabled.
  • K21 (K2 Normal/rtty_off): Same as K20, except that MD and IF report RTTY and RTTY-reverse modes as LSB and USB, respectively. This may be useful with programs that don’t support a separate RTTY mode.
  • K22 (K2 Extended mode): Enables all K2 command extensions.
  • K23 (K2 Extended mode/rtty_off): Enables all K2 extensions, but like K21, alters the MD and IF commands.

The K3 meta-command modifies the set/response format of some commands. Avoid using this command in switch macros.

  • K30 (K3 Normal mode): This is the default; K3 command extensions are disabled.
  • K31 (K3 Extended Mode): Enables all K3-specific command extensions (see, for example, FW). Typically, K3 applications will place the K3 in K31 mode except when K30 mode is needed due to the use of certain commands.

Macros — strings containing one or more control commands — can be used to automate K3/KX3/KX2 control sequences. The table below lists some examples. Macros can have a length of up to 120 characters, along with a label of up to 7 characters.

LabelDescriptionCommand String
SPLIT+2CW DX split starting point: A>B twice, enter SPLIT, move VFO B up 2 kHz, RIT/XIT offSWT13;SWT13;FT1;UPB5;RT0;XT0;
EQ MIC1Boost 100-Hz TX EQ band by 8 dB; others “flat”TE+00+08+00+00+00+00+00+00;
WEAKSIGDiversity mode, main/sub preamps on, 200-Hz bandwidth, no IF shiftDV1;PA1;PA$1;BW0020;IS 9999;
CLEANUPTurn off split/RIT/XIT; unlink VFOs; open squelchFT0;RT0;XT0;LN0;SQ000;
WWV 1030 m, AM mode, VFO A to 10.0 MHz, 3 kHz AF bandwidth (requires 6 kHz IF crystal filter)FA00010000000;MD5;FA00010000000;BW0300;
OLDIESSwitch to AM radio station at 1550 kHz; 4 kHz BW, attn. on, preamp offFA00001550000;MD5;FA00001550000;BW0400;IS 9999;RA01;PA0;
LCD BRTSet the MAIN:LCD BRT menu parameter to 6MN003;MP005;MN255;
MEM32Load frequency memory #32 into VFOs A and BMC032;
LOCKA&BLock both VFOsLK1;LK$1;
PWRTESTSend “BT” at 100 W, 10 W, and 1 W, then restore power to 100 WPC100;KYW =;PC010;KYW =;PC001;KYW =;PC100;
TUN 10WSet power to 10 W and enter TUNE modePC010;SWH16;
AMP ONTurn on an external amplifier and set K3 drive to 65 WMN019;MP001;MN255;PC065;
599FASTSend “5NN” at 40 WPM, “TEST ” at 30 WPMKS040;KYW5NN ;KS030;KYWTEST ;
MUTE AFSet main and sub AF GAIN to zeroAG000;AG$000;
MON OFFSet monitor volume to zero (present mode)ML000;
SCANNOW(K3 only) Stores VFO A & B in per-band quick-memory M4 and starts scanSWT15;SWT39;SWT23;SWT39;SWH41;
STEPPIRSend frequency info to a device attached to the serial portIF;

Important Restrictions: (1) Macros normally only use SET commands, since they cannot make use of the response from a GET. For a useful exception, see the STEPPIR entry above. (2) Macros should not use meta-commands (like K31;) as this can interfere with software applications that control meta-modes. (3) Macros can be used to send direct DSP commands (see ! and @), but at present this only works from K3 Utility, not from K3 front-panel switches.

K3/KX3/KX2 Utility can be used to create and test macros. The first eight can be sent to the transceiver (K3 and KX3 only), where they can be assigned to any of the programmable function switches.

The pseudo-code program below displays the VFO A frequency (8 digits) while watching for the user to request a frequency change via the PC keyboard:

VfoControlLoop
{
SendCommand( "FA;" ) // GET frequency of VFO A
StringF = GetResponse( TIMEOUT_100MS ) // wait for response; include a timeout
Display( StringSubset( StringF, 5, 12 ) ) // show MHz through Hz digits on PC screen
If( KeyboardInput = "+" )
SendCommand( "UP;" ) // SET command that moves VFO A up
If( KeyboardInput = "-" )
SendCommand( "DN;" )
}

Commands marked with a dollar sign ($) apply to VFO B (and the sub receiver, in the case of the K3). Commands marked with an asterisk (*) are not functionally applicable to the Elecraft KX3 or KX2, but the KX3 and KX2 will accept and reply to all K3 commands. For K2 commands, see the KIO2 Programmer’s Reference.

This section describes all K3 GET, SET and RSP (response) command formats. Unless otherwise noted, the GET format is just the 2 or 3 letters of the command followed by a semicolon. The SET and RSP data formats are identical unless noted otherwise. When K2 or K3 extended modes are in effect (typically K22 or K31), some commands have an extended format (see Meta-commands). Both Basic and Extended formats are described here.


! and @ - Direct Main/Auxiliary DSP Control

Section titled “! and @ - Direct Main/Auxiliary DSP Control”

K3/K3S only (@ is K3/K3S only)

Elecraft releases documentation on specific DSP commands as user needs for them arise. DSP commands can cause side effects and should be used with caution.

Note: At present, DSP commands cannot be used in combination with regular commands in K3 Utility macros. Also, they will not work as K3 switch macros.


GET/SET

SET/RSP: AGnnn; or AG$nnn;
ParameterRangeDescription
nnn000-255AF gain level

GET/SET

SET/RSP: AIn;
ParameterRangeDescription
n0-3Auto-info mode (see Meta-commands for details)

Note: The AI power-up default is normally AI0, corresponding to K3 menu setting CONFIG:AUTOINF = NOR. AUTOINF can also be set to AUTO1, which makes the default AI1 on power-up. This is useful for K3s controlling a SteppIR antenna, etc.


KX3/KX2 only; GET only

RSP: AKaabbcc;
FieldDescription
aaInductance IO bitmap (ASCII hex)
bbCapacitance bitmap (ASCII hex)
ccMisc relays bitmap

The aa and bb bitmaps can be equated to L and C values by looking at the KXAT3 or KXAT2 schematic. For example, a value of “01” would represent the smallest L or C value in the network. At present only bit 0 of byte cc is defined: 00 = capacitors on the antenna side; 01 = capacitors on the transmit side. If the ATU is not installed or is in one of the Lx/Cx test settings, AK000000; is returned. In BYP mode, on some bands L and C are set to fixed non-zero values in order to cancel the ATU’s own reactance when working into a 50-ohm load. In AUTO mode, the working auto-tuned values are shown.


GET/SET

SET/RSP: ANn;
ParameterValueDescription
n1Antenna 1
n2Antenna 2

GET/SET

SET/RSP: APn;
ParameterValueDescription
n0APF OFF
n1APF ON

Applies to CW mode only, and only if CONFIG:DUAL PB is set to APF.


GET/SET; K3/K3S only

SET/RSP: ARn;
ParameterValueDescription
n0RX antenna OFF
n1RX antenna ON

GET only

RSP: BGnnx;
FieldDescription
nnBars turned on
xR (receive) or T (transmit) — K3 only

Returns S-meter level in receive (also see SM/SM$ command), and power or ALC level in transmit. On the K3 and K3S only, transmit metering mode can be set remotely using the TM command.

K3 Receive: nn is 00-21 (CWT off) or 00-09 (CWT on).

K3 Transmit: nn is 00-12 (PWR) or 00-07 (ALC) depending on METER setting. Also see TM command.

K2 Receive or Transmit: nn is 00-10 (DOT mode) or 12-22 (BAR mode).


GET/SET

SET/RSP: BNnn;
ParameterRangeDescription
nn00-24Present logical band for VFO A (use BN$nn for VFO B)

Note: BN SET command applies only to VFO A at present. BN GET works with either VFO A or B. If a band change occurs, allow 300 ms before sending other commands.

ValueBandValueBand
00160 m0812 m
0180 m0910 m
0260 m106 m
0340 m11-15Reserved
0430 m16Xvtr band #1
0520 m17Xvtr band #2
0617 m
0715 m24Xvtr band #9

SET only

SET: BRn;
ParameterValueBaud Rate
n04800
n19600
n219200
n338400

Note: The K3 firmware download utility automatically sets the K3 to 38400 baud for downloads, then restores the baud rate to the user’s selection (made using CONFIG:RS232).


GET/SET

SET/RSP: BWxxxx;
ParameterRangeDescription
xxxx0-9999Bandwidth in 10-Hz units

May be quantized and/or range limited based on the present operating mode.

Notes:

  1. BW is a derivative of the legacy FW command. BW is safer to use in switch macros, because it makes no assumptions about meta-command settings (K2x and K3x). FW may be preferred in applications.
  2. In diversity mode, BW matches the sub receiver’s filter bandwidth to the main receiver’s.
  3. Both BW and BW$ can be used in BSET mode (one exception: at present, BW/BW$ SET cannot be used in BSET mode with diversity receive in effect).
  4. If a KX3/KX2 is in DUAL RX (dual watch) mode, BW$ returns the value for BW.

GET/SET

SET/RSP: CPxxx;
ParameterRangeDescription
xxx000-040Speech compression level

GET only

RSP: CWxx;
ParameterRangeDescription
xx30-80Sidetone pitch in 10 Hz units

GET/SET; K3, KX3, and KX2 variants

GET format: DB; (no data). Returns text displayed on VFO B, including decimal points and colons if present. VFO B normally displays only uppercase alphabetic characters. DB returns the following lower-case characters that represent symbols:

CharacterSymbol
aantenna
bmu
cslashed 0
ditself
esigma
f<- (left arrow)
g-> (right arrow)
hII (pause)
ileft-justified “1”
jdelta, large
kdelta, small
lright-justified “1”
msuperscript “m”
nlowercase “w”

There are two SET formats with different functions:

SET format 1: DBn; where n is an ASCII character to send to VFO B, entering at the right end of the display and scrolling left as additional characters are entered. This can be used to create scrolling messages, insert a newsfeed, report a DX spot, etc.

SET format 2: DBnn; where nn is one of the available VFO B alternate display modes:

K3 modes:

ValueDisplay
00Normal
01Time
02Date
03RIT/XIT offset
04Supply voltage
05Supply current
06PA heatsink temp
07Front panel temp
08PLL1 voltage (requires CONFIG:TECH MD = ON)
09PLL2 voltage (requires CONFIG:TECH MD = ON)
10AFV (requires CONFIG:TECH MD = ON)
11dBV (requires CONFIG:TECH MD = ON)

KX3 modes:

ValueDisplay
00Normal
01Time
02Supply voltage
03Battery voltage (if KXBC3 installed)
04Supply current
05PA temp (PA.I=KX3, PA.X=KXPA100)
06OSC temp
07AFV
08dBV

KX2 modes:

ValueDisplay
00Normal
01Time
02Supply or batt. voltage
03N/A
04Supply current
05PA temp (PA.I=KX2, PA.X=KXPA100)
06N/A
07AFV
08dBV
09Amp hours (X.XXX AH)

SET only; K3/K3S only

SET: DExxx;
ParameterRangeDescription
xxx001-255Delay value in 10-ms increments

This is useful in switch or K-pod macros, where a delay may be desired to allow the radio to complete a previous operation before the next command is processed. Note: DE001 may result in a delay shorter than 10 ms, while DE002 is guaranteed to provide a delay between 10 and 20 ms.


SET only

SET: DLx;
ParameterValueDescription
x2Turn DSP command debugging OFF
x3Turn DSP command debugging ON

When ON, all commands sent from the MCU to the DSP are echoed to the K3’s serial port, with a few exceptions such as during program loading. The DVR icon will flash as a reminder.


SET only (also pertains to UP/UPB)

SET: DN; or DNB; or DNn; or DNBn;

DN; and DNn; move VFO A down. DNB; and DNBn; move VFO B down. DN; and DNB; also change parameters shown on VFO B (menu or switch settings).

Value of nVFO Displacement
01 Hz
1 (or not used)10 Hz
220 Hz
350 Hz
41 kHz
52 kHz
63 kHz
75 kHz
8100 Hz
9200 Hz

Note: If the VFOs are linked (non-SPLIT), DN; and DNn; set VFO B to the same frequency as VFO A.


GET only

GET: DS;
RSP: DSttttttttaf;

Returns everything needed to reproduce the contents of the VFO A display, as well as a basic subset of the LCD icons (also see IC command).

FieldDescription
ttttttttLCD text and decimal point data (8 bytes, values 0x30-0xFF)
aIcon data (1 byte)
fIcon flash data or additional K3 icon data (1 byte)

Text and decimal point data: The first byte is the left-most displayed character. Bit 7 (MSB) of each byte indicates whether the decimal point to the left of each character is on (1) or off (0). The other bits contain an ASCII character.

Table 3: DS response character conversions (bit 7 cleared)

DS chr.Converts toDS chr.Converts toDS chr.Converts to
<small-caps LMNZlowercase c
>dashQO[r-bar
@space (blank)VU\lambda
KHWI]RX/TX EQ level 4
Xc-bar^RX/TX EQ level 5

The menu parameters for MAIN:RX EQ / TX EQ consist of 8 mini bar-graphs with 5 possible levels. These show up as the following characters in the DS response string (level 1 through 5): _, =, >, ], and ^.

Icon data (byte a): Value between 0x80 and 0xFF. Bit 7 is always 1.

BitDescription
B7Always 1
B61=NB on
B51=ANT2 selected
B41=PREAMP on
B31=ATT on
B20=VFO A selected (always 0 for K3)
B11=RIT on
B01=XIT on

Icon flash data / additional K3 icons (byte f): Value between 0x80 and 0xFF. Bit 7 is always 1. In K3 normal mode (K30), the other 7 bits are all 0. In K3 Extended mode (K31):

BitDescription
B7Always 1
B61=SUB on
B51=RX ANT on
B41=ATU on (in-line)
B31=CWT on
B21=NR on
B11=NTCH on
B01=MAN NOTCH on

The IC command provides extended info about the K3’s sub receiver and does not require the use of K31.


GET/SET

SET/RSP: DTn;
ParameterValueDescription
n0DATA A
n1AFSK A
n2FSK D
n3PSK D

The value returned is the data sub-mode last used with VFO A, whether or not DATA mode is in effect. In Diversity Mode (K3 only), sending DTn matches the sub receiver’s mode to the main receiver’s.

Notes:

  1. Use DT only when the transceiver is in DATA mode; otherwise, the returned value may not be valid.
  2. In AI2/3 modes, changing the data sub-mode results in both FW and IS responses.
  3. The present data sub-mode is also reported as part of the IF command (requires K31).

GET/SET

SET/RSP: DVn;
ParameterValueDescription
n0Diversity mode OFF
n1Diversity mode ON
nSToggle both sub RX and diversity on/off together

K3 only; requires sub receiver. Turning the sub off also cancels diversity mode. Also see: LN (VFO A/B link) and SB (sub receiver on/off).


SET only; KX3/KX2 only

SET: ELn;
ParameterValueDescription
n0Error logging OFF
n1Error logging ON

When error logging is ON, the radio will report all “ERR xxx” messages and general warnings (e.g. “HiTemp->5W;”) to an attached PC.


GET/SET

SET/RSP: ESn;
ParameterValueDescription
n0ESSB mode OFF
n1ESSB mode ON

Note: The application must place the K3 in either LSB or USB mode for the ESSB ON condition to be relevant.


GET/SET

SET/RSP: FAxxxxxxxxxxx; or FBxxxxxxxxxxx;
ParameterDescription
xxxxxxxxxxxFrequency in Hz (11 digits)

Example: FA00014060000; sets VFO A to 14060 kHz.

The Hz digit is ignored if the K3 is not in FINE mode (1-Hz tuning; use SWT49). If the specified frequency is in a different amateur band than the present one, the K3 will change to the new band.

Notes:

  1. Band changes typically take 0.5 seconds; all command handling is deferred until this process is complete.
  2. If the specified frequency is over 30 MHz and is within a valid transverter band, the K3 will switch to that transverter band. If the specified frequency is outside the range of 500 kHz-30 MHz and 48-54 MHz, the K3 will switch to the amateur band closest to the requested one. (KSYN3A extends low range to 100 kHz.)
  3. If the VFOs are linked (non-SPLIT), FA also sets VFO B to the same frequency as VFO A.

GET only; K3/K3S only

RSP: Finnnn;
ParameterDescription
nnnnLast 4 digits of the K3’s present I.F. center frequency in Hz

Example: If nnnn = 5000, the I.F. center frequency is 8,215,000 Hz. Intended for use with panadapters, which need to keep track of the exact I.F. center frequency as filter bandwidths and shifts are changed. Not applicable to the KX3/KX2.


GET/SET

SET/RSP: FRn;
ParameterDescription
nIgnored in the K3 case because VFO A is always active for receive

Any FR SET cancels SPLIT mode.


FT - TX VFO Assignment and Optional SPLIT Enable

Section titled “FT - TX VFO Assignment and Optional SPLIT Enable”

GET/SET

SET/RSP: FTn;
ParameterValueDescription
n0VFO A for transmit
n1VFO B for transmit (enters SPLIT)

If B (1) is selected for transmit, the K3 will enter SPLIT (except when split is N/A). Use FR0; to cancel SPLIT.


GET/SET

NOTE: FW is a legacy K2 command with side-effects based on the K3x and K2x meta command settings. For the KX3, KX2, and K3, use BW if possible. Also use BW in switch macros.

K3 Extended SET/RSP format (K31):

FWxxxx;
ParameterRangeDescription
xxxx0-9999Bandwidth in 10-Hz units

May be quantized and/or range limited based on the present operating mode.

Basic and K2 Extended formats: See KIO2 Programmer’s Reference (K2). In K22 mode, direct selection of crystal filters is possible by adding a 5th digit (K2 and K3 only). However, K31 must not be in effect, or it will override the legacy K2 behavior.

Example to select filter #3:

K30;K22;FW00003;K20;K31;

Notes:

  1. In AI2/3 modes, moving the physical WIDTH control results in both FW and IS responses.
  2. In diversity mode, FW matches the sub receiver’s filter bandwidth to the main receiver’s.
  3. Both FW and FW$ can be used in BSET mode (exception: FW/FW$ SET cannot be used in BSET mode with diversity receive in effect).
  4. In K22 mode, a legacy 6th digit is added to the response (always 0).
  5. If a KX3/KX2 is in DUAL RX (dual watch) mode, FW$ returns the value for FW.

GET/SET

Basic SET/RSP format:

GTnnn;
ParameterValueDescription
nnn002Fast AGC
nnn004Slow AGC

K2 Extended SET/RSP format (K22):

GTnnnx;
FieldValueDescription
x0AGC off
x1AGC on

Note: AGC time constant is stored per-mode, as is AGC on/off and VFO tuning rate.


GET only

RSP: ICabcde;

Where abcde are 8-bit ASCII characters used as collections of flags. Each flag represents the status of an LCD icon and/or a specific transceiver function. The 8th bit (B7) of each byte is always 1 to ensure that control characters are not sent to the computer.

Table 4: IC response fields

Byte a (Misc)

BitDescription
B7Always 1
B61=BSET, 0=Normal
B51=TX TEST, 0=Normal
B41=mW power level (xvtr or KXV3 test), 0=normal power out
B30=MSG bank 1, 1=MSG bank 2
B21=MSG is playing, 0=no MSG playing
B11=CONFIG:MEM0-9 = BAND SEL
B0Preset #: 0=I, 1=II

Byte b (Sub RX)

BitDescription
B7Always 1
B61=VFOs linked (VFO A tunes both) (K3 only)
B51=VFO A/B bands are independent
B41=Diversity mode (K3 only)
B31=Sub ant. = MAIN, 0=Sub ant. = AUX (K3 only)
B2Sub RX aux source: 1=BNC (AUX RF), 0=non-TX ATU ant (K3 only)
B11=Sub RX NB is on, 0=Off (K3 only)
B01=Sub RX is on (dual watch in KX3/KX2)

Byte c (CW/DATA)

BitDescription
B7Always 1
B61=Full QSK, 0=Semi QSK
B51=Dual-passband CW or APF in use
B41=VOX on for CW, FSK-D, or PSK-D
B31=Dual-tone FSK filter in use
B21=Normal FSK TX polarity, 0=inverted
B11=Sync DATA, 0=Normal
B01=Text-to-terminal is in effect (see TT)

Byte d (Voice Modes)

BitDescription
B7Always 1
B61=VOX on in voice, DATA A, AFSK A
B51=ESSB, 0=Normal
B41=Noise gate on, 0=Off
B31=AM Sync RX, 0=Normal
B21=FM PL tone on, 0=Off
B11=(+) Rptr TX offset
B01=(-) Rptr TX offset

Byte e (Misc)

BitDescription
B7Always 1
B61=10 Hz SHIFT, 0=50 Hz SHIFT
B51=AM Sync USB, 0=AM Sync LSB
B41=Main RX is squelched
B31=Sub RX is squelched (K3 only)
B21=Sub RX NR is on, 0=Off (K3 only)
B11=OFS LED is on, 0=VFOB LED is on (KX3/KX2 only)
B01=Fast Play in effect (KX3/KX2 only)

Notes:

  • If BSET is in effect (byte a, bit 6=1), the values of some other flags may change or may be invalid. The application should examine this bit first.
  • Per-mode or per mode-group items (e.g., MSG bank # is stored separately for CW/FSK-D/PSK-D and voice/DATA-A/AFSK-A).

GET only

RSP: IDnnn;
ParameterValueDescription
nnn017K3/K3S/KX3/KX2 identifier

This command is provided only for compatibility with existing software. New or modified software should send the K3 command to the transceiver. If a K3n; response is received, the computer must be connected to a K3, KX3, or KX2. The K3, KX3, and KX2 can be differentiated from each other using the OM command.


GET only

RSP: IF[f]*****+yyyyrx*00tmvspbd1*;
FieldDescription
[f]Operating frequency, excluding any RIT/XIT offset (11 digits; see FA command format)
*Space (BLANK, ASCII 0x20)
+Either ”+” or ”-” (sign of RIT/XIT offset)
yyyyRIT/XIT offset in Hz (range is -9999 to +9999 Hz when computer-controlled)
r1 if RIT is on, 0 if off
x1 if XIT is on, 0 if off
t1 if the K3 is in transmit mode, 0 if receive
mOperating mode (see MD command)
vReceive-mode VFO selection: 0 for VFO A, 1 for VFO B
s1 if scan is in progress, 0 otherwise
p1 if the transceiver is in split mode, 0 otherwise
bBasic: always 0; K22: 1 if present IF response is due to a band change
dBasic: always 0; K31: DATA sub-mode if applicable (0=DATA A, 1=AFSK A, 2=FSK D, 3=PSK D)

The fixed-value fields (space, 0, and 1) are provided for syntactic compatibility with existing software.


KX3/KX2 only

SET/RSP format: TBD.


GET/SET

SET/RSP: IS*nnnn;
FieldDescription
*Must be a space (blank)
nnnnAF center frequency (Fc) in Hz

The SET value may be altered based on the present mode; a subsequent IS GET reports the value used. The nominal Fc (i.e., with no SHIFT) varies with mode, and in CW or DATA modes will also vary with PITCH. To center the passband, send IS 9999;. A subsequent IS read will then return the center frequency.

Notes:

  • In AM-Sync mode, send IS 1400 / IS 1600 to shift to LSB / USB. An IS GET will return IS 1500 in AM-Sync because AF Fc remains at 1500 Hz. To determine which sideband is in use for AM sync, see the IC command.
  • In AI2/3 modes, moving the physical SHIFT control results in both IS and FW responses.
  • In diversity mode, an IS command also shifts the sub receiver.
  • IS is not applicable to FM mode or QRQ CW mode.

GET/SET

SET/RSP: K2n;
ParameterRangeDescription
n0-3K2 mode (see Meta-commands section)

If non-zero, enables K2 command extensions to legacy “2-letter” commands. In most cases the effects of the K2 command are independent from those of the K3 command, and the two can both be non-zero at the same time. The FW command is an exception.


GET/SET

SET/RSP: K3n;
ParameterRangeDescription
n0-1K3 mode (see Meta-commands section)

If n is 1, enables K3-specific command extensions to legacy “2-letter” commands. Not needed for new commands that are unique to the K3.


GET/SET

SET/RSP: KSnnn;
ParameterRangeDescription
nnn008-050Speed in WPM (8-50 WPM)

GET/SET

SET: KY*[text];
FieldDescription
*Normally a BLANK. If W (for “wait”), processing of following host commands will be delayed until the current message has been sent.
[text]0 to 24 characters

Basic RSP format:

KYn;
ValueDescription
n = 0CW text buffer not full
n = 1Buffer full

K2 Extended RSP format (K22):

ValueDescription
n = 0Buffer < 75% full
n = 1Buffer > 75% full
n = 2Buffer completely empty AND transmit of previous string is complete

Prosign mappings:

CharacterProsign
(KN
+AR
=BT
%AS
*SK
!VE

Special characters:

CharacterFunction
<Puts the K3 into TX TEST mode, until a > character is received
>Returns the K3 to TX NORM mode
@Normally terminates any CW message; can be changed to prosign for “at” sign via CONFIG:CW WGHT
^D (EOT, ASCII 04)Quickly terminates transmission; use with CW-to-DATA

GET/SET

SET/RSP: LKn;
ParameterValueDescription
n0VFO unlocked
n1VFO locked

GET/SET; K3/K3S only

SET/RSP: LNn;
ParameterValueDescription
n0VFOs unlinked
n1VFOs linked

GET/SET

SET/RSP: MCnnn;
ParameterRangeDescription
nnn000-099Regular memories
nnn100+Per-band quick memories: 100 + bandNum * 4 + Mn - 1

For bandNum, see BN. Mn is 1-4 (M1-M4 tap).

Notes:

  1. A SET is ignored if the target memory is invalid.
  2. K3 only: If CONFIG:MEM0-9 = BAND SEL, then memories 000-009 will recall the last-used VFO frequencies in the target band, not fixed frequencies.
  3. Switching to any regular memory (000-099) updates the K3’s default V>M / M>V memory number.
  4. Switching to any memory tagged with * as the first character in its label enables channel-hop scanning.

GET/SET

SET/RSP: MDn; or MD$n;
ParameterValueMode
n1LSB
n2USB
n3CW
n4FM
n5AM
n6DATA
n7CW-REV
n9DATA-REV

Notes:

  1. K3 only: In Diversity Mode, sending MDn; sets both main and sub mode.
  2. DATA and DATA-REV select the data sub-mode that was last in effect on the present band (use DT to read/set data sub-mode).
  3. In K2 command modes 1 and 3 (K21 and K23), the RSP message converts modes 6 and 7 (DATA and DATA-REV) to modes 1 and 2 (LSB and USB).
  4. If a KX3/KX2 is in DUAL RX (dual watch) mode, MD$ returns the value for MD.
  5. FM mode does not apply to the KX2.

GET/SET

SET/RSP: MGxxx;
ParameterRangeDescription
xxx000-060Mic gain level

GET/SET

SET/RSP: MLxxx;
ParameterRangeDescription
xxx000-060Monitor level

Applies to current mode (CW sidetone, voice, or data). In voice modes, applies to MON level, even if DVR monitor level is independent (MAIN:TX DVR).


GET/SET; K3, KX3, and KX2 variants

SET/RSP: MNnnn;

Where nnn is the menu entry number. MN255 is returned if the menu is not in use. MN commands can be sent in any order. To exit the menu, send MN255. To change the parameter, use UP / DN (or MP and MQ commands).

Important: TECH MD menu entry must be set to ON to access tech-mode menu entries; otherwise MN will skip these entries. Use MN072 to access the TECH MD menu entry. On the KX3/KX2, tech-mode parameters are locked by default when accessed at the radio, but are automatically unlocked when accessed via the MN/MP/MQ commands.

Items marked with + can be read/set using the MP command. Items marked * have been removed from the K3 menu (ID number preserved for backwards compatibility). md is the data mode pertaining to a menu entry: CW, SB (LSB/USB), DT (DATA), AM, or FM. pwr is LP (QRP), HP (QRO), or MW (milliwatt).

EntrynnnEntrynnnEntrynnnEntrynnn
ALARM000DATE MD030SMTR MD060XVx RF090
IAMBIC001DDS FRQ031AGC-F061XVx IF091
LCD ADJ +002LIN OUT +032REF CAL062XVx PWR092
LCD BRT +003KIO3033SQ MAIN063XVx OFS093
LED BRT +004ADC REF034SQ SUB064XVx ADR094
MSG RPT +005RFI DET035SMTR OF065AF GAIN095
PADDLE006KDVR3036SMTR SC066TX ESSB096
RPT OFS +007AGC-S037SMTR PK067SPKR+PH097
RX EQ008FLx BW038SPLT SV068VFO B->A098
TX EQ009FLx FRQ039SPKRS069AGC PLS099
VOX GN010FLx GN040SW TEST070RIT CLR100
ANTIVOX011FLx ON041SW TONE071TX GATE101
WEIGHT012FLTX md042TECH MD072MEM 0-9102
2 TONE013FP TEMP043TIME073PTT KEY103
AFV TIM014FSK POL044AGC THR +074VFO CRS104
MIC+LIN015AUTOINF045PTT RLS075AFX MD +105
TX DLY016KBPF3046BND MAP076SIG RMV106
AGC SLP017AF LIM047TTY LTR077AFSK TX107
FM MODE018KNB3 *048TX ALC078AGC DCY108
DIGOUT1 +019KRC2 AC049TXGN pwr079PB CTRL109
AGC HLD020KRX3050SUB AF080MACRO x110
FM DEV021KXV3051PWR SET081L-MIX-R +111
EXT ALC022LCD TST052MIC BTN082CW QRQ112
KAT3 +023MIC SEL053VCO MD +083TX DVR113
BAT MIN024NB SAVE054VFO CTS084TX MON114
TX INH025KPA3 +055VFO FST085DUAL PB115
SER NUM026PA TEMP056VFO IND086VFO LNK116
TXG VCE027RS232057VFO OFS087ATTEN +117
FW REVS028TUN PWR +058WMTR pwr088PREAMP2118
DATE029SYNC DT059XVx ON089Exit Menu255

Items marked with + can be read/set using the MP command (or MQ in the case of TXCRNUL). nnn is permanently associated with a menu entry, even if entries are moved.

EntrynnnEntrynnnEntrynnnEntrynnn
ALARM +000AUTOINF +045MIC BTN +082CW KEY1 +120
CW IAMB +001AF LIM +047VFO CTS +084CW KEY2 +121
MSG RPT +005LCD TST052VFO OFS +087VOX INH +122
RPT OFS +007RS232057WATTMTR +088RX I/Q +123
RX EQ008TUN PWR +058XVx ON089RX ISO +124
TX EQ009SMTR MD +060XVx RF090RXSBNUL +125
VOX GN +010REF CAL062XVx IF091AM MODE +126
CW WGHT +012SW TEST070XVx PWR092TXSBNUL +127
2 TONE013SW TONE +071XVx OFS093AGC MD +128
TX DLY +016TECH MD +072XVx ADR094AGC SPD +129
FM MODE +018TIME073TX ESSB +096TX BIAS130
FM DEV +021AGC THR +074VFO B->A098TX GAIN131
ATU MD +023BND MAP +076TX GATE +101TXCRNUL +132
BAT MIN +024SER NUM026VFO CRS +104AUTOOFF +133
FW REVS028FW REVS028AFX MD +105RX XFIL +134
MACRO x110ATU DATA +112VFO NR +119MICBIAS +135
PREAMP +136BAT CHG +137BKLIGHT +138COR LVL +139
DUAL RX +140ACC2 IO +141RX SHFT +142RX NR +143
PBT SSB +144LED BRT +145PA MODE +1462M MODE +147
Exit Menu255

Items marked with + can be read/set using the MP command (or MQ in the case of TXCRNUL). Items marked with * are new KX2-specific menu entries not present in the KX3.

EntrynnnEntrynnnEntrynnnEntrynnn
CW IAMB +001AUTOINF +045MIC BTN +082CW KEY1 +120
MSG RPT +005AF LIM +047WATTMTR +088CW KEY2 +121
RX EQ008LCD TST052XVx ON089VOX INH +122
TX EQ009RS232057XVx RF090RX I/Q +123
VOX GN +010TUN PWR +058XVx IF091RXSBNUL +125
CW WGHT +012SMTR MD +060XVx PWR092AM MODE +126
2 TONE013REF CAL062XVx OFS093TXSBNUL +127
TX DLY +016SW TEST070TX GATE +101AGC MD +128
ATU MD +023SW TONE +071VFO CRS +104AGC SPD +129
BAT MIN +024TECH MD +072AFX MD +105TX BIAS130
SER NUM026TIME073ATU DATA +112TX GAIN131
FW REVS028AGC THR +074LED BRT +145TXCRNUL +132
BKLIGHT +138COR LVL +139DUAL RX +140AUTOOFF +133
PA MODE +146MICBIAS +135PITCH + *148ALT MD *149
CWT *150AMP HRS *151VOX MD *152VOX DLY *153
TX CMP + *154RF GAIN + *155XIT *156ANT.X SW *157
KXIO2 *158RTC ADJ *159AUX 1 *160AUX 2 *161
Exit Menu255

GET/SET

SET/RSP: MPnnn;
ParameterRangeDescription
nnn0-255Parameter value (useful range determined by the present menu entry)

Only menu entries marked with + in Table 5, 6, or 6A can be accessed with MP, while others will return ?; (use UP / DN, DS, and SWT/SWH in such cases). There is no range checking with MP in most cases, so the user’s macro or application must verify the correct range.

MP Command Special Cases (KX3 and KX2 only):

For some menu entries, the MP get/set value pertains only to specific binary bit fields in the 8-bit quantity. For MP SETs, the KX2/3 protects all unrelated bit positions. For MP GETs, the KX2/3 masks off unused bit positions.

Menu EntryBit FieldDescription
AGC MDbit0on/off
AGC SPDbit1slow/fast
ALARM (KX3 only)bit4on/off
AM MODEbit6disabled/enabled
ATU DATAbit3SET1(0)/SET2(1)
ATU MODEWhen ATU.X is in effect (KXAT100 mode), MP is GET-only. KX2: L8/C8 do not apply to the KXAT2.
BND MAP (KX3 only)bit5in/out
CW IAMBbit7modeA/modeB
CW KEY1bit0=tip is dot/dash; bit1=paddle/hand-key
CW KEY2bit4=tip is dot/dash; bit5=paddle/hand-key
DUAL RXbit4off/on
FM MODEbit7disabled/enabled
MIC BIASbit4off/on
MIC BTNbit0=PTT disabled/enabled; bit2=UP/DN buttons disabled/enabled
PBT SSB (KX3 only)bit7lohicut/nor (nor=width-shift)
PREAMP (KX3 only)bit0=10dB, bit1=20dB, both=30dB
RX I/Q (KX3 only)bit2off/on
RX SHFT (KX3 only)bit0nor/8.0 kHz
RX XFIL (KX3 only)bit1KXFL3 not installed/installed
SMTR MD (KX3 only)bit7nor (relative)/absolute
SW TONEbits0-2=CW feedback speed in WPM; bit6=CW UI off/on; bit7=tones off/on
TECH MDbit2off/on
TX ESSB (KX3 only)bit0off/on
TX GATEbit1off/on
VFO CRSbits2-3one of up to 4 coarse-tuning selections
VFO NR (KX3 only)bit5on/off
VFO OFS (KX3 only)bit0coarse offset control disabled/enabled

GET/SET; KX3/KX2 only

SET/RSP: MQnnnnn;
ParameterRangeDescription
nnnnn0-6553516-bit parameter value

Applies only to the TXCRNUL menu entry at present.


GET/SET

SET/RSP: NBn; or NB$n;
ParameterValueDescription
n0Noise blanker OFF
n1Noise blanker ON

Notes: NB0 always turns the noise blanker off, overriding any non-zero NL settings. In K2 extended mode, an additional ‘0’ is appended to the NB response for legacy format compatibility.


GET/SET

SET/RSP: NLddii; or NL$ddii;
FieldRangeDescription
dd00-21DSP NB level
ii00-21IF NB level (K3 only)

For the K3’s DSP or IF blanker, 00 effectively turns that blanker off, even if NB1 is in effect. For the DSP blanker on the K3, 01 = setting t1-1, 02 = t1-2, etc. For the KX3/KX2 DSP blanker, 01 = level 1, etc. For the IF blanker (K3 only), 01 = NAR1, 02 = NAR2, etc.


GET only; K3S, K3, KX3, and KX2 variants

K3/K3S RSP format:

OM APXSDFfLVR--;

Characters, if present, indicate installed and detected option modules. Positions are fixed. If a module is not present, its letter is replaced by a dash (-).

K3/K3S Option modules:

LetterModule
AATU (KAT3A)
PPA (KPA3A)
XXVTR and RX I/O (KXV3, KXV3A, or KXV3B)
SSub Receiver (KRX3A)
DDVR (KDVR3)
FBand-Pass Filter module, main (KBPF3A)
fBand-Pass Filter module, sub (KBPF3A)
LLow-Noise Amplifier available on present band (preamp 2, KXV3B only)
VKSYN3A synthesizer (extends VFO tuning range)
RK3S RF board

Note 1: The presence of R in the string (K3S RF board) is the preferred way to identify a K3S.

Note 2: Presence of a KSYN3A (V) extends VFO tuning range down to 100 kHz. Use of frequencies below 160 meters requires a KBPF3 option module.

KX3 and KX2 RSP format:

OM APF---TBXI0n;

Where 0n is the product identifier: n=1 for KX2, n=2 for KX3.

KX3/KX2 Option modules:

LetterModule
AATU (KXAT3 or KXAT2)
PExternal 100-W PA (KXPA100)
FRoofing filter (KXFL3)
TExternal 100-W ATU (KXAT100, a KXPA100 internal option)
BInternal NiMH battery-charger/real-time clock (KXBC3)
XKX3-2M or KX3-4M transverter module
IKXIO2 RTC I/O module

GET/SET

SET/RSP: PAn; or PA$n;
ParameterValueDescription
n0Preamp OFF
n1Preamp ON
n2Preamp 2 on the KXV3B module (requires KXV3B option)

Notes:

  1. The main receiver’s preamp setting is saved per-RX ANT state. This is not the case for the sub receiver.
  2. Preamp 2 is available on 12/10/6 meters only, and must be enabled individually on each band using the KXV3B menu entry. If the LNA is enabled on the present band, an L will appear in the OM response.
  3. Preamp 2 is available for sub receiver use only if the sub is sharing the main antenna path.

GET/SET

Basic SET/RSP format:

PCnnn;
  • K3: nnn is normally 000-012 (KPA3 not enabled) or 000-110 watts (KPA3 enabled). If byte a, bit 4 of the IC command response is set (indicating CONFIG:KXV3 is set to TEST, or a transverter band with low-level I/O is selected), then the unit is hundreds of a mW, and the available range is 0.00-1.50 mW.
  • KX3/KX2: If a KXPA100 is not attached, nnn is 000-012 on 80-20 m and 000-015 on 160/15-6 m. If a KXPA100 is attached, nnn is 000-110.

K2 Extended SET format (K22):

PCnnnx;

Where x controls the 100-W PA stage. In the K3, x=0 sets CONFIG:KPA3 MD to PA BYP, and 1 sets it to PA NOR. In the KX3/KX2, x=0 sets MENU:PA MODE to OFF, and 1 sets it to ON.

K2 Extended RSP format (K22): PCnnnx; where nnn is power, and x is 0 (low range) or 1 (high range).


GET only; KX3/KX2 only

RSP: POnnn;
ParameterDescription
nnnPower in tenths of a watt (QRP mode) or watts (QRO mode)

Note: The QRO case only applies if the KXPA100 amplifier is enabled via PA MODE=ON, is connected to the KX3/KX2 via the special control cable, and the PWR level is set to 11 W or higher. The reading is approximate. For a more accurate reading, use the KXPA100’s ^PF; command.


GET/SET

SET/RSP: PSn;
ParameterValueDescription
n1Transceiver on
n0Transceiver off

Note: PS0 turns the transceiver off, but this removes power, so PS1 cannot be used to turn it on. To turn power on, the K3’s POWER_ON line (aux I/O jack) must be pulled low by an external device, or it can be turned on manually using the power switch.


GET/SET

SET/RSP: RAnn; or RA$nn;
  • K3/KX3/KX2: nn is 00 (attenuator OFF) or 01 (attenuator ON, -10 dB).
  • K3S: nn can be the actual value in dB: 00/05/10/15 for the main receiver, and 00/10 for the sub. For backward compatibility, RA01 can also be used to select 10 dB.

Notes:

  1. K3/K3S: The main receiver’s attenuator on/off condition is saved per-RX ANT state. The sub receiver’s attenuator setting is not.
  2. K3S only: The user’s desired main receiver attenuator ON level is saved per-band (5, 10, or 15 dB). A host application can directly set this per-band attenuator ON value using RA while simultaneously turning the attenuator on.

SET only

SET: RC;

No data. Sets RIT/XIT offset to zero, even if RIT and XIT are both turned off (the change will be reflected when either RIT or XIT is turned on).


SET only

SET: RD;

No data. Moves the RIT/XIT offset down one step, which can be 1, 10, 20, or 50 Hz, depending on the present VFO tuning rate. If the user has selected COARSE VFO tuning, RD moves either 20 or 50 Hz, as specified by CONFIG:VFO FST. The offset change occurs even if RIT and XIT are both turned off. RIT/XIT offset range under computer control is -9.999 to +9.999 kHz. VFO step size is stored per-mode. Use the IF command to check the present RIT/XIT offset amount.


GET/SET

SET/RSP: RGnnn; or RG$nnn;
ParameterRangeDescription
nnn000-250RF gain level

On the KX3/KX2, 250 = maximum RF gain (attenuation of 0 dB), and 190 = -60 dB.


GET/SET

SET/RSP: ROsnnnn;
FieldDescription
s+ or - (or space in lieu of +)
nnnn0000-9999 (offset in Hz)

GET/SET

SET/RSP: RTn;
ParameterValueDescription
n0RIT OFF
n1RIT ON

RIT is disabled in QRQ CW mode.


SET only

See RD command for details.


GET only

GET: RVx;
RSP: RVxNN.NN;
Value of xModule
MMCU
DMain DSP
AAux DSP (K3)
RDVR (K3)
FFront Panel flash (K3)

NN.NN is the firmware revision, e.g. 02.37. If a module is not present, or an unknown module ID is requested, the revision is normally reported as 99.99. A module that is present but malfunctioning may return 00.00.


SET only

SET: RX;

No data. Terminates transmit in all modes, including message play and repeating messages. RX/TX status is available via the TQ command and is also included in the IF response.

Note: RX is not usable in CW mode in the K2.


GET/SET

SET/RSP: SBn;
ParameterValueDescription
n0K3 sub receiver off, or KX3/KX2 dual watch off
n1On

Also see DV command (diversity), which can automatically turn the sub on/off when using the DVS form.


GET only

RSP: SDnnnn;
ParameterDescription
nnnnSemi-break-in delay in 50-ms increments

Provided for backwards compatibility with older applications. If the K3 is in full QSK mode, SD will still read the same value even though the actual break-in delay is set to as close to 0 as possible.


GET only

Basic RSP format:

SMnnnn;
ParameterRangeDescription
nnnn0000-0015S-meter reading (Basic)

Examples: S9=6; S9+20=9; S9+40=12; S9+60=15.

K3 Extended RSP format (K31):

ParameterRangeDescription
nnnn0000-0021S-meter reading (Extended)

Examples: S9=9; S9+20=13; S9+40=17; S9+60=21.

This command can be used to obtain either the main (SM) or sub (SM$) S-meter readings. Returns 0000 in transmit mode. Also see BG and BA.


GET only; K3 only at present

RSP: SMHnnn;
ParameterDescription
nnnApproximate S-meter values: S1=5, S9=40, S9+60=100

Max possible value is about 140.


K3/K3S only (functionally)

SPG; (KX3) returns ADC ground-reference reading, typically SP000.


GET/SET

SET/RSP: SQnnn; or SQ$nnn;
ParameterRangeDescription
nnn000-029Squelch level

If the K3’s CONFIG:SQ MAIN menu entry is set to a numeric value (0-29), then SQ and SQ$ apply to main and sub receivers, respectively, and the SUB RF/SQL pot on the K3 controls SUB RF GAIN. However, if SQ MAIN is set to =SUBPOT, then SQ and SQ$ are linked (either applies to both receivers).


GET only

RSP: SWnnn;
ParameterRangeDescription
nnn010-999SWR in tenths of a unit (1.0:1 to 99.9:1)

The value is updated on any transmit, but not on a band change. SW works during transmit, TUNE, and during ATU tuning.


SET only; K3, KX3, and KX2 variants

SET: SWTnn; (TAP functions)
SET: SWHnn; (HOLD functions)

Where nn is determined from the tables below. Switch emulation commands must sometimes be followed by a delay if successive commands expect the switch function to have been executed.

TAPHOLDnnTAPHOLDnnTAPHOLDnn
BAND-VOX09FREQ ENTSCAN41CWT (0)TEXT Dec40
BAND+QSK10FINECOARSE49AFX (<-)DATA Md43
MODE-ALT17RATELOCK50V->MAF REC15
MODE+TEST18SUBDVRSTY48M->VAF PLAY23
MENUCONFIG14A/B (1)BSET11M1M1-RPT21
XMITTUNE16REV (FM/rpt) (2)n/a12M2M2-RPT31
RX ANTn/a25A->B (3)SPLIT13M3M3-RPT35
DISPMETER08PRE (4)ATT24M4M4-RPT39
ATU TuneATU19AGC (5)OFF27RECMSG Bank37
ANTANT Name26XFIL (6)DUAL PB/APF29RITPF145
SHIFT/LONORM58NB (7)LEVEL33XITPF247
WIDTH/HII/II59NR (8)ADJ34CLRn/a53
SPD/MICDELAY57NTCH (9)MANUAL32
CMP/PWRMON56SPOT (.)PITCH42
TAPHOLDnnTAPHOLDnnTAPHOLDnnTAPHOLDnn
BAND+RCL08PRE (1)NR19MODEALT14A/BREV (FM/rpt)24
BAND-STORE41ATTN (2)NB27DATATEXT17A->BSPLIT25
FREQ ENTSCAN10APF (3)NTCH20RITPF118XITPF226
MSG (<-)REC11SPOT (4)CWT28RATEKHZ12DISPMENU09
ATU TUNE (.)ANT44CMP (5)PITCH21
XMIT (0)TUNE16DLY (6)VOX29
AF/RF-SQL (7)MON32PBT I/II (8)NORM33KEYER/MIC (9)PWR34OFS/BCLR35

Note: If “Fast Play” is in effect, switch emulation commands for BAND+, BAND- and FREQ ENT are blocked (both SWT and SWH). See byte (e), bit 0 of the IC response.

TAPHOLDnnTAPHOLDnnTAPHOLDnn
AF GAIN/MON (0)NB32DATATEXT26MODE (.)RCL08
PRE (/ATTN) (1)NR19MSGREC11BAND (<-)STORE14
FIL (2)APF/AN27RATEFREQ/SCAN41A/B (6)A>B44
ATU (3)PFn20RIT (7)SPLIT18
XMIT (4)TUNE16DISP (8)MENU09
KYR-SPT/MIC (5)PWR34OFS/B (9)CLR35

ATU on the KX2 is the same as ATU TUNE on the KX3.


TB - Received Text Read / Transmit Text Count

Section titled “TB - Received Text Read / Transmit Text Count”

GET only

RSP: TBtrrs;
FieldDescription
tCount of buffered CW/data characters remaining to be sent (from KY packets), 0-9
rrCount of received CW/data characters available (00-40)
sVariable-length receive text string

If no received text is available, and no transmit text to be sent, the response is TB000;.

Notes:

  1. Since an RX count is provided, semicolons can appear in the text string.
  2. After the K3 responds to a TB command, it clears the RX count to zero.
  3. Application software must poll with TB; often enough to prevent loss of incoming text.

GET only; KX3/KX2 only

RSP: TBXtts;
FieldDescription
ttCount of buffered CW/data characters remaining to be sent (00-40)
sVariable-length transmit text string

If no transmitted text is available, the response is TBX00;.


SET only

SET: TEabcdefgh;

Where a through h are 3-character fields, each specifying a range of -16 to +16 dB.

FieldEQ Band
a50 Hz
b100 Hz
c200 Hz
d400 Hz
e800 Hz
f1600 Hz
g2400 Hz
h3200 Hz

Important: If the current transmit mode is SSB, CW or DATA, TE applies to SSB. If the transmit mode is ESSB, AM, or FM, TE affects ESSB/AM/FM. The two setups are saved separately.


GET/SET; K3/K3S only

RSP: TM0; or TM1;
ValueDescription
TM0SWR/RF metering
TM1CMP/ALC metering

This sets the transmit meter mode for the LCD bargraphs, as well as for the BG command (equivalent to using the METER switch). When TM0 is in effect, BG returns the RF level. When TM1 is in effect, BG returns the ALC level.


GET only

RSP: TQ0; or TQ1;
ValueDescription
TQ0Receive mode
TQ1Transmit mode

This is the preferred way to check RX/TX status since it requires far fewer bytes than an IF response. TQ1 will be returned even during pseudo-transmit conditions such as TX TEST or when the radio is “pre-armed” for CW transmit via XMIT or PTT.


SET only

SET: TTn;
ParameterValueDescription
n0Disable decoded text routing to PC
n1Enable decoded text routing to PC (ASCII)

Note: TB (text buffer read) provides a more reliable means of implementing a CW/data terminal. TB must be used rather than TT if a P3 panadapter is attached between the computer and K3.

There is no GET command for TT, but its status can be checked using the IC command: byte c, bit 0.


SET only

SET: TX;

No data. Same as activating PTT or using the XMIT switch. Applies to all modes except direct data (FSK-D and PSK-D). In these cases, use the paddle, send a message, or use a KY text packet. The TX command is ignored in these modes. Use the RX command to cancel TX.


SET only

See DN/DNB command for full details. UP and UPn move VFO A up. UPB and UPBn move VFO B up.


GET/SET on K3; GET only on KX2 and KX3

SET/RSP: VXn;
ParameterValueDescription
n0VOX off
n1VOX on

Applies only to present mode (voice/data, or CW). In CW mode, VOX refers to “hit-the-key transmit.” In voice/data modes, VOX refers to voice-operated-relay.

KX2 only: In SSB mode, the VOX state returned by VX applies only to the external mic, whether currently plugged in or not. VOX cannot be used with the internal mic.


GET only

RSP: XFn;
ParameterRangeDescription
n1-5Present XFIL selection for the target receiver

In the K3, the XFIL selection refers to crystal filters. In the KX3, the XFIL selection refers to the analog I/Q filters on the KXFL3 module. The KX2 has only DSP filters, so XF always returns XF1;.


GET/SET

SET/RSP: XTn;
ParameterValueDescription
n0XIT OFF
n1XIT ON

XIT is disabled in QRQ CW mode.


Applicable MCU firmware revisions are shown in brackets.

Note: Prior to revision D1 this document applied only to the K3. For earlier change history, see rev C14.

K3 rev 4.48; KX3 rev 0.58

  • Document now pertains to both the K3 and KX3. Asterisks in Table 1 now show K3 commands that are not functionally applicable to the KX3.
  • SWT/SWH, MN, and OM descriptions updated to show differences between K3 and KX3.

K3 rev 4.48; KX3 rev 0.59

  • KXAT3 menu entry back to MN023.
  • XMIT/TUNE switch on KX3 remapped to match the K3’s SWT/SWH code (13).

K3 rev 4.48; KX3 rev 0.80

  • DB command is different for the KX3.
  • RG response is different for the KX3.
  • MQ command added for the KX3 (16-bit menu parameter access).
  • SPG command added (KX3 ground-reference check).
  • SMH command added (K3 high-resolution S-meter).

K3 rev 4.48; KX3 rev 0.91

  • PO command added to the KX3 (reads actual power output during transmit).
  • EL command added to the KX3 (turns run-time error logging on/off).

K3 rev 4.48; KX3 rev 0.92

  • Added RX SHFT menu entry to KX3’s MN command ID list.

K3 rev 4.48; KX3 rev 0.92

  • Corrected NL command description, including note about the KX3 noise blanker.

K3 rev 4.50; KX3 rev 0.99

  • The MN command table now reflects all of the KX3 menu parameters accessible via MP and MQ.
  • The MP command now has a full list of menu entries with detailed semantics and examples.

K3 rev 4.51; KX3 rev 1.10

  • Added RX NR to MN table.

K3 rev 4.51; KX3 rev 1.20

  • Added internal-only commands BC and KT to command table.

K3 rev 4.51; KX3 rev 1.35

  • Added bit to IC command to show state of OFS/VFOB LEDs. See byte (e) bit (1).

K3 rev 4.62; KX3 rev 1.38

  • Added MACRO menu function to MN table.

K3 rev 4.66; KX3 rev 1.42

  • Added LED BRT to MN table (MN145).

K3 rev 4.66; KX3 rev 1.54

  • Added PA MODE to MN table (MN146).

K3 rev 4.66; KX3 rev 1.70

  • Clarified the effect of meta-mode K22 on the PC command (power control).
  • Added 2M MODE menu entry to MN table (MN147).

K3 rev 4.68; KX3 rev 1.72

  • The SW commands for the REV switch on both radios only apply to swapping repeater input/output frequencies in FM mode.

K3 rev 4.83; KX3 rev 1.92

  • Added T and X identifiers to the OM (option module detect) response for the KX3.
  • Added KE command (Elecraft internal use only).
  • Clarified PO command usage in QRO mode.
  • Clarified NL command usage.
  • For ATU.X MD menu entry (KXAT100 status), the MP command is GET-only.

K3 rev 4.84; KX3 rev 1.94

  • Added special-case LCD characters m and n to DB command.

K3 rev 4.84; KX3 rev 1.95

  • Added TX DLY to KX3’s MN function list (#016).

KX3 rev 2.01

  • Added KX3-4M module to OM response list (for character X).

KX3 rev 2.11

  • If KX3 is in Fast Play message mode: (1) bit 0 of byte (e) is set in the IC response; (2) the SWT emulation commands for BAND+, BAND-, and FREQ ENT are blocked, returning ?;.

KX3 rev 2.25

  • When the KX3 is in DUAL RX mode (dual watch), BW$, FW$, and MD$ commands return the values for VFO A, not VFO B, in the dual-watch case.

K3 rev 5.12

  • In DV command: Described DVS command variant, which toggles both diversity and sub RX on/off together.
  • Added CONFIG:VFO LNK menu entry to the MN table for the K3 (#116).

K3 rev 5.20

  • The CONFIG:KNB3 menu entry has been removed (ID number 048 preserved for compatibility).
  • If a new synthesizer is in use (KSYN3A), the lower limit for the FA and FB commands is 100 kHz rather than 490 kHz.

F1 (March 31, 2015) — First K3S/K3/KX3 Version

Section titled “F1 (March 31, 2015) — First K3S/K3/KX3 Version”

K3S/K3 rev 5.26

  • Added ATTEN and PREAMP2 menu entries to the MN table.
  • The PA command now supports preamp 2 get/set (12/10/6 m only; requires KXV3B).

K3S/K3 rev 5.33

  • The UP/UPB and DN/DNB commands can now be used to adjust most displayed parameters.
  • The RA (attenuator) command now has GET/SET values of RA00/05/10/15 (dB) in the K3S case.
  • The OM (option module) command can now detect LNA, KSYN3A, and K3S RF board.

KX3, all firmware revisions

  • AK command (ATU relay values) documented.

K3/K3S rev 5.46

  • TX command does not apply to FSK-D and PSK-D modes.

KX3 rev 2.52

  • Correction to 599FAST macro.
  • TBX command documented.
  • PC command description improved.

KX2 rev 2.60

  • Command changes pertaining to the KX2: DB, MN, MP, OM, SW, VX.

KX2 rev 2.68

  • AM MODE menu command added to MN table for KX2 (ID = 126). FM mode does not apply to the KX2.

K3/K3S rev 5.58

  • VX SET (VOX on/off) command added.
  • AR GET/SET (RX antenna on/off) command added.

KX3 rev 2.74; KX2 rev 2.73

  • Added ATU DATA menu entry to MN tables for KX3 and KX2 (ID = 112).
  • In MP command, ATU DATA access mask is bit 3 (for SET0/SET1).

K3/K3S rev 5.62

  • TM command added. Sets the transmit metering mode for both the LCD bargraphs and for the BG command.
  • DE command added. Inserts a command processing delay of about 10 to 2550 ms.

K3/K3S rev 5.66; KX2 rev 2.92; KX3 rev 2.93

  • Added SW command. GET only; returns most recent transmit SWR reading.

KX2 and KX3, text corrections only

  • MN143 is not a valid menu index on the KX2 because there is no NR menu entry. Removed MN143 from the KX2’s table. NR can still be turned on/off on the KX2 using SWH19;.