HD PowerView Support via BLE for Home Assistant

A Home Assistant integration to support Hunter Douglas Powerview devices via Bluetooth

Warning

This integration is under development!
Test coverage is low, malfunction might occur.

Features

Zero configuration
Supports ESPHome Bluetooth proxy

Supported Devices

Type*	Description
1	Designer Roller
4	Roman
5	Bottom Up
6	Duette
8	Duette, Top Down Bottom Up
9	Duette DuoLite, Top Down Bottom Up
10	Duette and Applause SkyLift
19	Provenance Woven Wood
31, 32, 84	Vignette
33	Duette Architella, Top Down Bottom Up
39	Parkland
42	M25T Roller Blind
47	Pleated, Top Down Bottom Up
49	AC Roller
51, 62	Venetian, Tilt Anywhere
52	Banded Shades
53	Sonnette
103	Duo Roller

*) Type can be found in the PowerView app under product info, type ID

Provided Information

The integration provides the following information about the battery

Platform	Description	Unit	Details
`binary_sensor`	battery charging indicator	`bool`	true if battery is charging
`button`	identify shade	-	identify shade by LED and 3 beeps
`cover`	view/control position	`%`	percentage cover is open (100% is open)
`sensor`	SoC (state of charge)	`%`	range 100% (full), 50%, 20%, 0% (battery empty)

Installation

Important

In case you added your shades to the app or a gateway, you need to set the encryption key via the integration's configuration flow in Home Assistant.

Automatic

Installation can be done using HACS by adding a custom repository.

Manual

Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
If you do not have a custom_components directory (folder) there, you need to create it.
In the custom_components directory (folder) create a new folder called hunterdouglas_powerview_ble.
Download all the files from the custom_components/hunterdouglas_powerview_ble/ directory (folder) in this repository.
Place the files you downloaded in the new directory (folder) you created.
Restart Home Assistant
In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Hunter Douglas PowerView (BLE)"

Set the Encryption Key

Currently, there are three methods to obtain the key:

Via adopting a BLE shade: There is a shade emulator that works with Arduino IDE and an ESP32 device (≥ 2MiB flash, ≥ 128KiB required), e.g. Adafruit QT Py ESP32-S3. Install and connect via serial port, then go to the PowerView app and add the shade myPVcover to your home. You will see a log message set shade key: \xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx\xx . Copy this key. You can delete the shade from the app when done.
Extracting from gateway: This script is able to extract the key from a working PowerView gateway.
Grabbing from the app: Checkout this post in the Home Assistant community forum.

Once you have the key, enter it via the integration's configuration flow in Home Assistant: Settings → Devices & Services → Hunter Douglas PowerView (BLE) → Configure

The key is stored in the HA config entry and persists across integration updates.

Known Issues

Shade inoperable after charging

It seems that the shades require some re-initialization after charging. The solution is currently unknown, but as a workaround you can operate the shade ones using the vendor app.

Troubleshooting

In case you have severe troubles,

please enable the debug protocol for the integration,
reproduce the issue,
disable the log (Home Assistant will prompt you to download the log), and finally
open an issue with a good description of what happened and attach the log.

Thanks To

@mannkind

Outlook

Add tests!
Allow parallel usage to PowerView app as "remote"
~~Add support for tilt function~~ ✅ Vanes/tilt control for Duette, Duo Roller, and Venetian shades
Add support for further device types

Flameeyes/hdpv_ble

README