This section of the document describes how an application interfaces to the µH Router using the Unix FIFO interface. If you are only interested in using the router, please go directly to the Set Up page.
Backdoors
When µH Router is shared between multiple applications, the client applications should never directly set the keyer setting. This presents a predicament for an application that want, for example to change the polarity of the FSK keying signal, since the FSK Invert flag bit is a bit that is part of the Settings string.
To accommodate these changes, µH Router uses an unused CONTROL packet for the sending "backdoor" commands to the µH Router. These commands are not forwarded to the keyer and are interpreted by the router.
The backdoor commands start with the 0x0F byte and ends with a 0x8F byte. CONTROL sequences in the microHAM Keyer Protocol which start with 0x0F are for responses from the keyer (when the WinKey chip does not respond) and are not used in the command direction.
The byte that follows the initial 0x0F byte determines the type of the command.
Currently, the following commands are implemented
0F 01 LL 8F
Set or clear the FSK Invert bit. If LL is 0, the FSK Invert bit is cleared, otherwise the FSK Invert bit is set.
0F 02 RR 8F
Change the routing preference. RR can take the following values:
- 00 Automatic Routing
- 01 Manual Mode Dependent Routing
- 02 Fixed Digital Routing
- 03 Fixed Voice Routing
- 04 Fixed CW Routing
- 05 Fixed FSK Routing
0F 03 MM SS 8F
This command only works on the DigiKeyer II.
Enables or disables the right channel of the output sound card. MM can take the following values:
- 00 On-off tone keyed CW (q-CW)
- 01 On-off tone keyed FSK (p-FSK)
if the SS byte is non-zero, the selected tone keyed mode is enabled.