homebridge-rfoutlets's Introduction

homebridge-rfoutlets

Homebridge plugin purpose-built for controlling 433MHz radio frequency outlets which can be purchased inexpensively. (i.e. these). Homebridge maintains state information, so you can always know if you left that lamp on.

Tested on a Raspberry Pi 2 - Model B running Raspbian (Debian) and Node.js v6.9.0. This should work on most Raspberry Pi models, however YMMV

Supports lights, switches, and fans

Installation

Install homebridge
sudo npm install -g homebridge
Install homebridge-rfoutlets
sudo npm install -g homebridge-rfoutlets
Update your homebridge configuration

Notes

The user which homebridge is run from must be on the list of sudoers as the codesend executable requires root privileges
A great guide on how to record RF signals and set up your Pi to transmit can be found here. Note: the web portion of the guide is not required

Configuration

name: Name of your device
type: Light, Switch, or Fan (required)
manufacturer: manufacturer of the device plugged into the outlet (optional, defaults to blank)
model: model of the device plugged into the outlet (optional, defaults to blank)
serial: serial number of the device plugged into the outlet (optional, defaults to blank)
rf_on: RF signal to turn the outlet on (required)
rf_off: RF signal to turn the outlet off (required)
pulselength: RF transmission pulse length (optional, defaults to 189)
pin: GPIO pin of the 433MHz transmitter (optional, defaults to 0)