QM get command
The structure of the GET command is:
QMmqss;
where:
QM
The CAT command identifier
m
the number of the main menu. For example in the QCX+, menu 3 is the VFO menu
q
Query type. To simply return the value in the configuration menu, use a . (period). To
specify a verbose response that includes the title of the configuration menu, and in the case
of a list menu item, the list of possible values it can contain, use ? (question mark). This
feature could be useful for the host application to build up a model of the QCX+ menu
system.
ss
the number of the sub-menu. ss must be provided as two digits, even if you are reading the
value from a sub menu less than ten; for example to read menu 4.3 of the QCX+, you
would send QM4.03; (sub menu 03, including the leading zero).
;
Command termination character
The CAT host application does not need to know a priori how many menus and submenus there
are in the QCX+, because you can simply stop incrementing the submenu and asking, when the
return is ?
As an example, consider the keyer mode menu which is menu item 4.1, and assume it is in
IAMBIC A mode. The simple query is:
QM4.01;
The return is:
QM4.1 .IAMBIC A;
The return format is:
QMm.s .v;
where:
QM
The CAT command identifier
m
the number of the main menu. In this case menu 4, the Keyer menu
.
a period, that separates the menu and the submenu number
s
the number of the sub-menu. This could be 1 digit or 2 digits. Note that unlike the command
query, the response is NOT forced to be 2-digits with the leading zero.
.
a space character and a period, which separate the sub-menu number from its value
v
The value of the configuration menu item
;
Command termination character
This is the short version of the query, having a period between the 4 and the 01. Note the space
and dot between menu number, and the value. To be clear, this is the format always. QM then the
menu number as m.s (or m.ss if the submenu is 10 or more), then a space then a period, then the
value, and a semicolon to finish.
The verbose version of the QM command, has a question mark delimiter between the menu and
the sub-menu, as follows:
QM4?01;
QCX operating manual, firmware 1.07, manual edit 0.03
46
