jvc-projector-remote 0.1.1.post1

A small package to control jvc projectors over IP

JVC Projector Remote

This is a simple package to control JVC Projectors over IP. Created to be used with my Homeassistant custom component: bezmi/hass_custom_components. Works fine as a standalone module.

Currently supports:

• Power on/off
• Lens Memory
• Input (HDMI only)
• Power Status (Standby, Cooling, Emergency, Lamp On, Reserved)
• Low Latency Mode

Raise an issue if you would like any extra commands implemented. Alternatively pull requests are more than welcome and adding new commands is trivial. See Below.

Installation

PyPi

Install this package from PyPi with:

pip install jvc_projector_remote

From this repo

Install from this repo with:

pip install -e git+https://github.com/bezmi/jvc_projector.git#egg=jvc-projector-remote

Usage

For usage with homeassistant, see here.

Here is an example for using this module standalone:

>>> from jvc_projector import JVCProjector

 # replace with your projector's local IP
>>> host = "192.168.1.12"

 # replace with your projector's network password (if applicable)
>>> password = "MYPASSWORD"

# initialise
>>> projector = JVCProjector(host)

# initialise (alternate, with network password)
>>> projector = JVCProjector(host, password)

# power on, power off
>>> projector.power_on()
# check status once it's on
>>> projector.is_on()
True

>>> projector.power_off()
# check if it's off
>>> projector.is_on()
False

# Send arbitrary command
# possibilities include:
#   - memory1, memory2, memory3, memory4, memory5
#   - hdmi1, hdmi2
#   - add new commands to the Commands class in __init__.py
>>> projector.command("hdmi2")

Testing

I wrote this to interface my projector with homeassistant. The code to send/receive commands is rough and the error checking could be more robust. It has been tested on a DLA-X5900, but should work on most of the projectors that use a similar IP control scheme. Let me know if it works with your projector and I will add it to the list below.

Confirmed Models

• DLA-X5900
• NX5
• NZ8/RS3100

Bugs

The main issue one might face is receiving ConnectionRefusedError when making a request too soon after another. On my DLA-X5900, it takes about 600-700 ms between commands.

Improvements

• Currently I group all power states into either "on" or "off". I might separate these in future.
• ACK for all commands might be useful, but it's reliable enough without it.

Adding New Commands

Step 1

Page 25 of this reference shows that the function is PMPM for "Picture Mode Switch". The hex representation of these ASCII characters in pythonic format is:

b"\x50\x4D\x50\x4D"

Step 2

The relevant picture modes are presented in Table 4-19 on Page 30. Let's take 01 for the "Cinema" preset:

b"\x30\x31"

Step 3

Finally, the examples on page 42 show what we need to append to the start and end of the command string. In the end, the final command added to the Commands Enum in __init__.py becomes:

class Commands(Enum):
    # ...
    # ALL THE OTHER COMMAND STRINGS...
    # ...
 
    pm_cinema = b"\x21\x89\x01\x50\x4D\x50\x4D\x30\x31\x0A"

Step 5

Just change the value of step 2 for the remaining input modes you want. You should be able to use it like any of the other commands, with either the JVCProjector.command() function in this module or the remote.send_command service in Home Assistant using "pm_cinema" as the command string.

Inconsistencies

One of the reasons I held off on this is that the commands from step 2 will be slightly different for older projectors. The picture mode is represented by one byte/character. In this case, for the "Cinema" mode, we would use:

b"\x31"

Instead of the two byte code in step 2.