Plugin Description
The Epson Projector Q-SYS Plugin provides seamless integration and control of Epson projectors within the Q-SYS ecosystem. This plugin enables AV integrators and professionals to monitor and control an Epson projector directly from the Q-SYS environment via either a TCP/IP network connection or RS-232C serial connection.
By leveraging this plugin, Q-SYS users gain centralized control over power management, input selection, volume, audio mute, AV mute, image freeze, brightness settings, and comprehensive status monitoring. The plugin streamlines workflow efficiency by providing real-time device feedback and essential configuration controls within the familiar Q-SYS environment.
Key features
Power Management - Complete power control with toggle button, discrete power on/off triggers, and detailed power status monitoring including standby, warmup, cool down, and active states.
Input Selection - Flexible input management with a dynamic combo box for current input selection, per-input select buttons, and individual signal presence indicators for each configurable input.
Volume Control - Full audio volume management with a fader, dedicated up/down momentary buttons, and audio mute toggle.
AV Mute & Freeze - One-touch AV mute and image freeze controls for presentation management.
Brightness Control - Optional brightness management including brightness mode selection, brightness level fader, and constant brightness toggle (when enabled via property).
Menu Navigation - On-screen display navigation with Menu, ESC, OK, and directional arrow buttons for remote projector menu access.
Device Information Display - Automatic retrieval and display of device serial number, total operation time, and lamp/laser operation time.
Dual Connection Support - Supports both TCP/IP (Network) and RS-232C serial connections, adapting the setup interface accordingly.
Status Monitoring - Real-time connection status indicator showing connected, reconnecting, timeout, wrong password, and error states.
Use cases
Corporate boardroom and conference room AV control
Higher education lecture halls and classrooms
Digital cinema and screening room management
Houses of worship and event venue presentation control
Any Q-SYS deployment requiring centralized projector control
Configuration Overview
Plugin version
This document is written for the plugin :
Epson Projector V1.1.0.0
Release note
2026-05 : V1.1.0.0
Initial release to Q-SYS Library
2025-04 : V 1.1.0.0
Added password control
2025-02 : V 1.0.2.0
Corrected Power Status for: A/V standby / USB power standby
2024-10 : V 1.0.1.0
Correct an error that prevents some commands from being polled
2024-06 : V 1.0.0.0
Initial Release
QDS compatibility
This plugin has been developed and tested on :
Q-SYS Designer version 9.13.1 / 10.0.x / 10.1.x / 10.2.0 and 10.2.1
Properties
Connection Type
Type: Enum
Choices: TCP/IP (Network), RS-232C
Default Value: TCP/IP (Network)
Description: Selects the communication interface used to connect to the projector. When TCP/IP (Network) is selected, the Setup page will display IP Address and Password fields. When RS-232C is selected, those fields are hidden.
Poll Rate
Type: Integer
Min: 5
Max: 60
Default Value: 5
Description: Sets the polling interval in seconds. The plugin queries the projector status at this rate to keep controls synchronized with the device state.
Number of Inputs
Type: Integer
Min: 2
Max: 25
Default Value: 8
Description: Defines the number of input channels displayed in the Control page. Each input receives its own Name indicator, Select button, and Status LED.
Brightness Controls
Type: Boolean
Default Value: Yes
Description: When enabled, the Settings page displays additional brightness controls including Brightness Mode selection, Brightness fader, and Constant Brightness toggle. Disable this property if the connected projector model does not support brightness adjustment.
Debug Print
Type: Enum
Choices: None, Tx/Rx, Tx, Rx, Function Calls, All
Default Value: None
Description: Controls debug output for troubleshooting purposes. Set to Tx/Rx or All to log communication between the plugin and the projector in the Q-SYS Debug output.
Controls
Status
Status
Controls name: Status
Type: Indicator-Status
Description: Indicates the current connection and operational status of the plugin.
OK - Connected : The plugin is connected and communicating with the projector normally.
OK - Input Count Mismatch : Connected, but the projector returned a different number of inputs than configured.
Missing - Disconnected : The plugin is not connected to the projector.
Missing - Reconnecting : The plugin is attempting to re-establish the connection.
Missing - Timeout : No response was received from the projector within the timeout period.
Missing - No IP Address : No IP address has been entered in the Setup page.
Missing - Password missing : TCP/IP connection requires a password but none has been entered.
Fault - Wrong password : The password entered does not match the projector's monitor password.
Missing - Socket error : A network socket error occurred.
Missing - Socket closed : The network connection was closed by the projector.
Missing - Serial port error : An RS-232C serial port error occurred.
Setup Page
Connect to Projector
IP Address
Controls name: IPAddress
Type: Text-Text Edit
Description: The IP address of the Epson projector on the network. Visible only when Connection Type is set to TCP/IP (Network).
Password
Controls name: Password
Type: Text-Text Edit
Description: The monitor password configured on the Epson projector for network communication. Visible only when Connection Type is set to TCP/IP (Network).
Information
Serial Number
Controls name: SerialNumber
Type: Indicator-Text
Description: Displays the serial number of the connected projector, retrieved automatically upon connection.
Operation Time
Controls name: OperationTime
Type: Indicator-Text
Description: Displays the total cumulative operation time of the projector (in hours).
Lamp/Laser Operation Time
Controls name: Lamp
Type: Indicator-Text
Description: Displays the accumulated lamp or laser operation time (in hours), useful for maintenance scheduling.
Control Page
Projector Section
Power
Controls name: Power
Type: Button-Toggle
Description: Toggle button used to turn the projector power on or off. The button is lit when the projector is powered on (power state 1, 2, or 3).
Power On
Controls name: PowerOn
Type: Button-Trigger
Description: One-shot trigger button for turning the projector power on. Sends a discrete power-on command to the projector.
Power Off
Controls name: PowerOff
Type: Button-Trigger
Description: One-shot trigger button for turning the projector power off. Sends a discrete power-off command to the projector.
Power Status Led
Controls name: PowerStatusLed
Type: Indicator-Led
Description: LED indicator showing the current power state of the projector. Lit when the projector is in an active power state (warming up, on, or cooling down).
Power Status
Controls name: PowerStatus
Type: Indicator-Text
Description: Displays the detailed power status string returned by the projector. Possible values include: Standby Mode (Network OFF), Laser ON, Warmup, Cool down, Standby Mode (Network ON), Abnormality standby, or A/V standby / USB power standby.
Volume Section
Volume Down
Controls name: VolumeDown
Type: Button-Momentary
Description: Press-and-hold button that continuously decrements the projector volume while held.
Volume
Controls name: Volume
Type: Knob-Integer
Min: 0
Max: 255
Description: Fader control for setting the projector audio volume level directly to a value between 0 and 255.
Volume Up
Controls name: VolumeUp
Type: Button-Momentary
Description: Press-and-hold button that continuously increments the projector volume while held.
Audio Mute
Controls name: AudioMute
Type: Button-Toggle
Description: Toggle button to enable or disable audio mute on the projector. When active (true), the projector audio output is muted.
Input Section
Current Input
Controls name: CurrentInput
Type: Text-ComboBox
Description: Dropdown combo box displaying the currently active input source. The list is populated dynamically from the projector's available input list. Select a value to switch the active input.
Current Input Signal
Controls name: CurrentInputSignal
Type: Indicator-Led
Description: LED indicator that lights when a valid signal is detected on the currently active input.
Input X Name
Controls name: InputName X
Type: Indicator-Text
Description: Displays the name of input X as reported by the projector. The number of inputs shown is determined by the Number of Inputs property (repeated for each input 1 through N).
Input X Select
Controls name: InputSelect X
Type: Button-Toggle
Description: Toggle button to select input X as the active source. Lights when input X is the currently active input (repeated for each input 1 through N).
Input X Status
Controls name: InputStatus X
Type: Indicator-Led
Description: LED indicator that lights when input X is the currently active source on the projector (repeated for each input 1 through N).
Settings Page
Brightness & Mutes Section
AV Mute
Controls name: AVMute
Type: Button-Toggle
Description: Toggle button to enable or disable AV mute on the projector. When active, both the audio and video outputs are blanked simultaneously.
Freeze
Controls name: Freeze
Type: Button-Toggle
Description: Toggle button to freeze the current projected image. When active, the displayed image is held static while the input signal continues.
Brightness Section (visible when Brightness Controls property is enabled)
Brightness Mode
Controls name: BrightnessMode
Type: Text-ComboBox
Description: Dropdown combo box for selecting the projector brightness mode. Possible values include: Normal, Quiet/Eco, Medium, Auto, Extended, and Custom (availability depends on the projector model).
Brightness Fader
Controls name: Brightness
Type: Knob-Integer
Min: 0
Max: 255
Description: Fader control for adjusting the projector brightness level directly, from 0 (minimum) to 255 (maximum).
Brightness Constant
Controls name: BrightnessConstant
Type: Button-Toggle
Description: Toggle button to enable or disable the constant brightness mode on the projector, maintaining consistent light output over the lamp/laser life.
Menu Section
Key Menu
Controls name: NavMenu
Type: Button-Trigger
Description: Trigger button that sends the Menu key command to the projector, opening or closing the on-screen display menu.
Settings Key ESC
Controls name: NavEsc
Type: Button-Trigger
Description: Trigger button that sends the ESC key command to the projector, navigating back or cancelling the current menu action.
Settings Key Ok
Controls name: NavOk
Type: Button-Trigger
Description: Trigger button that sends the OK/Enter key command to the projector, confirming the currently highlighted menu option.
Settings Key Up
Controls name: NavUp
Type: Button-Momentary
Description: Press-and-hold button that sends repeated Up navigation commands to the projector on-screen menu.
Settings Key Down
Controls name: NavDown
Type: Button-Momentary
Description: Press-and-hold button that sends repeated Down navigation commands to the projector on-screen menu.
Settings Key Left
Controls name: NavLeft
Type: Button-Momentary
Description: Press-and-hold button that sends repeated Left navigation commands to the projector on-screen menu.
Settings Key Right
Controls name: NavRight
Type: Button-Momentary
Description: Press-and-hold button that sends repeated Right navigation commands to the projector on-screen menu.
Control Pins
PIN NAME | VALUE | STRING | POSITION | PINS AVAILABLE |
|---|---|---|---|---|
Status | - | - | - | - |
Status |
|
| - | Output |
Setup | - | - | - | - |
IP Address | - |
| - | Input / Output |
Password | - |
| - | Input / Output |
Serial Number | - |
| - | Output |
Operation Time | - |
| - | Output |
Lamp/Laser Operation Time | - |
| - | Output |
Control — Power | - | - | - | - |
Power |
|
|
| Input / Output |
Power On |
| - | - | Input / Output |
Power Off |
| - | - | Input / Output |
Power Status Led |
|
|
| Output |
Power Status | - |
| - | Output |
Control — Volume | - | - | - | - |
Volume Down |
| - | - | Input / Output |
Volume |
|
|
| Input / Output |
Volume Up |
| - | - | Input / Output |
Audio Mute |
|
|
| Input / Output |
Control — Input | - | - | - | - |
Current Input | - |
| - | Input / Output |
Current Input Signal |
|
|
| Output |
Input X Name | - |
| - | Output |
Input X Select |
|
|
| Input / Output |
Input X Status |
|
|
| Output |
Input X Name | - |
| - | Output |
Input X Select |
|
|
| Input / Output |
Input X Status |
|
|
| Output |
Settings | - | - | - | - |
AV Mute |
|
|
| Input / Output |
Freeze |
|
|
| Input / Output |
Brightness Mode | - |
| - | Input / Output |
Brightness Fader |
|
|
| Input / Output |
Brightness Constant |
|
|
| Input / Output |
Settings — Menu | - | - | - | - |
Key Menu |
| - | - | Input / Output |
Key ESC |
| - | - | Input / Output |
Key Ok |
| - | - | Input / Output |
Key Up |
| - | - | Input / Output |
Key Down |
| - | - | Input / Output |
Key Left |
| - | - | Input / Output |
Key Right |
| - | - | Input / Output |
support@ad-da.ca | Copyright © 2026 AD-DA.CA