A python async API for PowerView blinds written for Home-Assistant.
Have a look at the examples folder for some guidance how to use it.
| Description | Capabilities | Primary | Secondary | Tilt | Tilt Position | Vertical | DualShade |
|---|---|---|---|---|---|---|---|
| Bottom Up | 0 | X | |||||
| Bottom Up Tilt 180° | 1* | X | 180° | Closed | |||
| Bottom Up Tilt 90° | 1 | X | 90° | Closed | |||
| Bottom Up Tilt 180° | 2 | X | 180° | Anywhere | |||
| Vertical | 3 | X | X | ||||
| Vertical Tilt Anywhere | 4 | X | 180° | Anywhere | X | ||
| Tilt Only 180° | 5 | 180° | Anywhere | ||||
| Top Down | 6 | X | |||||
| Top Down Bottom Up | 7 | X | X | ||||
| Dual Shade Overlapped | 8 | X | X | X | |||
| Dual Shade Overlapped Tilt 90° | 9 | X | X | 90° | Closed | X | |
| Dual Shade Overlapped Tilt 90° | 10 | X | X | 180° | Closed | X | |
| Dual Shade Overlapped Illuminated | 11^ | X | X | X |
^ Capability 11 shades have the same functionality as capability 8 shades, plus an inbuild light. Light management not available via aiopvapi at this time
Shades that have been directly added to the API are listed below and should function correctly. In most cases this is identification is purely aestetic.
Shades not listed will get their features from their capabilities, unfortunately the json returned from the shade can sometimes be incorrect and we need to override the features for the API (and Home-Assistant) to read them correctly.
| Name | Type | Capability |
|---|---|---|
| AC Roller | 49 | 0 |
| Aura Illuminated, Roller | 49 | 11 |
| Banded Shades | 52 | 0 |
| Bottom Up | 5 | 0 |
| Curtain, Left Stack | 69 | 3 |
| Curtain, Right Stack | 70 | 3 |
| Curtain, Split Stack | 71 | 3 |
| Designer Roller | 1 | 0 |
| Duette | 6 | 0 |
| Duette, Top Down Bottom Up | 8 | 7 |
| Duette Architella, Top Down Bottom Up | 33 | 7 |
| Duette DuoLite, Top Down Bottom Up | 9 | 7 |
| Duolite Lift | 79 | 9 |
| Facette | 43 | 1 |
| M25T Roller Blind | 42 | 0 |
| Palm Beach Shutters | 66 | 5 |
| Pirouette | 18 | 1 |
| Pleated, Top Down Bottom Up | 47 | 7 |
| Provenance Woven Wood | 19 | 0 |
| Roman | 4 | 0 |
| Silhouette | 23 | 1 |
| Silhouette Duolite | 38 | 9 |
| Sonnette | 53 | 0 |
| Skyline Panel, Left Stack | 26 | 3 |
| Skyline Panel, Right Stack | 27 | 3 |
| Skyline Panel, Split Stack | 28 | 3 |
| Top Down | 7 | 6 |
| Twist | 44 | 1* |
| Vignette | 31 | 0 |
| Vignette | 32 | 0 |
| Vignette | 84 | 0 |
| Vignette Duolite | 65 | 8 |
| Vertical | 3 | 0 |
| Vertical Slats, Left Stack | 54 | 4 |
| Vertical Slats, Right Stack | 55 | 4 |
| Vertical Slats, Split Stack | 56 | 4 |
| Venetian, Tilt Anywhere | 51 | 2 |
| Venetian, Tilt Anywhere | 62 | 2 |
* No other shade are known to have this capability and currently the only way to get this functionality is by hardcoding into this API
- Install dev requirements.
- Testing is done using NOX
- Build a package:
python .\setup.py bdist bdist_wheel --universal - upload a package
twine upload dist/*.*
- Constrain aiohttp package versions.
- Add endpoints and handle 423 response
- Remove loop as argument
- Add support for all known shade types
- Fallback to shade recognition based on capability
- Clamping to prevent MIN_POSITION or MAX_POSITION being exceeded
- Code refactoring
- Invert type 3 & 4 to match api documentation from hunter douglas
- Add type 10
- Bug Fix to handle shades with unexpected json responses
- Add Type 26, 27 & 28 - Skyline Panels
- Force capability 1 for Type 44 - Twist
- Align class name standard
- Add Type 10 - SkyLift
- Handle calls to update shade position during maintenance
- Raise error directly on hub calls instead of logger
- Major overhaul to incorporate gateway version 3 API. Version can be automatically detected or manually specified.
- UserData class is deprecated and replaced with Hub.
- ShadePosition class now replaces the raw json management of shades in support of cross generational management.
- Schedules / Automations are now supported by the API
- New get_objecttype methods available to returned structured data objects for consistent management
- Raw hub data updates made via defined function (
request_raw_data,request_home_data,request_raw_firware,detect_api_version) - Parse Gen 3 hub name based on serial + mac
- Find API version based on firmware revision
- Remove async_timeout and move to asyncio
- Add type 19 (Provenance Woven Wood)
- Fix Positioning for ShadeVerticalTiltAnywhere + ShadeTiltOnly (Mid only)
- Fix logging regression on initial setup
- Fixes for ShadeVerticalTiltAnywhere + ShadeTiltOnly
- Fix tests
- Remove unneeded declerations
- Fix shade position reporting for v2 shades
- Dandle empty hub data being returned
- General docstring updates
- Handle kwargs in websessions for management of timeout internally
- Update error handling in tools
- Handle empty values and zeros better
- Add type 53 (Sonnette) and yype 95 (Aura Illuminated, Roller). Note: Type 95 do not support light control
- Handle PowerType 11 + 12. Both are fixed and cannot be edited
- Fix missed timeout blocks and handle in websession
