Kramer Protocol
Commands entering:
If terminal software used to connect over serial \ ethernet \ USB port, that possible to directly enter all commands characters (CR will be entered by Enter key, that key send also LF, but this char will be ignored by commands parser).
Sending commands from some controllers (like Crestron) require coding some characters in special form (like \X##). Anyway, there is a way to enter all ASCII characters, so it is possible to send all commands also from controller.
(Similar way can use for URL \ Telnet support that maybe will be added in future).
Commands forms:
Some commands have short name syntax beside the full name to allow faster typing, response is always in long syntax.
Commands chaining:
It is possible to enter multiple commands in same string by '' char (pipe).
In this case the message starting char and the message closing char will be entered just one time, in the string beginning and at the end.
All the commands in string will not execute until the closing char will be entered. Separate response will be sent for every command in the chain.
Input string max length:
64 characters.
Backward support:
Design note: transparent supporting for protocol 2000 will be implemented by switch protocol command from protocol 3000 to protocol
2000, in protocol 2000 there is already such a command to switch protocol to ASCII protocol (#56 : H38 H80 H83 H81).
Table 16: Instruction Codes for Protocol 3000
Help commands
| Command | Syntax | Response |
| |||||||||||||||
| Protocol Handshaking | #CR | ~OK |
|
|
|
|
|
|
|
|
|
|
|
|
|
| ||
| CRLF |
|
|
|
|
|
|
|
|
|
| ||||||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Device initiated messages |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Command |
| Syntax |
| |||||||||||||||
| Start message |
| Kramer Electronics LTD. , |
|
|
|
|
| |||||||||||
|
| Device Model |
|
| |||||||||||||||
|
|
| Version | Software Version |
|
|
|
|
| ||||||||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Switcher actions |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| AV | IN>OUT |
|
|
|
|
|
| |||||||||||
|
|
|
|
|
|
|
|
|
|
|
| ||||||||
| Video channel has switched (Breakaway mode) | VID |
|
|
|
|
|
|
|
|
|
|
|
| |||||
| IN>OUT |
| |||||||||||||||||
|
|
|
|
|
|
|
|
|
| ||||||||||
| Audio channel has switched (Breakaway mode) | AUD |
|
|
|
|
|
|
|
|
|
| |||||||
|
| IN>OUT |
| ||||||||||||||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Result codes (errors) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Syntax |
| ||||||||||
| No error. Command running succeeded |
|
|
|
|
|
|
|
|
|
|
|
|
|
| OK |
| ||
|
|
|
|
|
| COMMAND |
| PARAMETERS |
| ||||||||||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Protocol Errors |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Syntax Error |
|
|
|
|
|
| ERR001 |
| ||||||||||
| Command not available for this device |
|
|
|
|
| ERR002 |
| |||||||||||
| Parameter is out of range |
|
|
|
|
|
| ERR003 |
| ||||||||||
| Unauthorized access (running command without the match login). |
|
|
|
|
| ERR004 |
|
36 | KRAMER: SIMPLE CREATIVE TECHNOLOGY |