Table of Contents
Advertisement
Components
Data
Text parameters
Special characters for text
To use special characters in the API commands, you must use a two-character combination.
Special character
"
\
(
)
Line break
Send arbitrary code
CineLife+ Technical Reference–Serial Commands
020-103075-05 Rev. 1 (09-2022)
Copyright
©
2022 Christie Digital Systems USA, Inc. All rights reserved.
If printed, please recycle this document after use.
Description
mark (!) appears directly after the function code. For set messages to CineLife+,
neither of these characters appear—data directly follows the function code and
subcode.
A request for information is represented by a question mark (?) that appears directly
after the function code. A reply is represented by an exclamation mark (!) that
appears directly after the function code or subcode, if one is provided. The first
parameter located after the exclamation mark (!) reply character cannot have a
space, for example (PWR!000).
The value for a given CineLife+ state, such as on or off, appears in ASCII-decimal
format directly after the request/reply symbol. You can add an optional space after
the symbol—such as before the data—in a set message, but data in replies follow the
exclamation mark (!) symbol without a space. Other details to remember about
data:
• All values returned by CineLife+ (reply messages) have a fixed length,
regardless of the actual value. For a specific parameter, the length is always the
same (for example, contrast is always returned as three characters, CineLife+
number is always returned as five characters). The minimum parameter size is
three characters. Values less than the predefined size are padded with leading
zeros as needed. Parameters which have negative signs are zero padded after
the negative sign, and have one less digit to make space for the sign.
• Data in set messages to CineLife+ do not require padding with zeros.
• Within each message, multiple parameters of data must be separated by one
space character.
• Text parameters such as channel names are enclosed in double quotes following
the data, as in Name.
Most data is simply a numerical value; however, some messages also require text.
For example, the time command requires time to be provided in text enclosed in
double quotation mark, as in "19:45:23". Use all characters as required except for
special characters—these require a two-character combination.
Two-character
Description
combination
\"
Double quotation mark
\\
Backslash
\(
Left parenthesis
\)
Right parenthesis
\n
New line—If the text can be displayed on more than one line,
this sets the line break.
\h##
Sends one arbitrary code defined by the two hexadecimal
digits ##.
Communicating with the projector
7
Advertisement
Table of Contents
