hdpv_ble/README.md

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
39	Parkland
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 obtain 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 script is able to extract the key from a working PowerView gateway.
3. Grabbing 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!

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
• Add support for further device types