Download Print this page
ELECRAFT K3S Programmer's Reference Manual

ELECRAFT K3S Programmer's Reference Manual

Hide thumbs Also See for K3S:

Advertisement

E
K3
/K3/KX3/KX2
S
LECRAFT
P
R
ROGRAMMER'S
EFERENCE
Rev. G3, Nov. 16, 2017
(For change history, see Appendix A)
1

Advertisement

loading
Need help?

Need help?

Do you have a question about the K3S and is the answer not in the manual?

Questions and answers

Summary of Contents for ELECRAFT K3S

  • Page 1 /K3/KX3/KX2 LECRAFT ROGRAMMER'S EFERENCE Rev. G3, Nov. 16, 2017 (For change history, see Appendix A)
  • Page 2 Command Set Overview All K3S/K3/KX3/KX2 remote control commands are listed in Table 1. The KX3 and KX2 accept all K3 commands, though some have no functional effect on the KX3/KX2 (*). Some commands are recognized only by the KX3 or KX2 (**). For K2 commands, see the KIO2 Programmer’s Reference.
  • Page 3: Command Format

    Command Format Note: 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;...
  • Page 4 Meta-commands: AI, K2 and K3 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 macro, as they may adversely affect software applications that control meta-command modes. The Command Reference section explains when to use them with specific commands.
  • Page 5 Command Examples Macros Macros – strings containing one or more control commands – can be used to automate K3/KX3/KX2 control sequences. Table 2 lists some examples. See Creating and Using Macros (page 6) for complete instructions. Table 2 Sample Macros. These can be altered or combined as needed (see the Command Reference section). Label Description Command string...
  • Page 6 Creating and Using Macros K3/KX3/KX2 Utility can be used to create and test macros. The first eight of these can be sent to the transceiver (K3 and KX3 only), where they can be assigned to any of the programmable function switches. Macros can have a length of up to 120 characters, along with a label of up to 7 characters.
  • Page 7 AI0, corresponding to K3 menu setting CONFIG:AUTOINF = N O R . AUTOINF can also be set to A U T O 1 , which makes the default AI1 on power-up. This is useful for K3s controlling a StepIR antenna, etc.
  • Page 8 (T). 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. (CWT, SWR, and CMP readings not yet available.) K3, Receive: nn is 00 - 21 (CWT off) or 00 - 09 (CWT on).
  • Page 9 CLR can be used from within this menu entry to reset the value to 0. DE (Command Processing Delay; SET only; K3/K3S only) SET format: DExxx; where xxx is 001-255, the delay 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.
  • Page 10 DS (VFO A and Basic Icon Read; GET only) GET format: DS; (no data). Returns everything needed to reproduce the contents of the VFO A display, as well as a basic subset of the LCDs icons (also see IC command, which provides many more status indicators and does not require that K31 be in effect).
  • Page 11 DT (DATA Sub-Mode; GET/SET) SET/RSP format: DTn; where n is the data sub-mode last used with VFO A, whether or not DATA mode is in effect: 0 (DATA A), 1 (AFSK A), 2 (FSK D), or 3 (PSK D). See MD for setting data normal/reverse. In Diversity Mode (K3 only, accessed by sending DV1 or via a hold of S U B ), sending DTn matches the sub receiver’s mode...
  • Page 12 FW $ (Filter Bandwidth and Number; 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;...
  • Page 13 IC (Misc. Icons and Status; GET only) RSP format: ICabcde; where abcde are 8-bit ASCII characters (Byte in Table 4 below) used as collections of flags (Bit in table). Each flag represents the status of an LCD icon and/or a specific transceiver function. Some functions whose status is indicated by IC command flags can be controlled using other commands.
  • Page 14 ID (Transceiver Identifier; GET only) RSP format: IDnnn; where nnn is 017. This command is provided only for compatibility with existing software, which may use ID in order to distinguish between transceivers. New or modified software should send the K3 command to the transceiver.
  • Page 15 K3 * (Command Mode; GET/SET) SET/RSP format: K3n; where n is 0-1. 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. In most cases the effects of the K3 command are independent from those of the K2 command (see above), and the two can both be non-zero at the same time.
  • Page 16 MD $ (Operating Mode; GET/SET) SET/RSP format: MDn; or MD$n; where n is 1 (LSB), 2 (USB), 3 (CW), 4 (FM), 5 (AM), 6 (DATA), 7 (CW- S U B REV), or 9 (DATA-REV). Notes: (1) K3 only: In Diversity Mode (accessed by holding ), sending MDn;...
  • Page 17 MN (Menu Selection; GET/SET; K3, KX3, and KX2 variants) SET/RSP format: MNnnn; where nnn is shown in Table 5 (K3), Table 6 (KX3), or Table 6A (KX2). MN255 is returned if the menu is not in use. MN commands can be sent in any order. To exit the menu, send MN255.
  • Page 18 Table 6 KX3 MN values. (See Table 6A for KX2.) These are the same as the K3’s only if the two are functionally identical. nnn is permanently associated with a menu entry, even if entries are moved. ‡ = can be read/set using MP command (or MQ in the case of TXCRNUL). In some cases the get/set value requires interpretation, or must be bit-masked to isolate the relevant field.
  • Page 19 Table 6A KX2 MN values. * = New KX2-specific menu entry not present in the KX3. ‡ = can be read/set using MP command (or MQ in the case of TXCRNUL). In some cases the get/set value requires interpretation, or must be bit-masked to isolate the relevant field.
  • Page 20 MP (8-bit Direct Menu Parameter Access; GET/SET) SET/RSP format: MPnnn; where the useful range of nnn is determined by the present menu entry (255 max, or 8 bits). 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).
  • Page 21 V = KSYN3A synthesizer (extends VFO tuning range; see note 2 below), and R=K3S RF board. Note 1: The presence of ‘R’ in the string (K3S RF board) is the preferred way to identify a K3S. In this case: (1) Use the K3S format for the RA (receive attenuator) command;...
  • Page 22 SET/RSP format: RAnn; or RA$nn; . For the K3/KX3/KX2, nn is 00 (attenuator OFF) or 01 (attenuator ON, -10 dB). For the 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.
  • Page 23 RD (RIT Offset Down One Unit; SET only) SET format: RD; (no data). Moves the RIT/XIT offset down one step, which can be 1, 10, 20, or 50 Hz, depending 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.
  • Page 24 SMH (High-resolution S-meter Read; GET only; K3 only at present) RSP format: SMHnnn; where nnn has the following approximate values vs. S-meter reading: S1, 5; S9, 40; S9+60, 100. Max possible value is about 140. SP (Special Functions) SPG; (KX3) returns ADC ground-reference reading, typically SP000. SQ $ (Squelch Level;...
  • Page 25 SWT/SWH (Switch Emulation; SET only; K3, KX3, and KX2 variants) SET format: SWTnn; (TAP functions) or SWHnn; (HOLD functions). nn is determined from Table 7 (K3), Table 8 (KX3), or Table 8A (KX2). Switch emulation commands must sometimes be followed by a delay if successive commands expect the switch function to have been executed (example: SWT16;...
  • Page 26 Table 8A Switch identifiers (nn) for the KX2 SWT/SWH command. Numeric keypad switches (0-9, ‘.’, ‘<-’) are shown in parentheses. T A P H O L D T A P H O L D T A P H O L D AF GAIN/MON DATA TEXT...
  • Page 27 Note: If the TX EQ menu entry is displayed at the time TE is sent, the display will be updated accordingly. TM (Transmit Meter Mode; GET/SET; K3/K3S only) RSP format: TM0; (SWR/RF metering) or TM1; (CMP/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).
  • Page 28 TX (Transmit Mode; SET only) SET format: TX; (no data). Same as activating PTT or using the XMIT switch. Applies to all modes except direct data, i.e. FSK-D and PSK-D. (In these cases, just hit the paddle, send a message, or use a KY<text> packet. To avoid problems with existing applications, the TX command is ignored in these modes.) Use the RX command to cancel TX (some special considerations apply;...
  • Page 29: Appendix A: Change History

    Appendix A: Change History [Applicable MCU revisions shown in brackets] Note: Prior to revision D1 this document applied only to the K3. For earlier change history, see rev C14. D1, 1-18-2012 [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.
  • Page 30 [KX3] Added ‘T’ and ‘X’ identifiers to the OM (option module detect) resonse, indicating the KXAT100 and KX3-2M modules, respecitively, were detected. § [KX3] Added KE command (for Elecraft internal use only). § [KX3] Clarified PO command usage and imitations in QRO mode (with KXPA100). This command was not working in QRO mode prior to rev.
  • Page 31 [K3/K3S] Added ATTEN and PREAMP2 menu entries to the MN table. ATTEN, which is also accessible via the MP command, has values of 5/10/15 dB in the case of the K3S; it is fixed at 10 dB for the K3.
  • Page 32 [K3/K3S] The OM (option module) command can now be used to detect the following: preamp 2 (LNA) availability on the present band (‘L’); the KSYN3A synthesizer (‘V’), which extends VFO tuning range; and presence of the K3S RF board (‘R’), which is the preferred way to identify a K3S transceiver. See OM and PA commands.
  • Page 33 • [K3/K3S] DE command added. Inserts a command processing delay of about 10 to 2550 ms. 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.

This manual is also suitable for:

Kx2K3Kx3