WAREMA - An home assistant plugin to add and control window awning / ZIP blinds

Description

This platform plugin allows you to control window awnings / ZIP blinds from the manufacturer Warema. The plugin controls your components via the Warema API.

Requirements

You need to have Warema WMS WebControl pro installed to your network and have enabled the cloud connect. WMS WebControl pro is a hardware for integrating a mobile end device into the WMS as an additional transmitter. It is operated by app or web browser. The system is operating at home directly via the WLAN network or with a worldwide access via optional cloud connection.

Warema window awnings

WMS WebControl pro

Installation

Upgrading from an old component version

• Remove all configuration from Home Assistants config file configuration.yaml
• Upgrade the component via HACS or manually replace the files in the custom_component folder (see install manually below)
• Restart Home Assistant
• Add the component again as per below (install + configuration)

Install with HACS (recommended)

Do you you have HACS installed? Just search for Warema and install it direct from HACS. HACS will keep track of updates and you can easly upgrade Warema to the latest version.

Install manually

Make sure you have an account on your Warema WMS WebControl pro!

Clone or copy the repository and copy the folder homeassistant/custom_component/warema into <config dir>/custom_components

Configuration

• Restart Home Assistant
• Add and configure the component via the UI: Configuration > Integrations > search for Warema and follow the wizard to configure (use your Warema WMS WebControl pro credentials)
• All available components and controls should be added automatically

Configuration flow settings

Use your "Warema WMS WebControl pro" credentials! Password will be converted to a Bearer access token for the interaction with the Warema API.

• Username
• Password

Exposed entities

• cover.warema_[YOUR-ENTITY-Name] for each of your Warema window awnings

Note: If you have configured an awning collection entitiy in your App, this will appear as an own cover entity in HA

Automations

Save these automations in your automations file <config dir>/automations.yaml

Close covers when the sun is shining (above 50000 Lumen) and temperature is above 21°

- id: control_warema_awnings_sun_protection
  alias: Control Warema Awnings (Sun protection)
  trigger:
    - platform: numeric_state
      entity_id: sensor.temperature
      above: 21
    - platform: numeric_state
      entity_id: sensor.lightLumen
      above: 50000
  action:
    - service: scene.turn_on
      entity_id: scene.sun_protection

- id: control_warema_awnings_open
  alias: Control Warema Awnings (Open)
  trigger:
    - platform: state
      entity_id: cover.warema_all
      state: "closed"
    - platform: numeric_state
      entity_id: sensor.lightLumen
      below: 50000
      for: 30   # min
  action:
    - service: scene.turn_off
      entity_id: scene.sun_protection

Limitations

Please be aware that at this time the plugin only adds and controls window awnings. Support for e.g. Raft-Stores is not implemented yet due to the lack of being able to test it.

To be done

1. Parse room name from WMS and add it to HA
2. Add preconfigured scenes

Credits

Thanks a lot to Stefan Ruf from Warema who supported the development of this plugin