Homebridge-tado-thermostat-plugin NPM

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)