Network PJLink Projector
Controls and monitors a network-enabled projector (or display) that supports the PJLink protocol, a vendor-independent control standard published by JBMIA. PJLink lets a single module drive projectors and displays from many different manufacturers (Epson, NEC, Panasonic, Sony, Christie, Barco, Sharp, BenQ, Ricoh, etc.) over TCP/IP.
The module implements PJLink Class 1 commands (power, input, mute, error and lamp status, projector identification) together with the Class 2 read-only queries (serial number, software version, input resolution, filter usage time) when the projector supports them. Both unauthenticated sessions and the legacy MD5 password authentication are supported.
The module polls the projector every 5 seconds to refresh all the status outlets and tolerates the projector closing the TCP connection after each command, which is the normal behavior of most PJLink implementations.
Settings
on
Activates or deactivates the module.
ip
IP address of the projector (e.g. 192.168.1.100). The standard PJLink TCP port 4352 is used.
password
Optional password used by the projector's authentication procedure. Leave empty if the projector's PJLink security is disabled. If a password is set, the module automatically performs the MD5 challenge/response handshake described in the PJLink specification.
connected
Sends 1 when the last poll cycle reached the projector successfully, 0 otherwise.
power
Switch that drives the projector's power state. Turning it ON sends POWR 1 (power-on); turning it OFF sends POWR 0 (standby). Note that the actual state of the projector is reported by the power status outlet — depending on the projector, several seconds of warm-up or cooling may follow before the new state is reached.
input class
Combobox selecting the family of input source : RGB, VIDEO, DIGITAL, STORAGE, NETWORK, INTERNAL. Changing it sends a new INPT command to the projector, combining the chosen class with the input num value.
input num
Integer (1 to 35) identifying the input within the selected class. Values 1–9 map to digits 1–9, values 10–35 map to letters A–Z. For example, input class = DIGITAL and input num = 1 selects HDMI1 on most projectors.
mute
Combobox : off, video, audio, both. Sends the corresponding AVMT command (30, 11, 21, 31).
freeze
Switch. When ON, sends FREZ 1 to freeze the projected image; OFF sends FREZ 0 to release the freeze. Only supported on Class 2 projectors.
speaker vol +
Button. Increases the projector's speaker volume by one step (SVOL 1).
speaker vol -
Button. Decreases the projector's speaker volume by one step (SVOL 0).
mic vol +
Button. Increases the microphone volume by one step (MVOL 1).
mic vol -
Button. Decreases the microphone volume by one step (MVOL 0).
refresh
Button. Forces an immediate refresh of all the status outlets without waiting for the next polling cycle.
power status
Read-only listbox reflecting the projector's actual power state : standby, on, cooling or warmup. Updated on every poll cycle from the POWR ? response.
lamp on
Read-only switch. Sends 1 when the projector reports its lamp as currently lit.
lamp hours
Read-only integer. Total cumulative usage time of the lamp, in hours.
filter hours
Read-only integer. Cumulative usage time of the air filter, in hours. Only supported on Class 2 projectors.
input current
Read-only integer giving the input source number currently selected on the projector (see input num above for the encoding).
class
Read-only integer reporting the PJLink class the projector advertises (1 or 2). Class 2 enables the additional outlets below.
err fan
err lamp
err temp
err cover
err filter
err other
Six read-only listboxes reporting the projector's individual error flags from the ERST ? response : ok, warning, or error.
name
Read-only text. Human-readable projector name set by the user on the projector itself (NAME ?).
manufacturer
Read-only text. Manufacturer name returned by INF1 ? (e.g. Epson, Panasonic).
product
Read-only text. Product/model name returned by INF2 ?.
other info
Read-only text. Free-form additional information returned by INFO ?.
serial
Read-only text. Projector serial number (SNUM ?, Class 2 only).
sw version
Read-only text. Firmware version reported by the projector (SVER ?, Class 2 only).
input resolution
Read-only text. Native resolution of the currently selected input, e.g. 1920x1080 (IRES ?, Class 2 only). Reports - when no signal is detected and * when the signal cannot be identified.
trace logs
When ON, every PJLink command sent and every line received from the projector is logged into the trace-panel, prefixed by PJLink TX> and PJLink RX< respectively. Connection, parsing and authentication errors are also logged. Useful for debugging integrations with unfamiliar projectors.
Common Settings
info
show manual
Button. Opens the manual page of the selected object (or of its parent module for a control) in the web browser. If no page exists for this object, an error is traced in the trace panel.
For more details about information/help creation, see create-help-file.
description
Free multi-line text attached to the module, saved with the patch. It is only meant as an internal note for the patch designer: it is not displayed in the interface.
ID's
visible only in god mode, see setup-panel-tab-expert.
unique ID
Read-only, not saved. Current private numeric ID of the object, used internally to identify it (for example as the target of a bind ID).
preset ID
Read-only, not saved. Private ID used to store and recall the values of this control in presets.
recreate ID
Button. Generates a new unique ID, original ID and preset ID for the object. Use it if you experience difficulties in Polyphonic mode or if two objects share the same ID. Preset values and binds referring to the old IDs are lost.
Object Remote Address
absolute
Read-only, not saved. Absolute address of the object in the Usine objects tree, built from the workspace root. This is the address to use to reach the object from scripts, the objects panel or remote messages. Only shown for objects that are registered in the objects list. See objects-address.
local
Read-only, not saved. Address of the object relative to the current patch, valid inside that patch only. See objects-address.
user addr
Free user-defined address for the object (empty by default). When set, the object is also registered in the objects tree under this name, so it can be reached independently of its position in the workspace (the value is also reported in the mouse-over and mouse-down chunks). Changing it rebuilds the objects list. Only available on objects that support a user address. See objects-address.
See also
- Create OSC Translator File
- Setup tab Network
- Tutorial : OSC (Open-Sound-Control)
- Panel Embedded Web Page
- Network
- Network Modbus Client Read
- Network Send Bytes
- MDNS Service
- Network Get File
- Network Get Adapter Info
- Network FTP Put File
- Network MQTT Client
- Network Markdown to HTML
- MDNS Lister
- Network OSC Send
- Network OSC Receive
- Network KNX Connection
- Network PosiStageNet
- Network Web Browser
- Network Set IP Address
- Network Modbus Server
- Network TCP Client
- Network TUIO Receive
- Network KNX Group Receive
- Network OSC Lister
- Network Modbus Client Write
- Network TCP Server
- Network Web Socket
- Network KNX Group Send
- Network PJLink Projector
- Network RTTrPM
- Network Receive Bytes
- Network OSC Send String
version 7.0.250121
Edit All Pages