Skip to content

Installation

Mark Parker edited this page Dec 27, 2023 · 7 revisions

Minimum Requirements

V3.4 and above requires a minimum of HA 2023.12 and therefore Python 3.11.

Ensure you have setup your Wiser system via the app before trying to set up this integration. New devices can be added afterwards but you should have a basic hub setup before you use this.

Via HACS

We highly recommend using HACS Home Assistant Community Store, for more information on how to install HACS please see their documentation website at https://hacs.xyz/

Manual Installation

This method is best used when you want to play with the "latest and greatest" from the repository. The github repository contains two primary branches, master and dev. Master is the latest released version (and the most stable branch), whereas dev is the branch that we're currently working on.

  1. On your server clone the github repository into a suitable directory using the following command git clone https://github.com/asantaga/wiserHomeAssistantPlatform.git

  2. Change to the wiserHomeAssistantPlatform directory

  3. Switch to either the master or dev branch as per your requirements (it will default to master branch after cloning). e.g. git checkout master or git checkout dev

  4. Create a custom_components directory (if it does not already exist) within your Home Assistant config directory

  5. Within the wiserHomeAssistantPlatform/custom_components directory copy the wiser folder to your HA installations custom components directory, so that you have custom_components/wiser directory with the files in.

Initial Configuration

Once you have installed the integration and restarted Home Assistant, your hub should be automatically discovered. In this case, select the configure option from the discovered device.

image

If your hub is not automatically discovered, then select to add a new integration and find Drayton Wiser Integration for Home Assistant

NOTE: If after you have installed the integration via HACs, it does not show up in the list, do a SHIFT-F5 refresh on your browser.

image

You will then be presented with the setup screen below

image

In the case of a discovered device, the IP address of your Wiser Hub will be prepopulated. If adding via Add Integration, you will need to supply this.

You will also need your Wiser Hub's secret key. Follow the below instructions to obtain this.

Find your Wiser Hub Secret key

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

  1. On your hub, press the setup button and the led should flash green.
  2. Use your phone or tablet and connect to the wifi SSID (that you should now see available) that is Wiserxx_xxxxxx
  3. Once connected to this wifi network, open your browser and go to http://192.168.8.1/secret
  4. You can then copy your key to an email to send to another device or copy and paste into the HA config if setting up integration via your phone/tablet.