homebridge-satellite-fan

0.2.3 • Public • Published

Homebridge Ceiling Fan

Homebridge plugin that controls a ceiling fan control module made by Satellite Electronic, Ltd. over Bluetooth Low-Energy.

Satellite Fan module

The MR101F module installs into the ceiling fan canopy, substituting the wiring connection between the fan and the house. It also comes with a suprisingly nifty RF remote. The module is rebranded and sold in the US as Harbor Breeze Ceiling Fan Remote Control (Lowe's).

The plugin was designed and tested on Raspberry Pi Zero W.

Prerequisites

  • Install packages. For Raspbian Stretch:
# apt install nodejs-legacy npm bluetooth bluez libbluetooth-dev libudev-dev libcap2-bin 
  • Eanble BLE access via non-root users:
# setcap cap_net_raw+eip /usr/bin/nodejs 

Installation

# npm install -g homebridge homebridge-satellite-fan 

Update your configuration to include a satellite-fan accessory. See an example at sample-config.json.

Persistent Installation

See “Running Homebridge on Bootup”.

In condensed form, start with this gist and then:

# mkdir /var/lib/homebridge 
# useradd --system homebridge 
# usermod -a -G i2c homebridge 
# systemctl daemon-reload 
# systemctl enable homebridge 
# systemctl start homebridge 
$ systemctl status homebridge

Package Sidebar

Install

npm i homebridge-satellite-fan

Weekly Downloads

1

Version

0.2.3

License

MIT

Last publish

Collaborators

  • zwaldowski