Contemporary Research ICE-HE-DXL Display Control Center with Universal Rackmount User Manual
Page 18
Page | 18
ICE-HE-DXL Display Control Center Product Manual 042021
Command String Protocol
“$A5,<dh>,<dl>,<ncb>,<cmd1>,<parameter>[<cmdN>]”
$A5
Starts the command
<dh>
The zone or high order byte of the display device
<dl>
The unit or low order byte of the display device (0 for global zone)
<ncb>
The number of command bytes to follow
<cmd1>
The first two-character command
<parameter>
Command parameters (not used in all commands)
[<cmdN>]
Multiple commands can be concatenated, with byte count added to <ncb>
Characters in command strings are expressed in a combination of hex and ASCII characters. For clarity, the following protocol examples use
the following conventions:
•
Single-
byte hex numbers are preceded by the ‘$’ symbol.
•
ASCII characters or strings are enclosed in single quotes.
•
Numbers not marked as hex or ASCII are the decimal equivalent of a single hex byte.
•
Parameters shown in < > brackets are single byte.
•
A series of multiple commands or parameters are set apart by [ ] brackets.
•
Commas separate the bytes, but they are not part of the protocol.
•
Double quotes enclose the command string, but they are not part of the protocol.
A Decimal/ASCII/Hex conversion chart may be found a
String Format
Every software application has a different denotation for handling hex, ASCII, and decimal formats. The examples in this manual are in AMX
format, which is understood by many in the control industry:
•
Hex values begin with a dollar ($) symbol
•
ASCII values are enclosed in single quotes
•
Decimal values are shown as normal
When planning to use a mixed-format structure for commands, convert the symbols to the types required by your specific software
application. For example, a
Tune Digital Channel 12-3
command to display device 280 could be shown several ways:
•
AMX Mixed Form
at = “$A5,1,24,5,’TH’,2,12,3”
•
AMX Hex Format “$A5 $01 $18 $05 $54 $48 $02 $0C $03”
•
Standard Hex (no denotation) = A5 01 18 05 54 48 02 0C 03
•
Crestron Hex Format = \0xA5\0x01\0x18\0x05\0x54\0x48\0x02\0x0C\0x03
•
RTI = Select port, Hex mode, enter A5 01 18 05 54 48 02 0C 03 - Note that when you go back to normal editing mode, the app
inserts a \x before each Hex character.
Go to
or a handy Decimal/ASCII/Hex conversion chart.