Z2M, Philips Hue, and updating brightness without turning on

Configuration
1

Hello everyone,

I’m looking for some guidance on a specific automation challenge I’m facing with my Home Assistant setup.

I have a number of Philips Hue lights connected through Zigbee2MQTT (Z2M). I’m trying to create a script that adjusts the brightness of these lights without turning them on if they are currently off.

My current script uses light.turn_on which, as expected, turns the light on and sets the brightness. I

I tried, since I’m using Z2M, to send a direct MQTT command to bypass this behavior, but it doesn’t work. The MQTT message contains “status:ON” which seems to turn on the light. Writing “off” keeps the light turned off, or turns the light off, and disregards the brightness level.

Do you have any suggestions on how achieve with a script as follows;

If light is on, change brightness
If light is off, change brightness but don’t turn the light on yet, make sure they when light turns on, the new value of brightness is taken

Thanks!

2

Send an MQTT message to zigbee2mqtt/Friendly Name/set with payload {"state":null, "brightness": 254}

3

I’m not sure if all (or any) Hue lights support changing the brightness while the light is off.

If you’re not seeing that functionality working with "state": "OFF" or with "state": null (the latter as suggested above), you might need to use a scene that is programmed with Z2M.

4

Thank you!

I managed to change indeed the brightness value while OFF, and also in the Z2M user interface the new value of brightness is visible - however, when turning the light on, it picks up the former value, not the current one…

Any idea what else I could do?

An alternative would be to edit helper values:

  • if light is ON, an Automation would update the brightness of the light
  • if light is OFF, a dedicated script would turn on the light with a pre-defined value of brightness taken from the helper

I’d like to avoid it because of the hassle in maintaining all those helpers.

Thanks!

5

Like Dominic said before, not all devices support this feature. I used it with IKEA lights running on latest firmware (ZB3). I read somewhere that newer Hue lights (with BT) also support this, but I never use it myself.

Try also to send this payload to zigbee2mqtt/Friendly Name/set:

{"level_config": {"execute_if_off": true}}

This needs to be done just once. I believe that the outcome of this option is to write value 0x01 to attribute 0x000F of Zigbee cluster 0x0008 to enable pre-staging. If your device does not support this, I expect that you should get some error in the Z2M logs.

Hope this helps.

Edit: To enable color / color temperature pre-staging use this payload:

{"color_options": {"execute_if_off": true}}

Or combine both in a single payload:

{"level_config": {"execute_if_off": true}, "color_options": {"execute_if_off": true}}
6

I have a definitive solution for you that works for hue lights and - excitingly - allows them to be locally bound to [Inovelli] switches and works seamlessly, with no log errors/light staggers/duplicate commands. (Ataraxia Lighting is my own internal name ;))

This blueprint is a setup blueprint that configures hue lights from scratch for my preferences. It creates the correct settings for each of your lights to accept and report light and color commands while off. FYI read through the full blueprint to understand what all it does. zigbee2mqtt required. Make sure your lights have the latest firmware.

You need to run this once and select your lights. It does not need to be run on reboot as far as I can tell.

https://raw.githubusercontent.com/mnestrud/ha_random/refs/heads/main/Ataraxia%20Lighting%20-%20Hue%20Defaults.yaml

I recommend that anyone who uses this adopt it as their own - in other words expect it to change without warning.

Next, in whatever adaptive loop you have, send this mqtt publish command when it is on:

Base Topic/My Light/set

{
  "state": "ON",
  "brightness": <bri>,   // 1–254
  "color_temp": <mired>  // 153–500 mireds
}

and this one when it is off:

Base Topic/My Light/set

{
  "state": null,
  "brightness": <bri>,   // 1–254
  "color_temp": <mired>  // 153–500 mireds
}

You can validate all this with developer tools → actions and select mqtt.publish.

I have the default adaptive lighting hacs plugin running with no light targets to calculate my brightness and color settings and then a master loop that goes through my rooms and runs one of these commands every 90 seconds, pulling the correct brightness and color from the adaptive lighting plugin switch. (Separate configuration and commands are required to get the inovelli switches working)

7

Thank you ataraxia and dandanache! I’ll try both!

8

Thanks a lot!
It works like a charm, and now I can implement automatic color temperature changing

9

You’re a legend! This allowed me to use PyScript and json.dump to set bathroom lights to red at nighttime.

Code snippet:

entity_id = 'light.bathroom_ceiling'
friendly_name = state.getattr(entity_id).get('friendly_name')
log.info(f"{friendly_name.upper()} set to NIGHTLIGHT RED")

mqtt.publish(
  topic=f'zigbee2mqtt/{friendly_name}/set',
  payload=json.dumps({'color': {'x': 0.7006, 'y': 0.2993}})
)

light.turn_on(entity_id=entity_id, brightness_pct=10, transition=1)
10

That is fantastic. I’ve been doing some additional heavy lifting on this to try and create a solution that is fully deterministic with absolutely no double commands, race conditions, or conflicts. I think the next step will be to code it up and package it up as an integration.

Adaptive lighting as implemented by most default integrations basically sucks. To achieve the cognitive, emotional, environmental benefits you need accurate prestaging while off and accurate adaptation while on, no fast changes or blips, and fully local control compatible if the switch supports it. Unfortunately this requires a bit more intimate knowledge about each bulb and switches capability so will require some thought.

11

This is an old threat but thought it may be useful to add a simpler solution for those searching for answers using a Zigbee scene...

In Z2M, go to the device [or group] and choose the scene tab and set a scene with the device [or group] set to off with the desired brightness, color, etc.

Then set an automation to trigger when the device [or group] turns off that sends an MQTT message to the device [or group] to activate the scene - the message should be as follows if the scene ID is 1:
Topic: zigbee2mqtt/{zigbee_device_friendly_name}/set
Payload: {"scene_recall": 1}

This will set the desired brightness / color when the light is next turned on