Hao Deng Cloud Component for Home Assistant

Control your Hao Deng Lights mesh lights from Home Assistant! This integration allows you to control the above lights that you'd normally use through the Hao Deng App. It might work if you use the Magic Light BLE or Magic Home Pro app as well (see below).

Important Notes

• This integration is in beta. Please open an issue if you have any problems!
• This integration uses the cloud. If you don't have a wifi bridge, this won't work (ie, if you can control your lights with the Hao Deng app when you're away from home, you're good. If you have to be at your house to use it, you're not good)
• As of right now, lights are only read in on server start. So when you add or modify lights (including adding them to groups) they will not be automatically updated and you'll need to restart home assistant (this is definitely a feature coming, but we're in beta right now!)
• The Magic Cloud API doesn't seem to be able to handle more than 5 or so light updates at a time. This can make the lights stutter out of sync when updating a lot at once (I, personally, have 16 of these in my Great Room so I've really noticed!). To get around this issue, use the Hao Deng app to add your lights to groups that mirror the groups and rooms in your home. This allows the integration to "batch" those lights in a single group and makes everything flow better. For insance, I have a light group in Home Assisstant for my 16 Great Room lights. I put all those lights in a group in the Hao Deng app as well, and now they can be controlled in sync much better!
• If this integration works for you, please hit the star button up there. It gives me the warm fuzzies to know this code is benefitting other people! :)

Installation with HACS (recommended)

Do you have HACS installed?

1. Add Hao Deng Cloud Component as custom repository.
   1. Go to: HACS -> Integrations -> Click menu in right top -> Custom repositories
   2. A modal opens
   3. Fill https://github.com/Pharylon/hao_deng_cloud in the input in the footer of the modal
   4. Select integration in category select box
   5. Click Add
2. Search integrations for Hao Deng Cloud
3. Click Install
4. Restart Home Assistant
5. Setup Hao Deng Cloud integration using Setup instructions below

Install manually

1. Install this platform by creating a custom_components folder in the same folder as your configuration.yaml, if it doesn't already exist.
2. Create another folder hao_deng_cloud in the custom_components folder. Copy all files from custom_components/hao_deng_cloud into the hao_deng_cloud folder.

Setup

1. In Home Assistant click on Settings
2. Click on Devices & services
3. Click on + Add integration
4. Search for and select Hao Deng Cloud
5. Enter you username and password you also use in the Hao Deng app
6. The system will download you light list and add them to Home Assistant
7. Once the system could connect to one of the lights your lights will show up as available and can be controlled from HA
8. Enjoy :)

Troubleshooting

This integration requires the cloud

1. Make sure it works through the Hao Deng app (this integration does not work unless you can control your lights through that app) when bluetooth is off, or you're out of bluetooth range of your lights
2. Make sure your country code is correct
3. Make sure you have the newest version of this integration installed
4. Restart your server once if you've made any chages to your lights recently
5. Before submitting an issue, add custom_components.hao_deng_cloud: debug to the logger config in you configuration.yaml:

logger:
  default: error
  logs:
     custom_components.hao_deng_cloud: debug

Restart Home Assistant for logging to begin.
Logs can be found under Settings - System - Logs - Home Assistant Core
Be sure to click Load Full Logs in order to retrieve all logs and submit those with any issues.

Magic Light BLE and Magic Home Pro Users

If you use the Magic Light BLE or Magic Home Pro app, this might work. But I don't know, I don't use that app so I haven't tested it. My understand is they're all just reskinned versions of the Hao Deng app, but again, I have no first-hand experience using them. If you use either of those apps and this integration doesn't work, drop me a line and I can take a look at adding support. And if you do use them and they do work, let me know so I can update this ReadMe!

Credits

Credit to @SleepyNinja0o started work on a bluetooth integration and had to give it up as it was unstable. However, I used his authentication code and got a lot of other helpful tidbits from his repo. Huge shotout to him for all his hard work!