A Home Assistant custom integration for Häfele Connect Mesh devices. This integration allows you to control Häfele smart devices through Home Assistant.
I'm excited to share some great news regarding the Häfele Connect Mesh integration! Recently, I had the opportunity to connect with Häfele, and I'm delighted to report that they are not only aware of this project but are also highly supportive of Open Source Initiative (OSI) principles and open-source development as a whole. Häfele recognizes the importance of community-driven platforms like Home Assistant and is eager to see seamless integrations that benefit both their customers and the broader open-source community.
To support the development and testing of this integration, Häfele has generously provided me with a selection of their hardware. This will enable me to expand the capabilities of the Häfele Home Assistant integration and ensure broader compatibility with their product lineup.
You can expect to see more features, enhanced stability, and support for additional Häfele devices in the coming months as I put this hardware to work. Stay tuned for updates!
Currently, this integration has been tested with:
- Häfele LED lights (dimmable)
- Power socket (Häfele, LEDVance or Jung)
While the integration includes support for color temperature and RGB/HSL capable lights, as well as other device types (switches, sensors, etc.), these features are currently untested as I don't have access to these device types.
- A working Häfele Connect Mesh setup (Häfele Connect Mesh Gateway)
- A Häfele Connect Mesh API token (Sign up for a Connect Mesh Cloud account and generate an API token)
- Home Assistant 2024.1.0 or newer
- Make sure you have HACS installed
- Add this repository as a custom repository in HACS:
- Go to HACS > Integrations
- Click the three dots in the top right corner
- Select "Custom repositories"
- Add the URL of this repository
- Select "Integration" as the category
- Click "Install"
- Restart Home Assistant
- Copy the
haefele_connect_meshfolder to yourcustom_componentsfolder - Restart Home Assistant
- Go to Settings > Devices & Services
- Click "Add Integration"
- Search for "Häfele Connect Mesh"
- Enter your API token
- Navigate to Connect Mesh Cloud to create an account and generate an API token
- You can manually interact with the API using the Connect Mesh Web API if you prefer
- Select the network you want to add
- Automatic discovery of Häfele devices in your network
- Automatic periodic refresh of device information (i.e. names)
- Support for turning lights on/off
- Support for dimming lights
- Support for color temperature (untested)
- Support for RGB/HSL colors (untested)
- Color temperature and RGB/HSL features are untested
- Other device types (switches, sensors, etc.) are not yet implemented
Feel free to contribute to this project if you have access to other Häfele device types and can help test and improve the integration.
If you find any bugs or have feature requests, please create an issue in this repository.
This project is licensed under the MIT License - see the LICENSE file for details.
This integration is not officially affiliated with or endorsed by Häfele. Use at your own risk.
