beautypg.com

S": status inquiry – Sierra Video RTR-804 User Manual

Page 21

background image

OG-RTR

15

to 6 characters. Refer to the "G" command for accessing input and output names and full-length
untruncated level names.

The number of level names in the "L" command will be the same as the number of levels that was
given in the response (Nlvl). Valid characters for level names are any printable (i.e. non-control)
ASCII character (including SPACE) except "*" (asterisk), "~" (tilde), and "!" (exclamation mark).
The number of characters reported by the "L" command in level names may be no more than 6
(longer names are truncated when reporting them with "L"). In systems that do not support
naming of levels, the level names will be fixed number strings, e.g. "1", "2", etc.

For example, the command:

**L!!

might return the following string:

** L64,3,32,VIDEO~AudioL~AudioR~~ OK !!

indicating that the router has 64 outputs, 3 levels, and 32 inputs, and the levels are named
"VIDEO", "AudioL", and "AudioR".

Some routers can have different sized matrices on each level. However, the "L" command always
reports what is referred to as the "basic router size". This is the size of the largest levels in the
router. For example, a 2-level router with level 1 being 16x32 and level 2 being 32x16 would
report a basic router size of 32x32 in the "L" command. In these kinds of routers, it is not
considered an error to send a crosspoint command that specifies an all-levels take using an input
or output number that is beyond the range of some of the levels, as long those numbers lie within
the basic router size. Levels which are smaller than the specified numbers will not be affected by
such a take command. On the other hand, it is an error to send a crosspoint command that
specifies a take on a specific level with an input or output number that is beyond the range of that
level. To find out the actual physical size of each level, use the "G LEVEL_INFO" command.
Routers that do not support the "G" command or "G LEVEL_INFO" subcommand always have
the same-size crosspoint matrix on each level.

Some routers support virtual-to-physical mapping. These virtual-mapped routers use the same
virtual matrix size for each level, and it will be that size that is reported in the "L" command for
Nout and Nin. The physical crosspoint matrices can still be different sizes, and the "G
LEVEL_INFO" command can be used to find out what these sizes are, but they are of less
importance in a virtual-mapped router, because take commands are specified using virtual source
and destination numbers rather than physical input and output numbers.

"S": Status Inquiry

From Syntax

Description

Host S

Ask router to send source status of all router
outputs.

Router Y out,in or V out,in,in... or X out,in,lvl

Status of all outputs connected on one or more
levels to the specified input.

The command "S" requests that matrix status information be returned to the host. The status
information is sent as a sequence of "Y" and/or "V" and/or "X" commands. The order of the
commands is not significant, and different models of routers may send the status of their outputs