boneIO Documentation | Set the Covers

What are outputs?

Outputs are the executive parts of our controller.

This guide applies to

Controlling the outputs of the boneIO ESP Cover module

On other pages, you will find instructions for controlling the other boneio ESP modules.

32 relays 10A

24 relays 16A

Covermix module – 8 covers and 16 relays 10A

Why should you name them?

Naming your outputs will make working with the controller much easier. It's much easier to remember "Living Room Cover" than "Cover 01", right?

In our examples, we focus on a part of the configuration, which you can then adjust to your entire configuration.

Let's get started!

Roller Shutter Control (`time_based`)

This is the standard configuration for typical roller shutters without tilt control. It uses the time_based platform to estimate the cover's position.

cover:
  - platform: time_based
    name: "Living Room Cover"
    id: cover_01
    open_action:
      - switch.turn_on: cover_open_01_out01
    open_duration: 22s
    close_action:
      - switch.turn_on: cover_close_01_out02
    close_duration: 21s
    stop_action:
      - switch.turn_off: cover_open_01_out01
      - switch.turn_off: cover_close_01_out02

Configuration Explained

Parameter	Description
`platform: time_based`	Defines the cover as a standard roller shutter.
`name: 'Living Room Cover'`	A friendly name for Home Assistant. Change it to match the location, e.g., `'Bedroom Cover'`.
`open_duration` / `close_duration`	Crucial for calibration! You must measure the time it takes for the shutter to fully open and close and update these values.

Venetian Blinds Control with Tilt (`venetian_blinds`)

For venetian blinds, you can control the tilt of the slats using the venetian_blinds custom platform. This requires a more advanced setup.

For detailed instructions on how to set up the custom component and calibrate your venetian blinds, please see the How to Edit Config File guide.

Once configured, your cover block will look like this:

cover:
  - platform: venetian_blinds
    name: "Bedroom Blind"
    id: blind_01
    open_duration: 22s
    close_duration: 21s
    tilt_duration: 1500ms
    # ... other parameters are pre-configured

Additional Configuration Parameters

Parameter	Description
`platform: venetian_blinds`	Defines the cover as a venetian blind with tilt support.
`name: 'Bedroom Blind'`	A friendly name for your blind.
`tilt_duration`	Crucial for calibration! The time in milliseconds it takes for the slats to tilt from fully closed to fully open.

Set the Covers