Skip to main content

Drayton Wiser Heating smart home integration, free and open source

Drayton Wiser Heating integration for Gladys Assistant

Control your Drayton Wiser heating locally: rooms, hot water, smart plugs and valves.

View on GitHubAll integrations

Control your Drayton Wiser heating from Gladys: rooms, hot water, smart plugs, radiator valves and room thermostats. The integration talks to your Wiser HeatHub directly on your local network: no Wiser cloud account, nothing goes out to the internet, and it keeps working when your internet connection is down.

What you get​

After the configuration, the Discovery tab lists:

  • Wiser HeatHub — away mode, eco mode, and whether the boiler is heating.
  • One device per room — temperature, humidity (when a Room Thermostat serves the room), target temperature, mode (Off, Manual, Schedule), heating state, Boost and window (when a radiator valve detects it).
  • Hot water (when the hub drives a cylinder) — mode (Off, On, Schedule), heating state and Boost.
  • Smart plugs — on/off, power (W) and energy (kWh).
  • Radiator valves and room thermostats — battery, radio signal and, for a valve, the temperature next to the radiator.

How the controls behave, like in the Wiser app:

  • a target temperature set while the room follows its schedule lasts until the next slot of the schedule; in Manual mode it stays;
  • Boost adds a few degrees (2 °C by default) to the current temperature for a while (1 hour by default);
  • Away mode drops every room to the away temperature set in the Wiser app.

Before you start​

You need two things: the address of the hub and its secret.

1. The hub address​

Find the HeatHub in your router (its name starts with WiserHeat) and note its IP address. Give it a fixed address (DHCP reservation) so it does not change.

2. The hub secret​

The secret is a long key the hub only shows in setup mode. It does not stop the hub from working: your heating keeps running during these steps.

  1. Press the setup button on the hub once (on the back or side, depending on the model). Its light starts flashing.
  2. With a phone or a computer, join the Wi-Fi network named WiserHeatXXXXXX that the hub opens.
  3. Open http://192.168.8.1/secret in a browser: copy the long text shown (it often ends with ==).
  4. Press the setup button again (or wait a few minutes) so the hub leaves setup mode, and reconnect your device to your home Wi-Fi.

The secret stays the same afterwards; you only need to read it again if you reset the hub.

Configuration​

  1. Open the Configuration tab of the integration.
  2. Fill in HeatHub address and HeatHub secret.
  3. Leave Connection on Automatic: recent second-generation hubs only answer HTTPS, the integration finds out by itself.
  4. Optionally change the refresh interval (60 seconds by default: one read covers every room and device), the boost (degrees and duration) and the hot water boost duration.
  5. Save, then click Test the connection: the answer shows the hub firmware, the number of rooms and devices.
  6. Open the Discovery tab and add the devices you want.

Actions​

  • Test the connection — reads the hub now and says what it serves, or what to fix (wrong address, refused secret…).
  • Identify a device — pick a device: its LEDs blink. Pick a room and every valve and thermostat of the room blinks.

Scenes​

The integration adds its own cards to the scene editor (Gladys 5.1 or later), in the Integrations category.

Triggers:

  • Window opened or closed — a radiator valve detected an open window (a sudden drop in temperature) or its closing. Variables: room, state (open / closed).
  • Away mode changed — away mode was turned on or off outside Gladys (Wiser app, hub button). Variable: state (on / off).
  • Battery low — a valve or a thermostat needs new batteries soon. Variables: device_name, room, level, battery (%).
  • HeatHub connection lost or restored — the hub stopped answering (power cut, Wi-Fi, wrong secret) or answers again. Variables: state (lost / restored), reason.

Actions (each one returns a result the following actions can test):

  • Boost a room — degrees and duration; leave the room empty to boost every room.
  • Set a room temperature — a duration of 0 lasts until the next slot of the schedule.
  • Back to the schedule — cancels boosts and temporary temperatures of a room, or of every room.
  • Set away mode — on or off.
  • Boost hot water — for a number of minutes.

Dashboard​

  • Wiser heating — every room at a glance (temperature, target, mode, and a badge: heating, boost, window open, off), the hub connection, away and eco modes, the boiler, hot water and batteries. Buttons: away mode, back to the schedule, hot water boost.
  • Wiser room — pick a room in the widget settings: live temperature, target and humidity, mode, heating, boost and window. Buttons: Boost (asks the degrees and the duration), Cancel override, Follow schedule.

Troubleshooting​

  • "The HeatHub refused the secret" — read the secret again (see above); it changes when the hub is reset.
  • "The HeatHub does not answer" — check the address (it may have changed without a DHCP reservation) and that the hub is powered. The integration reports the hub as lost after two failed reads in a row, not at the first slow answer.
  • No humidity or window feature — they only exist when the room has a Room Thermostat (humidity) or radiator valves (window).
  • Heating actuators, underfloor heating controllers, lights and shutters of the Wiser range are not supported yet.
  • Detailed logs: view the integration logs from Gladys (or docker logs on the host).

Configuration settings​

These are the settings Drayton Wiser Heating asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Getting startedsectionNoThe integration talks to your Wiser HeatHub directly on your local network, without the Wiser cloud. It needs the hub address (find it in your router) and the hub secret: press the setup button of the hub, join its WiserHeat Wi-Fi network and open http://192.168.8.1/secret. The documentation explains each step.
HeatHub addressstringYesIP address or host name of the hub on your network. Give it a fixed address in your router.
HeatHub secretsecretYesThe long key read at http://192.168.8.1/secret while connected to the hub in setup mode.
ConnectionselectNoAutomatic suits every hub: recent second-generation hubs only answer HTTPS.
Refresh interval (s)numberNoHow often the hub is read, in seconds. One read covers every room and device.
Boost (°C)numberNoDegrees a room boost adds to the current temperature.
Boost duration (min)numberNoHow long a room boost lasts, in minutes.
Hot water boost (min)numberNoHow long a hot water boost lasts, in minutes.

How to install Drayton Wiser Heating in Gladys​

  1. In Gladys, open Integrations: Drayton Wiser Heating appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/prohand/gladys-draytonwiserheating:0.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/prohand/gladys-draytonwiserheating.

Drayton Wiser Heating requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Drayton Wiser Heating is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by prohand, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on