homebridge-philips-airplus-cloud 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
 
+## 0.3.2 — 2026-10-11
+
+- Option `homekitIdentity`: gives the purifier a new HomeKit identity when the Home app keeps a stuck record of it (rooms and names cannot be changed). The previous accessory is removed automatically.
+
+## 0.3.1 — 2026-10-11
+
+- Fix: on a fresh install the purifier started with the reduced profile ("Model AC0651 is not in models.yaml") because the cloud device list gives the model without its `/10` suffix. The short code now matches its `models.yaml` entry, and an unknown code waits for the exact one reported by the device.
+
 ## 0.3.0 — 2026-10-11
 
 - Published on npm as `homebridge-philips-airplus-cloud` (the name `homebridge-philips-airplus` belongs to an unrelated humidifier plugin). Installs from the earlier `.tgz` or git builds were named `homebridge-philips-airplus`: uninstall that first.

package/README.md

@@ -83,6 +83,7 @@ The refresh token rotates on every use; the plugin keeps the current one in `<ho
 | `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) |
 | `filterChangeThreshold` | `10` | Filter life (%) at or below which HomeKit shows "replace filter" |
 | `pollInterval` | `120` | Seconds between safety-net status polls |
 

package/config.schema.json

@@ -122,6 +122,12 @@
         "type": "boolean",
         "default": false,
         "description": "At startup, ask the purifier for all its ports and cloud shadow and write them to the log. Turn off again afterwards."
+      },
+      "homekitIdentity": {
+        "title": "HomeKit identity (advanced)",
+        "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."
       }
     }
   },
@@ -165,7 +171,8 @@
         "displayLightProperty",
         "filterChangeThreshold",
         "pollInterval",
-        "logDeviceData"
+        "logDeviceData",
+        "homekitIdentity"
       ]
     }
   ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-philips-airplus-cloud",
   "displayName": "Philips Air+",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "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",

package/src/accessory.js

@@ -78,9 +78,12 @@ class PurifierAccessory {
     });
     this.conn.on('message', (m, topic) => this._onMessage(m, topic));
 
+    // The cached/cloud model code is only a hint: if it does not match a
+    // models.yaml entry, wait for the device to report its exact code on the
+    // Config port instead of starting with the reduced fallback profile.
     const known = accessory.context.model;
-    if (known) this._applyModel(known, false);
-    else this.log.info('Model not known yet; waiting for the device to report it');
+    if (known && findModel(known)) this._applyModel(known, false);
+    else this.log.info(`Model ${known ? `${known} ` : ''}not identified yet; waiting for the device to report it`);
 
     this._setInfo();
   }

package/src/models.js

@@ -24,14 +24,22 @@ function loadModels(file = MODELS_FILE) {
   return cache;
 }
 
-/** Exact match first, then prefix match (e.g. "AC3221/10" -> "AC3221"). */
+/**
+ * Exact match first, then prefix match either way:
+ *  - "AC3221/10" -> "AC3221"     (device reports a longer code than the yaml key)
+ *  - "AC0651"    -> "AC0651/10"  (the cloud device list omits the /xx suffix)
+ */
 function findModel(ctn) {
   if (!ctn) return null;
+  const code = String(ctn).trim().toUpperCase();
   const models = loadModels();
-  if (models[ctn]) return { key: ctn, ...models[ctn] };
-  for (const [key, cfg] of Object.entries(models)) {
-    if (String(ctn).startsWith(key)) return { key, ...cfg };
-  }
+  const entries = Object.entries(models);
+  const exact = entries.find(([key]) => key.toUpperCase() === code);
+  if (exact) return { key: exact[0], ...exact[1] };
+  const longer = entries.find(([key]) => code.startsWith(key.toUpperCase()));
+  if (longer) return { key: longer[0], ...longer[1] };
+  const base = entries.find(([key]) => key.toUpperCase().startsWith(`${code}/`));
+  if (base) return { key: base[0], ...base[1] };
   return null;
 }
 

package/src/platform.js

@@ -66,7 +66,10 @@ class PhilipsAirPlusPlatform {
 
     const keep = new Set();
     for (const dev of wanted) {
-      const hbUuid = this.api.hap.uuid.generate(`${C.PLATFORM_NAME}:${dev.uuid}`);
+      // homekitIdentity: changing it gives the accessory a brand-new HomeKit
+      // identity, for when the Home app has a stuck record of the old one.
+      const identity = String(this.config.homekitIdentity || '').trim();
+      const hbUuid = this.api.hap.uuid.generate(`${C.PLATFORM_NAME}:${dev.uuid}${identity ? `:${identity}` : ''}`);
       keep.add(hbUuid);
       let acc = this.cached.get(hbUuid);
       if (!acc) {