Digital Projection Lightning 30sx+m, 40sx+m User Manual

							page 6.11       105-681B January 2007
Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual 6. Appendix
Using Windows Hyperterminal to connect to the projector
Many features of the projector can be controlled remotely by sending ascii character
strings to the serial control input, or via a LAN, using the protocol and syntax
described in the following pages.
If you are using a PC running Windows 95, 98, Me, NT, 2000 or XP, you can send
the control codes using Windows Hyperterminal. This can usually be found in:
Start → All  Programs → Accessories → Communications → Hyperterminal:
In File → Properties, set the connection either to your serial link or LAN connection.
For a serial connection, use the settings detailed on the previous page. For a LAN
connection, connect to the server using port number 7000.
In File → Properties → Settings → Ascii Setup, set the sending and receiving
characters as shown below:
Commands can be sent to the projector simply by typing in the Hyperterminal
window. Replies will also be seen in the window.
Notes
For a full description of all the
Control codes available, see the
Lightning Remote
Communications Protocol, on
the following pages.
Details of how to connect to the
projector, using the serial
control input or via a LAN, can
be found earlier in this section. 
						

							page 6.12       105-681B January 2007
6. Appendix Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual
Remote communications protocol
Version 1.2 Patch A
Each command string sent to the projector should start with character 0x0a and end
with character 0x0d. If you are using Windows Hyperterminal, then this will be taken
care of by the Ascii Setup described on the previous page.
Prefix each command with:
 [id],[user],[time],[date],[command priority],[projector id],[projector name],
for example:
1234,external,16:37:31,01/04/2004,5,543210,DPL-123,
example lens command (close shutter)
1234,external,15:20:25,14/10/2004,5,543210,DPL-123,lens,move,write,s,c,0,0
example lens command (open shutter)
1234,external,15:20:30,14/10/2004,5,543210,DPL-123,lens,move,write,s,o,0,0
Image commands
Image Brightness
Used to set and query image brightness (lift) levels.
CALL : image,brightness,write,r,[level],g,[level],b,[level],o,[level],a,[mode]
: Where [level] is -0.5 to 0.5 in steps of 0.001
: and [mode] is either on or off
: o is overall level - only valid if a is set to off.
: a is auto level control.
RETURNS : [msg id],ACK,brightness,r,[level],g,[level],b,[level],o,[level],a,[mode]
: OR
: [msg id],NAK,brightness
CALL : image,brightness,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],brightness,[r level],[g level],[b level],[o level],[a mode]
: OR
: [msg id],NAK,brightness
Notes
Details of how to connect to the
projector, using the serial
control input or via a LAN, can
be found earlier in this section. 
						

							page 6.13       105-681B January 2007
Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual 6. Appendix
Image Contrast
Used to set and query image contrast (gain) levels.
CALL : image,contrast,write,r,[r level],g,[g level],b,[b level],o,[level],a,[mode]
: Where [level] is 0.0 to 2.0 in steps of 0.001
: and [mode] is either on or off
: o is overall level - only valid if a is set to off.
: a is auto level control.
RETURNS : [msg id],ACK,contrast,r,[r level],g,[g level],b,[b
level],o,[level],a,[mode]
: OR
: [msg id],NAK,contrast
CALL : image,contrast,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],contrast,[r level],[g level],[b level],[o level],[a mode]
: OR
: [msg id],NAK,contrast
Image Projection Mode
Used to set and query image projection mode.
CALL : image,projectionmode,write,[mode]
: Where [mode] is one of curtain, testpattern or normal
RETURNS : [msg id],ACK,projectionmode,[mode]
: OR
: [msg id],NAK,projectionmode
CALL : image,projectionmode,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],projectionmode,[mode]
: OR
: [msg id],NAK,projectionmode
Notes 
						

							page 6.14       105-681B January 2007
6. Appendix Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual
Image Orientation
Used to set and query image orientation.
CALL : image,imageorient,write,[orient]
: Where [orient] is one of normal, nsflip, ewflip or newsflip
RETURNS : [msg id],ACK,imageorient,[orient]
: OR
: [msg id],NAK,imageorient
CALL : image,imageorient,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],imageorient,[orient]
: OR
: [msg id],NAK,imageorient
Image Mirror Park
Used to set and query mirror park.
CALL : image,mirrorpark,write,[mode]
: Where [mode] is one of park or release
RETURNS : [msg id],ACK,mirrorpark,[orient]
: OR
: [msg id],NAK,mirrorpark
CALL : image,mirrorpark,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],mirrorpark,[mode]
: OR
: [msg id],NAK,mirrorpark
Notes 
						

							page 6.15       105-681B January 2007
Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual 6. Appendix
Image Colour Temperature Gain
Used to set and query image colour temperature levels.
CALL : image,colourtempgain,write,r,[r level],g,[g level],b,[b level]
: Where [level] is 0.0 to 2.0 in steps of 0.001
RETURNS : [msg id],ACK,colourtempgain,r,[r level],g,[g level],b,[b level]
: OR
: [msg id],NAK,colourtempgain
CALL : image,colourtempgain,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],colourtempgain,[r level],[g level],[b level]
: OR
: [msg id],NAK,colourtempgain
Input Image Size
Used to set and query image input size.
CALL : image,inputimagesize,write,c,[cols],r,[rows]
: Where [cols] is the number of pixels range 640 to DMD size
: and [rows] is the number of lines range 480 to DMD size.
RETURNS : [msg id],ACK,inputimagesize,c,[cols],r,[rows]
: OR
: [msg id],NAK,inputimagesize
CALL : image,inputimagesize,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],ACK,inputimagesize,[cols],[rows]
: OR
: [msg id],NAK,inputimagesize
Notes 
						

							page 6.16       105-681B January 2007
6. Appendix Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual
Input Image Window Size
Used to set and query image input window size.
CALL : image,inputimagewindow,write,c,[cols],r,[rows]
: Where [cols] is the number of pixels range 640 to DMD size
: and [rows] is the number of lines range 480 to DMD size.
RETURNS : [msg id],ACK,inputimagewindow,c,[cols],r,[rows]
: OR
: [msg id],NAK,inputimagewindow
CALL : image,inputimagewindow,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],ACK,inputimagewindow,[cols],[rows]
: OR
: [msg id],NAK,inputimagewindow
Image Position
Used to set and query image position.
CALL : image,imageposition,write,c,[cols offset],r,[rows offset]
: Where [cols] is the number of pixels offset from centre
: and [rows] is the number of lines offset from centre.
: Positive values move the image down and right and negative move
: the image up and left.
RETURNS : [msg id],ACK,imageposition,c,[cols offset],r,[rows offset]
: OR
: [msg id],NAK,imageposition
CALL : image,imageposition,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],ACK,imageposition,[cols offset],[rows offset]
: OR
: [msg id],NAK,imageposition
Notes 
						

							page 6.17       105-681B January 2007
Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual 6. Appendix
Input Capture Offset
Used to set and query image capture offset.
CALL : image,inputcaptureoffset,write,c,[cols offset],r,[rows offset]
: Where [cols] is the number of pixels offset from centre
: and [rows] is the number of lines offset from centre.
: Positive values move the image down and right and negative move
the image up and left.
RETURNS : [msg id],ACK,inputcaptureoffset,c,[cols offset],r,[rows offset]
: OR
: [msg id],NAK,inputcaptureoffset
CALL : image,inputcaptureoffset,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],ACK,inputcaptureoffset,[cols offset],[rows offset]
: OR
: [msg id],NAK,inputcaptureoffset
Notes 
						

							page 6.18       105-681B January 2007
6. Appendix Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual
Test Patterns
Used to set and query test patterns.
CALL : image,testpattern,write,[pattern name][vertical rate]
: Where [pattern name] is one of:
: black        - Full Screen Black
: white        - Full Screen White
: green        - Full Screen Green
: red          - Full Screen Red
: blue         - Full Screen Blue
: checker      - ANSI Checkerboard
: align        - Alignment Pattern
: h_ramp       - Horizontal Ramp
: v_ramp       - Vertical Ramp
: max_lumens   - Native White
: native_white - Native White
: off          - Normal Picture
: and [vertical rate] is 60.
RETURNS : [msg id],ACK,testpattern,[pattern name][vertical rate]
: OR
: [msg id],NAK,testpattern
CALL : image,testpattern,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],testpattern,[pattern name][vertical rate]
: OR
: [msg id],NAK,testpattern
Notes 
						

							page 6.19       105-681B January 2007
Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual 6. Appendix
Degamma Table Select
Used to set and query degamma table settings.
CALL : image,degammaselect,write,[table no.][parametric]
: Where [table no.] is one of:
: 0   - Graphics/NTSC
: 1   - Graphics Enhanced
: 2   - NTSC Enhanced
: 3   - PAL/SECAM 2.8
: 4   - PAL/SECAM Enhanced
: 5   - Linear
:
: 255 - use parametric value:
:
: and [parametric] is in the range 0.01 to 4.0 in steps of 0.0001
RETURNS : [msg id],ACK,degammaselect,[table no.][parametric]
: OR
: [msg id],NAK,degammaselect
CALL : image,degammaselect,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],degammaselect,[table no.][parametric]
: OR
: [msg id],NAK,degammaselect
Notes 
						

							page 6.20       105-681B January 2007
6. Appendix Digital Projection LIGHTNING 30sx+m, 40sx+m User Manual
Picture Mute
Used to set and query picture mute.
CALL : image,picmute,write,[mode]
: Where [mode] is one of on or off
RETURNS : [msg id],ACK,picmute,[mode]
: OR
: [msg id],NAK,picmute
CALL : image,picmute,read,[urgency switch]
NOTE : Urgency switch is currently ignored (can be set to 0).
RETURNS : [msg id],picmute,[mode]
: OR
: [msg id],NAK,picmute
Notes