SmartthingsKingOfFansZigbee

KO | EN

gitlite — search

#python #hacktoberfest #go #golang #machine-learning #rust #deep-learning #nodejs #kubernetes #pytorch #security #openai #ios #open-source

SmartthingsKingOfFansZigbee

(★ 27)

Smartthings device handler for Home Depot Home Decorators Zigbee Fan (and fan controller) produced by King of Fans. This device handler is based on https://github.com/dcoffing/KOF-CeilingFan, refectored to work with new Smartthing app and to provide simpler user experience.

SmartthingsKingOfFansZigbee Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Smartthings King Of Fans Zigbee device handler
Smartthings device handler for Home Depot Home Decorators Zigbee Fan (and fan controller) produced by King of Fans or Hampton Bay Universal Wink Enabled White Ceiling Fan Premier Remote Control. This device handler is based on  https://github.com/dcoffing/KOF-CeilingFan, refactored to work with new Smartthings app and to provide simpler user experience.

You can find the complete fan (including the controller) on the following links:

[![Home Depot Home Decorators Zigbee Fan](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/home-decorators-collection-ceiling-fan.jpg)](https://www.homedepot.com/p/Home-Decorators-Collection-Gardinier-52-in-LED-Indoor-Brushed-Nickel-WINK-Enabled-Smart-Ceiling-Fan-with-Integrated-Light-Kit-with-Remote-Control-43260/206648825)
[![Hampton Bay Universal Wink Enabled White Ceiling Fan Premier Remote Control](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/hampton-bay-ceiling-fan-remotes.jpg)](https://www.homedepot.com/p/Hampton-Bay-Universal-Wink-Enabled-White-Ceiling-Fan-Premier-Remote-Control-99432/206591100)

This device handler has a main device for Fan Control and a child device for light control
![Device handler on Smartthings app](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/screenshots/screenshots.jpg)

### Google Assistant fan Control

If you are using Google assistant you can set option dimmerAsFanControl to true to control fan speed using light dimmer.
Google assistant does not properly support fan speed dial, showing it as a light dimmer instead. When this option is activated you can set fan speed with the command in Google Assistant as "Set <FAN NAME> speed to <0 to 100>", where:
  - 0 to 24 is speed 0 (turn off),
  - 25 to 49 is speed 1 (low),
  - 50 to 74 is speed 2 (medium),
  - 75 to 100 is speed 3 (high),
  
![Dimmer as Fan Control settings](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/screenshots/set_dimmer_as_fan_control_settings.jpg)

Note that you can still use the on/off button as usual (fan on/off). To control light level, you must use child light device (shown as a regular light).

When dimmerAsFanControl option is activated, fan slider and dimmer will sync when any of them changes values as seen in the following animation:

![Smartthings Device Settings - Dimmer as Fan Control](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/screenshots/smartthings_dimmer_as_fan_control_demo.gif)

Also note that Google Home sees the fan dimmer as a "brightness", but the device handler respond as a fan control. When you use the command "Ok Google, set fan to 15%", google you turn on fan level 1 and respond "Changing **brightness** to 15%" instead of "Changing **fan level** to 15%". You can also turn the fan on and of using the command "Ok Google, turn fan ON/OFF".

![Google Home demo](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/images/screenshots/google_home_fan_control.gif)

To control lights device child, simply use the command "Ok Google, set Fan **Light** brightness to 30%".

### Validation scenario 
#### V.01
This device handler was tested using Samsung Connect Home Pro (Smartthings V2 Hub) with Firmware version	000.027.00010 in a set up with +10 Zigbee devices. I used two King Of Fans, Inc. model HDC52EastwindFan at the same network.
Google assistant commands were validated using Google Home app  v 2.19.1.18 running under Android Oreo, Google Nest mini running  firmware 191160 and Google Nest Hub running  firmware 191160. All commands were tested using US-English language set.

#### V.02
This device handler was tested using SmartThings WiFi, Plume US (Smartthings V3 Hub)  with Firmware version	000.029.00009 in a set up with +10 Zigbee devices. I used two King Of Fans, Inc. model HDC52EastwindFan at the same network.
Google assistant commands were validated using Google Home app  v 2.26.1.8 running under Android Oreo, Google Nest mini running  firmware 191160 and Google Nest Hub running  firmware 191160. All commands were tested using US-English language set.

### Known issues
- Random delays to update child device.
- Excess message logging and events generated
- Child light device shows as off-line.

### Install Instructions

Follow [Smartthings Git Hub Integration Guide](https://docs.smartthings.com/en/latest/tools-and-ide/github-integration.html), using user rafaelborja and repository SmartthingsKingOfFansZigbee.

After creating the device handlers, you must change/set the Fan device type to "King of Fans Zigbee Fan Controller" on the device tab on IDE. You can do so by clicking on edit over the device and selecting the device from the list.

**Developer note: Please feel free to try Smartthings Git Hub Integration and validate if this issue is specific to my installation. **

You can also create a new device handler from code copying and pasting [king-of-fans-zigbee-fan-controller.groovy](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/devicetypes/rafaelborja/king-of-fans-zigbee-fan-controller.src/king-of-fans-zigbee-fan-controller.groovy) and [king-of-fans-zigbee-fan-light-child-device.src](https://raw.githubusercontent.com/rafaelborja/SmartthingsKingOfFansZigbee/master/devicetypes/rafaelborja/king-of-fans-zigbee-fan-light-child-device.src/king-of-fans-zigbee-fan-light-child-device.groovy) source code

### A note on https://github.com/dcoffing/KOF-CeilingFan

dcoffing made an amazing work with the legacy device handler https://github.com/dcoffing/KOF-CeilingFan. This device handler is not working with the new Smartthings app. For this reason I decided to make the needed changes and send PRs to contribute with the existing project, but unfortunately the project seems to be abandoned.

This device handler has also a simplified interface and less child devices (no child devices for the fan, only one for the light).

This device handler would not be possible with all work and effort from dcoffing and all that contributed to the legacy device handler.

### FAQ
#### Why the fan buttons devices are gone?
A single 4 step slider is simpler to maintain and is already supported by most of voice assistants. If you would like to have, feel free to fork the project and send a PR.

#### How can I use breeze function?
This functionality is not supported at the moment.

SmartthingsKingOfFansZigbee

SmartthingsKingOfFansZigbee Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

SmartthingsKingOfFansZigbee

SmartthingsKingOfFansZigbee Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README