homebridge-unipi2

Hombridge plugin for UniPi Neuron PLC Optimized for SmartHome usage.

Loosely based on Daan Kets original work, but with:

• support for one accessory per relay, or one accessory per room with relays as different services, or one accessory with all relays as services
• support for UniPi extensions modules (xS modules)
• support for persistent aliases in the config.json (so Neuron module can be reseted without loosing informations)
• support for complex rules (if/then/else with group conditions, actions to on/off relays, set analog outputs, process short/long/double clicks, or even call ifttt receipes)

Example config file:

    "platforms": [
    {
      "platform": "UniPi2",
      "id": "L203-sn250",
      "name": "My SmartHome",
    
      "aliases": {
        "DI 1_01": "in_switch1",
        "DI 1_02": "in_switch2",
        "DI UART_4_6_08": "in_doorbell",
        "AI UART_2_4_01": "in_rotary1",
        "DO 1_01": "led1",
        "DO 1_02": "led2",
        "RO 2_01": "light1",
        "RO 2_02": "light2",
        "AO UART_2_4_01": "dimmer1",
      },

      "rooms": {
        "living": [ "light1", "light2", "dimmer1" ],
        "leds": [ "led1", "led2" ]
      },

      "iftttKey": "xxxxxxxx",
      "config": {
        "dimmer1": { "inverted": true }
      },

      "rules": [
        {
          "when": "click in_doorbell",
          "then": "ifft doorbell"
        },
        {
          "when": "click in_switch1",
          "if": "off light1",
          "then": "on light1",
          "else": [ "off light1", "off light2", "off dimmer1" ]
        },
        {
          "when": "singleclick in_switch2",
          "if": [ "on light1", "on light2", "on dimmer1" ],
          "then": [ "off light1", "off light2", "off dimmer1" ],
          "else": "switch light2"
        },
        {
          "when": "doubleclick in_switch2",
          "then": [ "off light1", "off light2", "off dimmer1" ]
        },
        {
          "when": "move in_rotary1",
          "then": "setval dimmer1 in_rotary1"
        }

      ]
    }
  ]

Installation:

1. Install UniPian OS image on the Neuron's SD card

• Download the UniPian image (called "Neuron OpenSource OS")
• Download balenaEtcher and install it
• Connect the SD card to your PC, run balenaEtcher, and write the UniPian image to the SD card
• Create an empty file called ssh (without extensions) at the root of the SD card
• put the SD card into the Neuron and power it up

2. Update all packages Connect to the Neuron using a SSH client, then type:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install evok
sudo systemctl enable evok
reboot

3. Install homebridge

curl -sL https://deb.nodesource.com/setup_12.x | sudo bash -
sudo apt-get install -y nodejs gcc g++ make python
sudo npm i -g npm
sudo npm install -g --unsafe-perm homebridge
sudo hb-service install --user homebridge

4. Install UniPi2 plugin

sudo npm -g install homebridge-unipi2

5. Configure Evok and Homebridge

• Edit the file /etc/evok.conf, make sure to set device-name = to the correct devices for the extensions, if any
• Edit the file /var/lib/homebridge/.homebridge/config.json and add a platform "UniPi2" with all your rooms, devices, and rules

6. (optional) Install Config-UI-X plugin

sudo npm install -g homebridge-config-ui-x

This will let you edit the config.json file at will using a webbrowser