Homebridge-viewsonic-projector NPM

homebridge-viewsonic-projector

Homebridge plugin for ViewSonic projectors via serial RS232 as HomeKit TVs. Requires iOS >=12.2 and homebridge >=0.4.46.

This plugin connects to a ViewSonic projector via serial RS232. Developed and tested using a Raspberry Pi Zero W and a USB to serial RS232 cable to connect to a ViewSonic PX701HD. For now, it only manage power ON / OFF

Getting Started

Hardware and OS :

Install homebridge
Connect to projector via RS232 (make sure it appears in /dev/tty)

For now, this plugin can only be installed manually :

Install this plugin from terminal :

sudo hb-shell
cd /var/lib/homebridge/node_modules/
git clone https://github.com/achorein/homebridge-viewsonic-projector.git

Update your config.json, following the example below
Restart HomeBridge (from UI)

Configuration

Example configuration

{
   "bridge": {
     ...
   },
   "accessories": [
     ...
   ],
   "platforms": [
        {
            "devices": [
                {
                    "name": "ViewSonic",
                    "model": "PX701HDP",
                    "adapter": "/dev/ttyUSB0",
                    "baudrate": 115200,
                    "pollingInterval": 6000
                }
            ],
            "platform": "ViewSonic-Projector"
        },
        ...
    ]
}

General configuration

Attributes	Required	Usage
platform	Yes	Name of homebridge accessory plugin. Must be ViewSonic-Projector.
devices	Yes	Array of ViewSonic projectors. Each of them must be added manually to the Home app!

Device configuration

Attributes	Required	Usage
name	Yes	Name of the projector, how you want it to appear in HomeKit.
adapter	Yes	Path to serial RS232 adapter.
model	No	Projector model. Only displayed in accessory details in HomeKit.
pollingInterval	No	Polling interval in milliseconds (Default: 6000)

Deep Dive

This projector have a strange behaviour, when the power is off it use string values to interact (pow=?, pow=on, ...), but when the power is on we can only use the hexadecimal communication (06 14 00 04 00 34 12 00 00 5E) as mention in the documentation.

More info :