@homebridge-plugins/homebridge-tado 8.1.2 → 8.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v8.2.0 - 2025-10-23
+- Query all zone states in a single API request to significantly reduce the number of API calls to tado during polling
+- Update zone state after clearing a zone overlay
+- Skip getRunningTime call when a custom URL is used and remove obsolete getWeatherAirComfort (#176)
+- Add example for tadoApiUrl in config (#176)
+
 ## v8.1.2 - 2025-10-20
 - Fix: Skip auth also for config endpoints if enabled (#176)
 

package/config.schema.json

@@ -557,7 +557,7 @@
       "tadoApiUrl": {
         "title": "Tado API URL",
         "type": "string",
-        "description": "Optional: Use a custom tado api url."
+        "description": "Optional: Use a custom tado api url (e.g. http://localhost:8080)."
       },
       "skipAuth": {
         "title": "Skip Authentication",

package/homebridge-ui/public/js/schema.js

@@ -549,7 +549,7 @@ const schema = {
     'tadoApiUrl': {
       'title': 'Tado API URL',
       'type': 'string',
-      'description': 'Optional: Use a custom tado api url.'
+      'description': 'Optional: Use a custom tado api url (e.g. http://localhost:8080).'
     },
     'skipAuth': {
       'title': 'Skip Authentication',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebridge-plugins/homebridge-tado",
-  "version": "8.1.2",
+  "version": "8.2.0",
   "description": "Homebridge plugin for controlling tado° devices.",
   "main": "index.js",
   "scripts": {
@@ -40,8 +40,8 @@
     "moment": "^2.30.1"
   },
   "devDependencies": {
-    "@babel/core": "7.28.4",
-    "@babel/eslint-parser": "7.28.4",
+    "@babel/core": "7.28.5",
+    "@babel/eslint-parser": "7.28.5",
     "@babel/eslint-plugin": "7.27.1",
     "@eslint/js": "^9.38.0",
     "eslint": "^9.38.0",

package/src/helper/handler.js

@@ -110,6 +110,7 @@ export default (api, accessories, config, tado, telegram) => {
                     accessory.context.config.subtype.includes('heatercooler'))
                 ) {
                   await tado.clearZoneOverlay(config.homeId, accessory.context.config.zoneId);
+                  await updateZones(accessory.context.config.zoneId);
                   return;
                 }
 
@@ -170,6 +171,7 @@ export default (api, accessories, config, tado, telegram) => {
                   accessory.context.config.subtype.includes('heatercooler'))
               ) {
                 await tado.clearZoneOverlay(config.homeId, accessory.context.config.zoneId);
+                await updateZones(accessory.context.config.zoneId);
                 return;
               }
 
@@ -770,8 +772,8 @@ export default (api, accessories, config, tado, telegram) => {
     return;
   }
 
-  async function updateZones() {
-    if (!settingState) {
+  async function updateZones(idToUpdate) {
+    if (!settingState || idToUpdate !== undefined) {
       Logger.debug('Polling Zones...', config.homeName);
 
       //CentralSwitch
@@ -821,8 +823,18 @@ export default (api, accessories, config, tado, telegram) => {
         });
       }
 
-      for (const zone of config.zones) {
-        const zoneState = await tado.getZoneState(config.homeId, zone.id);
+      let zoneStates = {};
+      let zonesToUpdate = [];
+      if (idToUpdate !== undefined) {
+        zoneStates[idToUpdate] = await tado.getZoneState(config.homeId, idToUpdate);
+        zonesToUpdate = config.zones.filter(zone => zone.id === idToUpdate);
+      } else {
+        zoneStates = (await tado.getZoneStates(config.homeId))["zoneStates"];
+        zonesToUpdate = config.zones;
+      }
+
+      for (const zone of zonesToUpdate) {
+        const zoneState = zoneStates[zone.id];
 
         let currentState, targetState, currentTemp, targetTemp, humidity, active, battery, tempEqual;
 

package/src/tado/tado-api.js

@@ -10,6 +10,7 @@ const tado_client_id = "1bb50063-6b0c-4d11-bd99-387f4a91cc46";
 export default class Tado {
   constructor(name, config, storagePath, tadoApiUrl, skipAuth) {
     this.tadoApiUrl = tadoApiUrl || tado_url;
+    this.customTadoApiUrlActive = !!tadoApiUrl;
     this.skipAuth = skipAuth?.toString() === "true";
     this.name = name;
     const usesExternalTokenFile = config.username?.toLowerCase().endsWith(".json");
@@ -308,6 +309,10 @@ export default class Tado {
     return this.apiCall(`/api/v2/homes/${home_id}/zones/${zone_id}/state`);
   }
 
+  async getZoneStates(home_id) {
+    return this.apiCall(`/api/v2/homes/${home_id}/zoneStates`);
+  }
+
   async getZoneCapabilities(home_id, zone_id) {
     return this.apiCall(`/api/v2/homes/${home_id}/zones/${zone_id}/capabilities`);
   }
@@ -543,20 +548,6 @@ export default class Tado {
     return this.apiCall(`/api/v2/homes/${home_id}/airComfort`);
   }
 
-  async getWeatherAirComfort(home_id, longitude, latitude) {
-    let geoLocation = {
-      longitude: longitude,
-      latitude: latitude,
-    };
-
-    if (!geoLocation.longitude || !geoLocation.latitude) {
-      const data = await this.getHome(home_id);
-      geoLocation = data.geolocation;
-    }
-
-    return this.apiCall(`/v1/homes/${home_id}/airComfort`, 'GET', {}, geoLocation, 'https://acme.tado.com');
-  }
-
   async setChildLock(serialNumber, state) {
     if (!serialNumber) {
       throw new Error('Cannot change child lock state. No serialNumber is given.');
@@ -614,6 +605,8 @@ export default class Tado {
   }
 
   async getRunningTime(home_id, time, from, to) {
+    if (this.customTadoApiUrlActive) return;
+
     const period = {
       aggregate: time || 'day',
       summary_only: true,
@@ -623,6 +616,6 @@ export default class Tado {
 
     if (to) period.to = to;
 
-    return this.apiCall(`/v1/homes/${home_id}/runningTimes`, 'GET', {}, period, 'https://minder.tado.com', false);
+    return this.apiCall(`/v1/homes/${home_id}/runningTimes`, 'GET', {}, period, 'https://minder.tado.com');
   }
 }