1.1.13 • Published 4 years ago

@miblanchard/homebridge-big-ass-fans v1.1.13

Weekly downloads
4
License
MIT
Repository
github
Last release
4 years ago

Homekit

A Homekit implementation for Big Ass Fans. Is heavily dependant on the unofficial Big Ass Fans API.

Installing

First install homebridge - instructions here

An example config.json is as follows:

    "platforms": [
        {
            "platform": "BigAssFans",
            "name": "Big Ass Fan",
            "fan_count": 1
        }
    ]

This config will automatically scan and add all fans that are on your local wifi network. However you should also always add the expected number of fans with the optional config parameter fan_count (by default this assumes 1). Otherwise homebridge will not always discover all the fans.

Install this package with

npm install -g homebridge-bigAssFans

Important note

All of the smarts in your fan will continue to operate - eg. If you set homekit and your fan's local settings set to turn the light on when occupancy is sensed, and then decide to turn it off via homekit the local settings will still turn the light on

Legacy

Legacy mode allows you to specify a single fan to control - and also allows more fine grained control regarding the settings of the single fan.

Legacy mode can not run at the same time as the new Platform mode. In addition this mode does not support running multiple big ass fans.

{
    "accessory": "BigAssFan",
    "name": "Sean's Big Ass Fan",
    "fan_name": "Sean's Room",
    "fan_id": "20:F8:5E:AA:7A:57"
}

In order to get the fan_id, run the example program getFanInfo.js from theBigAssFansAPI.

You must also set the fan_name to the name returned here.

About the legacy config

FieldRequired?Description
nameOptionalOverall Name to use for this accessory
fan_nameRequiredMust get this from getFanInfo.js
fan_idRequiredMust get this from getFanInfo.js
fan_ip_addressOptionalIP address of fan, defaults to broadcast
light_existsOptionalHas light? set to true - default false
light_onOptionalWhat "On" means - default Max
fan_onOptionalWhat "On" means - default 3/7
homekit_fan_nameOptionalName to call the Fan in Homekit
homekit_light_nameOptionalName to call the Light in Homekit

Future features

  • Getting motion sensors to work
  • Allowing all Legacy settings in the Platform mode

Testing

In order to test a local copy you can read here, or as a brief tldr:

/usr/local/bin/homebridge -D -P ./homebridge-bigAssFans/

(Or if homebridge is somewhere else, run which homebridge to find it's location)

Other issues:

  • If you can't add the bridge device try changing the `"username" in the config file, sometimes this needs to be changed to fix a caching issue on iOS
1.1.13

4 years ago

1.1.12

4 years ago