Home

Background and Status

This plugin was created to enable HomeKit control of an i6 model fan at a time when there were no plugins for it. The i6 communicated with a binary protocol rather than the textual protocol used by the Haiku series fans.

Sometime around late March / early April, 2022 a firmware update became available for Haiku series fans which changed their protocol to be the same or similar to the i6. People who updated their firmware found they could no longer control their fans with HomeKit/Homebridge.

On a hunch @pponce ran the i6 plugin with his Haiku fan and it basically worked. So we've been trying to make the "i6" plugin more of a generic Big Ass Fans plugin.

Miscellaneous

If you wish, instead of entering your fan's IP address in the "ip" configuration field, you can use your fan's fully qualified domain name, which would be hostname . domain. Fan hostnames seem to be the fan's name (likely with punctation and spaces removed), followed by - and the last 3 octets of the MAC address. So for example, "ip": "HaikuFan-FE:8D:90.local", The idea that this is a naming convention is drawn from observing two fans' hostnames. If you can ping it, chances are you have it right.

Issue 27 uncovered an interesting HomeKit behavior. If you view your Fan and it's associated lights and switches as a single tile, the fan icon becomes locked. Also, if you have no separate tiles but do have sensors, the tile will be locked.