Sierra Video RTR-804 - Manual (Page 23)

OG-RTR
17
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. Whether a "Y", "V", or "X" command is sent depends
on several factors:
 Very old routers only supported the "X" command.
 Routers with pre-version-10 software supported all three commands, "Y", "V", and "X",
but usually provided a DIP switch that could be set to force the router to only send "X"
commands.
 Routers with version 10 or later software use the setting of the "U" command (described
below) to determine whether to send only "X" commands, or "Y", "V", and "X" commands.
A 6-level router using only "X" commands could generate as many as 6 "X" commands of status
output. The first command is for level 1, the next for level 2, etc. until the last level is reached.
(However, each "X" command contains the level number, so the sequence in which the data is
sent is not really important.)
When a router is able to send "Y", "V", and "X" commands, a "Y" command will typically be sent if
the router has only one level, and may also be sent if the output has all of its levels connected the
same, although this is not required and some routers may instead send a "V" command or a
series of "X" commands in that situation. A "V" command will be sent when an output has
different connections on different levels, which is a more compact representation of the status
than a series of "X" commands.
The length of a "Y" or "V" or "X" command depends on the size of the particular router involved.
Larger routers use longer numbers for inputs, outputs, and levels.
A space character precedes each "Y" or "V" or "X" command (spaces should be ignored by the
command parser, however). Each command begins with the command letter, a Y or V or X,
followed by the output number and a comma character. Following that, the "Y" command has the
input number connected to the output, the "V" command has L input numbers separated by
commas (L=number of levels) in order by level number, and the "X" command has the level
number at which the input-output pair is connected.
The input number may be a dash ('-') if no connection exists (for routers that are capable of
having their inputs disconnected). The input number may be 0 if the output doesn't exist at that
level in the router (or isn't mapped to a physical output, in virtual-mapped routers), or if the
connection is not known by the controller, as may be the case for some control panels
immediately after they are powered up.
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 !!
Note the dash, indicating that on level 2, output 65 is not connected to an input. Also note the 0,
indicating that the connection on level 3 is either unknown or that output 65 doesn't exist or isn't
mapped on level 3.
Or, a 3-level router might have the following single command as its Response: