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

| 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

• [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