Appendix B - Microham Control Protocol - microHAM MK2R Manual

Introduction
This appendix describes the commands in the microHAM Control Protocol that are likely to be useful to
users in creating custom macros in loggers that support user defined "scenarios." These user level
commands can be used to select antenna outputs (e.g., the 4 bit value on pins 6-9 (Radio 1) and 10-13
(Radio 2) of the Accessory port), to select transmitter or receiver focus, to control the Digital Voice Keyer,
CW Memory Keyer or FSK Message memories, to perform custom/dynamic headphone switching, or recall
saved configurations ("functions").
microHAM Control Protocol, as a whole or in any subset, is the intellectual property of
microHAM, s.r.o. and may not be used by any person in conjunction with any hardware
interface or control product ("controller") not manufactured by microHAM. Individuals who
have purchased a controller from microHAM, s.r.o or its dealers and distributors are
licensed to utilize the following subset of commands only with that controller. Complete
documentation is available on request and execution of a non-disclosure agreement to
qualified software developers who wish to support microHAM interfaces and controllers.
Disclosure of this sub-set of the microHAM Control Protocol shall not grant license to any
party to use these controls for any purpose not specifically authorized herein, nor shall this
disclosure grant license to use these controls, or any subset of these controls, with any
controller not produced by micoHAM.
Commands
All commands are ASCII and are case sensitive. Each command is uppercase and ends with <CR>. In this
document parameters (arguments) for the command are shown in lower case. Router responds to any
invalid command with an error message where the first character is an E is followed by copy of the
received command – e.g., Ecommand<CR>.
Focus control: These commands control transmit focus and headphone switching.
●
SetTxFocus(): active only when TX Auto Focus has been selected
FT1<CR> SetTxFocus(R1)
FT2<CR> SetTxFocus(R2)
SetRxFocus(): active only when RX Auto Focus has been selected
These commands set RX Focus to the states defined in the current "Function" for Radio_1,
Radio_2, and Stereo. The current "Function" can be selected from the front panel or
selected using the SA
FR1<CR> SetRxFocus(R1)
FR2<CR> SetRxFocus(R2)
FRS<CR> SetRxFocus(STEREO)
This command selects headphone audio sources directly. Parameters represent binary values
that correspond to the 12 headphone source LEDs on the front panel.
FRDxxxxxxxxxxxx<CR> SetRxFocus(DIRECT)
For example: FRD100000000010<CR>
microHAM © 2010 All rights reserved
APPENDIX B – microHAM Control Protocol
<CR> command.
#
switches Radio1-A (main) to left ear and Radio2-A (main) to right ear.
85