Skip to content

Latest commit

 

History

History
36 lines (24 loc) · 1.78 KB

README.md

File metadata and controls

36 lines (24 loc) · 1.78 KB
Raw

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)

See sample-config.json