homebridge-i6-bigassfans is a plugin for Homebridge which allows you to control a Big Ass Fans model i6, Haiku H/I Series and Haiku L Series fans.
I created the plugin origially to support only i6 fans and observing network traffic of my personal i6 fan. Recently, with a firmware update to the Haiku series fans, BigAssFans changed the protocal of how those fans communicate to conform to how i6 fans communicated. Since I don't own a Haiku fan, I colaborated with Haiku fan owners to add support for those fans. For the most part i'm guessing the format of the binary messages that are 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.
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.
- Turn fan and/or light on or off!
- Change speed, and direction (keep in mind Big Ass Fans frowns on reversing speed.)
- Detect existence of light
- Change brightness level of LED lamp.
- See the fan's bluetooth remote's temperature and humidity sensors (i6 only).
- See the fan's temperature sensors (Haiku Fans).
- Turn Whoosh Mode on or off.
- Turn Dim to Warm on or off (i6 only).
- Turn fan's fan Auto mode on or off.
- Turn the fan's light Auto mode on or off
- Turn on Eco Mode (Haiku fans only)
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.
sudo npm install -g homebridge-i6-bigassfansAdd the BigAssFans-i6 platform in config.json in your home directory inside .homebridge.
Add your fan(s) in the fans array.
Example configuration simple:
{
"platforms": [
{
"platform": "BigAssFans-i6",
"fans": [
{
"name": "Big Fan i6",
"mac": "20:F8:5E:00:00:00",
"ip": "192.168.7.150"
}
]
}
]
}Example configuration with optional params and multiple fans:
{
"platforms": [
{
"platform": "BigAssFans-i6",
"fans": [
{
"name": "Big Fan i6",
"mac": "20:F8:5E:00:00:00",
"ip": "192.168.1.150",
"fanAuto": true,
"lightAuto": true,
"whoosh": false,
"dimToWarm": false
},
{
"name": "BigAssFans Haiku",
"mac": "20:F8:5E:00:00:00",
"ip": "192.168.1.151",
"fanAuto": true,
"lightAuto": true,
"whoosh": true,
"ecoMode": true
}
]
}
]
}platform[required] Should always be "BigAssFans-i6".fans[required] A list of your fans.
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 fan Auto mode (true/false)lightAuto[optional] Adds accessory switch for the fan's light Auto mode (true/false)ecoMode[optional] Adds accessory switch for the fan's Eco mode (true/false)
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:
homebridge -Dhomebridge-miot - whose style served as a guide.
homebridge-bigAssFans - where the Haiku message protocol gave me some insight.
HAP-NodeJS & homebridge - for making this possible.
Big Ass Fans - who I hope is working on their Homekit implementation.