Toon
The Toon integration platform can be used to control your Quby Toon thermostat, which is currently being sold as:
- Eneco Toon
- Engie Electrabel Boxx
- Viesgo Toon
This integration adds a climate device for your Toon thermostat, some switches allowing you to control the program and holiday mode of the thermostats as well.
Sensors for energy, power and gas consumption, sensors for solar production and several binary sensors for things like boiler burner on/off, hot tap water and boiler health status.
For the Toon integration to work, you’ll need an active Toon subscription and a Toon API developer account.
There is currently support for the following device types within Home Assistant:
Setting up a developer account
In order to be able to use this integration, you’ll need to sign up for a free Toon API developer account.
- Visit the Toon API developers website, and sign in. Create an account if you don’t have one already.
- Open the “My Apps” page and click on “Add a new App” button on the top right.
- The “Add App” page shows a form with two fields:
- App Name: Can be anything you like, for example, “Home Assistant” will just do.
-
Callback URL:
https://my.home-assistant.io/redirect/oauth.
- Click on “Create App” to complete the creation process.
- Open the “My Apps” page again and click on the app that you’ve just created.
- You need the codes now shown: “Consumer Key” and “Consumer Secret”.
- Add the following Toon configuration to your
configuration.yamland restart Home Assistant.
# Example configuration.yaml entry
toon:
client_id: YOUR_CONSUMER_KEY
client_secret: YOUR_CONSUMER_SECRET
Configuration
To add the Toon integration to your Home Assistant instance, use this My button:
Toon can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.
If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the Add Integration button.
-
From the list, select Toon.
-
Follow the instructions on screen to complete the setup.
If you don’t have My Home Assistant on your installation,
you can use <HOME_ASSISTANT_URL>/auth/external/callback as the Callback URL
instead.
The <HOME_ASSISTANT_URL> must be the same as used during the configuration/
authentication process.
Internal examples: http://192.168.0.2:8123/auth/external/callback, http://homeassistant.local:8123/auth/external/callback.”
Binary Sensor
The Toon integration provides the following binary sensors:
- Boiler Burner (only with OpenTherm)
- Boiler Heating* (only with OpenTherm)
- Boiler Module Connection*
- Boiler Preheating* (only with OpenTherm)
- Boiler Status (only with OpenTherm)
- Hot Tap Water (only with OpenTherm)
- OpenTherm Connection* (only with OpenTherm)
- Thermostat Program Override*
Binary sensors marked with * are disabled by default, but can be enabled
from the UI, by clicking on the device and enabling the specific entity.
Climate
The Toon climate platform allows you to interact with your Toon thermostat.
Home Assistant support the four Toon presets: Comfort, Home, Away and Sleep.
It also supports setting the temperature manually.
Toon has no option to disable a preset. It will automatically unset when values of the thermostat are changed.
Sensor
The Toon integration provides the following sensors:
- Average Daily Energy Usage*
- Average Daily Gas Usage*
- Average Daily Water Usage*
- Average Gas Usage
- Average Power Usage*
- Average Water Usage*
- Average Solar Power Production to Grid* (only with solar module)
- Boiler Modulation Level* (only with OpenTherm)
- Current Gas Usage
- Current Power Usage
- Current Power Usage Covered By Solar (only with solar module)
- Current Solar Power Production (only with solar module)
- Current Water Usage*
- Electricity Meter Feed IN Tariff 1*
- Electricity Meter Feed IN Tariff 2*
- Electricity Meter Feed OUT Tariff 1*
- Electricity Meter Feed OUT Tariff 2*
- Energy Cost Today
- Energy Produced To Grid Today* (only with solar module)
- Energy Usage From Grid Today* (only with solar module)
- Energy Usage Today
- Gas Cost Today
- Gas Meter
- Gas Usage Today
- Humidity*
- Max Solar Power Production Today (only with solar module)
- Solar Energy Produced Today (only with solar module)
- Solar Power Production to Grid (only with solar module)
- Temperature
- Water Meter*
- Water Usage Today*
- Water Cost Today*
Sensors marked with * are disabled by default, but can be enabled
from the UI, by clicking on the device and enabling the specific entity.
Switch
The Toon integration provides the following switches:
- Thermostat Holiday Mode
- Thermostat Program