Christie Projector CP2230 User Manual

							Appendix B: Serial API
CP2230 User ManualB-15020-100430-07 Rev. 1 (05-2014)
NONEReturn lamp usage for current lamp in hours.
TLSK Return total lamp strikes on the installed lamp
EXAMPLES:
(LPH?) Get usage in hours
(LPH+FLSK?) Get lamp strikes 
Lamp Intensity (LPI)
Set lamp intensity setpoint. The value is used when la mp mode is set to LiteLOC™. The cinema projector will 
adjust the Lamp Power to maintain this intensity.  NOTE: This command can only be  used to update the current 
lamp file . Changing the lamp intensity for the current channel will change the lamp intensity for any channel using 
the same lamp file.
SUBCODEDESCRIPTION OF USE
Cxxx Replace Cxxx with the channel  number. Valid range is 101-164.
NONE Set lamp intensity for the current channel.
EXAMPLES:
(LPI 4500) Set lamp intensity to 4500 for current channel
(LPI+C103 4000) Set the lamp intensity to 4000 for channel 3
(LPI?) Get lamp intensity for the active channel
Lamp Life (LPL)
Set/get expected lamp life in hours. The default hours will be  used if lamp life is ‘not set’. Lamp expiry message 
will be sent out when lamp usage is over the lamp life.
SUBCODEDESCRIPTION OF USE
LIFE 0 - No warning will be generated. 
1 - Lamp Life Expiry Warning will  be generated when lamp hours extends  past lamp life. Warning will be 
reported in SST. Warning will  be cleared by extending lamp life or changing the lamp.
NONE Set or get expected lamp life.
ROTA Set to 1 acknowledge the Lamp Rotation Warning. Will auto clear at lamp life or on lamp change.
ROTW 0 - No warning will be generated. 
1 - Lamp Rotation Warning will be generated when lamp hours extends past  1/2 lamp life. Warning will be 
reported in SST. Warning will be cleare d by LPL+ROTA or changing the lamp.
EXAMPLES:
(LPL 1500) Set lamp life limit to 500 hours.
(LPL 0) Set lamp life limit to  default hours based on the lamp type.
(LPL ?) Get lamp life limit.
(LPL+LIFE 1) Enable  lamp expired message.
(LPL+LIFE 0) Disable  lamp expired message.
(LPL+ROTW 1) Enable lamp rotation message.
(LPL+ROTA 1) Acknowledge that lamp was rotated.
Lamp Hours (LPH) (Continued) 
						

							B-16CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
Lamp Mode (LPM) 
Set lamp mode to constant power or LiteLOC™ for global and per channel. NOTE: This command can only be 
used to update the current lamp file . Changing the lamp power for the current channel will change the lamp power 
for any channel using the same lamp file.
SUBCODEDESCRIPTION OF USE
Cxxx Replace Cxxx with the channel number. Valid range is 101-164.
NONE Set lamp mode for the current channel.
EXAMPLES:
(LPM 0) Set Constant Power mode for current channel
(LPM “Constant Power”) Set Constant  Power mode for active channel
(LPB+C101 1) Set intensity mode for channel 1
(LPM?) Get Lamp mode for active channel
Lamp Power (LPP)
Set lamp power to be used when in Constant Power mode.  NOTE: This command can only be used to update the 
current lamp file. Changing the lamp power for the current channel will change the lamp power for any channel 
using the same lamp file.
SUBCODEDESCRIPTION OF USE
Cxxx Replace Cxxx with the channe l number. Valid range is 101-164.
MINI Get nominal minimum lamp power for the current lamp. Read-only value
NONE Set lamp power for the current channel.
EXAMPLES:
(LPP 2500) Set lamp power to 2500 for current channel
(LPP+C102 2000) Set lamp pow er to 2000 for channel 2
(LPP+C102?) Get the lamp  power for channel 2
Lens Vertical Position Adjustment (LVO)
Adjust lens offset to specific vertical position with a  specific direction. NOTE: This command can only be used to 
update the current ILS file . Changing the vertical offset for the current channel will change the vertical 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 st eps. Do not save data to the active channel.
SUBCODEDESCRIPTION OF USE
BACN Motor backlash in negative  direction. Read-only. 
BACP Motor backlash in positive direct ion. Read-only. Set only command.
CALB Calibrate travel range and backlash on specified. Only valid parameter for this command is 1. Set only 
command.
Cxxx Replace Cxxx with the channe l 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 negati ve direction. Read-only. 
						

							Appendix B: Serial API
CP2230 User ManualB-17020-100430-07 Rev. 1 (05-2014)
RNGPMotor moving range in posi tive direction. Read-only.
RSET Move motor to the center flag then move back to cu rrent position. Only valid parameter for this command 
is 1. Set only command.
STRT Start motor moving in specified direction, where di rection 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  the current location. Write-only for v1.3 or newer.
EXAMPLES:
(LVO 500 1) Move lens to position 500 al ong vertical axis with positive approach
(LVO 500 -1) Move lens to position 500 al ong vertical axis with negative approach
(LVO+C101 -500 1) Set lens vertical position  for channel 1 to -500 with positive approach
(LVO ?) Return current motor positio n along vertical axis and direction
(LVO+CALB 1) Calibrate the vertical axis
(LVO+RSET 1) Reset the vertical axis
(LVO+STRT 1) Starts motor moving in positive direction
(LVO+STOP) Stops motor
(LVO+MOVR -100) Move motor 100 steps in negative direction
(LVO+MOVR 200) Move motor 200  steps in positive direction
Monitor Card Cage Fans (MCF)
Enables or disables the monitoring of the two additional card cage fans. This command has no effect on a 2210 cin-
ema projector.
SUBCODEDESCRIPTION OF USE
NONE  Set to 1 to monitor and 0 to not monitor.
EXAMPLES:
(MCF 1) Start monitoring the card cage fans
Measured Color (MCG) 
Select the Measured Color Gamut file. This file descri bes the native colorimetry for the cinema projector as 
installed and is required for accurate color processing in  the cinema electronics. This control is per channel to 
allow for different colorimetry  for applications such as 3D.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel num ber. Valid range is 101 - 164.
NONE  Select measured color gamut for the current channel.
Lens Vertical Position Adjustment (LVO) (Continued) 
						

							B-18CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
DATASet/Get active MCGD measurement values. The order is RedX, RedY, GreenX,  GreenY, BlueX, BlueY, 
WhiteX, WhiteY, BlackX, BlackY. Th e range for each value is 0 - 100000. The values represent MCGD 
measurement values multiplied by 100000.
SAVE Saves the active MCGD measurement values to a  new or existing MCGD file. (SET Only Command)
EXAMPLES:
(MCG+C108 “Nominal”) Use file “Nominal” on channel 108
(MCG+C108?) Get measured colo r file name on channel 108
(MCG?L) List all entries of measured color control
(MCG+DATA 123 31786 00333 0 100000 66000 1 88899 2154 5441) Set  the active MCGD measurement values to 
RedX=0.00123, RedY=0.31786, GreenX =0.00333, GreenY=0.00000, BlueX=1.000 00, BlueY= 0.66000, WhiteX=0.00001, 
WhiteY=0.88899, BlackX =0.02154, BlackY=0.05441
(MCG+DATA?) Retrieve the 10 active MCGD measurement values.
(MCG+SAVE “filename”) Save the 10 active MCGD measurement values to a file named “filename”. If the file doesn’t exist, it 
will be created. If the file alre ady exists, it will be overwritten.
Channel Name (NAM)
Set the descriptive channel na me for the specified channel
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel  number. Valid range is 101 - 164.
NONE Select channel name for the current channel.
EXAMPLES:
(NAM+C108 “Scope 2.39”) Set  channel name for channel 108
(NAM+C108?) Get channel name for channel 108
Network (NET)
Set the network parameters for Eth0, Gateway, and Subnet 0.
SUBCODEDESCRIPTION OF USE
DLP0 Set the IP address for the MGMT  Ethernet controller (deprecated).
ETH0 Set the WAN IP address for the cinema projector
GATE Set the WAN Gateway for the cinema projector
HOST Host name
Measured Color (MCG)  (Continued) 
						

							Appendix B: Serial API
CP2230 User ManualB-19020-100430-07 Rev. 1 (05-2014)
MAC0Gets the MAC address of  the cinema projector
SUB0 Set the WAN subnet mask for the cinema projector
EXAMPLES:
(NET+ETH0 192.168.1.35) Set new IP address on the MGMT Ethernet controller
(NET+GATE 192.168.0.1) Set the gateway 
(NET+SUB0 255.255.255.0) Set the subnet mask on the MGMT Ethernet controller
(NET+HOST MyHostName) Set the host name 
(NET+ETH0 ?) Retrieve IP address from the MGMT  Ethernet controller. (NET+ETH0! 192.168.1.35) 
(NET+MAC0 ?) Retrieve MAC address from MGMT controller. (NET+MAC0! 00:12:3F:7B:76:B4) 
(NET+GATE ?) Retrieve default gateway. (NET+GATE! 192.168.0.1) 
(NET+DLP0 “192.168.206.10”)  Set IP address (deprecated)
(NET+DLP0?) (NET+DLP0! “192.168.206.10 ”) Query IP address (deprecated)
cinema projector Configuration File (PCF) 
Set cinema projector Configuration File (PCF) file for the  specified channel. This file is used to configure many 
aspects of the cinema electronics . It will only be used if PCF in use (PIU) control is set.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel num ber. Valid range is 101 - 164.
NONE Select PCF file for the current channel.
EXAMPLES:
(PCF+C108 “SCOPE 2.39”) Use PCF  file “Scope 2.39” on channel 108. File used when PIU is on
(PCF?L) List all entries of PCF control
Pureformity Color Technology (PCT) 
Sets or returns the Pureformity Color Technology (PCT) fo rmat file which implements color correction on the cin-
ema projector.
SUBCODEDESCRIPTION OF USE
Cxxx Select the PCT file for th e specified channel. Replac e xxx with the channel number.
NONE Select or return the PCT file for the acti ve channel using the index or file name.
NFLT Return a list of all PCT files in the ICP. Does not filt er out files that are not available for use on the cinema 
projector. This sub-code onl y supports list queries (?L).
EXAMPLES:
(PCT+C108 ?) Get the current PCT file for channel 108.
(PCT?) Get the current active PCT file.
(PCT  PCT file name) Select the specified PCT file by name for the active channel.
(PCT 2) Select the specified PCT  file by index for the active channel.
(PCT +C108 PCT file name) Select the specified PCT file by  name for channel 108.
(PCT +C108 2) Select the specified  PCT file by index for channel 108.
(PCT?L ) List all available entries of PCT  files. Only lists files that are available for use on the cinema projector. For exam ple, 
on a 4K cinema projector, onl y 4K PCT files are listed.
(PCT+NFLT?L) List all PCT files.  Lists all files regardless of whether they are available for use  on the cinema projector or not.
Network (NET) (Continued) 
						

							B-20CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
PCT In Use (PCU)
Sets or returns PCT In Use and enables or disables PCT for the active or selected channel.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel number. Vali d Range is 101 - 164 0-disabled 1-enabled.
NONE Select PCU for the current ch annel. 0-disabled 1-enabled.
EXAMPLES:
(SIU?) Get current value for PCU In Use for the activ e channel. Returns 1 for enabled or 0 if disabled.
(SIU 1) Set PCU In Use on active channel.
(SIU+C101 ?) Get PCU In Use on channel 101.
(SIU+C101 1) Set PCU In Use on channel 101.
PCF In Use (PIU)
Select whether to use the PCF file or not.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel  number. Valid range is 101 - 164.
NONE Select “Use PCF” for the current channel
EXAMPLES:
(PIU?) Get the current status of PCF file
(PIU+C108 1) Use PCF file on channel 108
(PIU+C108 0) Do not use PCF file on channel 108
Ping (PNG)
This command returns basic cinema projector information to the user which includes the type of device & main 
software version. Note that some devi ces have multiple CPUs each with its own software version. Only the soft-
ware version of what is considered to  be the master CPU is returned here. The return parameters are: Type, Major, 
Minor, and Beta. The beta value is optional meaning it is an engineering build and has not been validated. 
NOTE : 
List of devices: 
40 = ACT, 
41 = CP2000-ZX, 
42 = CP2000-M, 
46 = CP4230/CP4230/CP4230, 
48 = MCB/IMCB, 
49 = EVB
SUBCODEDESCRIPTION OF USE
NONE None
EXAMPLES:
(PNG?)(PNG!46 001 000 234) -- Indicates ‘Cinem a’ type, software: 1 major, 0 minor, 234 beta
Power on Signature Test (PST)
Enable the ICP Power on Signature Test. To enable this command, restart the cinema projector.
EXAMPLES:
(PST 1) Set Power on Signature Test to enabled 
						

							Appendix B: Serial API
CP2230 User ManualB-21020-100430-07 Rev. 1 (05-2014)
Power (PWR)
Change the power state of the cinema projector. Data can be: 
3 - Power OFF - all electronics power OFF except cinema projector Contro l Module (PCM). Its also called 
Standby mode. 
1 - Power ON - cinema projector is powered ON with lamp ON. 
0 - Full power mode - cinema projector is ready for lamp ON. 
11 - Warm up. Read only, its middle status between standby and full power mode. 
10 - Cool down. Read only, cinema projector will stay in cooling down mode for 15 minute after lamp is turned 
OFF.
SUBCODEDESCRIPTION OF USE
COOL Status of current cooling dow n timer. Read only command.
NONE Select power state.
STAT Status of current power state. Read only command.
EXAMPLES:
(PWR+STAT?) - Get cinema projector power status 
(PWR+COOL?) - Get how many seconds left on cooling down mode
(PWR3) - Set the cinema projector to standby mode 
(PWR0) - Turn the cinema  projector ON and lamp OFF 
(PWR1) - Turn the cinema  projector ON and lamp ON 
(PWR?) - Get the target power state  from the latest command sent to the cinema projector. Target power state.
For cinema projector power states, refer to  Ta b l e  3 . 1.
Remote Access Level (RAL)
Set the remote serial protocol access le vel for a serial communications port. Valid sections are 
0 - No Access, 
1 - Login Required, 
2 - Free Access. 
Default value is 1 - Login required.
SUBCODEDESCRIPTION OF USE
NONE Set the access level on Ethernet all ports.
PRTA Set the access level on RS232 port A.
EXAMPLES:
(RAL 0) Disable remote serial pr otocol access for all Ethernet ports
(RAL?) Get access level for Ethernet ports (RAL!0)
(RAL+PRTA 2) Set remote serial protocol access le vel on port A to free access
(RAL+PRTA?) Ge t access level (RAL+PRTA!2) 
Reboot TPC (RBT)
Command for rebooting the  TPC, requires argument 3.
SUBCODEDESCRIPTION OF USE
NONE Reboot TPC, use 3 as argument  other arguments have no effect. 
						

							B-22CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
Restore Whole or Part of a Backup (RST)
Restore files from a backup file.
SUBCODEDESCRIPTION OF USE
CHAN Restore only channel settings.
CONF Restore only configuration settings.
FULL Restore all settings including channe l, config, preferences, and user.
ICPF Restore only ICP files. Th e cinema projector must be in power up mode.
LIST List backup files in the FTP root that can be used with restore.
PREF Restore only preferences.
STAT Get status of last restore command.
USER Restore only users.
EXAMPLES:
(RST+LIST?) Print a list of  existing backup files that can be used for restore
(RST+CHAN 7) Restore channel in formation from the backup file with index  7 from the list displayed by the command above
(RST+FULL Solaria.20110201153514.Backup) Complete a full restore from the file  specified (must be in power up mode)
(RST+USER E:/ Solaria.20110309211519.Backup) Restore user information from a  backup file located on a USB stick 
NOTE: Use forward slashes as path separators.
 (RST+STAT?) Check the status  of last restore operation
Screen Format (SCF)
S
elect Screen format file which describe s the geometry for the output image. 
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel  number. Valid range is 101 - 164.
NONE Select screen file for the current channel.
EXAMPLES:
(SCF+C108 “FLAT”) Use fi le “FLAT” on channel 108
(SCF+C108?) Get screen  file name on channel 108
(SCF?L) List all available entries of screen control
Schedule (SCH)
Schedule a power up or a power down at a specific time.
SUBCODEDESCRIPTION OF USE
BPON Bypass power on scheduling.  1 = enable, 0 = disable
BPOF Bypass power off scheduling. 1 = enable, 0 = disable 
						

							Appendix B: Serial API
CP2230 User ManualB-23020-100430-07 Rev. 1 (05-2014)
PONDSet the power on date and time, setting the date/time to  empty (“”) will turn off power on scheduling until 
a new date/time has been set.  Format “yyyy-mm-dd hh:mm”
POFD Set the power off date and time, setting the date/time to  empty (“”) will turn off power off scheduling until 
a new date/time has been set.  Format “yyyy-mm-dd hh:mm”
EXAMPLES:
(SC+BPON 1) Disable power on scheduling  events, it will still be possible to set the time but no event will occur.
(SC+POFD “2011-07-11 23:00”) Schedule a power off event at 11pm on 11 July, 2011
(SC+POND “”) Set the power on event to no time - no event will  be scheduled, if one was scheduled before it is removed. 
(SC+BPOF?) Query the current se tting for bypass power off events.
Scan Type (SCN)
Select the Scan Type, such as progressive or interlaced video content, for a particular channel.
SUBCODEDESCRIPTION OF USE
Cxxx Replace xxx with the channel number. Valid Range is 101 - 164.
NONE Select scan type for the current channel.
EXAMPLES:
(SCN+C108  Progressive) Use a Progressive scan on channel 108 
(SCN+C108?) Get the scan type for channel 108 
(SCN?L) List all available Scan types
Shutter/Douser (SHU)
Open/Close shutter/douser
SUBCODEDESCRIPTION OF USE
NONE Select douser position 0 - dous er removed from optical path 1 - douser blocking optical path
STEP The number of steps the douser should be moved  when opening/closing (default 60, minimum 30, maxi-
mum 200)
EXAMPLES:
(SHU 1) Close shutter
(SHU 0) Open shutter
(SHU?) Get current status of shutter
(SHU+STEP?) Get number of steps  douser should move to open/close
Select Input (SIN)
Selecting input port will reset the list and default data of DTF control. Use index number or text description to 
select input port. Available options are: 
“Auto-select”, 
“292-A”, 
“292-B”, 
“292-Dual”, 
“DVI-A”, 
“DVI-B”,
“DVI-Dual/Twin”
SUBCODEDESCRIPTION OF USE 
						

							B-24CP2230 User Manual020-100430-07 Rev. 1 (05-2014)
Appendix B: Serial API
CxxxReplace xxx with the channel  number. Valid range is 101 - 164.
NONE Select input for current channel
EXAMPLES:
(SIN?) Get current input port
(SIN?L) Show entries on the list
(SIN 1) Set current input port to entry with index 1
(SIN+C101 ?) Get input port on channel 101
(SIN+C101 1) Set input on channel 101
SNMP Agent Configuration (SNM)
This control will set the various configuration options for SNMP Agent
SUBCODEDESCRIPTION OF USE
ENVT Enables/Disables SNMP vers ion 2 and enables version 3
LEXT Gets/sets the Lamp Expire Trap Flag for the SNMP Agent
LHLT Gets/sets the Lamp Half Life Trap Flag for the SNMP Agent
TSIP Sets the Trap IP address for the SNMP agent
EXAMPLES:
(SNM+TSIP “xxx.xxx. xxx.xxx”) Sets the Trap IP address to xxx.xxx.xxx.xxx
(SNM+TSIP “0.0.0.0”) Setting the IP  address to 0.0.0.0 will stop SNMP Agent from sending the traps.
(SNM+LHLT 1) Setting this flag to 1 will  disable any future lamp half life traps 
(SNM+LEXT 1) Setting this flag to 1 will  disable any future lamp expire traps 
(SNM+ENVT ?) Get the flag to see if V2 is enabled (1) or disabled (0)
(SNM+ENVT 1) Enable SNMP V2
(SNM+ENVT 0) Disable SNMP V2
Screen Orientation (SOR)
Set screen orientation. This allows for flipping the screen  orientation to allow for various mounting options of the 
cinema projector including the use of mirr ors and front or rear screen projection.
SUBCODEDESCRIPTION OF USE
NONE Select Orientation:
0 - Normal Front, 
1 - Inverted Rear, 
2 - Normal Rear, 
3- Inverted Front
EXAMPLES:
(SOR?L) List orie ntation options 
(SOR?) Get the orientation status 
(SOR0) Set orientation to front
Select Source Format (SRF)
S
elect the Source format file.
SUBCODEDESCRIPTION OF USE