homebridge-philips-airplus-cloud 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 The Home Assistant integration in `custom_components/` is unchanged from upstream and keeps its own history.
 
+## 0.3.3 — 2026-10-11
+
+- Fix: the plugin could stop updating when the cloud connection stayed open but stopped delivering data. If the purifier sends nothing for three status polls (at least 6 minutes), the connection is now rebuilt.
+- Fix: a new accessory is announced to HomeKit only once all its services exist, so the Home app sees the labelled, linked components from the start.
+
+## 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.

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

@@ -91,9 +91,28 @@ class PurifierAccessory {
   start() {
     this.conn.start();
     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
+    // three polls (at least 6 minutes) the connection is rebuilt.
+    const silenceMs = Math.max(3 * pollS, 360) * 1000;
     this.pollTimer = setInterval(async () => {
       await this.conn.refreshIfNeeded();
-      if (this.conn.connected) this.conn.getPort(this.conn.ports.status);
+      if (!this.conn.connected) return;
+      const silent = Date.now() - this.conn.lastMessageAt;
+      if (silent > silenceMs) {
+        // Warn once; if the purifier is simply unplugged keep retrying quietly.
+        const msg = `No data from the purifier for ${Math.round(silent / 60000)} min; reconnecting to the Philips cloud`;
+        if (this._silenceWarned) this.log.debug(msg);
+        else this.log.warn(msg);
+        this._silenceWarned = true;
+        this.conn.reconnect();
+        return;
+      }
+      if (this._silenceWarned) {
+        this._silenceWarned = false;
+        this.log.info('Receiving data from the purifier again');
+      }
+      this.conn.getPort(this.conn.ports.status);
     }, pollS * 1000);
     this.filterTimer = setInterval(() => {
       if (this.conn.connected) this.conn.getPort(this.conn.ports.filter_read);
@@ -125,6 +144,11 @@ class PurifierAccessory {
     this._setInfo();
     this._pushAll();
     this.log.info(`Using model profile "${this.model.name}" (${this.speeds.length} manual speeds${this.hasAuto ? ' + Auto' : ''})`);
+    if (this.onModelReady) {
+      const cb = this.onModelReady;
+      this.onModelReady = null;
+      cb();
+    }
   }
 
   _prop(name) {

package/src/connection.js

@@ -70,6 +70,16 @@ class DeviceConnection extends EventEmitter {
     this.attempt = 0;
     this.timer = null;
     this.ports = { ...C.DEFAULT_PORTS };
+    this.lastMessageAt = Date.now();
+  }
+
+  /** Drop the current connection and connect again with fresh credentials. */
+  reconnect() {
+    if (this.stopped) return;
+    this.connected = false;
+    this.attempt = 0;
+    clearTimeout(this.timer);
+    this._connect();
   }
 
   setPorts(ports) {
@@ -161,12 +171,15 @@ class DeviceConnection extends EventEmitter {
       if (client !== this.client) return;
       this.connected = true;
       this.attempt = 0;
+      this.lastMessageAt = Date.now();
       client.subscribe(C.TOPIC_STATUS(this.deviceId), { qos: 0 });
       this.log.info('Connected to Philips cloud');
       this.emit('connected');
     });
 
     client.on('message', (topic, payload) => {
+      if (client !== this.client) return;
+      this.lastMessageAt = Date.now();
       let messages;
       try {
         messages = parseConcatenatedJson(payload.toString('utf8'));

package/src/platform.js

@@ -66,20 +66,33 @@ 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) {
+      const isNew = !acc;
+      if (isNew) {
         acc = new this.api.platformAccessory(dev.name, hbUuid, this.api.hap.Categories.AIR_PURIFIER);
         acc.context.uuid = dev.uuid;
         if (dev.model) acc.context.model = dev.model;
-        this.log.info(`Adding ${dev.name}`);
-        this.api.registerPlatformAccessories(C.PLUGIN_NAME, C.PLATFORM_NAME, [acc]);
       } else if (!acc.context.model && dev.model) {
         acc.context.model = dev.model;
       }
       const handler = new PurifierAccessory(this, acc, { account: this.account });
       this.handlers.set(hbUuid, handler);
+      if (isNew) {
+        // Announce a new accessory to HomeKit only once all its services exist:
+        // the Home app records names and links when it first sees an accessory,
+        // and services added to an already published accessory may show unlabelled.
+        const register = () => {
+          this.log.info(`Adding ${dev.name}`);
+          this.api.registerPlatformAccessories(C.PLUGIN_NAME, C.PLATFORM_NAME, [acc]);
+        };
+        if (handler.model) register();
+        else handler.onModelReady = register;
+      }
       handler.conn.on('authExpired', () => this._authExpired());
       handler.start();
     }