Skip to main content

A simple API for accessing data on the Drayton Wiser Heating system

Project description

Drayton Wiser Hub API v 1.0.5.2

This repository contains a simple API which queries the Drayton Wiser Heating sysystem used in the UK.

The API functionality provides the following functionality

  • Ability to query all rooms
  • Ability to query all thermostats and room stats
  • Ability to set temperature of room and TRV thermostats
  • Ability to query various data about the system (like heating status)
  • Ability to query and set schedules for rooms
  • Ability to query and set smartplugs (modes and states)

The project is closely associated with the Wiser HomeAssitant component availabe here https://github.com/asantaga/wiserHomeAssistantPlatform

Installation

1. Find your HeatHub Secret key

Reference https://it.knightnet.org.uk/kb/nr-qa/drayton-wiser-heating-control/#controlling-the-system

  1. Press the setup button on your HeatHub, the light will start flashing Look for the Wi-Fi network (SSID) called ‘WiserHeatXXX’ where XXX is random

  2. Connect to the network from a Windows/Linux/Mac machine

  3. Execute the secret url :-)

    • For Windows use Invoke-RestMethod -Method Get -UseBasicParsing -Uri http://192.168.8.1/secret/
    • For Linux (or Windows WSL) use curl 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

  4. Press the setup button on the HeatHub again and it will go back to normal operations

  5. 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

4. Add values in you wiserkeys.params

Create a file called wiserkeys.params and place two lines, one with the wiser IP and the other with the key it self. e.g.

wiserkey=ABCDCDCDCCCDCDC
wiserhubip=192.168.0.22

5. Run the sample

To help understand the api simply look at the sample code wiserapitest.py and the fully commented code.

6. Documentation

Documentation available in apidocs.html and within comments in the code

Changelog

1.0.2.1

  • Added ability to turn trvs off and then back on by using setRoomMode
  • Fixed bug in setRoomTemperature that wasnt checking the ranges properly

1.0.2.2

  • Changed temperature variables to be the real variable, and internally *10

1.0.3

  • Merged pull7 : Timeout and other improvements.
    • Fix for issue 1 Error when having zero TRVs
    • Fix for issue 4 Setting boost sometimes errors
  • Merged pull5 : Ability to turn hotwater on/off/auto

1.0.4

1.0.5

  • Added support for smartplugs, both mode and state

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wiser-heating-api-1.0.5.2.tar.gz (9.7 kB view details)

Uploaded Source

File details

Details for the file wiser-heating-api-1.0.5.2.tar.gz.

File metadata

  • Download URL: wiser-heating-api-1.0.5.2.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.8.0

File hashes

Hashes for wiser-heating-api-1.0.5.2.tar.gz
Algorithm Hash digest
SHA256 9b3ed5f87f534f9cc1b5fd33530535f16e1257455b6c7600c22389d576fe613e
MD5 5586774450d0b89bd06391a4e1165203
BLAKE2b-256 54741d8bbb1413c6c5788f774e7a53985a9f1f1a4909e8ce67d57cf41771ce6c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page