@homebridge-plugins/homebridge-tado 8.7.0 → 8.7.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v8.7.2 - 2025-11-08
+- Add notice about tado X compatibility to documentation (#179)
+- Use consistent spelling for tado and Apple Home across the entire plugin
+
+## v8.7.1 - 2025-11-04
+- Add debug logs for API responses (#179)
+
 ## v8.7.0 — 2025-11-03
 - Update documentation and add new config parameters with explanations (#176, #182)
 - Update `example-config.json` (#182)
@@ -23,7 +30,7 @@
 - Optimized task queue to prevent overlapping operations and API calls
 - Fixed multi-home polling and individual API handling (#176)
 - Added enhanced debug logs for zone updates and API interactions
-- Note: This update resets the Tado API counter for the current day
+- Note: This update resets the tado API counter for the current day
 - Apologies for the unexpected behavior introduced in v8.4.x–8.5.x — this release restores consistent and reliable behavior, with an optional fix for Siri users. Full statement: [#178 (comment)](https://github.com/homebridge-plugins/homebridge-tado/issues/178#issuecomment-3476646430)
 
 ## v8.5.0 - 2025-10-27
@@ -64,14 +71,14 @@
 - Update form-data due to vulnerability
 
 ## v8.0.1 - 2025-06-12
-- Tado-API: Verify that refresh token is not empty before saving to file
+- tado-API: Verify that refresh token is not empty before saving to file
 
 ## v8.0.0 - 2025-06-09
 - Add support for tado AC devices
 
 ## v7.6.0 - 2025-04-24
 - Fixed crash on telegram event (#164)
-- Rewrote Tado-Platform as ES6 class
+- Rewrote tado-Platform as ES6 class
 - Updated dependencies
 
 ## v7.5.3 - 2025-03-27
@@ -105,7 +112,7 @@
 - Added full support for Homebridge v2.0 (it is also shown as compatible when using Homebridge v1.X)
 - Updated all dependencies to their latest version
 - Added new authentication workflow to config-ui
-- Fixed an issue that caused HomeKit from pairing with the bridge (Error: Accessory out of compliance)
+- Fixed an issue that caused Apple Home from pairing with the bridge (Error: Accessory out of compliance)
 - Fixed an issue where the plugin crashed after startup due to a type error after upgrading got
 - Removed AirQuality feature [homebridge-tado-platform/issues/152#issuecomment-2708942491](https://github.com/seydx/homebridge-tado-platform/issues/152#issuecomment-2708942491)
 - Fixed an issue where the current temperature has been set to the target temperature after changing the target temperature through Apple Home
@@ -173,7 +180,7 @@
 
 **Note:**
 
-Hot water devices show 0° when they are first started in HomeKit if they are in "OFF" mode. The reason for this is that in "OFF" mode there is no temperature value in the API. When you turn on the device, the plugin saves the value for the further use case.
+Hot water devices show 0° when they are first started in Apple Home if they are in "OFF" mode. The reason for this is that in "OFF" mode there is no temperature value in the API. When you turn on the device, the plugin saves the value for the further use case.
 
 **IMPORTANT:**
 
@@ -191,7 +198,7 @@ If you previously used your "HOT_WATER" device/zone as a faucet, then disable th
 - Refactored code
 - Multiple tado accounts
   - Possibility to control multiple homes
-- Customizable temperature unit via HomeKit
+- Customizable temperature unit via Apple Home
 - Customizable Modes (AUTO | HEAT | COOL | OFF) or (ON | OFF)
 - Deactivatable battery indicator (support for old gen thermostats)
 - Customizable zone termination, separate for each zone

package/README.md

@@ -14,7 +14,7 @@
 
 This plugin has originally been created by [Seydx](https://github.com/seydx/). Donate to him: [![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square&maxAge=2592000)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=NP4T3KASWQLD8). It is currently maintained by [smart7324](https://buymeacoffee.com/smart7324).
 
-**Homebridge Tado** is possibly the biggest homebridge plugin for Tado devices. 
+**Homebridge tado** is possibly the biggest homebridge plugin for tado devices. 
 
 **Multiple home Support**
 
@@ -22,7 +22,7 @@ The plugin even offers support for multiple houses. So it is finally possible to
 
 **Full Apple Home Support**
 
-Everything Tado offers can be displayed through the plugin in Apple Home. The thermostat buttons themselves have custom characteristics. Full hot water support, weather temperature, solar intensity, weather, tado quick actions, child lock, presence lock, Air Conditioning and much more awaits you with this plugin!
+Most features that tado offers are fully supported and can be displayed through this plugin in Apple Home. The thermostat buttons themselves have custom characteristics. Full hot water support, weather temperature, solar intensity, weather, tado quick actions, child lock, presence lock, Air Conditioning and much more awaits you with this plugin!
 
 ## Installation
 
@@ -57,6 +57,7 @@ After [Homebridge](https://github.com/nfarina/homebridge) has been installed:
   - [History Service](#history-service)
   - [Telegram](#telegram)
 - [Supported Clients](#supported-clients)
+- [tado X Compatibility](#tado-x-compatibility)
 - [Contributing](#contributing)
 - [Troubleshooting](#troubleshooting)
 
@@ -108,17 +109,17 @@ See [Example Config](https://github.com/homebridge-plugins/homebridge-tado/blob/
 
 ## Authentication
 
-This plugin implements the Tado-supported authentication using the [Device Code Grant Flow](https://support.tado.com/en/articles/8565472-how-do-i-authenticate-to-access-the-rest-api).
+This plugin implements the tado-supported authentication using the [Device Code Grant Flow](https://support.tado.com/en/articles/8565472-how-do-i-authenticate-to-access-the-rest-api).
 
-During the initial setup, the plugin will prompt you to open a specific URL in your web browser. You will then be asked to log in with your Tado account and grant access to the new device. Once this process has been completed successfully, the plugin automatically handles all subsequent authentication tasks, including secure token storage, token refresh, and renewal. This ensures continuous access to the Tado API v2 without further user interaction.
+During the initial setup, the plugin will prompt you to open a specific URL in your web browser. You will then be asked to log in with your tado account and grant access to the new device. Once this process has been completed successfully, the plugin automatically handles all subsequent authentication tasks, including secure token storage, token refresh, and renewal. This ensures continuous access to the tado API v2 without further user interaction.
 
 ### Custom API Configuration
 
-For advanced use cases, the plugin allows overriding the default Tado API endpoint by specifying a custom API URL through the `tadoApiUrl` parameter within each home configuration.
+For advanced use cases, the plugin allows overriding the default tado API endpoint by specifying a custom API URL through the `tadoApiUrl` parameter within each home configuration.
 
 Additionally, it is possible to disable the built-in authentication flow entirely by setting the `skipAuth` parameter to `true`. When enabled, all API requests will be sent without an authentication token.
 
-**Important:** Use `skipAuth` only if you are certain that your setup does not require token-based authentication. Improper use may result in limited or failed communication with the Tado API.
+**Important:** Use `skipAuth` only if you are certain that your setup does not require token-based authentication. Improper use may result in limited or failed communication with the tado API.
 
 For further details and configuration examples, refer to the related discussion:  
 [homebridge-tado issue #176 – Authentication Options](https://github.com/homebridge-plugins/homebridge-tado/issues/176#issuecomment-3419839118)
@@ -231,7 +232,7 @@ Each zone in the config.json with `"type": "AIR_CONDITIONING"` is exposed to App
 - Elgato EVE history feature (FakeGato)
 
 **AC-Specific Features**
-Air conditioning zones support both heating and cooling modes with dedicated cooling threshold temperature control. Fan speed and swing controls are handled through the Tado app, while Apple Home integration focuses on temperature and mode control for optimal compatibility. Note that the RotationSpeed characteristic is not supported for AC units.
+Air conditioning zones support both heating and cooling modes with dedicated cooling threshold temperature control. Fan speed and swing controls are handled through the tado app, while Apple Home integration focuses on temperature and mode control for optimal compatibility. Note that the RotationSpeed characteristic is not supported for AC units.
 
 **Mode / Mode Timer**
 `mode` for the commands to be sent with. can be 'MANUAL' for manual control until ended by the user, 'AUTO' for manual control until next schedule change in tado° app OR 'TIMER' for manual control until timer ends. `modeTimer` for the `MANUAL` mode in minutes.
@@ -412,7 +413,7 @@ This option changes how combined state + temperature updates are interpreted:
 ## Extras
 
 ### Central Switch
-Shows a switch accessory with additional switches in Apple Home which mimics the "Boost" and "Turnoff" switch from Tado. It also shows the Heater Running information as a custom characteristic for the month (in hours) and it shows also how many thermostats are in auto, manual or off mode. Its also possible to show a dummy switch withiun the central switch for eg. automation purposes.
+Shows a switch accessory with additional switches in Apple Home which mimics the "Boost" and "Turnoff" switch from tado. It also shows the Heater Running information as a custom characteristic for the month (in hours) and it shows also how many thermostats are in auto, manual or off mode. Its also possible to show a dummy switch withiun the central switch for eg. automation purposes.
 
 ```
 "homes": [
@@ -432,7 +433,7 @@ Shows a switch accessory with additional switches in Apple Home which mimics the
 ```
 
 #### Boost Switch
-Shows a switch accessory in Apple Home (added to central switch) which mimics the "Boost" switch from Tado and switches all heaters to max temperature. 
+Shows a switch accessory in Apple Home (added to central switch) which mimics the "Boost" switch from tado and switches all heaters to max temperature. 
 _Note: Central Switch needs to be truned on._
 
 ```
@@ -453,7 +454,7 @@ _Note: Central Switch needs to be truned on._
 ```
 
 #### Shedule Switch
-Shows a switch accessory in Apple Home (added to central switch) which mimics the "Shedule" switch from Tado and switches all heaters to their default shedule
+Shows a switch accessory in Apple Home (added to central switch) which mimics the "Shedule" switch from tado and switches all heaters to their default shedule
 _Note: Central Switch needs to be truned on._
 
 ```
@@ -474,7 +475,7 @@ _Note: Central Switch needs to be truned on._
 ```
 
 #### Turnoff Switch
-Shows a switch accessory in Apple Home (added to central switch) which mimics the "Turn Off" switch from Tado and switches all heaters off
+Shows a switch accessory in Apple Home (added to central switch) which mimics the "Turn Off" switch from tado and switches all heaters off
 _Note: Central Switch needs to be truned on._
 
 ```
@@ -631,6 +632,21 @@ This plugin has been verified to work with the latest versions of:
 * 3rd party apps like Elgato Eve
 * Homebridge
 
+## tado X Compatibility
+
+**tado X devices are not supported.**
+
+The new generation of tado X devices uses a completely different API endpoint (`https://hops.tado.com`) and communication methods that are not compatible with the existing tado API (`https://my.tado.com/api/v2`) used by this plugin.
+
+Supporting tado X devices would require a full integration of the new API, which is currently **not planned** due to the significant development effort involved.
+
+For more technical details about the tado X API, see:
+- [tado X – API differences (wiki)](https://github.com/kritsel/tado-openapispec-v2/wiki/tado-X)  
+- [Swagger documentation](https://kritsel.github.io/tado-openapispec-v2/swagger.html#/)  
+- [Postman collection & additional resources](https://github.com/gedhi/tadox-postman-collection?tab=readme-ov-file#additional-resources)
+
+If you are using tado X devices, please note that this plugin will **not be able to control or display** those devices at the moment.
+
 ## Contributing
 
 You can contribute to this homebridge plugin in following ways:

package/config.schema.json

@@ -26,30 +26,30 @@
           "properties": {
             "id": {
               "title": "Home ID",
-              "description": "The id of your Home. Has to be the exact same id as in the web app of Tado.",
+              "description": "The id of your Home. Has to be the exact same id as in the web app of tado.",
               "type": "integer"
             },
             "name": {
               "title": "Home Name",
-              "description": "The name of your Home. Has to be the exact same name as in the web app of Tado.",
+              "description": "The name of your Home. Has to be the exact same name as in the web app of tado.",
               "type": "string",
               "required": true
             },
             "username": {
               "title": "Username",
               "type": "string",
-              "description": "The user name that you use for the app and the web app of Tado.",
+              "description": "The user name that you use for the app and the web app of tado.",
               "required": true
             },
             "tadoApiUrl": {
-              "title": "Tado API URL",
+              "title": "tado API URL",
               "type": "string",
-              "description": "Optional: Use a custom tado api url (e.g. http://localhost:8080)."
+              "description": "Optional: Use a custom tado API url (e.g. http://localhost:8080)."
             },
             "skipAuth": {
               "title": "Skip Authentication",
               "type": "boolean",
-              "description": "Optional: Skip authentication for tado api."
+              "description": "Optional: Skip authentication for tado API."
             },
             "polling": {
               "title": "Polling",
@@ -60,7 +60,7 @@
             },
             "temperatureUnit": {
               "title": "Temperature Unit",
-              "description": "Temperature Unit for accessories in HomeKit exposed by this plugin.",
+              "description": "Temperature Unit for accessories in Apple Home exposed by this plugin.",
               "type": "string",
               "default": "CELSIUS",
               "oneOf": [
@@ -134,7 +134,7 @@
                       "active": {
                         "title": "Active",
                         "type": "boolean",
-                        "description": "If enabled, a new motion/occupancy sensor for this user will be exposed to HomeKit."
+                        "description": "If enabled, a new motion/occupancy sensor for this user will be exposed to Apple Home."
                       },
                       "name": {
                         "title": "Name",
@@ -176,12 +176,12 @@
                 "temperatureSensor": {
                   "title": "Temperature Sensor",
                   "type": "boolean",
-                  "description": "If enabled, a temperature sensor for the weather will be exposed to HomeKit."
+                  "description": "If enabled, a temperature sensor for the weather will be exposed to Apple Home."
                 },
                 "solarIntensity": {
                   "title": "Solar Intensity",
                   "type": "boolean",
-                  "description": "If enabled, a lightbulb accessory for the solar intensity will be exposed to HomeKit."
+                  "description": "If enabled, a lightbulb accessory for the solar intensity will be exposed to Apple Home."
                 },
                 "accTypeSolarIntensity": {
                   "title": "Solar Intensity Accessory Type",
@@ -214,7 +214,7 @@
                 "centralSwitch": {
                   "title": "Central Switch",
                   "type": "boolean",
-                  "description": "If enabled, a switch will be exposed to HomeKit to enable/disable all thermostats/boiler at once."
+                  "description": "If enabled, a switch will be exposed to Apple Home to enable/disable all thermostats/boiler at once."
                 },
                 "runningInformation": {
                   "title": "Heat Running Information",
@@ -227,7 +227,7 @@
                 "presenceLock": {
                   "title": "Presence Lock",
                   "type": "boolean",
-                  "description": "If enabled, a Home/Away switch will be exposed to HomeKit."
+                  "description": "If enabled, a Home/Away switch will be exposed to Apple Home."
                 },
                 "accTypePresenceLock": {
                   "title": "Presence Lock Accessory Type",
@@ -289,7 +289,7 @@
                       "active": {
                         "title": "Active",
                         "type": "boolean",
-                        "description": "If enabled, a child lock switch for this device will be exposed to HomeKit."
+                        "description": "If enabled, a child lock switch for this device will be exposed to Apple Home."
                       },
                       "name": {
                         "title": "Name",
@@ -300,7 +300,7 @@
                       "serialNumber": {
                         "title": "Device Serial Number",
                         "type": "string",
-                        "description": "Enter the serial number of the device from which you want to display a 'Child Lock Switch' in HomeKit. (only for devices with child lock support)",
+                        "description": "Enter the serial number of the device from which you want to display a 'Child Lock Switch' in Apple Home. (only for devices with child lock support)",
                         "required": true,
                         "condition": {
                           "functionBody": "try { return model.homes[arrayIndices[0]].extras.childLockSwitches[arrayIndices[1]].active } catch(e){ return false }"
@@ -320,12 +320,12 @@
                   "active": {
                     "title": "Active",
                     "type": "boolean",
-                    "description": "If enabled, a new thermostat/boiler switch will be exposed to HomeKit."
+                    "description": "If enabled, a new thermostat/boiler switch will be exposed to Apple Home."
                   },
                   "id": {
                     "title": "ID",
                     "type": "integer",
-                    "description": "Zone ID. Has to be the exact same id as in the web app of Tado.",
+                    "description": "Zone ID. Has to be the exact same id as in the web app of tado.",
                     "condition": {
                       "functionBody": "try { return model.homes[arrayIndices[0]].zones[arrayIndices[1]].active } catch(e){ return false }"
                     }
@@ -333,7 +333,7 @@
                   "name": {
                     "title": "Name",
                     "type": "string",
-                    "description": "Zone Name. Has to be the exact same name as in the web app of Tado.",
+                    "description": "Zone Name. Has to be the exact same name as in the web app of tado.",
                     "required": true
                   },
                   "delaySwitch": {
@@ -349,12 +349,12 @@
                   "openWindowSensor": {
                     "title": "Open Window Sensor",
                     "type": "boolean",
-                    "description": "If enabled, additional window contact accessory for each zone will be exposed to HomeKit which triggers if tado detects an open window."
+                    "description": "If enabled, additional window contact accessory for each zone will be exposed to Apple Home which triggers if tado detects an open window."
                   },
                   "openWindowSwitch": {
                     "title": "Open Window Switch",
                     "type": "boolean",
-                    "description": "If enabled, additional window switch accessory for each zone will be exposed to HomeKit to trigger and enable/disable open window."
+                    "description": "If enabled, additional window switch accessory for each zone will be exposed to Apple Home to trigger and enable/disable open window."
                   },
                   "separateTemperature": {
                     "title": "Separate Temperature Sensors",
@@ -439,7 +439,7 @@
                     "condition": {
                       "functionBody": "try { return model.homes[arrayIndices[0]].zones[arrayIndices[1]].type === 'HEATING' } catch(e){ return false }"
                     },
-                    "description": "If enabled, the battery indicator will be removed from HomeKit."
+                    "description": "If enabled, the battery indicator will be removed from Apple Home."
                   },
                   "type": {
                     "title": "Type",

package/homebridge-ui/public/index.html

@@ -38,10 +38,10 @@
     <button type="submit" class="btn btn-elegant oldConfig" style="position: absolute;">
       <i class="fas fa-cogs" aria-hidden="true"></i>
     </button>
-    <img src="images/tado_logo.png" alt="Tado meets Homebridge" width="150px" class="center-it tadoLogo">
+    <img src="images/tado_logo.png" alt="tado meets Homebridge" width="150px" class="center-it tadoLogo">
     <h3 class="text-center"><span style="font-size: 20px">Welcome to</span> <br> <b style="font-weight: 800;">Homebridge
-        Tado</b></h3>
-    <h6 class="text-center">Homebridge plugin for Tado devices</h6>
+        tado</b></h3>
+    <h6 class="text-center">Homebridge plugin for tado devices</h6>
     <div class="container mt-4" style="max-width: 360px;">
       <div class="form-row">
         <div class="col-10">
@@ -71,9 +71,9 @@
     <button type="submit" class="btn btn-elegant oldConfig" style="position: absolute;">
       <i class="fas fa-cogs" aria-hidden="true"></i>
     </button>
-    <img src="images/tado_logo.png" alt="Tado meets Homebridge" width="150px" class="center-it tadoLogo">
-    <h3 class="text-center">Welcome to <br> <b style="font-weight: 800;">Homebridge Tado</b></h3>
-    <h6 class="text-center">Homebridge plugin for Tado devices</h6>
+    <img src="images/tado_logo.png" alt="tado meets Homebridge" width="150px" class="center-it tadoLogo">
+    <h3 class="text-center">Welcome to <br> <b style="font-weight: 800;">Homebridge tado</b></h3>
+    <h6 class="text-center">Homebridge plugin for tado devices</h6>
     <button id="start" type="submit" class="btn btn-primary center-it mt-3">Start</button>
   </div>
 
@@ -82,14 +82,14 @@
     <button type="submit" class="btn btn-elegant back" style="position: absolute;">
       <i class="fa fa-arrow-left" aria-hidden="true"></i>
     </button>
-    <img src="images/tado_logo.png" alt="Tado meets Homebridge" width="150px" class="center-it mt-4 tadoLogo">
-    <h6 class="text-center">To start the process, we need to authenticate with the Tado account of the home you want to
+    <img src="images/tado_logo.png" alt="tado meets Homebridge" width="150px" class="center-it mt-4 tadoLogo">
+    <h6 class="text-center">To start the process, we need to authenticate with the tado account of the home you want to
       add to Homebridge.<br>Please fill out all marked fields:</h6>
     <div class="container mt-5">
       <div class="form-group">
         <label for="homeUsername">Username<span class="text-danger">*</span></label>
         <input type="text" class="form-control" id="homeUsername" placeholder="your-tado@mail.com">
-        <label for="homeTadoApiUrl">Tado API URL (optional)</label>
+        <label for="homeTadoApiUrl">tado API URL (optional)</label>
         <input type="text" class="form-control" id="homeTadoApiUrl">
         <label for="homeSkipAuth">Skip Authentication (optional)</label>
         <input type="checkbox" class="form-checkbox" id="homeSkipAuth">
@@ -100,7 +100,7 @@
 
   <!-- fetchDevices -->
   <div id="fetchDevices" style="display:none;">
-    <img src="images/tado_logo.png" alt="Tado meets Homebridge" width="150px" class="center-it mt-2 tadoLogo">
+    <img src="images/tado_logo.png" alt="tado meets Homebridge" width="150px" class="center-it mt-2 tadoLogo">
     <h6 class="text-center">Devices are being searched.<br>Please follow the instructions below and be patient for a
       moment.</h6>
     <h6 class="text-center" id="authenticationInstructions" style="display:none;font-weight:bold;"></h6>

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

@@ -705,7 +705,7 @@ async function fetchDevices(auth, refresh, resync) {
 
       await TIMEOUT(2000);
 
-      homebridge.toast.info('Search for homes in the config to remove that were not found in the api...', 'Info');
+      homebridge.toast.info('Search for homes in the config to remove that were not found in the API...', 'Info');
 
       let removedHomes = 0;
 
@@ -1072,13 +1072,13 @@ async function fetchDevices(auth, refresh, resync) {
 
       }
 
-      homebridge.toast.info('Looking for homes which are found in the api but are not configured...', 'Info');
+      homebridge.toast.info('Looking for homes which are found in the API but are not configured...', 'Info');
 
       await TIMEOUT(2000);
 
       let addedHomes = 0;
 
-      //add new homes from api that doesnt exist in config
+      //add new homes from API that doesnt exist in config
       for (const foundHome of availableHomesInApis) {
 
         let found = false;

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

@@ -19,30 +19,30 @@ const schema = {
       'properties': {
         'id': {
           'title': 'Home ID',
-          'description': 'The id of your Home. Has to be the exact same id as in the web app of Tado.',
+          'description': 'The id of your Home. Has to be the exact same id as in the web app of tado.',
           'type': 'integer'
         },
         'name': {
           'title': 'Home Name',
-          'description': 'The name of your Home. Has to be the exact same name as in the web app of Tado.',
+          'description': 'The name of your Home. Has to be the exact same name as in the web app of tado.',
           'type': 'string',
           'required': true
         },
         'username': {
           'title': 'Username',
           'type': 'string',
-          'description': 'The user name that you use for the app and the web app of Tado.',
+          'description': 'The user name that you use for the app and the web app of tado.',
           'required': true
         },
         'tadoApiUrl': {
           'title': 'Tado API URL',
           'type': 'string',
-          'description': 'Optional: Use a custom tado api url (e.g. http://localhost:8080).'
+          'description': 'Optional: Use a custom tado API url (e.g. http://localhost:8080).'
         },
         'skipAuth': {
           'title': 'Skip Authentication',
           'type': 'boolean',
-          'description': 'Optional: Skip authentication for tado api.'
+          'description': 'Optional: Skip authentication for tado API.'
         },
         'polling': {
           'title': 'Polling',
@@ -53,7 +53,7 @@ const schema = {
         },
         'temperatureUnit': {
           'title': 'Temperature Unit',
-          'description': 'Temperature Unit for accessories in HomeKit exposed by this plugin.',
+          'description': 'Temperature Unit for accessories in Apple Home exposed by this plugin.',
           'type': 'string',
           'default': 'CELSIUS',
           'oneOf': [
@@ -127,7 +127,7 @@ const schema = {
                   'active': {
                     'title': 'Active',
                     'type': 'boolean',
-                    'description': 'If enabled, a new motion/occupancy sensor for this user will be exposed to HomeKit.'
+                    'description': 'If enabled, a new motion/occupancy sensor for this user will be exposed to Apple Home.'
                   },
                   'name': {
                     'title': 'Name',
@@ -169,12 +169,12 @@ const schema = {
             'temperatureSensor': {
               'title': 'Temperature Sensor',
               'type': 'boolean',
-              'description': 'If enabled, a temperature sensor for the weather will be exposed to HomeKit.'
+              'description': 'If enabled, a temperature sensor for the weather will be exposed to Apple Home.'
             },
             'solarIntensity': {
               'title': 'Solar Intensity',
               'type': 'boolean',
-              'description': 'If enabled, a lightbulb accessory for the solar intensity will be exposed to HomeKit.'
+              'description': 'If enabled, a lightbulb accessory for the solar intensity will be exposed to Apple Home.'
             },
             'accTypeSolarIntensity': {
               'title': 'Solar Intensity Accessory Type',
@@ -207,7 +207,7 @@ const schema = {
             'centralSwitch': {
               'title': 'Central Switch',
               'type': 'boolean',
-              'description': 'If enabled, a switch will be exposed to HomeKit to enable/disable all thermostats/boiler at once.'
+              'description': 'If enabled, a switch will be exposed to Apple Home to enable/disable all thermostats/boiler at once.'
             },
             'runningInformation': {
               'title': 'Heat Running Information',
@@ -220,7 +220,7 @@ const schema = {
             'presenceLock': {
               'title': 'Presence Lock',
               'type': 'boolean',
-              'description': 'If enabled, a Home/Away switch will be exposed to HomeKit.'
+              'description': 'If enabled, a Home/Away switch will be exposed to Apple Home.'
             },
             'accTypePresenceLock': {
               'title': 'Presence Lock Accessory Type',
@@ -282,7 +282,7 @@ const schema = {
                   'active': {
                     'title': 'Active',
                     'type': 'boolean',
-                    'description': 'If enabled, a child lock switch for this device will be exposed to HomeKit.'
+                    'description': 'If enabled, a child lock switch for this device will be exposed to Apple Home.'
                   },
                   'name': {
                     'title': 'Name',
@@ -293,7 +293,7 @@ const schema = {
                   'serialNumber': {
                     'title': 'Device Serial Number',
                     'type': 'string',
-                    'description': 'Enter the serial number of the device from which you want to display a \'Child Lock Switch\' in HomeKit. (only for devices with child lock support)',
+                    'description': 'Enter the serial number of the device from which you want to display a \'Child Lock Switch\' in Apple Home. (only for devices with child lock support)',
                     'required': true,
                     'condition': {
                       'functionBody': 'try { return model.homes.extras.childLockSwitches[arrayIndices[0]].active } catch(e){ return false }'
@@ -313,12 +313,12 @@ const schema = {
               'active': {
                 'title': 'Active',
                 'type': 'boolean',
-                'description': 'If enabled, a new thermostat/boiler switch will be exposed to HomeKit.'
+                'description': 'If enabled, a new thermostat/boiler switch will be exposed to Apple Home.'
               },
               'id': {
                 'title': 'ID',
                 'type': 'integer',
-                'description': 'Zone ID. Has to be the exact same id as in the web app of Tado.',
+                'description': 'Zone ID. Has to be the exact same id as in the web app of tado.',
                 'condition': {
                   'functionBody': 'try { return model.homes.zones[arrayIndices[0]].active } catch(e){ return false }'
                 }
@@ -326,7 +326,7 @@ const schema = {
               'name': {
                 'title': 'Name',
                 'type': 'string',
-                'description': 'Zone Name. Has to be the exact same name as in the web app of Tado.',
+                'description': 'Zone Name. Has to be the exact same name as in the web app of tado.',
                 'required': true
               },
               'delaySwitch': {
@@ -342,12 +342,12 @@ const schema = {
               'openWindowSensor': {
                 'title': 'Open Window Sensor',
                 'type': 'boolean',
-                'description': 'If enabled, additional window contact accessory for each zone will be exposed to HomeKit which triggers if tado detects an open window.'
+                'description': 'If enabled, additional window contact accessory for each zone will be exposed to Apple Home which triggers if tado detects an open window.'
               },
               'openWindowSwitch': {
                 'title': 'Open Window Switch',
                 'type': 'boolean',
-                'description': 'If enabled, additional window switch accessory for each zone will be exposed to HomeKit to trigger and enable/disable open window.'
+                'description': 'If enabled, additional window switch accessory for each zone will be exposed to Apple Home to trigger and enable/disable open window.'
               },
               'separateTemperature': {
                 'title': 'Separate Temperature Sensors',
@@ -432,7 +432,7 @@ const schema = {
                 'condition': {
                   'functionBody': 'try { return model.homes.zones[arrayIndices[0]].type === \'HEATING\' } catch(e){ return false }'
                 },
-                'description': 'If enabled, the battery indicator will be removed from HomeKit.'
+                'description': 'If enabled, the battery indicator will be removed from Apple Home.'
               },
               'type': {
                 'title': 'Type',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebridge-plugins/homebridge-tado",
-  "version": "8.7.0",
+  "version": "8.7.2",
   "description": "Homebridge plugin for controlling tado° devices.",
   "main": "index.js",
   "scripts": {
@@ -36,15 +36,15 @@
     "fakegato-history": "^0.6.7",
     "form-data": "^4.0.4",
     "fs-extra": "^11.3.2",
-    "got": "^14.6.2",
+    "got": "^14.6.3",
     "moment": "^2.30.1"
   },
   "devDependencies": {
     "@babel/core": "7.28.5",
     "@babel/eslint-parser": "7.28.5",
     "@babel/eslint-plugin": "7.27.1",
-    "@eslint/js": "^9.39.0",
-    "eslint": "^9.39.0",
+    "@eslint/js": "^9.39.1",
+    "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.4",

package/src/helper/handler.js

@@ -214,7 +214,7 @@ 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
+              // Map Apple Home target state to tado AC mode
               let acMode = 'COOL'; // Default to COOL
 
               // Get current target state from HeaterCooler service for proper mode detection
@@ -222,7 +222,7 @@ export default (api, accessories, config, tado, telegram) => {
               if (heaterCoolerService) {
                 let targetState = heaterCoolerService.getCharacteristic(api.hap.Characteristic.TargetHeaterCoolerState).value;
 
-                // Map HomeKit target states to Tado AC modes
+                // Map Apple Home target states to tado AC modes
                 // 1 = Heat, 2 = Cool, 3 = Auto
                 switch (targetState) {
                   case 1:
@@ -1092,7 +1092,7 @@ export default (api, accessories, config, tado, telegram) => {
             const acMode = zoneState.setting.mode || 'COOL';
             tempEqual = currentTemp && targetTemp ? Math.abs(currentTemp - targetTemp) < 0.5 : false;
 
-            // Map AC modes to HomeKit states
+            // Map AC modes to Apple Home states
             switch (acMode.toUpperCase()) {
               case 'HEAT':
                 targetState = 1; // Heating

package/src/platform.js

@@ -206,7 +206,7 @@ class TadoPlatform {
       Logger.info('Identify requested.', accessory.displayName);
     });
 
-    const manufacturer = 'Tado';
+    const manufacturer = 'tado';
 
     const model = device.model ? device.model : device.subtype;
 

package/src/tado/tado-api.js

@@ -42,7 +42,7 @@ export default class Tado {
     this._counter = persistedCounterData?.counter ?? 0;
     this._counterTimestamp = persistedCounterData?.counterTimestamp ?? new Date().toISOString();
     this._checkCounterMidnightReset();
-    //wait some seconds to catch recent api calls
+    //wait some seconds to catch recent API calls
     setTimeout(() => {
       void this._logCounter();
       setInterval(() => void this._logCounter(), 60 * 60 * 1000);
@@ -59,7 +59,7 @@ export default class Tado {
       if (data) return JSON.parse(data);
     } catch (error) {
       //no persisted counter data => ignore
-      Logger.debug(`Failed to read tado api file for user ${this.hashedUsername}: ${error.message || error}`);
+      Logger.debug(`Failed to read tado API file for user ${this.hashedUsername}: ${error.message || error}`);
     }
   }
 
@@ -82,7 +82,7 @@ export default class Tado {
       this._counter++;
       this._counterTimestamp = new Date().toISOString();
     } catch (error) {
-      Logger.warn(`Failed to increase tado api counter: ${error.message || error}`);
+      Logger.warn(`Failed to increase tado API counter: ${error.message || error}`);
     }
   }
 
@@ -100,16 +100,16 @@ export default class Tado {
       data.counterData = await this._getCounterData();
       await writeFile(join(this.storagePath, `tado-api-${this.hashedUsername}.json`), JSON.stringify(data, null, 2), "utf-8");
     } catch (error) {
-      Logger.error(`Error while updating the tado api file for user ${this.hashedUsername}: ${error.message || error}`);
+      Logger.error(`Error while updating the tado API file for user ${this.hashedUsername}: ${error.message || error}`);
     }
   }
 
   async _logCounter() {
     try {
       const counter = (await this._getCounterData()).counter;
-      Logger.info(`Tado API counter: ${counter.toLocaleString('en-US')}`);
+      Logger.info(`tado API counter: ${counter.toLocaleString('en-US')}`);
     } catch (error) {
-      Logger.warn(`Failed to get Tado API counter: ${error.message || error}`);
+      Logger.warn(`Failed to get tado API counter: ${error.message || error}`);
     }
   }
 
@@ -256,30 +256,15 @@ export default class Tado {
 
   async apiCall(path, method = 'GET', data = {}, params = {}, tado_url_dif) {
     const access_token = this.skipAuth ? undefined : await this.getToken();
+    const url = `${tado_url_dif || this.tadoApiUrl}${path}`;
 
-    let tadoLink = tado_url_dif || this.tadoApiUrl;
-
-    Logger.debug('Using ' + tadoLink, this.name);
-
-    Logger.debug(
-      'API request ' +
-      method +
-      ' ' +
-      path +
-      ' ' +
-      (data && Object.keys(data).length ? JSON.stringify(data) + ' <pending>' : '<pending>'),
-      this.name
-    );
-
-    let config = {
-      method: method,
+    const config = {
+      method,
       responseType: 'json',
-      headers: access_token ? {
-        Authorization: 'Bearer ' + access_token,
-      } : undefined,
-      timeout: {
-        request: 30000
-      },
+      headers: access_token ?
+        { Authorization: `Bearer ${access_token}` } :
+        undefined,
+      timeout: { request: 30000 },
       retry: {
         limit: 2,
         statusCodes: [408, 429, 503, 504],
@@ -294,12 +279,34 @@ export default class Tado {
 
     if (Object.keys(params).length) config.searchParams = params;
 
+    Logger.debug('API request start', {
+      name: this.name,
+      method,
+      url,
+      params: Object.keys(params).length ? params : undefined,
+      data: Object.keys(data).length ? data : undefined,
+    });
+
     try {
-      const response = await got(tadoLink + path, config);
+      const response = await got(url, config);
       await this._increaseCounter();
+      Logger.debug('API request success', {
+        name: this.name,
+        method,
+        url,
+        statusCode: response.statusCode,
+        body: response.body ?? 'empty response',
+      });
       return response.body;
     } catch (error) {
-      Logger.error(`API Request [${method} ${path}] - FAILED: ${error.message}`, this.name);
+      Logger.error('API request failed', {
+        name: this.name,
+        method,
+        url,
+        message: error.message,
+        statusCode: error.response?.statusCode,
+        body: error.response?.body,
+      });
       throw error;
     }
   }