Package: aioWiserHeatAPI
Drayton Wiser Hub API Async v1.5.6This 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 LightsRequirementsRequires a minimum of Python v3.10Installation1. Find your HeatHub Secret keyReferencehttps://it.knightnet.org.uk/kb/nr-qa/drayton-wiser-heating-control/#controlling-the-systemPress 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 addressConnect to the network from a Windows/Linux/Mac/Android/iPhone machineExecute the secret url :-)Open a browser to urlhttp://192.168.8.1/secretThis 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.paramsPress the setup button on the HeatHub again and it will go back to normal operationsCopy the secret and save it somewhere.3. Find Your HEATHUB IPUsing your router, or something else, identify the IP address of your HeatHub, it usually identifies itself as the same ID as theWiserHeatXXXXXXAlternatively see the test_api_discovery.py file for how to use the api to discover your hub4. Add values in you params.py to run testsCreate 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 sampleTo help understand the api simply look at the test sample codetests/test_api_properties.py,tests/test_api_methods.pyortests/test_api_discovery.pyand the fully commented code.6. DocumentationDocumentation available ininfo.mdin the docs directory and within comments in the codeChangelogv1.5.6Added improved error handling for json decode errorsv1.5.5Added addtional v2 hub attributes and switchesv1.5.4Fixed issue whereby json conversion errors due to control characters in stringv1.5.2Revert to aiohttp and fix errors with v3.9.x that caused move to httpxv1.5.1Fix nuances with httpxv1.5.0Move to httpx instead of aiohttpv1.4.0Add PowerTagE supportAdd new v2 hub cloud parametersAdd new v2 hub capabilities infoAdd v2 hub equipment data to relevant devicesAdd tilt support for shuttersFix issue where non ASCII chars removedv1.3.9Fix for hub firmware bug whereby Away Mode Affects HotWater is turned off when cancelling overrides if no overrides exist.v1.3.8Correct relative modulation level opentherm parameter magnitudev1.3.7Amend battery to return None for voltage and percent if battery data not present1.3.6Add new status classFix error if passive mode room device offlinev1.3.5Correct async error in extra_configv1.3.4Current temperature now returns none for room if TRV signal lost.v1.3.3Fixed issue in passive mode so that it works with 3 channel hub and different rooms on different channelsv1.3.2Fixed issue ot maintaining some parameters after hub updateImproved handling of extra config json errorsAmended current_target_temp to use DisplayedSetPoint instead of CurrentSetPoint as this displays incorrectly in Eco mode1.3.1Away mode overrides passive mode functions1.3.0Rework passive mode functionality (may break previous code if using passive mode)1.2.2Improve logic defining is_passive_mode property1.2.1Code refactoringAdded is_passive_mode propertyCorrected bug in passive mode automation to determine target temp1.2.0Breaking Change - changes to passive mode from on or off to disabled, passive manual and passive follow scheduleSupport boost in passive modeAdd additional opentherm parametersFix not clearing overrides when enabling passive mode1.1.1Fix issue setting on/off schedule - issue #3491.1.0Added room passive mode automation control1.0.2Fixed error in boost_all_rooms using old temp validation type (no longer supported)Fixed error in validating temps from yaml file1.0.1Added endpoint parameter to set_opentherm_parameter1.0.0Moved to stable build versionAmended timeout error textImproved error handling for setting schedulesAdded temp sensor support for heating actuatorAdded support for network diagnosticsAdded support for non standard portAdd boiler parameters to openthermSupport setting opentherm parameters0.1.8Add url to exception messagesFix for unicode decode error0.1.7Fixed error intiallising WiserUFHController classMade python3.9 compatible0.1.6Remove debuggin print linesRemove session close on endpoint error0.1.5Add ALL as special day option in schedule file for setting schedules from file0.1.4Fix incorrect id used for schedule assignment in electrical devices0.1.3Fixed issue in schedule.get_by_name0.1.2Fixed calling wrong enpoint id for lights and shutters0.1.0Initial asyncio release