https://github.com/michaelelliot/homebridge-dyson-fan

A Homebridge plugin for controlling a Dyson fan.
https://github.com/michaelelliot/homebridge-dyson-fan

dyson dyson-devices dyson-link homebridge homebridge-plugin homekit homekit-accessory siri

Last synced: 3 months ago
JSON representation

A Homebridge plugin for controlling a Dyson fan.

• Host: GitHub
• URL: https://github.com/michaelelliot/homebridge-dyson-fan
• Owner: michaelelliot
• License: mit
• Archived: true
• Created: 2017-07-10T04:07:25.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2018-03-31T06:21:20.000Z (almost 7 years ago)
• Last Synced: 2024-09-21T13:02:57.099Z (3 months ago)
• Topics: dyson, dyson-devices, dyson-link, homebridge, homebridge-plugin, homekit, homekit-accessory, siri
• Language: JavaScript
• Homepage:
• Size: 12.7 KB
• Stars: 18
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# homebridge-dyson-fan

A [Homebridge](https://github.com/nfarina/homebridge) plugin for controlling a Dyson fan.

This has been tested with and works using the [Dyson Pure Cool Link™ Tower](http://www.dyson.com.au/fans-and-heaters/purifiers/dyson-pure-cool-link.aspx), but may also work with other Dyson fans.

## Example Homebridge Configuration

See also: `config-sample.json`

```json

"accessories": [

  {

    "accessory": "Dyson Fan",

    "homeKitFanType": "Fan",

    "name": "Bedroom Fan",

    "model": "475",

    "host": "192.168.1.110",

    "username": "NN8-AU-XXXXXXXX",

    "password": "x"

  }

]

```

## Setup

You will need the following values set in the homebridge config.json accessory definition to connect to your fan:

1. Device serial number (`username`);

2. Device setup Wi-Fi password (`password`);

3. Device IP address on your network (`host`).

To ensure the IP address of your fan stays the same you can either change your router's DHCP lease duration to permanent or pin your fan's MAC address to a specific IP via your router's DHCP reservation feature. Use this IP address in the `host` field of the `config.json` file.

If the value `475` as `model` doesn't work for you, play around with different numbers above and below `475` until you find the right one, and then set the `model` field in `config.json` to this value.

## Notes

There are currently two HomeKit fan types: `Fan` and `Fanv2`. The `Fanv2` type will only work on iOS 11 and if used, the fan won't appear in the accessory list in the Home app on iOS 10. For maximum compatibility use the `Fan` type in the `homeKitFanType` config field. This is also currently the default value for this field if it's not specified.

## Help

If you need any help, feel free to reach out to me on [Twitter](https://twitter.com/michaelelliot).