I’m excited to announce the release of a new custom integration: Häfele Connect Mesh. This integration allows you to seamlessly connect and control your Häfele (Haefele) Connect Mesh devices through Home Assistant.
Features:
Device Discovery: Automatically discovers Häfele Connect Mesh devices on your network.
Control Lights: Turn on/off lights and adjust brightness.
Configurable via UI: Set up the integration through the Home Assistant UI with ease.
In development:
Control RGB Lights: Change the color and brightness of RGB lights.
Control Lights Temperature: Change the temperature and brightness of Multiwhite lights.
Scene control: Use your existing scenes from the app.
Installation Instructions:
HACS Installation:
Go to HACS in Home Assistant.
Add a custom repository with the URL: https://github.com/guillaumeseur/hafele_connect_mesh.git.
Install the Häfele Connect Mesh integration from the HACS store.
Configuration:
Go to Configuration → Integrations.
Click on “Add Integration” and search for “Häfele Connect Mesh”.
Enter your API key and follow the prompts to set up your devices.
Documentation: Available in the GitHub repository.
Feedback and Support:
Feel free to post any issues, feature requests, or general feedback in this thread or create an issue on GitHub. Your input is valuable and helps improve the integration.
Thank you for your support, and I hope you find this integration useful!
Wow this is great. Just ordered a gateway after I saw the initial post a few day ago and so far the integration works perfect!
I have a few LED Strips as well as a few ceiling lamps from Nimbus (Q Four). They can all adjust the color of the light from 2700 to 4000k I think and are dimmable as well. Integrating this features would be amazing, then I could ditch the cumbersome häfele app alltogether!
Thanks for using this integration! I didn’t expect such active interest, and I’m thrilled by the positive responses.
I’ve been intensively exploring the API and encountered a few issues. While the documentation shows support for changing temperature, RGB values, getting device status, and calling scenes, I only receive “Internal Server Error” responses. I suspect issues with the API itself and will contact the developers for clarification.
Features I aim to add:
Temperature control
RGB control (hue)
Device states
Scene control (I can already find scene IDs in the network)
Currently, identifying device capabilities within the Häfele network isn’t straightforward. I’ve hardcoded controls based on returned types, such as:
com.haefele.led.rgb = Brightness / hue
com.haefele.wallcontroller.actuator = toggle
com.haefele.led.multiwhite.2700K = Brightness / Temperature
com.haefele.led.white.strip = brightness
These are the types I own. For unknown types, I might seek help from the community to identify so I can implement controls.
Thanks for the update. If there is anything I can do to help, let me know. I’m just a user with no real programming experience, but if you need infos/logs from different networks let me know.
Presently I have LED strips from Häfele, Nimbus Q Four ceiling lights, a few meshboxes to control the LED strips and a few EnOcean switches to control my lights.
Yes, you do need the Häfele Connect Mesh Gateway 1 for this integration to work. The gateway acts as an intermediary between your Home Assistant setup and the Häfele Connect Mesh devices. It receives network commands from Home Assistant, converts them into Bluetooth signals, and then communicates with the devices.
Without the gateway, the integration won’t be able to connect to and control your devices.
I wanted to give you a quick update on the progress of the Häfele Connect Mesh integration. I’ve been a bit busy with life recently, but I should have more time to dedicate to this project next week.
Here’s what I have managed to get working so far:
Change temperature of lights.
Retrieve the current states of devices.
Currently, about 5 different devices are hardcoded in the integration; others will show up as a normal switch. In the next version, it will automatically discover devices and add their corresponding abilities (Dimmable, Temperature, RGB).
There are still a few areas that need more work, especially since the API isn’t completely open yet:
Control RGB lights (the settings show up, but the API call isn’t received correctly).
Add buttons to use existing Häfele scenes.
I’m also experiencing some trouble with switches not updating immediately. I’m working on resolving this issue and will release an update once it’s fixed.
OMG! How id I only just find this? I have been wondering how to do this for a while now. I was going to start trying to create a “Loox 5 remote” device profile on an ESP or something like that.
Does anyone who has the Hafele Connect Mesh system (Loox5) have the remote control device? The reason I ask is I have an idea of trying to build a “virtual” remote control on an ESP32 which looks like a remote control to the Connect Mesh app so it can be provisioned and connected to the mesh. Once that is done, it should be “reasonably” straightforward to interface that to HA so we can control the mesh from HA itself.
Unfortunately I don’t have the remote (I have the wall switch but it is not as functional) so I am wondering if anyone does, maybe they could provide the json config database so I can get the correct device identifiers and client/server models it supports?
And annoyingly I asked Hafele in the UK about availability of the gateway:
“… This is not certified for UK use and we unfortunately do not have an alternative currently.”
Just got my Hafele Connect Gateway today and installed it through the Hafele iOS app successfully. I followed your excellent instructions on your Hafele Connect Mesh integration. Everything worked as described and I found my 10 entities for each of my lights. However, when I attempt to turn the lights on and off I get the message: Failed to perform action light/turn_on ‘Nonetype’ object has no attribute ‘get’
Being a relative novice to HA, I’m not sure how to resolve that.
Same issue here with Version 2.
Get the same message:
“Failed to perform action light/turn_on ‘Nonetype’ object has no attribute ‘get’”
In Version 1 I needed to add my devices
“com.haefele.led.rgb.spot”, “com.haefele.led.multiwhite.spot” to light.py
as there were not registered as light. Can this be part of the problem?
So when version 2 came out and there was an update to the iOS Connect Mesh app, I decided to delete and reinstall the custom component and start over again. I was able to link to my connect mesh gateway which was already connected to Alexa (which now also works).
It found all my lights, which didn’t show up as light icons, but they worked and whenever I would turn them on the icon would change to a light.
I will say that sometimes, it doesn’t work unless I try several times turning a light on and off. I created an automation to turn on my in cabinet/under cabinet lights based on Sunset. So far it is working (although occasionally one of the lights doesn’t come on).
The help section on the iOS app mentions that the gateway can work on Wifi, but I have no idea how to enable it. I have mine wired to an Ethernet switch.
.