Sierra Video RTR-804 - Manual (Page 17)

OG-RTR
11
Control via Ethernet
The matrix switcher module may be controlled via Ethernet using the DashBoard
software (see next section).
Serial Control
The RS-232/422 serial control port supports baud rates of 9600, 38400, and115200.
RS-232 pinout;
Pin 2……….TX
Pin 3……….RX
Pin 5……….GND
Generic Protocol
Commands are sent to a routing switcher in a group called a command string. A
command string can contain zero or more commands, limited only by the size of the
receive buffer of the router, whose size depends on the particular router model.
A command string consists of a leader string of asterisk characters, zero or more
commands, and a trailer string of exclamation marks. Larger Routing Switchers require
two leader (**) and trailer (!!) characters, while small Routing Switchers require only one,
in order to make the protocol compact for those Routing Switchers. The remainder of this
document gives examples using doubled characters. Note that two leader/trailer
characters may be sent to small Routing Switchers even when only one is required, and
they will still work fine.
If a leader character (**) is encountered within a command string being processed by a
router, the string up to that point is discarded and a new command string is expected.
This ensures that a router will always act on a complete command string sent to it, even if
the previous one was never completely received.
When a command string is received, it is not acted upon (but rather, is merely buffered
up) until the final trailer character (!) character of the command string is received. At that
time, the routing switcher begins to execute the commands within the string.
The protocol uses only 7-bit ASCII characters. The 8th bit of received characters is
treated as if it is 0. Within the command string, certain ASCII characters may be present
and are ignored: any ASCII character whose code is less than the SPACE character
(includes all control characters and the SPACE character) and the DEL (ASCII 7F)
character. Alphabetic characters within the command string may be in either upper-case
or lower-case letters. The router always sends upper case characters, except for
character strings such as input, output, and level names, which may have lower case
characters in them.
When sending commands to the router, SPACE characters are optional, but if used may
only appear before and after each individual command and NOT embedded within an
individual command. Within command strings sent from the router, a single SPACE
character appears before and after each individual command. SPACES may also appear
in character strings.
After the command string has been executed, the routing switcher returns the string " OK
" (with a single space character before and after the word "OK"), followed by a string of
trailer characters (exclamation marks) and a CR (carriage return, ASCII 0D) character, to
the host. This indicates that the command has executed successfully. If an error occurs
within any command of a command string, the remainder of the command string is
ignored and the router returns the string " ERROR ", followed by an optional descriptive