Skip to main content

Hook - Cover

Import this blueprint

My Home Assistant

Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.
(Home Assistant 2024.10.0 or higher)

Direct Link

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 cover. Supports opening, closing and tilting the cover.

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

Cover Integration

Required

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

Cover Integration Docs

Inputs​

Controller Device Device Required

The controller device which will control the Cover. Choose a value only if the integration used to connect the controller to Home Assistant exposes it as a Device. This value should match the one specified in the corresponding Controller automation.

Controller model Select Required

The model for the controller used in this automation. Choose a value from the list of supported controllers.

Cover Entity Required

Cover which will be controlled with this automation.

Supported Controllers​

Additional Notes​

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

Changelog​

  • 2021-03-26: first blueprint version 🎉

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

  • 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.

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

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

  • 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-02-20: Added support for IKEA E2201 RODRET Dimmer. (@yarafie)