Page | 19
ICC1-TC Tuner/Controller Product Manual 082020
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 hex 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 at www.asciitable.com .
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 Format = “$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
www.asciitable.com
for a handy Decimal/ASCII/Hex conversion chart.