Skip to main content

Hook - Light

Import this blueprint

My Home Assistant

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.


tip

This blueprint is part of the Controllers-Hooks Ecosystem. You can read more about this topic here.

Description​

This Hook blueprint allows to build a controller-based automation to control a light. Supports brightness and color control both for white temperature and rgb lights.

info

An automation created with this blueprint must be linked to a Controller automation. Controllers are blueprints which allow to easily integrate a wide range of controllers and use them to run a set of actions when interacting with them. They expose an abstract interface used by Hooks to create controller-based automations.

See the list of Controllers supported by this Hook for additional details.

Requirements​

Controller Automation

Required

To use this blueprint you need to first create an automation with a Controller blueprint. You can then create an automation with this Hook, making sure that you provide the same controller device used in the corresponding Controller blueprint. This key step will link the two automations and ensure the Hook will respond to events fired by the Controller.

List of Supported Controllers - Controllers Docs

Light Integration

Required

This integration provides the entity which represents a light in Home Assistant. It should be activated by default so unless you tweaked the default configuration you're good to go.

Light Integration Docs

Inputs​

Supported Controllers​

Additional Notes​

If you want to link multiple lights to the same controller you can either use Light Groups or build multiple Hooks linked to the same Controller.

Changelog​

  • 2021-03-04: first blueprint version 🎉

  • 2021-03-07: add support for IKEA E1744 SYMFONISK rotary remote

  • 2021-03-14: add support for IKEA E1812 Shortcut button, fix E1743 naming

  • 2021-03-25: update action mapping for IKEA E1744. If you're using this Hook with an IKEA E1744, please update also the corresponding Controller blueprint

  • 2021-03-26:

    • set minimum and maximum light brightness
    • specify number of steps from min to max brightness, both for short and long actions, when controlling the light
    • allow to force brightness to a specific value when turning on the light

  • 2021-03-27: add support for Philips Hue dimmer switch

  • 2021-04-06: fix light color modes not allowing to configure an automation with color temperature control.

  • 2021-04-15:

    • add smooth power on/off features
    • breaking change: by default the light now turns off when a brightness down command is received and light is at minimum brightness. To disable this behaviour, turn off the smooth power off feature.
    • fix some optional fields name.

  • 2021-04-19: remove unused variable, fix warnings for undefined variables in Home Assistant Core >=2021.4.0

  • 2021-05-16: Add support for Osram SMART+ Switch Mini

  • 2021-07-03: Add support for Philips Hue Smart Button

  • 2021-08-02: Improve inputs documentation and organization

  • 2021-10-26:

    • Standardize blueprints structure and inputs naming across the whole collection.
    • Improve blueprint documentation.
    • 🎉 Add support for alternate mappings. Additional mappings for currently supported controllers will be added from now on. Refer to the documentation of your controller for more details.
    • ⚠️ Breaking Change: update controller names in the Controller Model input, to match the full name of controllers, prevent ambiguities and enable support for alternate mappings. After updating this blueprint, please reconfigure your automations by selecting again the value for the Controller Model input, matching the full name of the controller you're using with this hook.
    • Fix for remembering brightness level when turning on, where brightness level unavailable when light off.
    • Added secondary mapping for IKEA E1743 TRÅDFRI On/Off Switch & Dimmer

  • 2021-10-29: Add support for IKEA E1766 TRÅDFRI Open/Close Remote.

  • 2021-11-07:

    • Add support for IKEA E2001/E2002 STYRBAR Remote control.
    • Fix color mode automatic detection not working properly with color temperature lights.
    • Add "None" color mode to completely disable color control features.

  • 2021-11-21: Add support for Philips 929002398602 Hue Dimmer switch v2.

  • 2021-12-03: Add support for Xiaomi WXCJKG11LM, WXCJKG12LM, WXCJKG13LM.

  • 2021-12-05: Added secondary mapping for IKEA E2001/E2002

  • 2022-07-22: Add support for Xiaomi WXKG11LM.

  • 2022-07-30: Add support for SONOFF SNZB-01.

  • 2025-02-13:

    ⚠️ Breaking Change:

    Migrate to Zigbee2MQTT MQTT Device Triggers. (@yarafie)

    The controller_entity input has been deprecated, and controller_device is now mandatory. If you are a Zigbee2MQTT user and plan to update this blueprint, please make sure to remove the controller_entity input from your automation config and add the device ID of your controller to the controller_device input. To obtain the device ID from your controller, configure the automation from the UI and use the device selector dropdown on the controller_device input to select your controller.

  • 2025-02-16:

    ⚠️ Breaking Change:

    Add support for Xiaomi WXKG01LM Mi Wireless Switch, rename Xiaomi WXKG11LM Aqara Wireless Switch Mini to Aqara WXKG11LM Wireless Mini Switch

    If you had configured the controller_model input to Xiaomi WXKG11LM Aqara Wireless Switch Mini, please change it to Aqara WXKG11LM Wireless Mini Switch. The change has been implemented to match the controller with the correct manufacturer name (Aqara).

  • 2025-03-18: use min_brightness and max_brightness as conditions instead of "while true" loops @Nicolai-.

  • 2025-03-20: Added support for IKEA E2201 RODRET Dimmer. (@yarafie)

  • 2025-03-26: Added support for IKEA E2213 SOMRIG shortcut button. (@yarafie)

  • 2025-03-28: Added support for IKEA E2123 SYMFONISK sound remote, gen 2. (@yarafie)

  • 2025-03-29: Added support for Tuya ERS-10TZBVK-AA Smart knob. (@yarafie)