beautypg.com

Contemporary Research ICE-HE-DXL Display Control Center with Universal Rackmount User Manual

Page 18

background image

Page | 18

ICE-HE-DXL Display Control Center Product Manual 042021

Command String Protocol

“$A5,,

,,,[]”


$A5

Starts the command

The zone or high order byte of the display device

The unit or low order byte of the display device (0 for global zone)

The number of command bytes to follow

The first two-character command

Command parameters (not used in all commands)

[]

Multiple commands can be concatenated, with byte count added to

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 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 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

www.asciitable.com

for a handy Decimal/ASCII/Hex conversion chart.