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:

• Binary Sensor
• Climate
• Sensor
• Switch

Setting up a developer account

In order to be able to use this component, you’ll need to sign up for a free Toon API developer account.

1. Visit theToon API开发人员网站, andsign in.创建一个帐户if you don’t have one already.
2. Open the “我的应用程序” page and click on “Add a new App” button on the top right.
3. The “Add App” page shows a form with two fields:
   • App Name：例如，“家庭助理”可以做的任何东西。必威是什么
   • Callback URL:https://my.home-assistant.io/redirect/oauth.
4. 单击“创建应用程序”以完成创建过程。
5. Open the “我的应用程序” page again and click on the app that you’ve just created.
6. You need the codes now shown: “Consumer Key” and “Consumer Secret”.
7. Add the following Toon configuration to yourconfiguration.yamland restart Home Assistant.

# Example configuration.yaml entrytoon:client_id:YOUR_CONSUMER_KEYclient_secret:YOUR_CONSUMER_SECRET

Configuration

Adding Toon to your Home Assistant instance can be done via the user interface, by using this My button:

Toon can be auto-discovered by Home Assistant. If an instance was found, it will be shown as“Discovered”, which you can select to set it up right away.

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)
• 锅炉状态（仅带有Opentherm）
• Hot Tap Water (only with OpenTherm)
• OpenTherm Connection* (only with OpenTherm)
• 恒温器计划覆盖*

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.

必威是什么家庭助理支持四种香槟预设：Comfort,Home,AwayandSleep. 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 Gas Usage
• Average Power Usage*
• Average Water Usage*
• 平均太阳能生产到网格*（仅使用太阳能模块）
• Boiler Modulation Level* (only with OpenTherm)
• 当前的气体使用
• 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)
• 今天的能源使用
• 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*

标记的传感器*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