# \[BETA v0515\] Hampton Bay Zigbee Ceiling Fan/Light Controller **URL:** \ **Category:** Community Created Drivers\ **Tags:** fan, dth\_hvac\ **Created:** [April 18, 2017, 12:00am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084 "2017-04-18T00:00:28Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![dalec](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/dalec/32/22232_2.png) [@dalec](https://community.smartthings.com/u/dalec)\ **Post date:** [April 18, 2017, 12:00am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/1 "2017-04-18T00:00:28Z")
![](https://global.discourse-cdn.com/smartthings/original/3X/a/4/a47e42376455a92d0de2bfd9b55f7dbb8542ecaf.gif)Thanks to @ranga for getting things underway with[the alpha release](https://community.smartthings.com/t/release-alpha-hampton-bay-home-decorators-zigbee-ceiling-fan-controller/79552) and pioneering the effort. @stephack @dalec have joined up with @ranga to collaborate on this device handler and it is ready for a beta release. @stephack incorporated the just released composite (child) device handler functionality so that all control points are accessible to standard smartapps. This custom code is designed to be used with Hampton Bay Wink Ceiling Fan receiver in the [Gardinier 52" Ceiling Fan](http://www.homedepot.com/p/Home-Decorators-Collection-Gardinier-52-in-LED-Brushed-Nickel-Ceiling-Fan-43260/206648825?) or [Universal Ceiling Fan Premier Remote](http://www.homedepot.com/p/Hampton-Bay-Wink-Enabled-White-Universal-Ceiling-Fan-Premier-Remote-Control-99432/206591100?) Read about [how to get just the MR101Z Zigbee receiver here](https://community.smartthings.com/t/home-decorators-ceiling-fan-light-controller-mr101z-first-impressions/81408) if you want to update an existing fan to be on SmartThings. If you want to control this device by temperature, I modified [3 Speed Ceiling Fan Thermostat smartapp](https://community.smartthings.com/t/release-3-speed-ceiling-fan-thermostat/47080) to take advantage of this new device for SmartThings staging all 4 speeds based on temperature. You can download the Thermostat control smartapp directly here EDIT UPDATE: Removed link to this smartapp until we find cause of a user reporting device lockup. [Video link showing the older Version 0501](https://www.youtube.com/watch?edit=vd&v=kYek342SYsY) in action with individual child device icons . ![](https://global.discourse-cdn.com/smartthings/original/3X/a/d/ad62cd89bc47bd2a859e31b48768f9ef4be43701.jpg) ![](https://global.discourse-cdn.com/smartthings/original/3X/b/8/b8bc83a69804317c43e0d6492cecc685a9310426.jpg) ![](https://global.discourse-cdn.com/smartthings/original/3X/a/d/ad04180bc2bd408a3da24ba670f669fd05999ab2.jpg) Things view; individual Fan & Light things - Typical smartapp showing all control points accessible ![](https://global.discourse-cdn.com/smartthings/original/3X/8/e/8e9ce83c3e568602b0c91e028125b21de607d6f4.png) ![](https://global.discourse-cdn.com/smartthings/original/3X/9/5/95580585040af940293f09bd09ec941e9efc9cb7.png) The Light Child device and new version checker feature. Simply press the Refresh tile twice in the parent app to check the versions of the child apps are updated and compatible with parent device handler. Green indicates you are OK and current, RED indicates the child device handlers need updating. ![](https://global.discourse-cdn.com/smartthings/original/3X/f/0/f07e9a31db32ce8948d1173648f8395a673b1d33.png) ![](https://global.discourse-cdn.com/smartthings/original/3X/a/6/a6c5eb13e4d2969d91fbfcf44ba931b478745a13.jpg) It is still BETA version and things can still change and might require you to delete all the child instances and recreate them when updating to newer device handler releases. This is an easy process when using the gear icon for settings which will delete all child instances with one setting. The caveat is you will also need to remove all smartapp associations to perform the child delete then re-associate them. **Github Repository Settings** Owner: dcoffing Name: KOF-CeilingFan Branch: master > > > You must install all three device handlers. **How To Install Zigbee Ceiling Fan/Light device handler** If you need help installing this custom device handler @JDRoberts gave some excellent step-by-step instructions here > [@\[OBSOLETE\] FAQ: An Overview of Using Custom Code in SmartThings (SmartThings Classic, Groovy Code)](https://community.smartthings.com/t/faq-an-overview-of-using-custom-code-in-smartthings/16772): > > The original FAQ information in this thread refers to the original smartthings architecture, which was in place through the end of 2022 and a little beyond. Custom code was written in the groovy programming language and ran in the smartthings cloud. As of May 2023, you can no longer add new Groovy DTH‘s or smartapps to your smartthings account. So if you came here because of a link in an old forum thread, or on another site, I’m afraid the Groovy information is no longer usable. All of this was replaced by a new architecture. Cloud to cloud integrations use the smartthings API. Hub connected devices, mostly Zigbee and zwave, now use “Edge Drivers,” written in the LUA programming language. Here’s the official announcement on those: The process for using a custom Edge Driver in the new … ---
**Author:** ![Llama11amaduck](https://avatars.discourse-cdn.com/v4/letter/l/3e96dc/32.png) [@Llama11amaduck](https://community.smartthings.com/u/Llama11amaduck)\ **Post date:** [April 18, 2017, 2:09am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/3 "2017-04-18T02:09:36Z")
> [@dalec](#): > > Name: KOF-CeilingFan Quick mention, this is a typo. The Name is actually KOF-Fan , no ceiling with it! Just installed this tonight (completely fresh install, just actually got the receiver and remote in the mail). The remote and wallplate work just fine, but the SmartThings part doesn’t seem to be. It was found and I added it, then installed the device handler and selected that for my device. It shows up in the app on my Android phone, but doesn’t seem to be accurate to what state the fan and light are currently in, nor does it seem to change the states. Suggestions? It’s possible I’ve missed something, I’m quite new to all of this. ---
**Author:** ![dalec](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/dalec/32/22232_2.png) [@dalec](https://community.smartthings.com/u/dalec)\ **Post date:** [April 18, 2017, 11:30am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/4 "2017-04-18T11:30:07Z")
Sorry for the confusion. Fixing it now, it really is supposed to be KOF- **Ceiling** Fan as I needed to delete forks from @stephack and from @ranga that is causing confusion. I gave it the prefix name of Ceiling to differentiate the repositories from each other. If you setup with IDE integration to the KOF-Ceiling Fan repo do an update from Repo to get the latest code and publish it again. I am traveling all day today so maybe Stephan can chime in. Edit: My original timing was to get this out on the weekend before my travel so I apologize for not being able to test the repo downloading before I left ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [April 18, 2017, 1:45pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/5 "2017-04-18T13:45:24Z")
I have quite a few meetings today myself but if the update from Repo does not resolve the issue as @dalec prescribed, please post a screenshot of the “my device handlers” page in the IDE and I’ll try to assist. ---
**Author:** ![pilot04](https://avatars.discourse-cdn.com/v4/letter/p/898d66/32.png) [@pilot04](https://community.smartthings.com/u/pilot04)\ **Post date:** [April 18, 2017, 9:15pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/6 "2017-04-18T21:15:22Z")
Just installed the beta DTHs and it works well so far on my HD Home Decorator Gardinier ceiling fan. Now I can delete the WebCoRE pistons that were controlling the fan as Alexa can use the new child fan DTH. Thanks all for the refinements and release of the beta! ---
**Author:** ![Llama11amaduck](https://avatars.discourse-cdn.com/v4/letter/l/3e96dc/32.png) [@Llama11amaduck](https://community.smartthings.com/u/Llama11amaduck)\ **Post date:** [April 18, 2017, 11:24pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/7 "2017-04-18T23:24:56Z")
Unfortunately, trying to do this via GitHub keeps failing. I’m able to add the repo, but every time I attempt to publish it fails with a 500 error, not sure why. So, I went ahead and copy + pasted from GitHub into a New Device Hander from Code just to test, and I still get the same behavior as before, where the app seems to not do anything. Here is a screenshot ![](https://global.discourse-cdn.com/smartthings/original/3X/6/e/6ee947e34bace48f06c10d1912dbfd813cd0e5f3.PNG) And here is from the Devices Page ![](https://global.discourse-cdn.com/smartthings/original/3X/1/3/13e7f06b72988f71187c1bbb82fd766235952c7a.PNG) The in-wall and handheld remotes still work, so I know the receiver is powered and reachable. I do not have any other Zigbee devices in the house, the distance to the hub is approximately 25’ and only needs to go through one wall. ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [April 18, 2017, 11:41pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/8 "2017-04-18T23:41:28Z")
It looks like you have all the Device handlers installed but you are missing the light device. Open the fan Thing and click the gear in the top right corner. Choose the option to delete children (after removing any smartapp connections you may have added). Hit done. Click the gear again and disable the delete children option and hit done again. This should rebuild all the child device types. If it does not work after this then please repost the device page screenshot again. ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [April 18, 2017, 11:48pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/9 "2017-04-18T23:48:35Z")
> [@Llama11amaduck](#): > > it fails with a 500 error, not sure why @dalec, I just tried to add one of the DTH’s from the repo and I’m seeing the same error Llama described. It’s also showing the full github path when clicking “update from repo”. Take a look at it when you have some time. ---
**Author:** ![dalec](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/dalec/32/22232_2.png) [@dalec](https://community.smartthings.com/u/dalec)\ **Post date:** [April 19, 2017, 5:15am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/10 "2017-04-19T05:15:52Z")
Just got back home from travel… looking at it now. Stephan see if you can spot anything wrong with my github syntax. I may just need to delete all my KOF devices and see what happens from scratch? Update: See if the 500 error is gone now. I think it was all due to the filenames having spaces and not dashes. @Llama11amaduck Sorry for issues you are having. I did a test by removing my devices and re-updated from repo and it is working for me. **Your screen shot doesn’t show the device’s being connected to the repo?** The Green color indicates that the device handlers are in your IDE only, and not in any repository.[(Color Coded Names)](http://docs.smartthings.com/en/latest/tools-and-ide/github-integration.html#github-integration-ide-tour) See my screen below and they should be Black color with the KOF-CeilingFan(master) repo location shown. FYI, the two child devices do not have to be published to have this all work as you see in my screen capture below. ![](https://global.discourse-cdn.com/smartthings/original/3X/f/a/faf300322258dbfe525bdc17bfdee27a34697af7.png) To connect to my repo in your IDE, go to My Device Handlers, click Settings button, click Add new repository, enter Owner: dcoffing Name: KOF-CeilingFan Branch: master then click “Save” button. Then to click “Update from Repo” button, select KOF-CeilingFan(master) and it should pull up in the Obsolete column all three of the KOF device handlers for you to select. After selecting them , select Publish checkbox and Execute Update. Also to help in troubleshooting I added version info to each of the devices now to verify that you are indeed getting the current device handler installed. Look at the bottom of the device details and verify for me **what version you have installed for all three devices: fan, fan speed, and light** please. ![](https://global.discourse-cdn.com/smartthings/original/3X/f/7/f7456397fd20f3a2ac72e17aab67307b9e3b190b.png) ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [April 20, 2017, 12:28am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/11 "2017-04-20T00:28:27Z")
ooops…posted in wrong spot ---
**Author:** ![Llama11amaduck](https://avatars.discourse-cdn.com/v4/letter/l/3e96dc/32.png) [@Llama11amaduck](https://community.smartthings.com/u/Llama11amaduck)\ **Post date:** [April 20, 2017, 1:27am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/12 "2017-04-20T01:27:32Z")
Well, @stephack and @dalec, I’m not 100% sure which fixed it, as I was able now to use the repo update (before I couldn’t) and I also did Stephen’s recommendation and deleted and rebuilt the child apps. Between the two, something clicked! Thanks, guys. ---
**Author:** ![emersonvier](https://avatars.discourse-cdn.com/v4/letter/e/b38774/32.png) [@emersonvier](https://community.smartthings.com/u/emersonvier)\ **Post date:** [April 28, 2017, 1:28am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/13 "2017-04-28T01:28:27Z")
Can I Dimmable the light with MR101Z? ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [April 28, 2017, 2:02am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/14 "2017-04-28T02:02:23Z")
Yes. The light is dimmable. ---
**Author:** ![ChadBailey](https://avatars.discourse-cdn.com/v4/letter/c/e0b2c6/32.png) [@ChadBailey](https://community.smartthings.com/u/ChadBailey)\ **Post date:** [May 1, 2017, 4:58am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/15 "2017-05-01T04:58:55Z")
Just got this working with [Gardinier 52 in. LED Brushed Nickel Ceiling Fan](http://www.homedepot.com/p/Home-Decorators-Collection-Gardinier-52-in-LED-Brushed-Nickel-Ceiling-Fan-43260/206648825) and it’s working fantastic!! Thank you so much for your work on this! ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [May 1, 2017, 11:07am UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/16 "2017-05-01T11:07:46Z")
We are glad you like it. @dalec, @ranga and I have been tweeking it a little every day, so let us know if you find any bugs or have any feature requests. ---
**Author:** ![dalec](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/dalec/32/22232_2.png) [@dalec](https://community.smartthings.com/u/dalec)\ **Post date:** [May 1, 2017, 12:35pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/17 "2017-05-01T12:35:00Z")
> [@ChadBailey](#): > > it’s working fantastic!! I agree! @stephack has done phenomenal work on this new parent/child device function and this past week on adding the feature of custom icons per child device. So the UI is getting very polished with some customized icons to take full advantage of this 🙂 I did a video showing all the latest UI improvements and will post it up later. UPDATE: I just [updated the original post](https://community.smartthings.com/t/beta-hampton-bay-zigbee-ceiling-fan-light-controller/85084) with the new UI screens shots and video link. So this is a great time to do an Update from Repo if you are not at ver 20170430 or greater. [![](https://global.discourse-cdn.com/smartthings/original/3X/1/d/1def2b86d6d9d2006a5d6d1003284fe6325ed610.jpeg "Hampton Bay Zigbee Receiver on SmartThings ver0501") ](https://www.youtube.com/watch?v=kYek342SYsY) ---
**Author:** ![Albert\_Lo](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/albert_lo/32/121277_2.png) [@Albert\_Lo](https://community.smartthings.com/u/Albert_Lo)\ **Post date:** [May 1, 2017, 8:29pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/18 "2017-05-01T20:29:49Z")
This looks awesome. I am very interested in getting this fan now. Curious, have you tried to see how this would work with Google home? With my GE Fan controller, you basically tell it to turn on based on %. less than or equal to 33% = low, 66% medium etc… How will it work with this? ---
**Author:** ![stephack](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/stephack/32/57942_2.png) [@stephack](https://community.smartthings.com/u/stephack)\ **Post date:** [May 1, 2017, 9:37pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/19 "2017-05-01T21:37:35Z")
I can’t speak for google home, but with the echo you have the following exposed for use Assuming you named your device “bedroom fan”: Bedroom fan light Bedroom fan Bedroom fan low Bedroom fan medium Bedroom fan medium high Bedroom fan high Bedroom fan breeze mode So you would say, "Alexa, turn on bedroom fan low" Or “Alexa turn on bedroom fan medium” or simply “Alexa turn on bedroom fan” to resume the last state before it was turned off. @dalec has google home, so he can provide confirmation for you. ---
**Author:** ![PaulChampagne](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/paulchampagne/32/53953_2.png) [@PaulChampagne](https://community.smartthings.com/u/PaulChampagne)\ **Post date:** [May 1, 2017, 11:39pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/20 "2017-05-01T23:39:38Z")
Great work Stephan and Dale. I do have a question: since it appears that the child side is not working with Android for now, should I still install them in order for the controller to work properly? Thanks again for all the hard work ---
**Author:** ![dalec](https://yyz2.discourse-cdn.com/smartthings/user_avatar/community.smartthings.com/dalec/32/22232_2.png) [@dalec](https://community.smartthings.com/u/dalec)\ **Post date:** [May 1, 2017, 11:40pm UTC](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084/21 "2017-05-01T23:40:14Z")
> [@PaulChampagne](#): > > since it appears that the child side is not working with Android for now, should I still install them in order for the controller to work properly? Everything works just fine, install all three on Android. The only part that doesn’t open (which in no way affects the operation) is the ability to open up the child device independently directly from the parent. All the child dth work great and you can see them all from the parent device, just not independently other than the Light of course with shows up on the Things view along side the Fan Parent showing the speeds. Sorry for the confusion. I will edit the original post for clarity. [Next page](https://community.smartthings.com/t/beta-v0515-hampton-bay-zigbee-ceiling-fan-light-controller/85084.md?page=2)