User manual INFOCUS LP820 Document

[. . . ] Command Line Interface on the LP820 Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Message Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Write Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] 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. 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). 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. The command table indicates the commands and requests that are supported. Write Commands Write commands have the following format: (AAA####) where, ( AAA #### ) - starts the CLI command - 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. 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. 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 Volume Command Freeze Command Freeze Command Power Command Power Command Power Command (BRT10) (VOL0000) (FRZ1) (FRZ9999) (PWR0) (PWR1) (PWR9999) Sets the brightness to 10 Set the volume to 0 Freeze the display Freeze the display Turn power off Turn power on Command not recognized 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 Brightness Command (BRT+10) (BRT+) Increment brightness 10 steps Increment brightness 1 step Decrement Commands Increment commands have the following format: (AAA-####) where, ( AAA #### ) . Examples: Brightness Command Brightness Command (BRT-10) (BRT-) Decrement brightness 10 steps Decrement brightness 1 step - starts the CLI command - 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 Read Commands Read commands have the following format: (AAA?) where, ( AAA ?) - starts the CLI command - 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) Range Format: (r-R, V) Where ( r R V ) Examples: (VOL?) (BRT?) Read the current range and value of the projector's volume Returns: (0-127, 64) Read the current range and value of the projector's brightness Returns: (0-255, 128) open parenthesis marks the start of the CLI response minimum value of the setting's range maximum value of the setting's range the current value of the setting closing parenthesis marks the end of the CLI response String Format: (S) Where ( S ) Examples: (VER?) Read the current software version Returns: (v2. 0) open parenthesis marks the start of the CLI response character string closing parenthesis marks the end of the CLI response 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?) (VOL ?) "123" is not a valid CLI command prefix. This read request will return `?' "VOL" is a valid CLI command prefix, but the spaces between the prefix and the question mark character invalidates the command. [. . . ] Windows HyperTerminal or ProComm are two tools that can be used to send CLI commands across the serial port. Setting Bits per second Data bits Parity Stop bits Flow Control Table 1 Configuration Value 19200 8 None 1 None TABLE OF END USER COMMANDS NA = Not Available, Src. dep = Source depended use a read request with ?to get current supported range. Function Power Rear Ceiling Display Message Power Save Auto Power Enable Low Power Enable Screen Saver Blank Screen Blank Screen Color Command PWR REA CEL DMG PSV APO LPE SSV BLK BSC Attribute R&W Range 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­1 0 ­ Off 1 ­ On 0­2 0 ­ black 1 ­ blue 2 ­ white 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 ­ 11 0 ­ English 1 ­ French 2 ­ German 3 ­ Spanish 4 ­ Chinese Traditional 5 ­ Japanese 6 ­ Korean 7 ­ Portuguese 8 ­ Russian 9 ­ Norwegian 10 ­ Chinese Simplified 11 ­ Italian 0­1 0 ­ disable 1 ­ enable 0­4 0 ­ up 1 ­ down 4 ­ select ? [. . . ]