Skip to content

Zengge mesh light integration for Home Assistant

License

Notifications You must be signed in to change notification settings

SleepyNinja0o/home-assistant-zengge

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zengge Mesh Component for Home Assistant

alt text

Control your Zengge bluetooth mesh lights from Home Assistant!

Install with HACS (recommended)

Do you have HACS installed?

  1. Add Zengge Mesh as custom repository.
    1. Go to: HACS -> Integrations -> Click menu in right top -> Custom repositories
    2. A modal opens
    3. Fill https://github.com/SleepyNinja0o/home-assistant-zengge in the input in the footer of the modal
    4. Select integration in category select box
    5. Click Add
  2. Search integrations for Zengge Mesh
  3. Click Install
  4. Restart Home Assistant
  5. Setup Zengge Mesh 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 zenggemesh in the custom_components folder. Copy all files from custom_components/zenggemesh into the zenggemesh folder.

Setup

  1. In Home Assistant click on Settings
  2. Click on Devices & services
  3. Click on + Add integration
  4. Search for and select Zengge Mesh
  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

As of right now, only the first place is retrieved from the Hao Deng servers, currently working on this

Make sure that at least 1 device/light is in bluetooth range of your Home Assistant server.

If you run into issues during setup or controlling the lights please increase logging and provide them when creating an issue:

Add custom_components.zenggemesh: debug to the logger config in you configuration.yaml:

logger:
  default: error
  logs:
     custom_components.zenggemesh: 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.

Credits

The majority of this work was based on the home-assistant-awox integration created by @fsaris .
Huge shotout to him for all his hard work!

Also, many kudos to @donparlor and @cocoto for their continued support on this project!
It is appreciated very much!

About

Zengge mesh light integration for Home Assistant

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%