homebridge-tado-thermostat v3.2

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

W.I.P features

• [x] Fakegato
• [x] Weather Sensor
• [x] Occupancy Sensor
• [x] Weather State Service
• [x] Central switch to put all thermostats in off/on mode
• [x] Better error handling
• [x] Hot Water
• [x] Weather information like pressure, humidity etc.
• [x] Clear dependencies
• [x] 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