Configure covers

The boneIO Black Cover controller allows configuration of 8 covers or blinds. Each cover can operate as a regular cover (TIME_BASED) or a venetian blind with tilt function (VENETIAN).

How to add or edit a cover?

1. Go to Settings → Covers
2. Click Add New or the edit icon next to an existing cover
3. Fill in the configuration form

Basic settings

Display Name

Friendly name for the cover, e.g.:

• Living Room Cover
• Bedroom Blind
• Terrace Awning

This name will be visible in the interface and Home Assistant.

Custom ID

Technical ID of the cover (optional):

• If not provided, it will be auto-generated as cover_{open_relay}_{close_relay}
• Only lowercase letters, numbers, and underscores
• Example: living_room_cover

Area / Room

Select an area from the dropdown - the cover will be automatically assigned to this area in Home Assistant.

Platform

Select the cover type:

Open Relay

Select the output responsible for opening (up):

• cover_01_up, cover_02_up, ... cover_08_up

Close Relay

Select the output responsible for closing (down):

• cover_01_down, cover_02_down, ... cover_08_down

Open Time

Time required for full opening of the cover, e.g.:

• 30s - 30 seconds
• 45s - 45 seconds
• 1m - 1 minute

Minimum: 1 second

Close Time

Time required for full closing of the cover, e.g.:

• 30s - 30 seconds
• 45s - 45 seconds

Minimum: 1 second

Tilt Duration (VENETIAN only)

Time required for full slat rotation (venetian blinds only), e.g.:

• 500ms - 500 milliseconds
• 1s - 1 second

Minimum: 10 milliseconds

This field appears only when you select VENETIAN platform.

Advanced settings

Click the Advanced Settings tab to access additional options:

Device Class

Device type in Home Assistant (affects icon):

Other advanced options

• Restore State - restore state after restart
• Show in HA - visibility in Home Assistant
• Other parameters - platform-dependent

Configuration examples

Example 1: Regular cover in living room

1. Display Name: Living Room Cover
2. Area / Room: Living Room
3. Platform: TIME_BASED
4. Open Relay: cover_01_up
5. Close Relay: cover_01_down
6. Open Time: 30s
7. Close Time: 30s
8. Device Class: shutter

Example 2: Venetian blind in bedroom

1. Display Name: Bedroom Blind
2. Area / Room: Bedroom
3. Platform: VENETIAN
4. Open Relay: cover_02_up
5. Close Relay: cover_02_down
6. Open Time: 25s
7. Close Time: 25s
8. Tilt Duration: 800ms
9. Device Class: blind

After saving, the covers will appear in the table and be available in Home Assistant in the corresponding areas.