User`s manual
GENERIC PROTOCOL
29
“I”: Capabilities Inquiry
The command “I” requests that command capability information be returned to the host. The
information is sent as a string of characters. The first characters are a space followed by “I”, the
next characters are the letters of the commands that are implemented and available in this router,
and the last character is “~” (tilde). Do not count on the characters being in any specific order.
Search all characters for a particular one.
All routing switchers implement the I, L, S, and X commands. The Q command will
eventually be added to all.
For example, the command:
**I!!
Might return the following string:
** ILSX~ OK !!<CR>
indicating that the router supports the I, L, S, and X commands from the host.
“Q”: Model Name and Software Version Inquiry
The command “Q” requests that the router model name and software version number string be
returned to the host. The information is sent as a string of characters. The first characters are a
space followed by “Q”, the next characters are the router model name, terminated by a “~” (tilde).
Following this are the characters of the software version number string, again terminated by a “~”
(tilde).
For example, the command:
**Q!!
might return the following string:
** Qsmall~V2.1~ OK !!<CR>
indicating that the router model name is “Small” and the software version number is “V2.1”.
“L”: Matrix Size and Level Names Inquiry
The command “L” requests that matrix size (Nout, Nlvl, Nin) and level name information (lvl1, lvl2,
etc.) be returned to the host. The information is sent as a string of characters. The first characters
are a space followed by “L”, some optional values described below, then the number of outputs
(Nout), a comma, the number of levels (Nlvl), a comma, the number of inputs (Nin), a comma,
and then the level names, each terminated by a “~” (tilde), and the last followed by two tildes.
For example, the command:
**L!!
might return the following string:
** L64,3,32,VIDEO~AudioL~AudioR~~ OK !!<CR>
indicating that the router has 64 outputs, 3 levels, and 32 inputs, and the levels are named
“VIDEO”, “Audio L”, and “Audio R”.
“O”: Output Status Inquiry
The command “O” requests that matrix status information for a single output be returned to the
host. The status information is sent as a “Y” command or a “V” command or as a sequence of L
“X” commands, where L=number of levels.
For example, the command:
**O5!!
To a 3-level router might have the following three commands as its response:
** X65,23,1 X5,-,2 X5,0,3 !!