Appendix B - Microham Control Protocol - microHAM MK2R User Manual

Introduction
This appendix describes the commands in the microHAM Control Protocol that are likely to be useful to
users in creating custom commands in loggers that support user defined "scenarios." The user level
commands can be used to control outputs (e.g., the 4 bit value on pins 6-9 (Radio 1) and 10-13 (Radio 2) of
the Accessory port) or to perform custom/dynamic headphone switching. Additional control and status
reporting is available to qualified developers on request.
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>
ACC output control: These commands control 16 bits represented by the 4-bit outputs of the ACC
●
port. The 4-bit outputs must be configured for "Protocol Control" on the ACC tab. Current firmware
treats the 4 four bits as a HEX representation (0-F) of a 1:16 decoder connected to the port. Only
one output may be active.
This command sets the output using a binary mask.
AM1xxxxxxxxxxxxxxxx<CR> SetAccOutputs(R1, outputs)
AM2xxxxxxxxxxxxxxxx<CR> SetAccOutputs(R2, outputs)
This command sets the output by decimal value.
AS1dd<CR> SetAccOutputSelection(R1, selection)
AS2dd<CR> SetAccOutputSelection(R2, selection)
microHAM © 2008 All rights reserved
APPENDIX B – microHAM Control Protocol
<CR> command.
#
switches Radio1-A (main) to left ear and Radio2-A (main) to right ear.
78