InFocus LASER PROJECTOR LP 540 User manual

LP540 / LP640 CLI

1COMMAND LINE INTERFACE .............................................................. 3
1.1.1 Purpose ............................................................................................ 3
1.1.2 Message Format................................................................................. 3
1.1.3 Write Commands ............................................................................... 3
1.1.4 Increment Commands ........................................................................ 4
1.1.5 Decrement Commands........................................................................ 4
1.1.6 Read Commands ................................................................................ 5
1.1.7 Error Handling ................................................................................... 6
1.1.8 Limitations ........................................................................................ 7
2SERIAL COMMUNICATIONS CONFIGURATION ................................... 8
3TABLE OF COMMANDS ....................................................................... 8

1COMMAND LINE INTERFACE
1.1.1 Purpose
This specification defines the serial command line streams for controlling
an InFocus projector through the RS232 connector to the projector.
These commands are intended to provide a simple set of controls to the
projector through what InFocus calls the Command Line Interface (CLI).
The CLI is designed for use by what the industry commonly calls
boardroom controllers. The CLI will accept commands via RS232 to
control the necessary features used by most boardroom controllers. This
CLI language uses a simple human readable protocol to help facilitate the
installers’ time necessary to setup or diagnose a problem with boardroom
control installations. However, the CLI is not a guaranteed delivery
system.
1.1.2 Message Format
As commonly used in math notation, everything is evaluated in the
parenthesis first, as the parentheses are designed to group things
together. This same parenthesis nomenclature is used to group a
command and its data together (nested parenthesis are not supported).
All commands are three alpha characters followed by the request. The
request can be a “?” symbol that signifies a read request, or a numerical
number represented by 1 to 4 ASCII digits, that signifies a write request.
Not all commands support reading and writing. The command table
indicates the commands and requests that are supported. There are also
support commands available on non CLI format.
1.1.3 Write Commands
Write commands have the following format:
(AAA####) where,
( - starts the CLI command
AAA - denotes the CLI function
#### - denotes the value to be written (leading zeros are
not necessary)
) - ends the CLI command
Some functions have ranges for settings while others are Boolean.
Settings with ranges range from zero to a maximum number. If a
number greater than the maximum is received, it is automatically limited
to the maximum number for that function. IT IS SUGGESTED THAT EACH

FUNCTION BE QUERIED FOR ITS RANGE WITH A READ COMMAND
BEFORE ISSUING A WRITE COMMAND. Boolean settings consider 0 as off
and 1-9999 as on. The only exception is the Power command. The only
valid write values that will be accepted will be ‘0’ for turning the power off
and ‘1’ for turning the power on.
Examples:
Brightness Command (BRT10) Sets the brightness to 10
Volume Command (VOL0000) Set the volume to 0
Freeze Command (FRZ1) Freeze the display
Freeze Command (FRZ9999) Freeze the display
Power Command (PWR0) Turn power off
Power Command (PWR1) Turn power on
Power Command (PWR9999) Command not recognized
1.1.4 Increment Commands
Increment commands have the following format:
(AAA+####) where,
( - starts the CLI command
AAA - denotes the CLI function
+ - denotes Increment command
#### - Is optional and denotes number of steps to be
incremented (leading zeros are not necessary)
) - ends the CLI command
Examples:
Brightness Command (BRT+10) Increment brightness 10 steps
Brightness Command (BRT+) Increment brightness 1
step
1.1.5 Decrement Commands
Increment commands have the following format:
(AAA-####) where,
( - starts the CLI command
AAA - denotes the CLI function
- - denotes decrement command
#### - Is optional and denotes number of steps to be
decrement (leading zeros are not necessary)
) - ends the CLI command

.
Examples:
Brightness Command (BRT-10) Decrement brightness 10 steps
Brightness Command (BRT-) Decrement brightness
1 step
1.1.6 Read Commands
Read commands have the following format:
(AAA?) where,
( - starts the CLI command
AAA - denotes the CLI function
? - denotes the read request
) - ends the CLI command
A read command returns the current setting in an ASCII format enclosed in
parentheses.
The following Format is defined:
1) Range Format (r-R,V)
2) String Format (S)
1.1.6.1 Range Format: (r-R,V)
where
( open parenthesis marks the start of the CLI
response
r minimum value of the setting’s range
R maximum value of the setting’s range
V the current value of the setting
) closing parenthesis marks the end of the CLI
response
Examples:

(VOL?) Read the current range and value of the
projector’s volume
Returns:(0-127,64)
(BRT?) Read the current range and value of the
projector’s brightness
Returns: (0-255,128)
1.1.6.2 String Format: (S)
where
( open parenthesis marks the start of the CLI
response
S character string
) closing parenthesis marks the end of the CLI
response
Examples:
(VER?) Read the current software version
Returns:(v2.0)
1.1.7 Error Handling
When the closing parenthesis is received, the command is validated
before it is processed. If the received command is determined to be
invalid, a question mark character will be returned as a error response.
Examples:
(123?) “123” is not a valid CLI command prefix. This read
request will return ‘?’
(VOL ?) “VOL” is a valid CLI command prefix, but the spaces
between the prefix and the
question mark character invalidates the command.
This read request will
return ‘?’.
Not all settings are readable. If an attempt is made to read from a write-
only setting, the projector will return a question mark.
Example:

(RST?) If the RST CLI command is write only, this read
request will return ‘?’.
A more descriptive error message on the errors can then be
queried with the (ERR?) command. The following message are
defined:
(No Error Detected)
(Unknown command)
(Unknown parameter)
(Command not supported by this projector)
(Command only available in Power on)
(Projector not ready to be turned on)
(Command only available with valid input source)
(Command only available with external module)
(Command failed)
(Write only Command)
(Command only available in RGB)
(Command only available in VIDEO)
(Command only available in NTSC)
1.1.8 Limitations
The CLI cannot respond to commands coming in at a high rate.
Therefore, a delay must occur between commands to ensure that the
command is properly executed before the next one is received.
The recommended approach for interfacing to the projector is:
Read:
1. Send the read command
2. Receive read response
Write
1. Send the write command
2. Verify that an error response ‘?’ was not received.
Continually query (for a predefined time) the setting until the value has
changed
Some settings don’t implement the full range of values in the setting’s defined range.
If an attempt is made to change the setting to an unsupported value, the CLI will
round down to the nearest supported value.
1.1.9 Help Commands

There are help commands available on non CLI format. The following non CLI
commands is available in plain text:
help - Prints help screen
cli AAA - Prints help information for the AAA command
cli cmds - Prints an alphabetical list of CLI commands
cli all - Prints the current value of all CLI settings
cli verbose on/off - Turns verbose on and off
1.1.10 Serial Communications Configuration
The following table describes the serial communication configuration that should be
used when interfacing to the CLI via the serial port. Windows HyperTerminal or
Procomm are two tools that can be used to send CLI commands across the serial
port.
Setting Value
Bits per second 19200
Data bits 8
Parity None
Stop bits 1
Flow Control None
Table 1 Configuration
2TABLE OF COMMANDS
All commands in the table may not be available for your current product. Run the
help command CLI ALL to get a list of supported commands.
Abbreviations:
NA = Not Available, Src.dep = Source depended use a read request with ? to get
current supported range.
Function Comm
and
Attrib
ute
Range Default
Power PWR
R & W 0 – 1
0 – Off
1 – On
0
Rear REA R & W 0 – 1
0 – Off
1 – On
0
Ceiling CEL R & W 0 – 1
0 – Off
1 – On
0
Auto ACL R & W 0 – 1 0

Ceiling 0 – Off
1 – On
Display
Message
DMG R & W 0 – 1
0 – Off
1 – On
1
Power Save PSV R & W 0 – 1
0 – Off
1 – On
1
Auto Power
Enable
APO R & W 0 – 1
0 – Off
1 – On
0
Low Power
Enable
LPE R & W 0 – 1
0 – Off
1 – On
0
Screen
Saver
SSV R & W 0 – 1
0 – Off
1 – On
0
Blank
Screen
BLK R & W 0 – 1
0 – Off
1 – On
0
Display
Startup
Logo
DSU R & W 0 – 2
0 – Default
1 – Blank
Screen
2 – Capture
0
Blank
Screen
Color
BSC R & W 0 – 2
0 – black
1 – blue
2 – white
0
Effect Key EFK R & W 0 – 10
0 – Blank
1 – Mute
2 – Mask
3 – Aspect
Ratio
4 – Source
5 – Auto
Image
6 – Freeze
7 – Zoom
8 – About
9 – PiP
10 – Screen
Trigger
0
Language LAN R & W 0 – 11
0 – English
1 – French
2 – German
0

3 – Spanish
4 – Chinese
Traditional
5 – Japanese
6 – Korean
7 –
Portuguese
8 – Russian
9 –
Norwegian
10 – Chinese
Simplified
11 – Italian
Menu
Enable
MNU R&W 0 – 1
0 – Off
1 – On
0
Menu
Navigation
NAV R&W 0 – 4
0 – up
1 – down
4 – select
NA
Error
Message
ERR R ? NA
Table 2 System Commands
Function Com
mand
Attribut
e
Range Default
Horizontal
Keystone
Correction
DKH R & W 0-100 50
Vertical
Keystone
Correction
DKV R & W 0-100 50
Auto Vertical
Keystone
AVK R&W 0 – 1
0 – Off
1 – On
0
Contrast CON R & W 0-100 50
Brightness BRT R & W 0-100 50
Color CLR R & W 0-100 50
Tint TNT R & W 0-100 50
Aspect ratio ARZ R & W 0–2
0 – native
1 – 16:9
2 – 4:3
0