Homebridge Relays

Controls 4 channel i2c relays with a Raspberry Pi using HomeKit.

Hardware

The hardware is quite simple to construct.

1. Raspberry Pi 3 Model B
2. 4-relay module pins are connected to 4 GPIO pins.

The raspberry pi can then control the state of the relays.

Installation

1. Install homebridge using: sudo npm install --unsafe-perm -g homebridge
2. Install this plugin using: sudo npm install -g --unsafe-perm homebridge-relays-i2c
3. Update your configuration file. See config-sample.json in this repository for a sample.

Sample Configuration

{
  "bridge": {
    "name": "RelayServer",
    "username": "CC:22:3D:E3:CE:FA",
    "port": 51826,
    "pin": "031-45-155"
  },
  "description": "4 Channel i2c Relay",
  "accessories": [
    {
      "accessory": "Relay",
      "name": "North",
      "i2cAddress": "0x10",
      "i2cRegister": "0x01",
      "invert": true,
      "intial_state": 0,
      "timeout_ms": 5000
    },
    {
      "accessory": "Relay",
      "name": "South",
      "address": "0x02",
      "invert": false,
      "initial_state": 0,
      "timeout_ms": -1
    },
    {
      "accessory": "Relay",
      "name": "Kitchen",
      "address": "0x03"
    },
    {
      "accessory": "Relay",
      "name": "Garage Door",
      "address": "0x024
    }
  ],
  "platforms": []
}

Accessory Configuration Options

| Name | Optional | Description | | ---- | -------- | ----------- | | accessory | No | Accessory type | | name | No | Default name of an accessory | | address | No | i2c address | | invert | Yes | If true, output on pin is LOW for ON, HIGH for OFF (default: false) | | initial_state | Yes | Initial pin state. 1 for ON, 0 for OFF (default: 0) | | timeout_ms | Yes | Relay will stay ON for a given period of time then OFF (default: 0) |