KH1 Elecraft Handheld Portable Transceiver User Guide
- June 15, 2024
- ELECRAFT
Table of Contents
KH1 Elecraft Handheld Portable Transceiver
Product Information
Specifications
- Product Name: Elecraft KH1 Programmer’s Reference
- Revision: A
- Date: Oct. 20, 2023
Overview
The Elecraft KH1 Programmer’s Reference is designed to support 100% remote
control of the KH1 radio. This feature is primarily used for updating firmware
and automated factory testing. It can also be utilized to operate the radio
using custom software in
various applications, including HF-Pack Lite and antenna feed point placement.
Computer Interface
The KH1 can be controlled through the KEY/DATA jack using a KXUSB cable and a terminal emulator or software application. To enable this remote control, the MENU:KEY JACK setting must be set to RS232. The serial interface baud rate is fixed at 9600b.
When the KEY/DATA jack is used for remote control, it cannot be simultaneously used with a keyer paddle or hand key. However, there is a host command (HK) available to simulate CW keying, as if using a hand key. This command is used during manual or factory alignment procedures but can also be utilized for CW transmission, replacing the physical key or keyer paddle. The software application would be responsible for ASCII to CW translation and/or providing a keying input device.
Command Types
The KH1 remote-control commands fall into three categories: UI emulation, ID/firmware load, and parametric commands. A help command (H) is also available to list all commands.
UI Emulation
Commands such as EN (encoder), DS (display), HK (hand key), MN (menu), and SW (switch) emulate the user interface (UI) of the radio. These commands are context-dependent and can be used to access menu entries or simulate radio operation. They extend the remote control capabilities of the radio in the absence of specific parametric commands.
Example:
To retrieve the filter number, you can use the following sequence: SW1H;
(bring up RCVR functions) followed by DS1; (read line 1 of the display). To
set the filter number to 2, you can then send the command SWT2;.
Parametric
Parametric commands such as AG (AF gain), MD (mode), and FA (frequency) behave similarly to commands on other Elecraft transceivers like KX2 and KX3. In most cases, only SET commands are provided since the KH1 does not have auto-info capability (AI) and is not intended to support applications like HRD. If needed, a GET operation can be simulated by using a display read command (DS command). For example, to obtain the operating frequency, you can read line 1 of the LCD.
Change History
The change history for the Elecraft KH1 Programmer’s Reference manual is not provided in the text extract.
Frequently Asked Questions (FAQ)
-
Q: What is the purpose of the KH1 Programmer’s Reference manual?
A: The KH1 Programmer’s Reference manual is primarily used for updating firmware and automated factory testing of the KH1 radio. It also provides information on remote control capabilities and custom software usage. -
Q: Can I use a keyer paddle or hand key while the KH1 is remotely controlled?
A: No, when the KH1 is being controlled remotely through the KEY/DATA jack, it cannot be simultaneously used with a keyer paddle or hand key. However, you can simulate CW keying using the HK command. -
Q: Are there any limitations to the KH1 command set compared to other Elecraft transceivers?
A: Yes, the KH1 command set is more limited compared to other Elecraft transceivers. However, UI emulation commands can be used to extend remote control capabilities. -
Q: How can I retrieve the operating frequency using a remote control?
A: To obtain the operating frequency, you can use a display read command (DS command) to read line 1 of the LCD.
OVERVIEW
The KH1 supports 100% remote control. This feature is primarily intended for
updating firmware and for automated factory testing (see the Elecraft KH1
Alignment Manual for manual procedures). That said, it could also be used to
operate the radio using custom software, in applications ranging from “HF-Pack
Lite” to putting the KH1 at an antenna feedpoint.
KH1 commands consist of one or two letters followed by zero or more
parameters. There is some overlap with the command sets from other Elecraft
transceivers. But in general the KH1 command set is more limited.
COMPUTER INTERFACE
The KH1 can be controlled through the KEY/DATA jack using a KXUSB cable and a
terminal emulator or software application. MENU:KEY JACK must be set to RS232.
The serial interface baud rate is 9600b (fixed).
When the KEY/DATA jack is being used for remote control, it is not available
for use with a keyer paddle or hand key. However, there’s a host command (HK)
that can be used to simulate CW keying, as if using a hand key. This is used
during manual or factory alignment procedures, but it could be used for CW
transmission, replacing the key or keyer paddle. The software application
would be responsible for ASCII to CW translation and/or could provide a keying
input device.
COMMAND TYPES
There are three categories of KH1 remote-control commands: UI emulation,
ID/firmware load, and parametric. There’s also a “help” command that lists
available commands in terse form (H).
EMULATION:
The EN (encoder), DS (display), HK (hand key), MN (menu), and SW (switch)
commands emulate the UI, in a completely context-dependent manner, like the
panel controls themselves. These commands can be used to access menu entries
or emulate radio operation, in most cases providing a way to extend the
radio’s remote control capabilities instead of other specific parametric
commands.
Examples: A GET of the filter number could be created using SW1H; (bring up
RCVR functions) followed by DS1; (read line 1 of the display). A SET of filter
number 2 could be effected by then sending SWT2;.
ID/FIRMWARE LOAD:
This group includes I (rig ID), LD (firmware load), RV (firmware rev.), and SN
(serial number). “I;” returns “KH1;” in the main app (upper case), while the
boot loader responds to “I” with “kh1” (lower case). This allows KH1 Utility
to tell whether it’s talking to the boot loader or the main app. “RV;” returns
“RVnn.nn;” (firmware revision). “LD;” initiates firmware loading and is only
used by KH1 utility. SN can be used by anyone to get the serial number. It is
used by the factory to set the serial number, which requires a non-public
password.
PARAMETRIC:
Commands such as AG (AF gain), MD (mode), and FA (frequency), behave like
similar commands on the KX2, KX3, etc. In most cases only SETs are provided,
since the KH1 doesn’t have “AI” capability (auto-info) and is not intended to
support apps like HRD, etc. If required, a GET can be simulated by using a
display read command (DS command). For example the operating frequency could
be obtained by reading line 1 of the LCD.
COMMAND LIST
All commands and responses are terminated by a semicolon.
AG (AF Gain; SET only)
- FORMAT: AGnn; where
is 00-30 - NOTE1: The AF gain value is stored separately for phones and speakers.
- NOTE2: AF gain can be incremented/decremented using the ENAU/ENAD commands.
DS (Display Text; GET/SET)
- FORMAT: DSls; where:
-
= ‘1’ (line 1, or upper row) or ‘2’ (line 2, or lower row) = Up to 16-char string (string is returned for GET, and supplied for SET)
-
NOTE1: The DS SET string is flashed for about 1.5 seconds. Use subsequent DS
SETs to keep the flashed string on the display longer.
NOTE2: The LCD supports 8 special characters, some of which change depending
on the radio’s operational context. For a GET, the host app must translate
these to suitable characters within the host’s display environment. For a SET,
the host app must embed low-hex ASCII values for special characters that make
sense in the KH1’s context. List of characters and contexts TBD
-
EN (Encoder Emulation; SET only)
FORMAT: ENed; where:-
= encoder: ‘A’ (AF gain) or ‘V’ (VFO) -
= direction: ‘U’ (up/clockwise) or ‘D’ (down/counter-clockwise)
-
-
FA (VFO Frequency; SET only)
FORMAT: FAf; whereis in 10 Hz units (e.g. 1400000 = 14000.00 kHz) -
H (Help; GET only)
FORMAT: H; Responds with terse help information. -
HK (Hand-Key Emulation; SET only)
FORMAT: HKm; where m == 1 for key-down, and 0 for key-up. -
I (ID; GET only)
FORMAT: I; Respond with “KH1;”.
NOTE : If the radio is in the boot loader, it responds to “I” with “kh1”. -
LD (Firmware Load; SET only)
FORMAT: LD; Jumps to boot loader. -
MD (Operating Mode; SET only)
FORMAT: MDn; where n = 0 (CW), 1 (LSB), 2 (USB), 4 (RTTY).
NOTE : In SSB modes, the KH1 operates cross-mode (CW transmit, SSB receive). SSB receiving operarators hear the KH1’s CW at a 700 Hz pitch. -
MN (Menu Open by Name; SET only)
FORMAT: MNsss; whereis a short-form menu ID string. See list below. The target menu entry is unlocked if applicable. The menu can be exited by emulating a tap of the [x] field for the given menu entry. In most cases this is switch 4, so: “SW4T;”.
NOTE 1: These 3-characters ID strings are also used to identify programmable switch functions in the associated PFn display fields.
NOTE 2: Some menu parameters can be changed using the MP command (see below). -
ID/MENU ENTRY
- AGC ADJ AGC V
- BFO ADJ BFO
- BIA ADJ BIAS
- BPF ADJ BPF MP command applies
- DAT ADJ DATE
- OSC ADJ OSCID
- PWR ADJ PWR MP command applies
- REF ADJ REF
- RTC ADJ RTC
- SMT ADJ SMTR
- SWR ADJ SWR
- TIM ADJ TIME
- WTM ADJ WMTR
- ATM ATU MODE
- ATP ATU PARAM
- DSP DISP MODE
- EE EE INIT
- F/W FIRMWARE
- IAM KEY IAMB
- PDL KEY JACK
- WGT KEY WGHT
- LOG LOGGING
- RPT MSG RPT
- PAN PAN MODE
- SPN PAN SPAN
- THR PAN THR
- PF1 PF1 FUNC
- PF2 PF2 FUNC
- PF3 PF3 FUNC
- CLR RIT CLEAR
- S/N SERIAL NR
- SWT SW TONES
- TXT TEXT DEC
- VBT VBAT
- FST VFO FAST
-
MP (Menu Parameter; GET/SET)
FORMAT: MPnnn; whereis a decimal value from 0-999.
This command must be preceded by an MN command that opens an applicable entry (and unlocks it if required). These menu entries include ADJ BPF and ADJ PWR. -
RV (Firmware Revision; GET only)
FORMAT: RV; Response format: “RVxx.xx;”. -
SN (Serial Number; GET only)
FORMAT: SN; Response format: “SNnnnnn;”. -
SW (Switch Emulation; SET only)
FORMAT: SWnt; where:= ‘1’-‘4’ (regular pushbutton switches) or ‘5’-‘6’ (encoder switches) = ‘T’ (tap) or ‘H’ (hold)
CHANGE HISTORY
Rev. A, Oct. 9, 2023: Added MP command.