Skip to content

Commit

Permalink
README changed
Browse files Browse the repository at this point in the history
Added the FAN_MODE-Features
  • Loading branch information
Wolfgang Malgadey authored Jun 15, 2017
1 parent ebfc676 commit 555539b
Showing 1 changed file with 20 additions and 18 deletions.
38 changes: 20 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@ Custom home-assistant component for tado (using my fork of PyTado for a py3 comp

It is highly inspired by https://community.home-assistant.io/t/tado-api-json/272/5 and the comments by diplix (https://community.home-assistant.io/users/diplix)

It is called `tado_v1` because it is build upon the unofficial API used by the myTado.com-Webapp. It will be merged as `tado` component in hass main repository, but I will leave this here for those willing to use a custom component.
It is called `tado_v1` because it is build upon the unofficial API used by the myTado.com-Webapp. It has been merged as `tado` component in hass main repository, but I will leave this here for those willing to use a custom component and to do some testing on new features or bug-fixes.

# Howto use
I created a new custom_component which adds multiple sensors for every zone in myTado.com (not for every device)
I created a new custom_component which adds multiple sensors for every zone in myTado.com (not for every device, tado is build around zones!)

## Copy files to local config directory
you have to copy all files included in `custom_components` to your home-assistant config directory.
Expand All @@ -23,30 +23,32 @@ tado_v1:
```

## Use the new sensors in home-assistant
For every zone in your tado setup we will create a sensor with a specific unit
```
sensor.<name of tado zone>_temperature (°C) Attributes: { "setting" : °C, "time" : string }
sensor.<name of tado zone>_humidity (%) Attributes: { "time" : string }
sensor.<name of tado zone>_heating (%) Attributes: { "time" : string }
sensor.<name of tado zone>_power (string)
sensor.<name of tado zone>_link (string)
sensor.<name of tado zone>_tado_mode           (string) [AWAY|HOME]
sensor.<name of tado zone>_overlay           (bool) Attributes: { "termination" : string [TADO_MODE|MANUAL|TIMER] }
```
and one sensor for the bridge
It creates a sensor for the bridge
```
sensor.<name of tado home>_tado_bridge_status (boolean)
```

lastly I added a climate device for every zone
and one climate device for every zone
```
climate.<name of tado zone>
```
with the capabilities of changeing the temperature settings and the tado mode for manual changes. Away mode is not supported.
with the capabilities of changeing the temperature setting and the tado mode for manual changes. Manually setting the away mode is not supported, because you cannot set the away mode in mytado.com.

The following operation modes are supported
```
CONST_OVERLAY_MANUAL: 'Manual',
CONST_OVERLAY_TIMER: 'Timer',
CONST_OVERLAY_TADO_MODE: 'Tado mode',
CONST_MODE_SMART_SCHEDULE: 'Smart schedule',
   CONST_MODE_OFF: 'Off',
```

For devices supporting `FAN_MODES` (like ac devices), you can set the following fan modes:
```
CONST_OVERLAY_TADO_MODE = "TADO_MODE" # wait until tado changes the mode automatic
CONST_OVERLAY_MANUAL = "MANUAL" # the user has change the temperature or mode manually
CONST_OVERLAY_TIMER = "TIMER" # the temperature will be reset after a timespan
CONST_MODE_FAN_HIGH: 'High',
CONST_MODE_FAN_MIDDLE: 'Middle',
CONST_MODE_FAN_LOW: 'Low',
   CONST_MODE_OFF: 'Off',
```

# Links
Expand Down

0 comments on commit 555539b

Please sign in to comment.