homebridge-philips-airplus-cloud 0.3.5 → 0.3.8

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
 
+## 0.3.8 — 2026-10-11
+
+- Homebridge verification: `supports-hap` keyword; config schema uses object-level `required` arrays instead of per-field `required: true`. No functional changes.
+
+## 0.3.7 — 2026-10-11
+
+- Removed the `labelRefresh` option added in 0.3.5: it did not help, the missing labels were caused by linked components (fixed in 0.3.6). A leftover `labelRefresh` value in the config is simply ignored.
+
+## 0.3.6 — 2026-10-11
+
+- Components (Sleep, Air Quality, Filter, Pre-filter, Display) are no longer linked to the purifier by default. The Home app draws linked components as controls of the purifier without their names; unlinked ones get their own labelled tile in the purifier's combined view. Existing links are removed on startup. Set `linkComponents: true` to link them again.
+
 ## 0.3.5 — 2026-10-11
 
 - Option `labelRefresh`: if the Home app does not show the labels under the purifier's components in its combined view, set any new value and restart. About 40 s after startup the plugin renames the components in two steps (long name, then short label), replaying the rename that made Home show the labels before. Names set in the Home app are replaced by the defaults.

package/README.md

@@ -80,11 +80,11 @@ The refresh token rotates on every use; the plugin keeps the current one in `<ho
 | `filterSensors` | `true` | Show filter and pre-filter status |
 | `sleepSwitch` | `true` | Show the Sleep mode switch |
 | `sleepSwitchStyle` | `switch` | `purifier` shows the Sleep control as a second air purifier (purifier icon in Home) that only turns Sleep on/off |
+| `linkComponents` | `false` | Link Sleep, air quality and filters to the purifier. Off: each gets its own labelled tile in the purifier's combined view. On: Home shows them as controls inside the purifier, without labels |
 | `displayLight` | `true` | Show the display light |
 | `displayLightProperty` | — | Property key of the display light, if it is not detected (see the `Status properties reported by the device` log line) |
 | `logDeviceData` | `false` | Diagnostics: at startup, log every port and the cloud shadow the purifier publishes |
 | `homekitIdentity` | — | Change to any new value to give the purifier a new HomeKit identity (use only if the Home app refuses to move or rename it; reassign the room afterwards) |
-| `labelRefresh` | — | Change to any new value if the Home app does not show the labels under the components; the plugin renames them in two steps ~40 s after startup (Home-app renames are replaced) |
 | `filterChangeThreshold` | `10` | Filter life (%) at or below which HomeKit shows "replace filter" |
 | `pollInterval` | `120` | Seconds between safety-net status polls |
 

package/config.schema.json

@@ -10,8 +10,7 @@
       "name": {
         "title": "Name",
         "type": "string",
-        "default": "Philips Air+",
-        "required": true
+        "default": "Philips Air+"
       },
       "email": {
         "title": "Philips account email",
@@ -41,8 +40,7 @@
           "properties": {
             "uuid": {
               "title": "Device UUID",
-              "type": "string",
-              "required": true
+              "type": "string"
             },
             "name": {
               "title": "Name in HomeKit",
@@ -53,7 +51,10 @@
               "type": "string",
               "description": "e.g. AC0651/10. Normally detected automatically."
             }
-          }
+          },
+          "required": [
+            "uuid"
+          ]
         }
       },
       "airQualitySensor": {
@@ -91,6 +92,12 @@
         ],
         "description": "'Air purifier' shows Sleep with the purifier icon in the Home app; it only turns Sleep mode on and off."
       },
+      "linkComponents": {
+        "title": "Link components to the purifier",
+        "type": "boolean",
+        "default": false,
+        "description": "Off (default): Sleep, air quality and filters get their own labelled tile in the purifier's combined view. On: the Home app shows them as controls inside the purifier, without labels."
+      },
       "displayLight": {
         "title": "Show the display light as a dimmable light",
         "type": "boolean",
@@ -128,14 +135,11 @@
         "type": "string",
         "placeholder": "e.g. 2",
         "description": "Only if the Home app refuses to move or rename the purifier: type any new value (e.g. 2, then 3 next time) and restart. Home will see the purifier as a new accessory; reassign its room and check your scenes afterwards."
-      },
-      "labelRefresh": {
-        "title": "Refresh component labels (advanced)",
-        "type": "string",
-        "placeholder": "e.g. 1",
-        "description": "If the Home app does not show the labels under the purifier's components, type any new value and restart: about 40 seconds after startup the plugin renames the components in two steps so Home picks the labels up. Names you set in the Home app are replaced by the default ones."
       }
-    }
+    },
+    "required": [
+      "name"
+    ]
   },
   "layout": [
     "name",
@@ -173,13 +177,13 @@
         "filterSensors",
         "sleepSwitch",
         "sleepSwitchStyle",
+        "linkComponents",
         "displayLight",
         "displayLightProperty",
         "filterChangeThreshold",
         "pollInterval",
         "logDeviceData",
-        "homekitIdentity",
-        "labelRefresh"
+        "homekitIdentity"
       ]
     }
   ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-philips-airplus-cloud",
   "displayName": "Philips Air+",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "Homebridge plugin for Philips Air+ / PureProtect air purifiers via the Philips (Versuni) cloud — the same MQTT protocol used by the Air+ app and Google Home.",
   "main": "src/index.js",
   "license": "MIT",
@@ -15,6 +15,7 @@
   "homepage": "https://github.com/Micheledipaola/homebridge-philips-airplus#readme",
   "keywords": [
     "homebridge-plugin",
+    "supports-hap",
     "philips",
     "air purifier",
     "air+",

package/src/accessory.js

@@ -90,7 +90,6 @@ class PurifierAccessory {
 
   start() {
     this.conn.start();
-    this._scheduleLabelRefresh();
     const pollS = Math.max(30, Number(this.platform.config.pollInterval) || C.STATUS_POLL_INTERVAL_S);
     // Watchdog: the cloud connection can stay open but stop delivering data.
     // Every poll asks the device for its status, so if nothing has arrived for
@@ -120,44 +119,7 @@ class PurifierAccessory {
     }, C.FILTER_POLL_INTERVAL_MS);
   }
 
-  /**
-   * labelRefresh: replays what made the Home app show labels under each
-   * component in the purifier's combined view — the plugin renaming the
-   * components while Home is connected (as the 0.2.1 update did, from
-   * "<purifier> Air Quality" to "Air Quality"). Runs once per new value.
-   * Names given in the Home app are replaced by the default labels.
-   */
-  _scheduleLabelRefresh() {
-    const want = String(this.platform.config.labelRefresh || '').trim();
-    if (!want || this.accessory.context.labelRefresh === want) return;
-    const { Characteristic } = this.hap;
-    const STEP_MS = 20000;
-    const targets = () => this.accessory.services.filter((x) => x.__label && x !== this.purifier);
-    const rename = (long) => {
-      for (const x of targets()) {
-        const name = long ? `${this.accessory.displayName} ${x.__label}` : x.__label;
-        x.updateCharacteristic(Characteristic.Name, name);
-        if (x.testCharacteristic(Characteristic.ConfiguredName)) x.updateCharacteristic(Characteristic.ConfiguredName, name);
-      }
-    };
-    this._labelTimers = [
-      setTimeout(() => {
-        if (!targets().length) return;
-        this.log.info('labelRefresh: renaming components in two steps so the Home app shows their labels');
-        rename(true);
-      }, STEP_MS),
-      setTimeout(() => {
-        if (!targets().length) return;
-        rename(false);
-        this.accessory.context.labelRefresh = want;
-        this.platform.updateAccessory(this.accessory);
-        this.log.info('labelRefresh: done');
-      }, 2 * STEP_MS),
-    ];
-  }
-
   stop() {
-    (this._labelTimers || []).forEach(clearTimeout);
     clearInterval(this.pollTimer);
     clearInterval(this.filterTimer);
     this.conn.stop();
@@ -227,7 +189,6 @@ class PurifierAccessory {
       ? this.accessory.getServiceById(type, subtype)
       : this.accessory.services.find((x) => x.UUID === type.UUID && !x.subtype);
     const s = existing || this.accessory.addService(type, label, subtype);
-    s.__label = label; // default label, used by labelRefresh (not persisted)
     // Set the label on new services, and once on services created by older
     // versions (which used long "<device> Sleep" names). Later user renames
     // made in the Home app are kept.
@@ -238,8 +199,14 @@ class PurifierAccessory {
         s.setCharacteristic(Characteristic.ConfiguredName, label);
       }
     }
-    if (link && this.purifier && s !== this.purifier && !this.purifier.linkedServices.includes(s)) {
-      this.purifier.addLinkedService(s);
+    // linkComponents (default off): linked components are drawn by the Home
+    // app as controls of the purifier, without their names; unlinked ones get
+    // their own labelled tile in the purifier's combined view.
+    if (this.purifier && s !== this.purifier) {
+      const linked = this.purifier.linkedServices.includes(s);
+      const want = link && this.platform.config.linkComponents === true;
+      if (want && !linked) this.purifier.addLinkedService(s);
+      if (!want && linked) this.purifier.removeLinkedService(s);
     }
     return s;
   }