Christie Projector CP2230 User Manual

							Appendix B: Serial API
CP2230 User ManualB-5020-100430-07 Rev. 1 (05-2014)
BLUVSet or query the blue vertical EDC value. 
RSET Set all six EDC values to their default value.
EXAMPLES:
(EDC?) Get all six EDC values
(EDC 0 3 1 2 2 3) Set all six EDC values at once. Set red horizontal to 0,  green horizontal to 3, blue horizontal to 1, red vertical 
to 2, green vertical to  2 and blue vertical to 3.
(EDC+REDH?) Set the re d horizontal EDC value
(EDC+REDH 2) Set the red horizontal EDC value to 2
(EDC+BLUV?) Get the blue  vertical EDC value
(EDC+BLUV 1) Set the blue  vertical EDC value to 1
(EDC+RSET) Set all six EDC va lues to their default value
Enable Error Messages (EME)
Enable broadcasting error messages.
SUBCODEDESCRIPTION OF USE
FA N F 0 - No Fan Fail warni ng will be generated,
1 - Fan Fail warning  will be generated. 
NONE 0 - Disable broadcast, 
1 - Enable broadcast of error messages to all  connected serial ports and telenet sessions. 
TEMP 0 - No Over Temperature wa rning will be generated,
1 - Over Temperature wa rning will be generated.
EXAMPLES:
(EME 1) Enable broadcasting error messages
(EME+FANF 0) Disable fa n fail alarm warnings
(EME?) Requests current  state of broadcast. Example response is (EME!001)
Focus Lens Position Adjustment (FCS)
Adjust lens to specific focus posi tion with a specified direction. NOTE: This command can only be used to update 
the current ILS file . Changing the focus for the current channel will change the focus for any channel using the 
same ILS file.
Use command without subcode:
•  If ILS is ON, motor will move to specified steps, and save data to the active channel.
•  If ILS is OFF, motor will move to specified steps. Do not save data to the active channel.
SUBCODEDESCRIPTION OF USE
BACN Motor backlash in negati ve direction. Read-only.
BACP Motor backlash in positiv e direction. Read-only.
CALB Calibrate travel range and backlash  on specified. Only valid parameter for this command is 1. SET only 
command.
Cxxx Replace Cxxx with the channel  number. Valid range is 101-164.
NONE Moving lens mount to a specified vertic al position with a specified direction. 
RNGN Motor moving range in nega tive direction. Read-only.
Electronic Digital Convergence (EDC) (Continued) 
						

							B-6CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
RNGPMotor moving range in posit ive direction. Read-only.
RSET Move motor to the center flag then move back to current position. Only valid parameter for this command 
is 1. SET only command.
STRT Start motor moving in specified dire ction, where direction can be (-1, 1). Write-only for v1.3 or newer.
STOP Stops the motor. Write-only for v1.3 or newer.
MOVR Moves the motor a given number of steps based on th e current location. Write-only for v1.3 or newer.
EXAMPLES:
(FCS 500 1) Move lens  to position 500 at focus motor with positive approach
(FCS 500 -1) Move lens to position 500  at focus motor with negative approach
(FCS+C101 -500 1) Set lens focus position fo r channel 1 to -500 with positive approach
(FCS ?) Return current motor position
(FCS+CALB 1) Calibrate the focus axis
(FCS+RSET 1) Reset the focus axis
(FCS+STRT 1) Starts motor  moving in positive direction
(FCS+STOP) Stops motor
(FCS+MOVR -100) Move motor 100  steps in negative direction
(FCS+MOVR 200) Move motor 200  steps in positive direction
Gamma Control (GAM)
Gamma control, gamma file will be set when PCF in Use (PIU) is off. This control describes the gamma response 
curve for the source signal.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel  number. Valid range is 101 - 164.
NONE Select gamma for the current channel.
EXAMPLES:
(GAM+C108 “gamma 2.6”) Use file “gamma 2.6” on channel 108
(GAM+C108?) Get gamma fi le name on channel 108
(GAM?L) List all entries of gamma control
Focus Lens Position Adjustment (FCS) (Continued) 
						

							Appendix B: Serial API
CP2230 User ManualB-7020-100430-07 Rev. 1 (05-2014)
Lamp History (HIS)
Retrieve the history of installed lamp entries, including the current lamp. There is an individual entry for each lamp 
in the history. The format for  each entry is: (HIS!AAA “BBBB/BB/BB”  “C” “D” EEE FFF GGG HHH III JJJ 
KKK).
A = Lamp Number
B = Date Installed
C = Serial Number 
D = Type
E = Strikes
F = Failed Strikes
G = Failed Restrikes
H = Unexpected Lamp Off
I = Pre-installed Hours (will always re turn “00000”)
J = Lamp Hours
K = Lamp Rotation
SUBCODEDESCRIPTION OF USE
NONE None 
EXAMPLES:
(HIS?)
(HIS!000 “N/A” “N/A” “N/A” 000 000 000 000 000 000 000)
(HIS!001 “2007/05/21” “qa-1” “CDXL-30” 000 000 000 000 020 020 001)
(HIS!002 “2007/05/21” “qa-2” “Other-30” 000 000 000 000 015 015 000)
(HIS!003 “2007/05/21” “qa-3” “Other-20” 000 000 000 000 000 000 001)
Serial Command Help (HLP)
Get help on serial commands. 
SUBCODEDESCRIPTION OF USE
NONE Request entire command  help listing or list for a single command 
EXAMPLES:
(HLP?) Retrieve entire command help listing
(HLP? “DLG”) Retrieve all subcode s/descriptions for DLG control
ICP File Management (ICP)
Provides file management for LUT-SCC (PCT), LUT- CLUT, MCGD, TCGD, Source, Screen, and PNG (Test Pat-
tern) files.
SUBCODEDESCRIPTION OF USE
FSET Adds or Copies an ICP file from the TPC FTP root dire ctory to the appropriate directory on the ICP. Will 
not overwrite an existing file with the same name.
FGET Not supported.
FDEL Deletes a file from the ICP. The filename parameter is case sensitive. 
						

							B-8CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
FCOPNot supported.
FREN Not supported.
EXAMPLES:
(ICP+FSET “ones4K_LE.LUT -SCC”) Copies the “ones4K_LE.L UT-SCC” PCT file from the TPC’s ftproot directory to the 
LUT-SCC directory on the ICP.
(ICP+FSET “Nominal.MCGD”) Copy the “Nominal.MCGD” MC GD file from ftproot to the MCGD directory on the ICP.
(ICP+FDEL “Nominal.MCGD”) Deletes the “Nominal.MCGD” file from the ICP. 
ILS File (ILF)
Set or get the current ILS file fo r the current or a specific channel.
SUBCODEDESCRIPTION OF USE
C1xx Set or get the current ILS fi le for a specific channel.
NONE Select the ILS file for a current channel.
SAVE Save the currently active ILS data to a file. Will overwrite an existing file with the same name. Requires 
advanced access level.
FDEL Delete an ILS File
EXAMPLES:
(ILF+C101 “ILS Flat”) Set ILS file for channel 1 to file “ILS Flat”
(ILF?L) List all av ailable ILS files
(ILF 1) Set ILS file for current  channel to index 1 in file list
(ILF+Save “filename”) Save the active ILS valu es to a file named “filename”. If the file doesn’t exist, it will be created. If  the 
file already exits, it  will be overwritten.
(ILF+FDEL “LensSetup1”) Dele te the “LensSetup1” ILS file from the system.
(ILF+FDEL 3) Delete the ILS file at index 3 in the list.
ILS Config (ILS)
Enable/disable the Intelligent Lens System for each channel. 
SUBCODEDESCRIPTION OF USE
ACLB Enable/disable the Auto Lens Mount  and Lens reset feature. Once ACLB is turned on, lens mount and lens 
system will be reset automatically when system is powered on.
CALB Calibrate travel range and backlash on specified. On ly valid parameter for this command is 5. SET only 
command.
CSTS Motor calibration status (0-100%)
INST Sets ILS to installed
NONE Enable/Disable the Intelligent Lens  System for each channel. (1/0)
ICP File Management (ICP) (Continued) 
						

							Appendix B: Serial API
CP2230 User ManualB-9020-100430-07 Rev. 1 (05-2014)
RSETMove motor to center flag and then move back to  current position. Only valid parameter for this command 
is 5. SET only command.
RSTS Motor reset status (0-100%)
EXAMPLES:
(ILS 1) Enable ILS, lens  will be moved to the position in each channel
(ILS 0) Disable ILS, position da ta in each channel will not be used. Moving lens will no t affect any channel setting 
(ILS+CALB 5) Calibrate all axes  of the lens. Set only command
(ILS+RSET 5) Reset all axes of the lens
(ILS+ACLB 1) Reset lens au tomatically when power on
Set IMB Device Type (IMI)
Used to set the IMB device type.
SUBCODEDESCRIPTION OF USE
DEVT Set device type from the list of devices.
EXAMPLES:
(IMI 1) Set to IMB installed.
(IMI+DEVT?L) List va lid device types.
(IMI+DEVT?) Query cu rrent device type.
Start Interrogator, check interrogator status (INT)
SUBCODEDESCRIPTION OF USE
BASC Start a basic interrogation (set only)
ENHA Start an enhanced interrogation (set only)
STAT Responds with 2 values: currently runni ng (1 if running) and result file.
EXAMPLES:
(INST+BASC 1)  Run a basic interrogation (set only)
(INT+STAT?)  Query interrogator status. Returns (INT+STAT! 00100 00000 “Interrogator_Enhanced_20101103194849.7z”), 
which means the interrogator is 100% finished, not currently runni ng and the latest interrogator file that was generated is named 
“Interrogator_Enhanced_201001103194849.7z” and can be  found on the cinema projector’s FTP server.
Internal Test Pattern (ITP)
List and select internal test patterns. This command also creates the customized test pattern list from the internal 
test patterns. The list of available test patterns is determin ed by what files are loaded on the TI cinema electronics.
SUBCODEDESCRIPTION OF USE
FULL Set(1)/Reset(0) full screen size
KEEP When KEEP=1, don’t disable test  pattern when changing channels
NOCR NOCR set non-correction test  patterns for measured color. Valid range is 0 to 6
NONE Select test pattern from full li st of defined test patterns
ILS Config (ILS) (Continued) 
						

							B-10CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
STUPAdd test pattern from full list of defi ned test patterns to the user list
USER Select test pattern from user  defined test pattern list
EXAMPLES:
(ITP ?) Get current test  pattern, 0 means no test pattern is used.
(ITP 4) or (ITP “ “) Use number  or string to set test pattern
(ITP+USER 4) or (ITP+USER “ “) Use number or string  to set test pattern from user’s test pattern list.
(ITP+FULL 1) Use full screen size
(ITP+FULL 0) Use activ e channel screen file
(ITP+NOCR 1) Set non-correction test pa tterns for measured color you can use
(ITP+STUP “DC2K Framing Green, DC 2K Framing Red”) Add these two test patterns to the user list
(ITP+STUP 1 3) Add these two  test patterns indexed in the ITP list to the user list
Lamp Intensity Calibration (LCA)
This control is used to calibrate (correlate) the intens ity feedback mechanism to footlamberts. Note the minimum/
maximum power are used to pick two points on the curve. Th ese points will not stay consistent over the life of the 
lamp, but the conversion algorithm will extrapolate the conversion beyond the range of the two end points. Foot-
lamberts for minimum/maximum power are converted to integer by  multiplying 100 because serial command pro-
tocol does not support floating point number. 
NOTE:  Changing the lamp or lamp alignment will require re-
calibration.
SUBCODEDESCRIPTION OF USE
MAXF Set footlamberts at maximum lamp power , the value should be (footlamberts * 100)
MAXS Set sensor value at maximum lamp power
MINF Set footlamberts at minimum lamp power,  the value should be (footlamberts * 100)
MINS Set sensor value at minimum lamp power
NONE Not available
EXAMPLES:
(LCA+MINF 10) Set 10 footlamberts as me asured brightness at minimum lamp power
(LCA+MINF?) Get footlamberts on minimum lamp power
(LCA+MINS 5000) Set 5000 as re ading value from the light sensor at minimum lamp power
(LCA+MAXF 17) Set 17 footlamberts as me asured brightness as maximum lamp power
(LCA+MAXF?) Get footlamberts at maximum lamp power
(LCA+MAXS 15000) Set 15000 as reading value fro m the light sensor on maximum lamp power
LUT CLUT Control (LCT)
Set Look up Table (LUT) Color Look Up Table (CLUT) file  for the specified channel. The CLUT is used during 
color processing in th e cinema electronics.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel  number. Valid range is 101 - 164.
NONE Select CUT for the current channel.
EXAMPLES:
(LCT+C108 “9x9x9”) Use PCF file “9x9x9” on channel 108
(LCT+C108?) Get LUT-CLUT  file name on channel 108
(LCT?L) List all entries of LUT-CLUT control
Internal Test Pattern (ITP) (Continued) 
						

							Appendix B: Serial API
CP2230 User ManualB-11020-100430-07 Rev. 1 (05-2014)
Link Decrypter Bypass (LDB)
Setting LD bypass to TRUE (1) will bypass the link decrypter (LD). Only use if marriage is broken and content being played is 
not CineLink 2 encrypted  (non D-Cinema content).
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel num ber. Valid range is 101 - 164.
NONE Set to 1 to bypass and 0 to not bypass.
EXAMPLES:
(LDB+C108 1) Bypass link decrypter on channel 108.
(LCT 0) Use link decr ypter on current channel (i.e. do not bypass).
(LCT+C108?) Get value for LDB on channel 108.
Link Decrypter Installed (LDI)
Access Level:  Advanced
Min Power Level:  Power Down
Set LD to installed or not installed.
SUBCODEDESCRIPTION OF USE
None Set to 1 to installed and 0 to not installed.
EXAMPLES:
(LDI 1) Set LD installed.
Lamp Intensity Calibration (LEN)
Define model and serial number for primary installed lens and auxiliary lens.
SUBCODEDESCRIPTION OF USE
AMOD Auxiliary lens model
ASER Auxiliary lens serial number
MMOD Main lens model
MSER Main lens serial number
NONE Not available
EXAMPLES:
(LEN+MMOD?L) List supported lens model
(LEN+AMOD?L) List supporte d auxiliary lens model
(LEN+MMOD 1 Set lens model
(LEN+MSER “xxxx”) Set  lens serial number 
						

							B-12CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
Lens Horizontal Position Adjustment (LHO)
Adjust lens offset to specific horizontal position with a specified direction. NOTE: This command can only be 
used to update the current ILS file . Changing the horizontal offset for the current channel will change the horizon-
tal offset for any channel using the same ILS file.
Use command wi thout subcode:
• If ILS is ON, motor will move to specified  steps and save data to the active channel.
•  If ILS is OFF, motor will move to specified  steps, do not save data to the active channel.
SUBCODEDESCRIPTION OF USE
BACN Motor backlash in negative direction. Read-only. 
BACP Motor backlash in positive direction. Read-only.
CALB Calibrate travel range and backlash on specified. Only  valid parameter for this command is 1. Set only command.
Cxxx Replace xxx with the channel number. Valid range is 101-164.
NONE Moving lens mount to a specified horizontal  position with a specified direction. 
RNGN Motor moving range in nega tive direction. Read-only.
RNGP Motor moving range in positive direction. Read-only.
RSET Move motor to the center flag then move back to current positi on. Only valid parameter for this command is 1. Set only command
STRT Start motor moving in specified direction, where dir ection can be (-1, 1). Write-only for v1.3 or newer.
STOP Stops the motor. Write-only for v1.3 or newer.
MOVR Moves the motor a given number of steps based on th e current location. Write-only for v1.3 or newer.
EXAMPLES:
(LHO 500 1) Move lens to position 500 along horizontal axis with positive approach
(LHO 500 -1) Move lens to  position 500 along horizontal ax is with negative approach
(LHO+C101 -500 1) Set lens horiz ontal position for channel 1 to -500 with positive approach
(LHO ?) Return current moto r position along horizontal axis and direction (-1 or 1)
(LHO+CALB 1) Calibrat e the horizontal axis
(LHO+RSET 1) Reset the horizontal axis
(LHO+STRT 1) Starts motor  moving in positive direction
(LHO+STOP) Stops motor
(LHO+MOVR -100) Move motor 100  steps in negative direction
(LHO+MOVR 200) Move motor 200  steps in positive direction
Lamp ID (Type) (LID)
Get lamp type (ID) for the currently installed lamp. Su pports readback of the list of supported lamp types.
SUBCODEDESCRIPTION OF USE
NONE Get Lamp ID for current lamp. This is a read-only  control. Lamp ID can be changed with LPC (lamp 
change) command only.
EXAMPLES:
(LID?L) List supported lamp IDs
(LID?) Get the lamp ID for installed lamp 
						

							Appendix B: Serial API
CP2230 User ManualB-13020-100430-07 Rev. 1 (05-2014)
LampLOC™ Module (LLM)
Allows adjustment of lamp position to optimize intensity and uniformity of the optical system. This is referred to 
as the LampLOC™ feature and can be done automatically or manually.
SUBCODEDESCRIPTION OF USE
AUTO Set to 1 to do LampLOC™ automatically. It will do calibration first, then move the X, Y, Z-motors to find 
the maximum brightness. Set to 0 to cancel auto adjustment and restore the previous position. Reset to 0 
when it has finished.
CALI Calibrate LampLOC motors.
MTRX Moving X-axis motor manually. Data range from ±250.
MTRY Moving Y-axis motor manuall y. Data range from ±250.
MTRZ Moving Z-axis motor manuall y. Data range from ±175.
NONE Not Available 
STAT Provides feedback (status) on the progress of the  Auto mode. Read-only command. Data range from 0 to 
100, where 100 indicates the LampLOC™ is finished.
EXAMPLES:
(LLM+MTRX 100) Move motor X to position 100
(LLM+AUTO 1) Do Lamp LOC™ automatically
(LLM+AUTO 0) Abort LampLOC™. It will restore the motors to previous position automatically
(LLM+AUTO?) Get running status. (LLM+AUTO!000) indicates finished , (LLM+AUTO!001) indicates running
(LLM+STAT ?) Get the progress feedback of the Auto mode (0-100%)
Adjust All Lens Position Para meters Simultaneously (LMV)
Adjust all lens position parameters simultaneously. 
SUBCODEDESCRIPTION OF USE
NONE (LMV )
where , , ,  and  represent the horizontal, vertical, zoom, and focus 
position information. Valid values  for direction are 1 and -1.
EXAMPLES:
(LMV 1000 1500 500 -500 -1 -1 1 1)
Local Settings (LOC)
S
et the time format and display  options for temperature units.
SUBCODEDESCRIPTION OF USE
LANG Set the current language of the user interface.
TEMP Set the temperature units. 0 - Celsius. 1 - Fahrenheit.
TIME Set Time format. 0 - 24 hour, 1 - 12 hour.
EXAMPLES:
(LOC+TIME 1) Set time  zone to standard 12 hour
(LOC+TIME?1) Get list of formats
(LOC+TIME?)(LOC+TIME! 001) Get time format 
						

							B-14CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
Lamp Changed (LPC)
Record current lamp information into the lamp history, then start a new entry. Set lamp information of a new lamp 
type ID, serial number, and pre-used hours. When the values are set, use the (LPC 1) command to add the record.
SUBCODEDESCRIPTION OF USE
LPID Set lamp type ID for the new lamp
NONE Save lamp information to lamp history
PREV Set lamp previous lamp hours for the new lamp
SERL Set lamp serial number for the new lamp
EXAMPLES:
(LPC+LPID 2) Set lamp type ID
(LPC+SERL “CDX30-001”) Set lamp serial number
(LPC 1) Save information to lamp histor y. Consecutive lamp changes require a 5 -  10 second time difference as writing to 
EEPROM is involved.
Lamp File (LPF)
Set or get the current lamp file for the current or a speci fic channel. This command can also be used to save the 
active lamp data to a new or existing lamp file, and delete a lamp file from the system.
SUBCODEDESCRIPTION OF USE
Cxxx Set or get the current lamp  file for a specific channel
NONE Set lamp file for current channel
SAVE Save the currently active lamp data to a file. Will overwrite an existing file with the same name. 
FDEL Delete a lamp file from the system.
EXAMPLES:
(LPF+C101 “Default”) Set lamp file  for channel 1 to file “Default”
(LPF?L) List all available lamp files
(LPF 1) Set lamp file for current channel to index 1 in file list 
(LPF+SAVE “filename”) If the file doesn’t exist, it will be  created. If the file already exits, it will be overwritten.
(ILF+FDEL “LampSetup1” ) Delete the “LampSetup1” la mp file from the system.
(ILF+FDEL 3) Delete the lamp file at index 3 in the list.
Lamp Hours (LPH)
Get information on installed lamp. Read only control.
SUBCODEDESCRIPTION OF USE
FLSK Return total failed lamp strikes on the installed lamp
FRSK Return total failed lamp restrikes on the installed lamp
LPOF Return total lamp unexpected off times on the installed lamp