@homebridge-plugins/homebridge-tado 8.1.1 → 8.2.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # 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)
+
 ## v8.1.1 - 2025-10-20
 - Fix config UI not working on HOOBS 5 (#177)
 

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.1",
+  "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

@@ -57,7 +57,7 @@ export default (api, accessories, config, tado, telegram) => {
 
               // Use AC-specific overlay for AIR_CONDITIONING zones
               if (accessory.context.config.type === 'AIR_CONDITIONING') {
-                
+
                 await tado.setACZoneOverlay(
                   config.homeId,
                   accessory.context.config.zoneId,
@@ -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;
                 }
 
@@ -123,7 +124,7 @@ export default (api, accessories, config, tado, telegram) => {
                 // Use AC-specific overlay for AIR_CONDITIONING zones
                 if (accessory.context.config.type === 'AIR_CONDITIONING') {
                   let acMode = value === 1 ? 'HEAT' : value === 2 ? 'COOL' : 'COOL';
-                  
+
                   await tado.setACZoneOverlay(
                     config.homeId,
                     accessory.context.config.zoneId,
@@ -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;
               }
 
@@ -187,15 +189,15 @@ export default (api, accessories, config, tado, telegram) => {
 
             // Use AC-specific overlay for AIR_CONDITIONING zones
             if (accessory.context.config.type === 'AIR_CONDITIONING') {
-              
+
               // Map HomeKit target state to Tado AC mode
               let acMode = 'COOL'; // Default to COOL
-              
+
               // Get current target state from HeaterCooler service for proper mode detection
               let heaterCoolerService = accessory.getService(api.hap.Service.HeaterCooler);
               if (heaterCoolerService) {
                 let targetState = heaterCoolerService.getCharacteristic(api.hap.Characteristic.TargetHeaterCoolerState).value;
-                
+
                 // Map HomeKit target states to Tado AC modes
                 // 1 = Heat, 2 = Cool, 3 = Auto
                 switch (targetState) {
@@ -210,7 +212,7 @@ export default (api, accessories, config, tado, telegram) => {
                     acMode = 'AUTO';
                     break;
                 }
-                
+
                 // For temperature changes, use the appropriate threshold characteristic
                 if (![0, 1, 3].includes(value)) {
                   // This is a temperature change, use the appropriate temperature based on mode
@@ -230,7 +232,7 @@ export default (api, accessories, config, tado, telegram) => {
                   // This is a state change - use the mapped AC mode
                 }
               }
-              
+
               await tado.setACZoneOverlay(
                 config.homeId,
                 accessory.context.config.zoneId,
@@ -273,7 +275,7 @@ export default (api, accessories, config, tado, telegram) => {
 
           // Use AC-specific overlay for AIR_CONDITIONING zones
           if (accessory.context.config.type === 'AIR_CONDITIONING') {
-            
+
             await tado.setACZoneOverlay(
               config.homeId,
               accessory.context.config.zoneId,
@@ -725,7 +727,7 @@ export default (api, accessories, config, tado, telegram) => {
     } finally {
       setTimeout(() => {
         getStates();
-      }, config.polling * 1000);
+      }, Math.max(config.polling, 300) * 1000);
     }
   }
 
@@ -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;
 
@@ -867,9 +879,9 @@ export default (api, accessories, config, tado, telegram) => {
           const thermoAccessory = accessories.filter(
             (acc) =>
               acc &&
-              (acc.context.config.subtype === 'zone-thermostat' || 
-               acc.context.config.subtype === 'zone-heatercooler' ||
-               acc.context.config.subtype === 'zone-heatercooler-ac')
+              (acc.context.config.subtype === 'zone-thermostat' ||
+                acc.context.config.subtype === 'zone-heatercooler' ||
+                acc.context.config.subtype === 'zone-heatercooler-ac')
           );
 
           if (thermoAccessory.length) {
@@ -974,7 +986,7 @@ export default (api, accessories, config, tado, telegram) => {
 
           if (zoneState.setting.power === 'ON') {
             active = 1;
-            
+
             // Get target temperature from setting
             targetTemp =
               zoneState.setting.temperature !== null && zoneState.setting.temperature
@@ -987,7 +999,7 @@ export default (api, accessories, config, tado, telegram) => {
             if (zone.type === 'AIR_CONDITIONING') {
               const acMode = zoneState.setting.mode || 'COOL';
               tempEqual = currentTemp && targetTemp ? Math.abs(currentTemp - targetTemp) < 0.5 : false;
-              
+
               // Map AC modes to HomeKit states
               switch (acMode.toUpperCase()) {
                 case 'HEAT':
@@ -1015,8 +1027,8 @@ export default (api, accessories, config, tado, telegram) => {
 
           //Thermostat/HeaterCooler
           const heaterAccessory = accessories.filter(
-            (acc) => acc && (acc.context.config.subtype === 'zone-heatercooler-boiler' || 
-                            acc.context.config.subtype === 'zone-heatercooler-ac')
+            (acc) => acc && (acc.context.config.subtype === 'zone-heatercooler-boiler' ||
+              acc.context.config.subtype === 'zone-heatercooler-ac')
           );
           const switchAccessory = accessories.filter((acc) => acc && acc.context.config.subtype === 'zone-switch');
           const faucetAccessory = accessories.filter((acc) => acc && acc.context.config.subtype === 'zone-faucet');

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");
@@ -224,6 +225,7 @@ export default class Tado {
   }
 
   async fullAuthentication() {
+    if (this.skipAuth) return "";
     let instructions = "";
     let resolve;
     const oPromise = new Promise((res, _) => {
@@ -245,7 +247,7 @@ export default class Tado {
   }
 
   async waitForAuthentication() {
-    await this.getToken();
+    if (!this.skipAuth) await this.getToken();
     return "Authentication successful!";
   }
 
@@ -307,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`);
   }
@@ -542,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.');
@@ -613,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,
@@ -622,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');
   }
 }

package/src/tado/tado-config.js

@@ -519,7 +519,7 @@ export default {
               home.extras && home.extras.childLockSwitches
                 ? home.extras.childLockSwitches.filter((childLockSwitch) => childLockSwitch && childLockSwitch.active)
                 : [],
-            polling: Number.isInteger(home.polling) ? (home.polling < 30 ? 30 : home.polling) : 300,
+            polling: Number.isInteger(home.polling) ? (home.polling < 300 ? 300 : home.polling) : 300,
           };
 
           if (home.zones && home.zones.length) {