7a2bf2193a
Add ShadeCapability lookup to replace hardcoded model string checks for tilt/tilt-only selection. Add velocity number entity (0–100) and pass velocity through all movement paths including open/close. Remove redundant device_info property overrides and deduplicate hex parsing.
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.
- The HOME_KEY is lost over updates!
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.pyfile after each update!
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_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledhunterdouglas_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
myPVcoverto your home. You will see a log messageset 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.
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
Outlook
- Add tests!
- Allow parallel usage to PowerView app as "remote"
- Add support for tilt function
- Add support for further device types