Christie Projector Mirage WU-L User Manual

							C-4Mirage WU-L User Manual020-100774-01 Rev. 2 (4-2012)
Appendix C: Serial Communication
• If entering a negative number, there must be a space between the code/subcode, and the value. For 
example, (CRM3) and (CRM 3) can both be used when the number is positive. (CRM -2) is acceptable, 
but (CRM-2) is not.
• Data in set messages to the projector 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”. 
Te x t  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”. Use all characters as desired except for the following special characters shown in the left column 
below. These special characters require a 2-character combination. See C.2.2 Sample Messages and their 
Meaning. 
C.2.2 Sample Messages and their Meaning 
Table C.2  Special Characters for Text
If you want this...Enter this...Description
\ \\ Backslash
”\”Quote
( \( Left Bracket
) \) Right Bracket
0x0A \n New line - if the text can be displayed on more than one line, this will set the line break.
\h## Sends one arbitrary code defined by the 2 hexadecimal digits ##
Table C.3  Sample Messages and Their Meaning
For a Single Projector
Message Format Function Example
(Code Data) SET (set contrast of main image to 500) (CON500)
(Code+Subcode Data) SET (set contrast of PIP image to 500) (CON+PIIP500) 
(Code?) REQUEST (what is current contrast?) (CON?) 
(Code+Subcode?) REQUEST (what is contrast of PIP image?) (CON+PIIP?)
(Code!Data) REPLY (contrast is 64) (CON!64)
(Code+Subcode!Data) REPLY (PIP contrast is 64) (CON+PIIP!64)
($Code Data) SET AND ACKNOWLEDGE MESSAGE (message processed?) ($CON64)
(&Code+Subcode Data   Checksum) SET WITH CHECKSUM (&CON64 240)
For a Specific Projector within a Network with 1 Controller present
Message Format Function Example
(Dest Addr Code Data) SET (turn projector #5 on) (5pwr1)
($Dest Addr Code Data) SET AND ACKNOWLEDGE MESSAGE (message processed?ffr55) ($5pwr1) 
						

							Appendix C: Serial Communication
Mirage WU-L User ManualC-5020-100774-01 Rev. 2 (4-2012)
C.2.3 What is Actually Sent in a Message 
Although you will send and read messages as strings of ASCII characters, the actual message travels as a 
sequence of bytes. Each character in this sequence requires 1 byte. The example below illustrates a “lamp limit 
is 2000 hours” reply from the projector. 
C.2.4 Maximizing Message Integrity
For additional reassurance and/or maximum message integrity, you can insert 1 or 2 special characters:
•Acknowledgments: If you want assurance from the projector (or group of projectors) that a set message has 
been processed, request an acknowledgement. An acknowledgement is returned after a message has been 
received and fully executed by the projector (i.e. in the case of a source switch it is not sent until the switch 
is complete). If a message is not able to execute for some reason (i.e. invalid parameters, timeout, etc) a 
NAK is returned instead (Not-Acknowledge). Note that requesting an acknowledgement serves no purpose 
when included in a request message, since the acknowledgement will be redundant to the actual reply from 
the projector. However, if requested, the “$” acknowledgement from the projector will follow the reply.
There are two types of acknowledgements:
•Simple Acknowledgements: Insert a “$” character just after the start code “(“. This will only return a 
‘$’. This will only return a $ on success, or a ^ on failure (NAK).
•Full Acknowledgements: Insert a “#” character just after the start code “(“. This will return the message 
sent, as a reply.
This is a quick way to confirm success with set messages, and is particularly useful with long-distance 
communication links or where the projectors and/or images are not visible from the controller. 
Acknowledgements can also be a type of flow control. 
•Checksums: For maximum message integrity, add a checksum character “&” just after the start code “(”. 
You must then also include the correct checksum total (0-255) just before the “)” end code. Make sure to add 
a space before the calculated checksum to separate it from the last data parameter: 
For a Specific Projector within a Network with Multiple Controllers present
Message Format Function Example
(Dest Addr   Src Code?) REQUEST (get contrast from projector #5 to controller #2) (5 2con?)
For a Specific Projector within a Network with Multiple Controllers present
Message Format Function Example
($Dest Addr   Src Code Data) SET AND ACKNOWLEDGE MESSAGE (is message from control-
ler #2 processed by projector #5)($5 2con?)
(Dest Addr   Src Code!Data) REPLY (from projector #5 to controller #2: contrast is 64) (002 005con!064)
ASCII = ( LPL! 2000)
HEX = 0x28 0x4 0x50 0x28 0x21 0x32 0x30 0x30 0x30 0x29 
						

							C-6Mirage WU-L User Manual020-100774-01 Rev. 2 (4-2012)
Appendix C: Serial Communication
The checksum is the low order byte of the sum of the ASCII values of all characters between the “(“and the 
beginning of the checksum, but not including either. It does include the space in front of the checksum. 
Calculate the checksum for the above “set contrast to 64” command as follows: 
CHECKSUM EXAMPLE = & + c + o + n + 6 + 4 + ‘space’ 
= 26h+63h +6Fh +6E h +36h +$34h +$20h 
= 01F0h
= F0h when only the low byte is used 
= 240
The projector collects all of the message bytes as defined in the first byte of the message, then creates its own 
checksum value for comparison with the checksum included in the controller’s message. If the values match, 
the message is considered to have been correctly received—otherwise the message is discarded. 
NOTES: 1) ‘h’ indicates a hex number. 2) If a “request” message has a checksum so will the reply. 3) If using 
both “acknowledge” and “checksum”, either character can occur first. 
C.2.5 Accessing Specific Channels or Inputs
For several commands (for example, ASR, Auto Channel Select) you can direct the message to particular 
channel, input or image. To do this, include a subcode after the function code. 
Example: 
(ASR 1)Enable Auto Channel Select for the channel being used by the Main image
(ASR+MAIN 1)Enable Auto Channel Select for the channel being used by the Main image
(ASR+PIIP 1)Enable Auto Channel Select for the channel being used by the PIP image
(ASR+C003 1)Enable Auto Channel Select for channel 3
(BBL+IN12 30)Set the bottom blanking value on slot 1 input 2 to value 30
It is only possible to set parameters from a specific channel or input if that parameter is stored separately for 
each channel or input. This function cannot be used for parameters that are specified for the projector as a 
whole such as projector address. The serial commands listed in the document specify which subcodes are 
applicable to each function.
C.2.6 Flow Control
Normally messages can be sent to the projector before processing of earlier messages is complete—the 
projector will just store messages in a buffer until ready to process. However, if a series of messages is sent it is 
possible that the projector may not be able to process them as fast as they arrive and the buffer will become 
full. If this happens, the projector will send the 13h (Xoff) code to instruct the controller (or any devices 
preparing to transmit) to cease transmission. At this point, the controller must respond immediately and send 
no more than 10 extra characters or they may be lost (i.e., the projector is able to accommodate the receipt of 
up to 10 more bytes after it sends 13h (Xoff)). When the buffer is once again available, the projector will send 
a 11h (Xon) command to resume transmission. 
NOTE: Xon and Xoff controls apply to both directions of communication. The projector will not send more 
than 3 characters after it has received a 13h (Xoff) code.  
						

							Appendix C: Serial Communication
Mirage WU-L User ManualC-7020-100774-01 Rev. 2 (4-2012)
C.2.7 Network Operation
Up to 1000 projectors can be linked together in a chain with the ‘OUT’ port on one connected to the ‘IN’ port 
on the next. A controller connected to the ‘IN’ port on the first projector can control them all, either by 
broadcasting messages which have no address and are thus seen by all projectors, or by directing messages to 
specific projector addresses. 
To work with a specific projector in a group, the projectors must first be assigned a unique I.D.—either a 
projector number or an Ethernet IP address. Insert the number of the target projector between the starting ‘(’ 
and the 3-character ASCII code.
Table C.4  - Message for Specific Projector
Each projector compares the message address with its own address and, if matching, responds and processes 
the message. If the address does not match, the message is passed on until it reaches the intended projector. 
Although messages without an address are always broadcast, you can also broadcast by including the reply 
destination address 65535. This ensures that replies go to a specific controller address rather than being 
broadcast. The projector will also include its address. 
Table C.5  - Message for Projector from a Specific Controller
If you have more than one controller on a network, ensure to include both a source address and a destination 
address. With a single controller on the network, its address is never required. Place the source address 
between the destination address and 3-character code, including a space before and after as shown. 
NOTE: 
Replies from a projector do not contain an address unless the request message includes both a destination 
address and a source address—i.e., a reply to a request having only a destination address will not have any 
source address. 
Table C.6  - Message for Specific Projector from a Specific Controller
 ( Addr Code Data )
         ( Dest    Src Code Data )
         ( Dest Src Code Data )
Examples
Command Message from Controller Reply from Projector
Turn Projector #5 on. (5pwr1) {none}
What is the contrast level in Projector 30? (30con?) (CON!127)
Return Contrast from Projector #30 to Controller #2. (30 2con?) (00002 00030con!127) 
						

							C-8Mirage WU-L User Manual020-100774-01 Rev. 2 (4-2012)
Appendix C: Serial Communication
C.3 Description Of Control Types
C.3.1 Subclasses
•Power Down Controls - These controls are accessible when the projector is in Standby power mode (i.e. 
power off) as well as when powered on.
•Power Up Controls - These controls are only accessible when the system electronics are fully powered (not 
necessarily lamp on).
C.3.2 Control Groups
•Unsaved Controls - These controls are not saved to flash. The settings are not maintained between power 
sessions.
•Saved Controls - These controls are saved to flash. The settings are persistent between power sessions.
•Preference Controls - These controls are transferable from one projector to another. Example: NET+SUB0 
(projector subnet).
•Configuration Controls - These controls are projector specific settings. They are non-transferable between 
projectors. Example: NET+ETH0 (projector IP address).
•Channel Controls - These settings are specific to a particular input signal. Example: BRT (signal 
brightness).
•Option Card Controls - These settings are specific to a particular option card type / slot combination.
C.3.3 Access Levels
•Operator - Command is available at the operator level log in.
•Advanced - Command is available at the advanced operator level log in.
•Admin - Command is available at the administrator level log in.
•Service - Command is available at the service level log in. 
						

							Mirage WU-L User ManualD-1020-100774-01 Rev. 2  (4-2012)
Appendix D: Serial Command Reference 
The following tables define the serial commands associated with the Mirage WU-L projector.
(ABL) ARRAY BRIGHT COLOR LOC 
CONTROL GROUP: Preference     SUBCLASS: Power Up           ACCESS LEVEL: Operator
DESCRIPTION
This command is used to set parameters that control how the Array Bright/ColorLOC feature operates. From this control you 
enable the mode in which you want to operate the feature: target brightness, target gamut, update intervals, and other 
miscellaneous parameters. This command is persistent, and will save the “synchronize to this projector” operation between 
power-ups.
SUBCODE
EABL
DESCRIPTION OF USE
Enable Array Bright/ColorLOC:
0 = OFF
1 = fixed mode (uses CCA only)
2 = cool mode (uses CCA and LED control)
3 = bright mode (uses CCA and multi LED control)
BRGP Brightness Group. Identifies a subset of all projectors in the array to 
be used in the Array BCLOC algorithm. May be used to provide 
multiple groups of projectors with different color targets. (0-9999)
BRTG Brightness Target. Sets the target brightness that the projectors in the 
array brightness group should meet. (0-1000 Lumens)
MINB Minimum Brightness. Sets the minimum brightness, as a percentage 
of target brightness, that the projector will display if it is capable. (0-
100 percent)
MING Minimum Gamut. Sets the minimum gamut, as a percentage of the 
target gamut, that the projector will display if it is capable. (0-100 
percent)
ADIN Adjustment interval. Controls the interval in seconds that this 
projector will run the Array Bright/ColorLOC algorithm. (1-9999)
BRIN Broadcast interval. Controls the interval in seconds that this projector 
will update the projector array. (1-9999)
ALBV When set, all projectors in brightness group will use this projectors 
settings:
0 = OFF (normal)
1 = synchronize to group
Note: A group can synchronize to only one projector. Setting 
ABL+ABLV on any projector in a group to make that projector the 
master projector releases the setting from any previous master 
projector in the group. 
						

							D-2Mirage WU-L User Manual020-100774-01 Rev. 2 4-2012
Appendix D: Serial Command Reference
DEVC Specifies the ethernet port used for transfer of ColorLOC data. When 
selected will use the PHM network ethernet port rather than default 
EM network ethernet port.
0 = PHM network
1 = EM network
WENA (FUTURE USE). 
Enable warnings associated with Bright/ColorLOC.
0 = disable
1 = enable
WBTH (FUTURE USE). Sets the brightness threshold at which a warning is 
issued when warnings are enabled. (0-100 percent).
WGTH (FUTURE USE). Sets the gamut threshold at which a warning is 
issued when warnings are enabled (0-100 percent).
IRTG (FUTURE USE). IR Brightness Target. Sets the target brightness that 
the projectors in the array brightness group should meet. (0-1000).
DSEL  Allows selection of the Duty Cycle mode of operation: 
0 = Automatic
1 = Preset
SKEY  Synchronize remote control keystrokes, test pattern and color enable 
amongst array projectors 
0 = Independent 
1 = Synchronized 
SFRD  Synchronize frame delay amongst array projectors 
0 = Independent 
1 = Synchronized 
AFRD  Sets the array frame delay parameter. Applies to all projectors in 
array if SFRD is set to Synchronized 
AFRS  Read-only control reports smallest frame delay value in array that 
will not generate tearing artifacts 
SRGB  Synchronize RGB Brightness setting amongst array projectors 
0 = Independent 
1 = Synchronized 
SACF Synchronize AccuFrame setting amongst array projectors 
0 = Independent 
1 = Synchronized 
EXAMPLES:
(ABL+EABL 1) - Turn ON Array Bright/ColorLOC and run in Fixed mode
(ABL+BRGP 2) - Set the brightness group to 2
(ABL+BRTG 400) - Set the brightness target to 400 Lumens
(ABL+ADIN ?) - Return current value of adjustment interval in seconds
(ABL) ARRAY BRIGHT COLOR LOC  (CONTINUED) 
						

							Appendix D: Serial Command Reference
Mirage WU-L User ManualD-3020-100774-01 Rev. 2 (4/2012)
(ACE) AUTO COLOR ENABLE 
CONTROL GROUP: Preference     SUBCLASS: Power Up           ACCESS LEVEL: Operator
DESCRIPTION
Automatically select Color Enable based on the control being adjusted. If enabled, this control allows the projector to 
automatically change the color enable control when the user is using the OSD interface to adjust controls such as Input levels, 
odd pixel, and brightness uniformity. This is an unsaved control, which can only be set when powered on, and only affects the 
operation of the On Screen Menus.
SUBCODE
 DESCRIPTION OF USE
Enable/Disable auto color controls.
EXAMPLES
: 
(ACE 0) - Disable Auto Color 
(ACE 1) - Enable Auto Color 
(ACF) ACCUFRAME
CONTROL GROUP: Preference     SUBCLASS: Power Up           ACCESS LEVEL: Operator
DESCRIPTION
This controls the settings for AccuFrame. AccuFrame is used to reduce image artifacts such as smearing and double image 
perception in high speed simulation environments. 
SUBCODE
SLCTDESCRIPTION OF USE
Enable 
0 = OFF
1 = ON
PARM Strength parameter which controls the effect of AccuFrame. Higher 
values will reduce artifacts, but will also reduce image brightness. 
Expressed as a percentage (0-100).
EXAMPLES
: 
(ACF+SLCT 1) - Enable 
(ACF+PARM 35) - Set strength to 35%
(ACO) ADAPTIVE CONTRAST 
CONTROL GROUP
: Input     SUBCLASS: Power Up           ACCESS LEVEL: Operator
DESCRIPTION
Adaptive Contrast Enhancement dynamically expands the contrast of the output image producing vibrant images with 
seamless response to scene changes and fades. The adaptive contrast function implements a dynamic non-linear mapping 
between the Input and output contrast levels based on frame-by-frame luminance histogram measurement of the Input image.
SUBCODE
INxyDESCRIPTION OF USE
Set the adaptive contrast for SlotSlot x, Input y. Range 0-15.
MAIN
Set the adaptive contrast for main video. Range 0-15
.
PIIP
Set the adaptive contrast for PIP video. Range 0-15.  
						

							D-4Mirage WU-L User Manual020-100774-01 Rev. 2 4-2012
Appendix D: Serial Command Reference
EXAMPLES: 
(ACO 8) - Sets adaptive contrast for main image to 50% strength.
(ACT) ACTIVE WINDOW  
CONTROL GROUP: Input     SUBCLASS: Power Down           ACCESS LEVEL: Operator
DESCRIPTION
This control defines the Input active window in pixels. The production aperture is available for analog sources only, but not 
for decoded analog signals. The aperture is set once on every auto setup or on new signal detection when a channel for that 
signal is not present. The aperture defines the maximum window in which blanking controls can be opened up to, relative to 
the active portion of the signal. This is a read only control.
 
SUBCODE
INxy
DESCRIPTION OF USE
Set the adaptive contrast for Slot x, Input y.
MAIN Set the adaptive contrast for main video.
PIIP  Set the adaptive contrast for PIP video.
EXAMPLES:
(ACT?) - Returns the active window for main video. 
(ACT+PIIP?) - Returns the active window for PIP video. 
(ACT+IN12?) - Returns the active window for Slot 1 Input 2. 
(ADR) ADDRESS 
CONTROL GROUP
: Preference     SUBCLASS: Power Down           ACCESS LEVEL: Operator
DESCRIPTION
Set/Query Device Address on ASCII Protocol network. Required only for RS-232 connections that are daisy chained to allow 
directed messages.
SUBCODE
 
DESCRIPTION OF USE
Valid Address range is 0 to 999. Reserved broadcast address is 
65535.
EXAMPLES:
(65535 ADR 0) - Set all devices to address 0. 
(0 ADR 5) - Set first device at address 0 to address to 5. 
(65535 1001ADR?) - Query address for all devices and return results to address 1001. 
Expected response to previous query (01001 00005ADR!005).
(AGC) AUTOMATIC GAIN CONTROL 
CONTROL GROUP: Input     SUBCLASS: Power Down           ACCESS LEVEL: Advanced
DESCRIPTION
Enable/disable the Automatic Gain Control. This control allows the decoder to automatically track the sync amplitude of the 
incoming signal. Turn this control OFF if you are experiencing strange color artifacts, indicating an incompatibility between 
the source and the AGC. 
(ACO) ADAPTIVE CONTRAST  (Continued) 
						

							Appendix D: Serial Command Reference
Mirage WU-L User ManualD-5020-100774-01 Rev. 2 (4/2012)
SUBCODE
INxy
DESCRIPTION OF USE
Set the AGC on Slot x, Input y to the specified state of either enable 
or disable.
 
MAIN Set automatic gain control on main image. 
PIIP Set automatic gain control on main image. 
EXAMPLES:
(AGC 1) - Enables AGC on main video. 
(AGC+MAIN 0) - Disables AGC on main video. 
(AGC+PIIP 1) - Enables on PIP video. 
(AGC?) - Returns the current AGC state on main video. 
(AGC+PIIP ?) - Returns the current AGC state on PIP video. 
(AGC+IN12 ?) - Returns the current AGC state on Slot 1 Input 2.
(AIC) AUTO INPUT CYCLING 
CONTROL GROUP: Preference     SUBCLASS: Power Down           ACCESS LEVEL: Operator
DESCRIPTION
When enabled, the system will continually search for the next valid signal when no signal is present or when loss of sync 
occurs on the current user selected Input. In the case of multiple signals to choose from, the order is based on Slot, followed 
by Inputs on that Slot.
 
SUBCODE
 
DESCRIPTION OF USE
Enable or disable auto Input cycling.
EXAMPLES:
(AIC 0) - Disable auto Input cycling. 
(AIC 1) - Enable auto Input cycling.
(AIL) AUTO INPUT LEVEL 
CONTROL GROUP: Unsaved     SUBCLASS: Power Up           ACCESS LEVEL: Operator
DESCRIPTION
If enabled, this control allows the projector to continuously monitor the Input signal levels of the analog Inputs and make 
adjustments as needed. Whenever the projector detects a level that would lead to the crushing of black or white levels, it 
adjusts the Input offset or gain to compensate. If the Input signal is not being crushed, the projector will do nothing. The Auto 
Input Level feature should only be used when the current source requires further Input level adjustment. There must be at 
least 12 consecutive white pixels in the image in order to use Auto Input Levels. The monitor period will run for 10 seconds 
after being issued. Auto setup or source switching will stop the level period. To use this control, turn the Auto Input Level 
feature ON, wait for the blacklevel and drive values to stabilize, and turn the Auto Input Level feature off or wait for the 10 
seconds. When the Auto Input Level feature is turned OFF, the current drive and blacklevel values are maintained. This 
control only applies to analog BNC or Dual DVI cards.
SUBCODE
MAIN
DESCRIPTION OF USE
Perform auto Input level on the main image. 
PIIP
Perform auto Input level on the PIP image. 
(AGC) AUTOMATIC GAIN CONTROL  (CONTINUED)