Homebridge-i6-bigassfans NPM

homebridge-i6-bigassfans

homebridge-i6-bigassfans is a plugin for Homebridge which allows you to control a Big Ass Fans model i6.

This works with my LED equipped i6 fan. I'm hoping it works for you. I created the plugin by observing network traffic and for the most part guessing the format of the binary messages that were sent to and from the fan. Of the appoximately 80 unique message types I've seen, I think I know what about half of them probably mean.

Bugs

The network connection to the fan will reset on occassion. I try to handle that gracefully but if it happens just as you issue a command (e.g., turn on the light) as oppposed to the periodic probe message, the command will be ignored. Try again after two seconds.

Features

Turn fan and/or light on or off!
Change speed, and direction (keep in mind Big Ass Fans frowns on reversing speed.)
Change brightness level of LED lamp.
See the fan's bluetooth remote's temperature and humidity sensors.
Turn Whoosh Mode on or off.
Turn Dim to Warm on or off.
Turn fan's Auto mode on or off.

Installation

If you are not already running homebridge you'll find how to install it in the homebridge documentation. After you install homebridge you can install and configure the homebridge-i6-bigassfans plugin through homebridge-config-ui-x using a command line and editor as described below.

Install homebridge-i6-bigassfans:

sudo npm install -g homebridge-i6-bigassfans

Configuration

Add the BigAssFans-i6 platform in config.json in your home directory inside .homebridge.

Add your fan(s) in the fans array.

Example configuration:

{
  "platforms": [
    {
      "platform": "BigAssFans-i6",
            "fans": [
                {
                    "name": "Big Fan",
                    "mac": "b8:f0:09:ac:db:b6",
                    "ip": "192.168.7.150"
                }
            ]
    }
  ]
}

Platform configuration fields

platform required Should always be "BigAssFans-i6".
fans required A list of your fans.

General configuration fields

name required Name of your fan.
ip required IP address of your fan. Can be found in the Big Ass Fans app's Wi-Fi settings screen.
mac required MAC address of your fan. Can be found in the Big Ass Fans app's Wi-Fi settings screen.
whoosh optional Adds accessory switch for Whoosh Mode (true/false)
dimToWarm optional Adds accessory switch for Dim to Warm (true/false)
fanAuto optional Adds accessory switch for the fan's Auto mode (true/false)

Troubleshooting

First, make sure you can control your fan from the official Big Ass Fans app.

If you have any issues with the plugin, you can run Homebridge in debug mode, which will provide some additional information. This may be useful for investigating issues.

Homebridge debug mode: