Kramer Electronics Ltd.
VP-439
– The RS-232/Ethernet (UDP) Communication Protocol
30
Command Terms
Command
A sequence of ASCII letters ('A'-'Z', 'a'-'z' and '-').
Command and parameters must be separated by at least one space.
Parameters
A sequence of alphameric ASCII characters ('0'-'9','A'-'Z','a'-'z' and some special characters
for specific commands). Parameters are separated by commas.
Message string
Every command entered as part of a message string begins with a
message starting
character
and ends with a
message closing character
.
Note
: A string can contain more than one command. Commands are separated by a pipe ( '|' )
character.
Message starting character
'#'
– For host command/query
'~'
– For machine response
Device address (Optional, for K-NET)
K-NET Device ID followed by '@'
Query sign
'?' follows some commands to define a query request.
Message closing character
CR
– For host messages; carriage return (ASCII 13)
CRLF
– For machine messages; carriage return (ASCII 13) + line-feed (ASCII 10)
Command chain separator character
When a message string contains more than one command, a pipe ( '|' ) character separates
each command.
Spaces between parameters or command terms are ignored.
Entering Commands
You can directly enter all commands using a terminal with ASCII communications software,
such as HyperTerminal, Hercules, etc. Connect the terminal to the serial or Ethernet port on
the Kramer device. To enter
CR
press the Enter key.
(
LF
is also sent but is ignored by command parser).
▪
For commands sent from some non-Kramer controllers like Crestron, some
characters require special coding (such as, /X##). Refer to the controller manual.
Command Forms
Some commands have short name syntax in addition to long name syntax to allow faster
typing. The response is always in long syntax.