Hi, and thank you for all the work you’re doing on the netatmo integration. I have been using it a lot with tons of celiane switches and weather modules.
Netatmo API supports zigbee color led lights from Philips Hue and LEDVANCE
I have bought compatible lights (philips Hue and LEDVANCE zigbee) that I added to my Celiane Zigbee gateway. They appear as basic light switches, but we are missing the ability to set the colors of those LED.
Netatmo doesn’t help much with their API documentation, but I have played a little with it and I have found out that the API allows the control of many color parameters on the compatible Z3L type devices. Here’s what I have managed to do with the API, and I can share those learnings below.
Using the legrand api to set the color
On the legrand api, the homestatus method tell us which devices are color compatible (types “Z3L”) and the min and max temperature values available.
Here’s an example of the data returned on my Philips Hue Light by the netatmo api :
{
"brightness": 50,
"color_mode": "temperature",
"color_temperature": 219,
"color_temperature:min": 153,
"color_temperature:max": 500,
"hue": 220,
"id": "xxx",
"on": true,
"reachable": true,
"saturation": 10,
"type": "Z3L",
"variant": "Z3L:generic_extended_color_light",
// ... and some other data
},
We can clearly see that the API knows about the color capabilities of such lights.
For those device, we have additional body parameters to use in the setstate method of the netatmo api:
{
"home": {
"id": "xxx",
"modules": [
{
"id": "xxx",
// You can turn on or off the light
"on": true, // true or false to turn on or off the light
"brightness": 100, // 0 to 100%
// For a product type=Z3L (Zigbee 3rd party light) it appears we have other fields we can use to control the color of the bulbs
// You can either set the color using the color mode
"saturation": 100, // percent saturation in color between the center and outer of the hue wheel
"hue": 240, // angle on the hue wheel 0-360°, red=0, green=120, blue=240
// Or you can use color_temperature white mode
// "color_temperature": 500, // between the boundaries returned by get homestatus : "color_temperature:min": 153, "color_temperature:max": 500
"bridge": "xxx..."
}
]
}
}
I tried playing with the API and this works flawlessly.
Why do we need to add this feature
I would really need the Home Assistant integration to give me control on the colors of the lights, as I would be able to synchronize multiple bulbs.
(Even in the Home+ control app, you have to click on each bulb to set it’s color on the wheel, resulting in a cumbersome and not synchronized way to set multiple bulbs on a color at once, and you have different hue values since the wheel is not precise).
Possible issues ?
I don’t see a lot of things that can go wrong here, except that those lights are always added as switches in the Home assistant entities. Maybe switches don’t support color modes and color wheels.
It would maybe also help to enable this integration to import light modules as light and not switches, according to the types of the device reported in the API :
Netatmo Connect | Legrand API Documentation
I’ll hope you’ll find a way to add this feature support on the Netatmo API, it would really help me a ton.
Have a great day !
