Christie TruLife+ Griffyn 4K32-RGB Use and care manual

Technical Reference
020-103316-01
Christie TruLife+
Serial Commands

NOTICES
COPYRIGHT AND TRADEMARKS
Copyright © 2020 Christie Digital Systems USA Inc. All rights reserved.
All brand names and product names are trademarks, registered trademarks or trade names of their respective holders.
GENERAL
Every effort has been made to ensure accuracy, however in some cases changes in the products or availability could occur which may not be reflected in this
document. Christie reserves the right to make changes to specifications at any time without notice. Performance specifications are typical, but may vary
depending on conditions beyond Christie's control such as maintenance of the product in proper working conditions. Performance specifications are based on
information available at the time of printing. Christie makes no warranty of any kind with regard to this material, including, but not limited to, implied
warranties of fitness for a particular purpose. Christie will not be liable for errors contained herein or for incidental or consequential damages in connection
with the performance or use of this material. Manufacturing facilities in Canada and China are ISO 9001 certified. Manufacturing facilities in Canada are also
ISO 14001 certified.
PREVENTATIVE MAINTENANCE
Preventative maintenance is an important part of the continued and proper operation of your product. Failure to perform maintenance as required, and in
accordance with the maintenance schedule specified by Christie, will void the warranty.
REGULATORY
The product has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules. These limits are designed
to provide reasonable protection against harmful interference when the product is operated in a commercial environment. The product generates, uses, and
can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio
communications. Operation of the product in a residential area is likely to cause harmful interference in which case the user will be required to correct the
interference at the user’s own expense. Changes or modifications not expressly approved by the party responsible for compliance could void the user's
authority to operate the equipment
CAN ICES-3 (A) / NMB-3 (A)
이 기기는 업무용(A급)으로 전자파적합등록을 한 기기이오니 판매자 또는 사용자는 이점을 주의하시기 바라며, 가정 외의 지역에서 사용하는 것을 목적으로 합니다.
ENVIRONMENTAL
The product is designed and manufactured with high-quality materials and components that can be recycled and reused. This symbol means that electrical
and electronic equipment, at their end-of-life, should be disposed of separately from regular waste. Please dispose of the product appropriately and according
to local regulations. In the European Union, there are separate collection systems for used electrical and electronic products. Please help us to conserve the
environment we live in!

Content
Communicating with Christie TruLife+..................................6
Model names......................................................6
Product documentation................................................6
Technical support................................................... 6
Connection and use..................................................7
Connecting to a computer or server with 10/100/1000 base-T Ethernet................7
Configuring the RS232 port...........................................7
Setting up the Ethernet............................................. 8
Understanding message format...........................................8
Basic message structure...............................................9
Special characters for text...........................................10
Sample messages and their meaning......................................11
Sample messages for a single projector...................................11
Sample messages for querying a projector.................................11
What is sent in a message.............................................12
Maximizing message integrity...........................................12
Error messages....................................................13
Descriptive error.................................................14
Flow control......................................................14
Serial API commands..............................................15
ADR–Projector Address...............................................15
APW–Auto Power On.................................................16
BDR–Baud Rate....................................................16
BGC–Gamma Function............................................... 17
CAV–Video Input Configuration..........................................17
CCA–Color Adjustment...............................................18
CHA–Channel.....................................................21
CLE–Color Enable.................................................. 22
CSP–Color Space Selection.............................................23
CUC–1D Color Uniformity..............................................23
DEF–Factory Defaults................................................25
DMX–DMX/ArtNet.................................................. 25
DRK–3D Dark Interval................................................26
Christie TruLife+ Technical Reference–Serial Commands 3
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

DTL–Sharpness....................................................26
EBB–Black Level Blending............................................. 27
EBL–Edge Blending Select.............................................27
EDO–EDID Override.................................................28
EME–Enable Asynchronous Serial Messages..................................29
ETP–Engine Test Pattern..............................................29
EVT–Event Manager.................................................31
FCS–Lens Focus Position Adjustment...................................... 32
FMD–Film Mode Detect...............................................32
FRD–Frame Delay..................................................33
FRZ–Image Freeze..................................................34
GAM–Gamma Power Value.............................................35
GIO–General Purpose Input/Output.......................................35
ITP–Test Pattern...................................................36
KEN–Keypad Enable.................................................38
LAS–Light & Output Settings........................................... 39
LCB–Lens Motor Calibration............................................41
LHO–Lens Horizontal Position Adjustment................................... 41
LMV–Lens Move................................................... 42
LOC–Localization Settings............................................. 43
LVO–Lens Vertical Position Adjustment..................................... 44
MSP–OSD Menu Position Presets.........................................44
NET–Network Setup.................................................45
OSD–On Screen Display.............................................. 46
OTR–Output Resolution...............................................47
PNG–Ping....................................................... 47
PRO–Profile......................................................47
PWR–Power......................................................48
RAL–Remote Access Level.............................................49
SDI–SDI Payload Overrride............................................ 49
SHU–Shutter..................................................... 50
SIN–Select Input...................................................50
SNM–SNMP Configuration............................................. 52
SOR–Screen Orientation.............................................. 53
SPS–Splash Screen................................................. 53
SST–Status...................................................... 54
SZP–Resize Presets................................................. 55
TDD–3D Sync Delay.................................................55
TDM–3D Mode.................................................... 56
Content
Christie TruLife+ Technical Reference–Serial Commands 4
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

TDN–Invert 3D Input................................................57
TDO–3D Sync Out..................................................57
TDT–3D Test Pattern.................................................58
THM–Video Thumbnails...............................................59
TMC–Thermal Management Control....................................... 59
TMD–Time and Date.................................................60
UID–User ID..................................................... 60
WRP–Warp Selection................................................ 61
ZOM–Lens Zoom Position Adjustment......................................62
Asynchronous messages...........................................63
Content
Christie TruLife+ Technical Reference–Serial Commands 5
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

Communicating with
Christie TruLife+
Understand the information and procedures for communicating with Christie TruLife+ from a remote
location.
Model names
The Christie TruLife+ User Guide (P/N: 020-103315-XX) applies to the following models.
• Griffyn 4K32-RGB
• Mirage 4K32-RGB
Product documentation
For installation, setup, and user information, see the product documentation available on the Christie
website. Read all instructions before using or servicing this product.
1. Access the documentation from the Christie website:
• Go to this URL: https://bit.ly/3fbZLx8 or
https://www.christiedigital.com/products/projectors/all-projectors/griffyn-series/.
• Scan the QR code using a QR code reader app on a smartphone or tablet.
2. On the product page, select the model and switch to the Downloads tab.
Technical support
• North and South America: [phone] or [email protected]
• Europe, Middle East, and Africa: [phone] or [email protected]
• Asia Pacific
• Australia: [phone]
• China: [phone]
• India: [phone]
Christie TruLife+ Technical Reference–Serial Commands 6
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

• Japan: 81-3-3599-7481
•Singapore: [phone]
• South Korea: [phone]
• Christie Professional Services: [phone] or [email protected]
Connection and use
Once you have connected your computer to either the RS232 IN port (depending on which standard is
supported by your computer) or to the Ethernet port on Christie TruLife+, you can remotely access
controls and image setups, issue commands or queries, and receive replies.
Use these bidirectional messages to:
• Control multiple projectors
• Obtain a projector’s status report
• Diagnose performance problems
Refer to the User Manual provided with the projector for all cable requirements and other connection
details.
Some commands are operational only when projector is powered up.
Connecting to a computer or server with 10/100/1000 base-T
Ethernet
Communicate with a remote computer
, server, or an existing network using a RJ-45 cable.
The port located on the Video Input panel uses Christie-proprietary protocol or Art-Net control protocol
and is intended for Christie accessories or automation controllers only.
1. Use an RJ-45 cable to connect the Ethernet hub or switch to the Ethernet port, located on the
projector Video Input panel.
2. When using the Christie serial protocol over Ethernet, connect to port 3002.
3. For applications or equipment using serial communications, use the Christie-proprietary serial
protocol or Art-Net protocol to communicate with the Ethernet port on the Video Input panel.
Configuring the RS232 port
Configure the RS232 port to send Christie serial commands using a standard RS232 serial cable.
1. Select Menu > Communications > Projector Communication.
Communicating with Christie TruLife+
Christie TruLife+ Technical Reference–Serial Commands 7
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

2. Use the down arrow to select Baud Rate.
3. Select the appropriate baud rate and select Enter.
4. Use the down arrow to select Network Routing.
5. Select the type network routing appropriate for your projector and select Enter.
Setting up the Ethernet
Ethernet is setup to obtain an IP address automatically if a DHCP server is on the network, modify IP
settings, or manually enter an address.
Christie recommends using the Ethernet port on the Video Input panel as the HDBaseT port is limited
to 100 Mb/s.
You cannot change the IP settings using the web interface.
1. From the display panel, use the arrow keys to select IP Settings.
2. To set the type of network, select DHCP or Static.
3. If you selected Static, manually enter the network information for the IP Address, Subnet,
and Gateway.
4. Select Apply and select Enter.
5. Select MENU > Communications > Network Settings.
6. Select Device name.
7. Use the up and down keys to enter the name of the projector.
8. Select Enter.
Understanding message format
Commands sent to and from Christie TruLife+ are formatted as simple text messages consisting of a
three letter command code, an optional four letter subcode, and optional data.
Source Format Function Example
From controller (Code Data) SET (set power on) (PWR1) or (PWR 1)
(Code+Subcode
Data)
SET (set input port configuration) (SIN+PORT 1)
(Code ?) REQUEST (what is current power
state?)
(PWR?) or (PWR ?)
(Code+Subcode ?) REQUEST (what is current input port
configuration?)
(SIN+PORT?)
From projector (Code Data) REPLY (power state is 1 "On") (PWR!001 "On")
(Code+Subcode
Data)
REPLY (input port configuration is 1
"One-Port")
(SIN+PORT!001 "One-
Port")
Generally, most commands include 0 or 1 data fields or parameters. Where applicable, a message may
expand to include additional parameters of related details.
Communicating with Christie TruLife+
Christie TruLife+ Technical Reference–Serial Commands 8
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

The smallest step size for any parameter is always 1. For some controls (such as Size) the value
displayed on the screen has a decimal point (for example, 0.200 to 4.000). In this case, the values
used for the serial communications is an integer value (for example, 200 to 4000), not the decimal
value seen on the screen.
Available message types
Message type Description
Set A command to set a projector parameter at a specific level, such as changing the
brightness.
Request A request for information, such as what is the current brightness setting.
Reply Returns the data in response to a request or as confirmation of a command.
Basic message structure
Understand the component fields that comprise a standard ASCII message.
Components Description
Start and end of message Every message begins with the left bracket character and ends with the right bracket
character.
If the start character is received before an end character of the previous message,
the partial (previous) message is discarded.
Prefix characters (optional) To acknowledge that Christie TruLife+ has responded, and/or maximize message
integrity, insert one or two special characters before the three-character function
code:
• $ (Simple Acknowledgment)—Causes a dollar sign ($) character to be sent from
Christie TruLife+ when it has finished processing the message.
• # (Full Acknowledgment)—Causes an echo of the message as a reply to be sent
from Christie TruLife+ when it has finished processing the message.
• & (Checksum)—Allows a checksum to be put as the last parameter in the
message for verification at Christie TruLife+.
Function code The Christie TruLife+ function you want to work with, such as channel selection or
gamma, is represented by a three-character ASCII code (A-Z, upper or lower case).
This function code appears immediately after the leading bracket that starts the
message. In messages sent to Christie TruLife+ that do not have a subcode, a space
between the function code and the first parameter (or special character) is optional.
+Subcode The Christie TruLife+ function you want to work with may have one or more
subcodes that allow you to select a specific source, image, channel or subfunction.
The subcode is represented by a four-character ASCII code (A-Z, upper or lower
case, and 0-9). This subcode appears immediately after the function code, with a
plus sign (+) character to separate the code and subcode. If there is no subcode, the
plus sign (+) is also omitted. In messages sent to Christie TruLife+ that have a
subcode, a space between the subcode and the first parameter (or special character)
is optional.
Communicating with Christie TruLife+
Christie TruLife+ Technical Reference–Serial Commands 9
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.

Components Description
Request/reply symbols If the controller is requesting information from Christie TruLife+, a question mark (?)
appears directly after the function code. If Christie TruLife+ is replying, an
exclamation mark (!) appears directly after the function code. For set messages to
Christie TruLife+, neither of these characters appear—data directly follows the 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).
Data The value for a given Christie TruLife+ 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 Christie TruLife+ (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, Christie
TruLife+ 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 Christie TruLife+ 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.
Text parameters Most data is simply a numerical value; however, some messages also require text.
For example, a channel naming message typically includes a text-based name—
enclose this text in double quotation marks, as in "Tilt the Wagon". 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.
Related information
Special characters for text (on page 10)
Maximizing message integrity (on page 12)
Special characters for text
To use special characters in the API commands, you must use a two-character combination.
Special character Two-character
combination
Description
” \” Double quotation mark
\ \\ Backslash
Communicating with Christie TruLife+
Christie TruLife+ Technical Reference–Serial Commands 10
020-103316-01 Rev. 1 (09-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.