Skip to content
Homebridge plugin for controlling Tado smart thermostats with Fakegato History
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images Delete readme.txt Mar 20, 2018
src Update Thermostat.js Mar 31, 2018
.gitignore Create .gitignore Feb 23, 2018
LICENSE Initial commit Feb 6, 2018
README.md Update README.md Mar 27, 2018
config-example.json Update config-example.json Mar 27, 2018
index.js Update index.js Mar 28, 2018
package.json v3.2.3 Mar 31, 2018

README.md

homebridge-tado-thermostat v3.2

npm npm GitHub last commit

Homebridge plugin for Tado Smart Thermostats

This homebridge plugin exposes Tado thermostats, occupancy sensors, weather sensors and contact (window) sensors to Apple's HomeKit. It provides following features:

Thermostats:

  • Additional modes: Heat, Cool, Auto and Off
  • Secure temperature setting (temperature setting only possible in heat or cool mode)
  • Auto heat/cool to a certain value (configurable in config.json)
  • Battery state and notification if battery is low
  • Built-in humidity sensor
  • Delay timer: You can set up a timer as delay for your thermostats to wait a certain time to go back to the automatic mode (Helpful in automations where you shut off the thermostat after window is opened and in automatic mode if window is closed. So this timer let the thermostat wait a certain time in off mode before going back to auto mode. Helpful if you open the window only for a few minutes)
  • Elgato EVE history feature (Fakegato)

Boiler:

  • Expose Tado Hot Water to Apple HomeKit!
  • Additional modes: Heat, Cool, Auto and Off
  • Auto heat/cool to a certain value (configurable in config.json)
  • Elgato EVE history feature (Fakegato)

Occupancy sensors:

  • If enabled in config.json AND under the settings in the tado app (geotracking) this plugin will create occupancy/motion sensors for all registred persons (configurable in the tado app).
  • In addition to this, it will create an "Anyone" sensor too, to create automations based on "Anyone at home / not at home"
  • Elgato EVE history feature (Fakegato)

Weather sensors:

  • If enabled in config.json, this plugin will create a weather sensor for your location based on tado.
  • Elgato EVE history feature (Fakegato)
  • OpenWeather Support: If API and Location setted in config, the Weather accessory will also show the current humidity state and Elgato EVE will also show the airpressure, sunrise, sunset and weather state with FakeGato support! Note: You can get an API-Key from openweathermap.org - After sign up, you can create an API Key in the profile section

Window sensors:

  • If enabled in config.json AND under the setting in the tado app (open window detection), this plugin creates windows sensors for each room.

Central Switch:

  • If enabled in config.json this plugin creates a central switch to turning off/on all thermostats together with just one click!
  • Turning on the switch means, turn ALL thermostats into automatic mode
  • Turning off the switch means, turn ALL thermostats off
  • If ALL thermostats are off, the switch turns off
  • If ONE thermostat is on, the switch turns on

See Images for more details.

Installation instructions

After Homebridge has been installed:

sudo npm install -g homebridge-tado-thermostat-plugin

Example config.json:

{
 "bridge": {
     ...
 },
 "platforms": [
   {
   "platform":"TadoThermostat",
   "name":"Thermostat",
   "username":"TadoUserName",
   "password":"TadoPassword"
   }
 ]
}

Advanced config.json:

{
 "bridge": {
     ...
 },
 "platforms": [
   {
   "platform": "TadoThermostat",
   "name": "Thermostat",
   "username": "TadoUsername",
   "password": "TadoPassword",
   "homeID":"123456",
   "tempUnit":"CELSIUS",
   "heatValue": 5,
   "coolValue": 5,
   "delayTimer": 0,
   "weatherEnabled": true,
   "weatherAPI":"XXXXXXXXXXXXXXX",
   "weatherLocation":"Berlin",
   "occupancyEnabled": false,
   "windowDetection": false,
   "centralSwitch": false,
   "boilerEnabled":false,
   "boilerType": "BU01",
   "interval": 10,
   "includeTypes":["VA01", "RU01"],
   "onePerRoom":false
   }
 ]
}

See Example Config for more details.

Options

Attributes Required Usage
name no Name for the Thermostat. Will be used as part of the accessory name.
username Yes Tado Login Username
password Yes Tado Login Password
interval No Interval for polling state of accessories (Default: 10s)
homeID No For faster loading (only by restarting HB), you can put your homeID in your config.json (Default: empty)
tempUnit No For faster loading (only by restarting HB), you can put the Temperature Unit in your config.json (Default: empty - Valid values are: CELSIUS or FAHRENHEIT)
includeTypes No If you want to restrict the plugin not to expose more accessory per room as need, you can add or remove the types from the includeTypes array. Types: VA01: heating thermostat, RU01: remote thermostat (Default: ["VA01", "RU01"]
onePerRoom No If true, the plugin will expose only one thermostat per room (Default: false)
heatValue No Value for the "Heat" mode. Example: a value of 4 will heat up the room to Current Room Temperature + 4 degrees (Default: 4)
coolValue No Value for the "Cool" mode. Example: a value of 4 will cool down the room to Current Room Temperature - 4 degrees (Default: 4)
delaytimer No Delay for setting the thermostat back in automatic mode (Default: 0 == not enabled)
weatherEnabled No Exposes temperature sensors for your location based on tado (Default: false)
weatherAPI No Openweather API Key for detailed weather information
weatherLocation No Openweather Location for detailed weather information
occupancyEnabled No Exposes occupancy/motion sensors for all registred persons (only if geotracking is enabled in tado! - Default: false)
windowDetection No Exposes window sensors for each room (only if open weather detection is enabled in tado! - Default: false)
centralSwitch No Exposes a switch to turning on/off all thermostats with just one click! (Default: false)
boilerEnabled No Expose Tado Hot Water to HomeKit - Default: false)
boilerType No If the plugin don't expose Hot Water to HomeKit, try to change boilerType to "RU01" (Default: BU01)
heatValueBoiler No Value for the BOILER "Heat" mode. Example: a value of 10 will heat up the Boiler to Current Temperature + 10 degrees (Default: 10)
coolValueBoiler No Value for the BOILER "Cool" mode. Example: a value of 10 will cool down the Boiler to Current Temperature - 10 degrees (Default: 10)

W.I.P features

  • Fakegato
  • Weather Sensor
  • Occupancy Sensor
  • Weather State Service
  • Central switch to put all thermostats in off/on mode
  • Better error handling
  • Hot Water
  • Weather information like pressure, humidity etc.
  • Clear dependencies
  • New options
  • Add DEBUG (in work)
  • Dynamic Platform

Contributing

You can contribute to this homebridge plugin in following ways:

  • Report issues and help verify fixes as they are checked in.
  • Review the source code changes.
  • Contribute bug fixes.
  • Contribute changes to extend the capabilities

Pull requests are accepted.

Credits

This plugin was initially forked from and inspired by homebridge-tado-ac by @nitaybz

You can’t perform that action at this time.