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 2021.3.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 or entity 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 Entity Entity Required

The controller entity which will control the Cover. Choose a value only if the integration used to connect the controller to Home Assistant exposes it as an Entity. 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.