This driver was written to control the Epson EB-Z projector series. It does not present all functions of the hardware.
-r, --rpc-endpoint —
Endpoint to receive commands on. Defaults to tcp://127.0.0.1:46111.
-p, --pub-endpoint —
Endpoint to push notifications from. Defaults to tcp://127.0.0.1:46211.
-i, --identity —
Identity for both endpoints. Defaults to epson.
Apart from these flags, the epson-driver command expects an address of the device to connect to via its TCP/IP interface. For example:
epson-driver --identity projector-1 10.8.0.21
Would connect to the device and assume the projector-1 identity.
To request immediate notification about projector status:
(hasheq 'request "status")
To bring projection on-line or off-line respectively.
(hasheq 'request "online!") (hasheq 'request "offline!")
To control aspect ratio of projection:
(hasheq 'request "set-aspect!" 'aspect aspect)
Valid aspect values are listed below, but not all of them are supported by all projector types:
deform to fit
To control freezing of currently projected picture:
(hasheq 'request "set-freeze!" 'freeze? freeze?)
In order to freeze the picture, pass #t for freeze?. To cancel, pass #f.
To control blanking of projection (closing a shutter while leaving the lamps running):
(hasheq 'request "set-mute!" 'mute? mute?)
In order to blank the picture, pass #t for mute?. To cancel, pass #f.
Note that since the projector closes an actual, physical shutter in order to blank the picture, there is an audible noise to be heard. This means that blanking projector during input switch and similar operations aiming to improve user experience will probably not yield the desired results.
When the device is running, following status message is published every 5 seconds:
(hasheq 'full (hasheq 'status status 'aspect aspect 'mute? mute? 'freeze? freeze?))
Where aspect is the current aspect ratio (see above), mute? is set to #t when blanking is active, freeze? is set to #t when the picture is frozen, and status represents current power status.
Possible power statuses are:
projector standing by, network off
projector running, lamp active
projector starting, lamp pending
projector shutting down, lamp cooling
projector standing by, network on
projector state abnormal
projector standing by (A/V)
When either aspect, mute? or freeze? changes, partial status update is published immediately:
(hasheq 'delta (hasheq 'aspect aspect)) (hasheq 'delta (hasheq 'freeze? freeze?)) (hasheq 'delta (hasheq 'mute? mute?))