An AsyncIO API for controlling the Drayton Wiser Heating system
Project description
Drayton Wiser Hub API Async v1.2.1
This repository contains a simple API which queries the Drayton Wiser Heating sysystem used in the UK.
The API functionality provides the following functionality to control the wiser heating system for 1,2 and 3 channel heat hubs The API also supports Smart Plugs and initial basic functionality for Shutter and Lights
Requirements
Requires a minimum of Python v3.9
Installation
1. Find your HeatHub Secret key
Reference https://it.knightnet.org.uk/kb/nr-qa/drayton-wiser-heating-control/#controlling-the-system
-
Press the setup button on your HeatHub, the light will start flashing Look for the Wi-Fi network (SSID) called ‘WiserHeatXXXXXX’ where XXXXXX is last 6 digits of the MAC address
-
Connect to the network from a Windows/Linux/Mac/Android/iPhone machine
-
Execute the secret url :-)
- Open a browser to url
http://192.168.8.1/secret
This will return a string which is your system secret, store this somewhere. If you are running the test script simply put this value , with the ip address of the hub, in your wiserkeys.params
- Open a browser to url
-
Press the setup button on the HeatHub again and it will go back to normal operations
-
Copy the secret and save it somewhere.
3. Find Your HEATHUB IP
Using your router, or something else, identify the IP address of your HeatHub, it usually identifies itself as the same ID as the WiserHeatXXXXXX
Alternatively see the test_api_discovery.py file for how to use the api to discover your hub
4. Add values in you params.py to run tests
Create a file called params.py and place two lines, one with the wiser IP or hostname and the other with the secret key. e.g.
HOST=192.168.0.22
KEY=ABCDCDCDCCCDCDC
5. Run the sample
To help understand the api simply look at the test sample code tests/test_api_properties.py
, tests/test_api_methods.py
or tests/test_api_discovery.py
and the fully commented code.
6. Documentation
Documentation available in info.md in the docs directory and within comments in the code
Changelog
1.2.1
- Code refactoring
- Added is_passive_mode property
- Corrected bug in passive mode automation to determine target temp
1.2.0
- Breaking Change - changes to passive mode from on or off to disabled, passive manual and passive follow schedule
- Support boost in passive mode
- Add additional opentherm parameters
- Fix not clearing overrides when enabling passive mode
1.1.1
- Fix issue setting on/off schedule - issue #349
1.1.0
- Added room passive mode automation control
1.0.2
- Fixed error in boost_all_rooms using old temp validation type (no longer supported)
- Fixed error in validating temps from yaml file
1.0.1
- Added endpoint parameter to set_opentherm_parameter
1.0.0
- Moved to stable build version
- Amended timeout error text
- Improved error handling for setting schedules
- Added temp sensor support for heating actuator
- Added support for network diagnostics
- Added support for non standard port
- Add boiler parameters to opentherm
- Support setting opentherm parameters
0.1.8
- Add url to exception messages
- Fix for unicode decode error
0.1.7
- Fixed error intiallising WiserUFHController class
- Made python3.9 compatible
0.1.6
- Remove debuggin print lines
- Remove session close on endpoint error
0.1.5
- Add ALL as special day option in schedule file for setting schedules from file
0.1.4
- Fix incorrect id used for schedule assignment in electrical devices
0.1.3
- Fixed issue in schedule.get_by_name
0.1.2
- Fixed calling wrong enpoint id for lights and shutters
0.1.0
- Initial asyncio release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aioWiserHeatAPI-1.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6614f6ab5df6960c8162a9a9d0b8cf4eaf90932b77469b1ed79422b43723f964 |
|
MD5 | cdc2dc4b8528d49ef38cd39d25de767e |
|
BLAKE2b-256 | f7e43cb236b70e2c946c99bb245e8b8618a7af640b2ddd0f5517ec7d8699346a |