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 19, values 10–35 map to letters AZ. 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

Opens the web browser to display information or help about the selected object, if it exists.

For more details about information/help creation, see create-help-file.

description

Description of the module for internal help purposes only. The description is not displayed in the interface.

ID's

visible only in god mode, see setup-panel-tab-expert.

unique ID

Current private ID for this control used to identify the object.

preset ID

Current private preset ID for this control used for presets.

recreate ID

If you experience difficulties in Polyphonic mode, try to recreate new id(s) with this button.

repair ID s

Each Patch shared on the local network uses its own ID (identification number). If you experience issues of Patches that don't send information to the good target, this button will rebuild all these id's.

Object Remote Address

absolute

Absolute remote address. see objects-address.

local

Local to the current patch remote address. see objects-address.

user addr

User defined remote address. see objects-address.

See also

version 7.0.250121

Edit All Pages