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.
• Currently only position change is supported (e.g., no tilt)

Features

• Zero configuration
• Supports ESPHome Bluetooth proxy

Supported Devices

Type*	Description
1	Designer Roller
4	Roman
5	Bottom Up
6	Duette
10	Duette and Applause SkyLift
19	Provenance Woven Wood
31, 32, 84	Vignette
42	M25T Roller Blind
49	AC Roller
52	Banded Shades
53	Sonnette

*) 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 manually in the const.py file after each update!

Automatic

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

Manual

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called hunterdouglas_powerview_ble.
4. Download all the files from the custom_components/hunterdouglas_powerview_ble/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. 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 optain the key:

1. 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.
2. Extracting from gateway: This PR proposes a script to extract the key from a working PowerView gateway.
3. Grabing from the app: Checkout this post in the Home Assistant community forum.

Finally, you need to manually copy the key to const.py.

Important

You need to update the file after each update!

Outlook

• Add support for encryption
• Allow parallel usage to PowerView app as "remote"
• Add support for tilt function
• Add support for further device types

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.