20
SCIP Command Operation
6.3 Command Separators and conventions
A
colon
(:) is used to separate a command keyword from a lower level
keyword.
A
blank space
is used to separate a parameter from a command keyword.
A
comma
(,) is used if a command requires more than one parameter.
A
semicolon
(;) is used to combine multiple commands into one message
string. Commands from the same
subsystem
are permitted to skip repeating
the upper-level keyword.
Eg. “
Route:Switch1 8; Switch2 5; Switch3 2
”
A
colon
is used when linking commands from different subsystems into one
message string, allowing a new upper-level keyword to be introduced. Since
the keyword is optional, such keyword could also be omitted (see example
2).
Only the first command requires the colon. Any subsequent commands of
the same subsystem do not require the colon (see example 3).
Ex. 1: “
Route:Switch1 8; Switch2 5; Switch3 2; System:Error?
”
Ex. 2: “
Route:Switch1 8; Switch2 5; Switch3 2; :Error?
”
Ex. 3: “
Route:Switch1 8; Switch2 5; Switch3 2; :Error?; Timeout 2; status?
”
When linking multiple commands the maximum number of characters
supported is 220. The limit of 220 characters is valid in transmission and
receiving.
All messages are in ASCII format (numeric values are represented in
decimal format with exception of the MAC address which is expressed in
hex format).
Timing, sequences and action requirements are only shown where
applicable and are under the TIMING sub-paragraphs on each command
description.
Any string returned by the matrix is terminated with a carriage return
(0×0D)
followed by a line feed
(0×0A)
.
e.g. ”ROUT:SWIT2?\r\n”
will return
“1\r\n”
Where “\r” stands for carriage return (0×0D) and “\n” stands for line
feed (0×0A).