Skip to content

Commit

Permalink
Add Toon docs (#3706)
Browse files Browse the repository at this point in the history
  • Loading branch information
fabaff authored Oct 21, 2017
1 parent 8d7c975 commit 5f68226
Show file tree
Hide file tree
Showing 5 changed files with 91 additions and 0 deletions.
18 changes: 18 additions & 0 deletions source/_components/climate.toon.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
layout: page
title: "Toon"
description: "Instructions how to integrate Toon Climate devices within Home Assistant."
date: 2017-10-21 12:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Climate
ha_release: 0.56
logo: toon.png
ha_iot_class: "Cloud Polling"
---

The `toon` climate platform allows you to interact with your Toon device.

The requirement is that you have setup the [`toon`](/components/toon/) component.
18 changes: 18 additions & 0 deletions source/_components/sensor.toon.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
layout: page
title: "Toon"
description: "Instructions how to integrate Toon Climate devices within Home Assistant."
date: 2017-10-21 12:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Sensor
ha_release: 0.56
logo: toon.png
ha_iot_class: "Cloud Polling"
---

The `toon` sensor platform allows you to observe your Toon device.

The requirement is that you have setup the [`toon`](/components/toon/) component.
18 changes: 18 additions & 0 deletions source/_components/switch.toon.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
layout: page
title: "Toon"
description: "Instructions how to integrate Toon Climate devices within Home Assistant."
date: 2017-10-21 12:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Switch
ha_release: 0.56
logo: toon.png
ha_iot_class: "Cloud Polling"
---

The `toon` switch platform allows you to control your Toon device.

The requirement is that you have setup the [`toon`](/components/toon/) component.
37 changes: 37 additions & 0 deletions source/_components/toon.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
layout: page
title: "Toon"
description: "Instructions how to integrate Toon within Home Assistant."
date: 2017-10-21 12:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Hub
ha_release: 0.56
logo: toon.png
ha_iot_class: "Cloud Polling"
---

The `toon` component platform can be used to control your Toon thermostat. This component adds a climate device for your Toon thermostat and sensors for power and gas consumption. The component also auto-detects any smart plugs, solar panels and smoke detectors connected to Toon and adds sensors and switches for them.

For the `toon` component to work, you'll need an active Toon subscription with Eneco. The component uses your Mijn Eneco credentials to control your thermostat through the [toonopafstand](https://toonopafstand.eneco.nl) website.

To use your Toon thermostat in your installation, add the following to your `configuration.yaml` file:

```yaml
# Example configuration.yaml entry
toon:
username: YOUR_USERNAME
password: YOUR_PASSWORD
```
Configuration variables:
- **username** (*Required*): Username for Mijn Eneco.
- **password** (*Required*): Password for Mijn Eneco.
Toon is a smart thermostat delivered by the Eneco power company in The Netherlands. It can measure energy consumption (power and gas), but also the amount of energy generated in case solar panels are connected to it. Toon also acts as a z-wave hub for supported Fibaro devices like the wall plug and the smoke detector. This component uses the [toonlib library](https://github.com/costastf/toonlib) by Costas Tyfoxylos that connects to the unofficial API on [https://toonopafstand.eneco.nl](https://toonopafstand.eneco.nl).
The current version of this component supports setting any of the four built-in programs and setting the temperature manually. It polls the Toon API at 30 second intervals so the status is relatively fresh without overloading the API.
Binary file added source/images/supported_brands/toon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 5f68226

Please sign in to comment.