homebridge-pax-calima 2.3.1 → 2.4.0

package/README.md

@@ -1,27 +1,155 @@
 # homebridge-pax-calima
 
-Homebridge platform plugin for **Pax Calima** and **Vent-Axia Svara** Bluetooth LE bathroom extractor fans.
+**Homebridge 2.0 Ready** · [npm](https://www.npmjs.com/package/homebridge-pax-calima) · [GitHub](https://github.com/JayC68/homebridge-pax-calima)
 
-The Vent-Axia Svara is the UK rebrand of the Pax Calima — they use the **exact same Bluetooth protocol**, MAC prefix (`58:2b:db`), and GATT characteristics.
+Full HomeKit integration for **Pax Calima** and **Vent-Axia Lo-Carbon Svara** Bluetooth LE bathroom extractor fans.
+
+Compatible devices:
+- **Pax Calima** — Sweden, Norway, Denmark, Finland, Spain, Portugal
+- **Vent-Axia Lo-Carbon Svara** (White & Black) — UK
+
+All are hardware-identical and share the same BLE protocol and MAC prefix (`58:2b:db`).
+
+---
 
 ## Features
-- Automatic discovery of fans (MAC starting with `58:2b:db`)
-- Fan control (On/Off + Rotation Speed 0-100%)
-- Live sensors: Humidity, Temperature, Light level
-- Mode switching (Multi Mode, Heat Distribution)
-- Boost button (press to activate temporary high-speed boost)
-- Silent Hours toggle
-- Automatic cycle switches (30/60/90 min)
-- Trickle ventilation toggle
-- Easy configuration via Homebridge Config UI
-
-Perfect for Apple Home automations.
+
+| Feature | Detail |
+|---|---|
+| **Auto-discovery** | Finds all compatible fans automatically — no MAC address needed |
+| **Fan speed** | Displays live RPM as 0–100%; speed control available (see wiring note) |
+| **Humidity sensor** | Live readings, updates every 10 seconds |
+| **Temperature sensor** | Live readings, updates every 10 seconds |
+| **Light sensor** | Live lux readings, updates every 10 seconds |
+| **Boost button** | Stateless programmable switch |
+| **Silent Hours** | Toggle switch — suppresses automatic boosting during quiet periods |
+| **Automations** | Full HomeKit automation support on all sensors |
+
+---
+
+## Requirements
+
+- Homebridge `^1.6.0` or `^2.0.0`
+- Node.js `>= 18`
+- A Bluetooth LE adapter on the Homebridge host
+
+### Raspberry Pi / Homebridge OS — one-time setup
+
+```bash
+sudo setcap cap_net_raw+eip /opt/homebridge/bin/node
+```
+
+If Bluetooth shows as `poweredOff`:
+
+```bash
+sudo rfkill unblock bluetooth
+```
+
+---
 
 ## Installation
 
 ### Via Homebridge UI (recommended)
-Search for **Pax Calima** or **Svara** and install.
+Search for **Pax Calima** or **Svara** and click Install.
 
 ### Via Terminal
 ```bash
 npm install -g homebridge-pax-calima
+```
+
+---
+
+## Configuration
+
+No configuration needed for auto-discovery. To set a custom name or PIN per fan:
+
+```json
+{
+  "platform": "PaxCalima",
+  "name": "Pax Calima / Vent-Axia Svara",
+  "fans": [
+    {
+      "name": "Wetroom Fan",
+      "mac": "58:2b:db:xx:xx:xx",
+      "pin": "012345"
+    }
+  ]
+}
+```
+
+The `fans` array is optional. Default PIN is `012345`.
+
+---
+
+## Accessories in Apple Home
+
+Each fan appears as a single accessory with:
+
+- **Fan** — live speed display; slider available (see wiring note)
+- **Boost** — single-press programmable button
+- **Silent Hours** — on/off switch
+- **Humidity** — % relative humidity
+- **Temperature** — °C
+- **Light** — lux
+
+> Accessories appear in the **Home app**, not the Homebridge UI accessories tab. This is correct for child bridge plugins.
+
+---
+
+## Fan Speed Control — Wiring Mode
+
+The fan supports two installation wiring modes:
+
+**Intermittent mode** — fan is off by default, triggered by sensors or timer. BLE speed commands work fully; the slider controls the fan directly.
+
+**Always-on (trickle) mode** — fan runs continuously at a speed set by its onboard controller. BLE speed writes are accepted but the firmware reasserts its own setpoint immediately. The slider accurately reflects current RPM but cannot override the onboard speed.
+
+If your fan is in always-on mode, sensors and automations remain fully functional — for bathroom and wetroom use these are the primary value of the integration. To enable full speed control, switch to intermittent wiring mode per the installation guide.
+
+---
+
+## Sensor Notes
+
+The light sensor detects occupancy via movement and shadows rather than acting as a precision lux meter. Small variances from a reference device are expected and normal.
+
+For lux-based automations, use **Eve** or **Hesperus** which support lux thresholds synced to HomeKit.
+
+---
+
+## Troubleshooting
+
+**Fan not discovered** — run `hciconfig` on Pi; confirm `UP RUNNING`. If `RF-KILL`, run `sudo rfkill unblock bluetooth`. Confirm `setcap` was applied to `/opt/homebridge/bin/node`.
+
+**Authentication failed** — default PIN is `012345`. If changed in the official app, add the fan to the `fans` config with the correct PIN.
+
+**Speed slider has no effect** — fan is wired in always-on mode. See wiring note above. All sensors work normally.
+
+**Accessories not in Home app** — clear accessory cache via Homebridge UI → plugin settings → Remove Accessory Cache, then restart.
+
+---
+
+## Release Notes
+
+### 2.4.0
+- **Rebuilt:** Connection architecture reverted to persistent BLE connection model — connect once, cache all characteristics, poll with direct `readAsync()` calls. Eliminates the per-poll scan/connect/auth/discover overhead that made 2.x sluggish and error-prone
+- **Improved:** Both sensor characteristics now read in parallel via `Promise.all` — faster polls
+- **Improved:** Characteristics cached once per connection — no repeated service discovery
+- **Improved:** Auth performed once per connection, not per poll
+- **Improved:** Automatic reconnection on unexpected disconnect with clean cache flush
+- **Fixed:** `Characteristic not found` intermittent errors eliminated — characteristic lookup now uses pre-cached map rather than repeated discovery
+- **Fixed:** `writeSpeed` uses cached control characteristic and preserves trickle/boost values
+- **Fixed:** Default accessory name changed to `Pax Calima` for international compatibility
+
+### 2.3.2
+- Documented always-on vs intermittent wiring mode behaviour for speed control
+
+### 2.3.1
+- Identified correct control characteristic; added write diagnostics
+
+### 2.3.0 / 2.2.1 / 2.1.0
+- Sensor characteristic UUIDs and byte mappings confirmed via live device
+- BLE initialisation fixes for Homebridge 2.0
+- Duplicate accessory registration resolved
+
+### 1.0.x
+- Initial working releases

package/config.schema.json

@@ -11,22 +11,58 @@
         "default": "Pax Calima / Vent-Axia Svara"
       },
       "fans": {
-        "title": "Configured Fans",
+        "title": "Manually Configured Fans",
+        "description": "Optional. Leave empty to use auto-discovery (recommended). Add entries here only to set a custom name or PIN per fan.",
         "type": "array",
         "items": {
           "type": "object",
           "properties": {
-            "name": { "title": "Name", "type": "string", "default": "Bathroom Fan" },
+            "name": {
+              "title": "Accessory Name",
+              "type": "string",
+              "default": "Bathroom Fan"
+            },
             "mac": {
               "title": "MAC Address",
               "type": "string",
-              "pattern": "^([0-9A-Fa-f]{2}[:]){5}([0-9A-Fa-f]{2})$",
-              "placeholder": "e.g. 58:2b:db:00:00:00"
+              "pattern": "^([0-9A-Fa-f]{2}:){5}([0-9A-Fa-f]{2})$",
+              "description": "MAC address of the fan (e.g. 58:2b:db:xx:xx:xx). Must start with 58:2b:db."
             },
-            "pin": { "title": "PIN Code", "type": "string", "default": "012345" }
-          }
+            "pin": {
+              "title": "PIN Code",
+              "type": "string",
+              "default": "012345",
+              "description": "6-digit PIN. Only change this if you set a custom PIN in the official Pax / Vent-Axia app."
+            }
+          },
+          "required": ["name", "mac"]
         }
       }
     }
-  }
+  },
+  "layout": [
+    {
+      "type": "section",
+      "title": "General",
+      "expandable": false,
+      "items": ["name"]
+    },
+    {
+      "type": "section",
+      "title": "Fans (optional — auto-discovery recommended)",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        {
+          "key": "fans",
+          "type": "array",
+          "items": [
+            "fans[].name",
+            "fans[].mac",
+            "fans[].pin"
+          ]
+        }
+      ]
+    }
+  ]
 }

package/index.js

@@ -1,15 +1,18 @@
+'use strict';
+
 const noble = require('@abandonware/noble');
 
 let Service, Characteristic, Categories, API, PlatformAccessory;
 
-const UUID_AUTH    = '4cad343a-209a-40b7-b911-4d9b3df569b2';
-const UUID_STATUS  = '528b80e8-c47a-4c0a-bdf1-916a7748f412'; // read: RPM + temp
-const UUID_SENSOR  = 'a22eae12-dba8-49f3-9c69-1721dcff1d96'; // read: humidity + lux
-const UUID_CONTROL = '1488a757-35bc-4ec8-9a6b-9ecf1502778e'; // read/write: speed config
+// ── Verified BLE UUIDs (confirmed via live device dump) ───────────────────────
+const UUID_AUTH    = '4cad343a-209a-40b7-b911-4d9b3df569b2'; // PIN auth — write once
+const UUID_STATUS  = '528b80e8-c47a-4c0a-bdf1-916a7748f412'; // RPM (offset 6) + temp (offset 2)
+const UUID_SENSOR  = 'a22eae12-dba8-49f3-9c69-1721dcff1d96'; // humidity (offset 0) + lux (offset 2 BE)
+const UUID_CONTROL = '1488a757-35bc-4ec8-9a6b-9ecf1502778e'; // speed config — 6 bytes: trickle/normal/boost
 
-const MAC_PREFIX      = '58:2b:db';
-const POLL_MS         = 10000;
-const SCAN_TIMEOUT_MS = 15000;
+const MAC_PREFIX   = '58:2b:db';
+const POLL_MS      = 10000; // 10s — responsive for shower humidity spikes
+const RECONNECT_MS = 15000;
 
 module.exports = (homebridge) => {
   Service           = homebridge.hap.Service;
@@ -17,33 +20,40 @@ module.exports = (homebridge) => {
   Categories        = homebridge.hap.Categories;
   API               = homebridge;
   PlatformAccessory = homebridge.platformAccessory;
+
+  // true = dynamic platform, required for Homebridge 2.0
   homebridge.registerPlatform('homebridge-pax-calima', 'PaxCalima', PaxCalimaPlatform, true);
 };
 
+// ─── Platform ─────────────────────────────────────────────────────────────────
 class PaxCalimaPlatform {
   constructor(log, config, api) {
-    this.log               = log;
-    this.config            = config || {};
-    this.api               = api;
-    this.registeredMACs    = new Set();
-    this.discoveryStarted  = false;
-    this.cachedAccessories = [];
+    this.log              = log;
+    this.config           = config || {};
+    this.api              = api;
+    this.registeredMACs   = new Set();
+    this.discoveryStarted = false;
+    this.cachedAccessories = []; // held until BLE is ready after didFinishLaunching
 
     this.log.info('PaxCalima platform initialised');
 
     this.api.on('didFinishLaunching', () => {
-      this.log.info('Homebridge finished launching - starting BLE');
+      this.log.info('Homebridge finished launching — starting BLE');
+
       noble.on('stateChange', (state) => {
         this.log.info('BLE state: ' + state);
         if (state === 'poweredOn') this.startDiscovery();
       });
+
+      // Catch case where noble is already poweredOn before listener fires
       setTimeout(() => {
-        this.log.info('BLE current state: ' + noble.state);
         if (noble.state === 'poweredOn') this.startDiscovery();
       }, 3000);
     });
   }
 
+  // Called by Homebridge for each cached accessory on startup.
+  // We hold them until startDiscovery() confirms BLE is ready.
   configureAccessory(accessory) {
     const mac = accessory.context && accessory.context.mac;
     this.log.info('Restoring cached accessory: ' + accessory.displayName);
@@ -57,13 +67,14 @@ class PaxCalimaPlatform {
     if (this.discoveryStarted) return;
     this.discoveryStarted = true;
 
+    // Spin up handlers for all cached (previously registered) accessories
     for (const { accessory, mac } of this.cachedAccessories) {
-      const pin = this.pinForMac(mac);
-      this.log.info('Starting BLE handler for cached fan: ' + mac);
-      new PaxCalimaAccessory(this.log, accessory, mac, pin);
+      this.log.info('Connecting to cached fan: ' + mac);
+      new PaxCalimaAccessory(this.log, accessory, mac, this.pinForMac(mac));
     }
     this.cachedAccessories = [];
 
+    // Scan for any new fans not yet registered
     this.log.info('Starting BLE discovery scan...');
     noble.startScanning([], false);
 
@@ -71,23 +82,25 @@ class PaxCalimaPlatform {
       const mac = peripheral.address.toLowerCase();
       if (!mac.startsWith(MAC_PREFIX)) return;
       if (this.registeredMACs.has(mac)) return;
+
       this.registeredMACs.add(mac);
       this.log.info('Discovered new fan: ' + mac);
-      const name  = this.nameForMac(mac);
-      const pin   = this.pinForMac(mac);
-      const uuid  = API.hap.uuid.generate('pax-svara-' + mac);
-      const hbAcc = new PlatformAccessory(name, uuid, Categories.FAN);
+
+      const uuid  = API.hap.uuid.generate('pax-calima-' + mac);
+      const hbAcc = new PlatformAccessory(this.nameForMac(mac), uuid, Categories.FAN);
       hbAcc.context.mac = mac;
-      new PaxCalimaAccessory(this.log, hbAcc, mac, pin);
+
+      new PaxCalimaAccessory(this.log, hbAcc, mac, this.pinForMac(mac));
       this.api.registerPlatformAccessories('homebridge-pax-calima', 'PaxCalima', [hbAcc]);
     });
   }
 
   fanConfig(mac)  { return (this.config.fans || []).find(f => f.mac && f.mac.toLowerCase() === mac) || {}; }
   pinForMac(mac)  { return this.fanConfig(mac).pin  || '012345'; }
-  nameForMac(mac) { return this.fanConfig(mac).name || ('Vent-Axia Svara ' + mac.slice(-5).toUpperCase()); }
+  nameForMac(mac) { return this.fanConfig(mac).name || ('Pax Calima ' + mac.slice(-5).toUpperCase()); }
 }
 
+// ─── Accessory ────────────────────────────────────────────────────────────────
 class PaxCalimaAccessory {
   constructor(log, accessory, mac, pin) {
     this.log       = log;
@@ -95,22 +108,28 @@ class PaxCalimaAccessory {
     this.mac       = mac.toLowerCase();
     this.pin       = pin || '012345';
 
+    // Sensor state — served to HomeKit between polls
     this.currentRPM  = 0;
     this.humidity    = 0;
     this.temperature = 20;
     this.lightLevel  = 0.0001;
     this.silentHours = false;
 
-    this.pollTimer = null;
-    this.polling   = false;
+    // BLE connection state
+    this.peripheral  = null;
+    this.charCache   = {};   // uuid (stripped) → characteristic — populated once per connection
+    this.connected   = false;
+    this.pollTimer   = null;
 
     this.setupServices();
-    this.schedulePoll(0);
+    this.connect();          // connect immediately — BLE is ready by the time we're constructed
   }
 
+  // ── HomeKit services ────────────────────────────────────────────────────────
   setupServices() {
     const n = this.accessory.displayName;
 
+    // Fan — always reports as active; speed reflects live RPM
     this.fanService = this.accessory.getService(Service.Fanv2)
       || this.accessory.addService(new Service.Fanv2(n, 'fan'));
     this.fanService.getCharacteristic(Characteristic.Active)
@@ -120,17 +139,20 @@ class PaxCalimaAccessory {
       .onGet(() => this.rpmToPercent(this.currentRPM))
       .onSet((v) => this.writeSpeed(v));
 
+    // Boost — stateless single-press button
     this.boostButton = this.accessory.getService(Service.StatelessProgrammableSwitch)
       || this.accessory.addService(new Service.StatelessProgrammableSwitch(n + ' Boost', 'boost'));
     this.boostButton.getCharacteristic(Characteristic.ProgrammableSwitchEvent)
       .setProps({ validValues: [0] });
 
+    // Silent Hours — suppresses automatic boosting overnight
     this.silentService = this.accessory.getServiceByUUIDAndSubType(Service.Switch, 'silent-hours')
       || this.accessory.addService(new Service.Switch(n + ' Silent Hours', 'silent-hours'));
     this.silentService.getCharacteristic(Characteristic.On)
       .onGet(() => this.silentHours)
       .onSet((on) => this.setSilentHours(on));
 
+    // Sensors
     this.humidityService = this.accessory.getService(Service.HumiditySensor)
       || this.accessory.addService(new Service.HumiditySensor(n + ' Humidity', 'humidity'));
     this.humidityService.getCharacteristic(Characteristic.CurrentRelativeHumidity)
@@ -146,71 +168,66 @@ class PaxCalimaAccessory {
     this.lightService.getCharacteristic(Characteristic.CurrentAmbientLightLevel)
       .onGet(() => Math.max(0.0001, this.lightLevel));
 
-    this.log.info('Services set up for: ' + n);
+    this.log.info('Services ready: ' + n);
   }
 
-  schedulePoll(delayMs) {
-    if (this.pollTimer) clearTimeout(this.pollTimer);
-    this.pollTimer = setTimeout(() => this.poll(), delayMs);
-  }
+  // ── BLE connection ──────────────────────────────────────────────────────────
+  async connect() {
+    this.log.info('Connecting to ' + this.mac + '...');
 
-  async poll() {
-    if (this.polling) { this.schedulePoll(POLL_MS); return; }
-    this.polling = true;
-    let peripheral = null;
     try {
-      peripheral = await this.findPeripheral();
-      await peripheral.connectAsync();
+      // Find the peripheral via scan
+      this.peripheral = await this.findPeripheral();
+      await this.peripheral.connectAsync();
+      this.log.info('Connected to ' + this.mac);
+
+      // Discover and cache ALL characteristics in one pass
+      this.charCache = {};
+      const services = await this.peripheral.discoverServicesAsync();
+      for (const svc of services) {
+        const chars = await svc.discoverCharacteristicsAsync();
+        for (const c of chars) {
+          this.charCache[c.uuid.replace(/-/g, '')] = c;
+        }
+      }
 
-      const authChar = await this.getCharacteristic(peripheral, UUID_AUTH);
+      // Authenticate once — stays valid for the life of this connection
+      const authChar = this.charCache[UUID_AUTH.replace(/-/g, '')];
+      if (!authChar) throw new Error('Auth characteristic not found');
       const pinBuf = Buffer.alloc(4);
       pinBuf.writeUInt32LE(parseInt(this.pin, 10), 0);
       await authChar.writeAsync(pinBuf, true);
+      this.log.info('Authenticated');
 
-      const statusChar = await this.getCharacteristic(peripheral, UUID_STATUS);
-      const statusData = await statusChar.readAsync();
-      this.currentRPM  = Math.max(0, statusData.readUInt16LE(6));
-      this.temperature = Math.round((statusData.readUInt16LE(2) / 6) * 10) / 10;
-
-      const sensorChar = await this.getCharacteristic(peripheral, UUID_SENSOR);
-      const sensorData = await sensorChar.readAsync();
-      this.humidity   = Math.max(0, Math.min(100, sensorData.readUInt8(0) * 2));
-      this.lightLevel = Math.max(0.0001, sensorData.readUInt16BE(2));
+      this.connected = true;
 
-      // Also log the raw control characteristic on each poll for diagnostics
-      try {
-        const ctrlChar = await this.getCharacteristic(peripheral, UUID_CONTROL);
-        const ctrlData = await ctrlChar.readAsync();
-        this.log.info('CTRL raw: ' + Array.from(ctrlData).join(',') +
-          ' | UInt16s: ' + ctrlData.readUInt16LE(0) + ',' +
-          ctrlData.readUInt16LE(2) + ',' + ctrlData.readUInt16LE(4));
-      } catch (_) {}
-
-      const speed = this.rpmToPercent(this.currentRPM);
-      this.fanService.getCharacteristic(Characteristic.RotationSpeed).updateValue(speed);
-      this.humidityService.getCharacteristic(Characteristic.CurrentRelativeHumidity).updateValue(this.humidity);
-      this.tempService.getCharacteristic(Characteristic.CurrentTemperature).updateValue(this.temperature);
-      this.lightService.getCharacteristic(Characteristic.CurrentAmbientLightLevel).updateValue(this.lightLevel);
+      // Handle unexpected disconnects — reconnect automatically
+      this.peripheral.once('disconnect', () => {
+        this.log.warn(this.mac + ' disconnected — reconnecting in ' + (RECONNECT_MS / 1000) + 's');
+        this.connected = false;
+        this.charCache = {};
+        if (this.pollTimer) { clearTimeout(this.pollTimer); this.pollTimer = null; }
+        setTimeout(() => this.connect(), RECONNECT_MS);
+      });
 
-      this.log.info('Status: RPM=' + this.currentRPM + ' Speed=' + speed +
-        '% Hum=' + this.humidity + '% Temp=' + this.temperature +
-        'C Light=' + this.lightLevel + 'lx');
+      // Start polling immediately
+      this.poll();
 
     } catch (err) {
-      this.log.warn('Poll error: ' + err.message);
-    } finally {
-      if (peripheral) { try { await peripheral.disconnectAsync(); } catch (_) {} }
-      this.polling = false;
-      this.schedulePoll(POLL_MS);
+      this.log.error('Connection failed: ' + err.message);
+      this.connected = false;
+      setTimeout(() => this.connect(), RECONNECT_MS);
     }
   }
 
+  // Targeted scan — resolves as soon as our specific MAC is seen, removes its own listener
   findPeripheral() {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
         noble.removeListener('discover', onDiscover);
         reject(new Error('Scan timeout for ' + this.mac));
-      }, SCAN_TIMEOUT_MS);
+      }, 20000);
+
       const onDiscover = (periph) => {
         if (periph.address.toLowerCase() === this.mac) {
           clearTimeout(timeout);
@@ -218,57 +235,79 @@ class PaxCalimaAccessory {
           resolve(periph);
         }
       };
+
       noble.on('discover', onDiscover);
       noble.startScanning([], false);
     });
   }
 
-  async getCharacteristic(peripheral, uuid) {
-    const stripped = uuid.replace(/-/g, '');
-    const services = await peripheral.discoverServicesAsync();
-    for (const service of services) {
-      const chars = await service.discoverCharacteristicsAsync();
-      for (const char of chars) {
-        if (char.uuid.replace(/-/g, '') === stripped) return char;
+  // ── Polling — uses cached characteristics, no reconnect overhead ────────────
+  async poll() {
+    if (!this.connected) return;
+
+    try {
+      const statusChar = this.charCache[UUID_STATUS.replace(/-/g, '')];
+      const sensorChar = this.charCache[UUID_SENSOR.replace(/-/g, '')];
+
+      if (!statusChar || !sensorChar) throw new Error('Characteristics not cached — reconnecting');
+
+      // Read both characteristics
+      const [statusData, sensorData] = await Promise.all([
+        statusChar.readAsync(),
+        sensorChar.readAsync(),
+      ]);
+
+      // Parse — confirmed mappings from live device
+      this.currentRPM  = Math.max(0, statusData.readUInt16LE(6));
+      this.temperature = Math.round((statusData.readUInt16LE(2) / 6) * 10) / 10;
+      this.humidity    = Math.max(0, Math.min(100, sensorData.readUInt8(0) * 2));
+      this.lightLevel  = Math.max(0.0001, sensorData.readUInt16BE(2));
+
+      const speed = this.rpmToPercent(this.currentRPM);
+
+      // Push to HomeKit
+      this.fanService.getCharacteristic(Characteristic.RotationSpeed).updateValue(speed);
+      this.humidityService.getCharacteristic(Characteristic.CurrentRelativeHumidity).updateValue(this.humidity);
+      this.tempService.getCharacteristic(Characteristic.CurrentTemperature).updateValue(this.temperature);
+      this.lightService.getCharacteristic(Characteristic.CurrentAmbientLightLevel).updateValue(this.lightLevel);
+
+      this.log.info('Poll: RPM=' + this.currentRPM + ' Speed=' + speed +
+        '% Hum=' + this.humidity + '% Temp=' + this.temperature +
+        'C Light=' + this.lightLevel + 'lx');
+
+    } catch (err) {
+      this.log.warn('Poll error: ' + err.message);
+      // If cache is stale, reconnect
+      if (!this.charCache[UUID_STATUS.replace(/-/g, '')]) {
+        this.connected = false;
+        setTimeout(() => this.connect(), RECONNECT_MS);
+        return;
       }
     }
-    throw new Error('Characteristic ' + uuid + ' not found');
+
+    // Schedule next poll
+    this.pollTimer = setTimeout(() => this.poll(), POLL_MS);
   }
 
+  // ── Fan speed write ─────────────────────────────────────────────────────────
   async writeSpeed(percent) {
-    // Pause the poll cycle to avoid BLE conflicts during a write
-    if (this.pollTimer) { clearTimeout(this.pollTimer); this.pollTimer = null; }
-
-    let peripheral = null;
+    if (!this.connected) {
+      this.log.warn('Cannot set speed — not connected');
+      return;
+    }
     try {
-      peripheral = await this.findPeripheral();
-      await peripheral.connectAsync();
+      const ctrlChar = this.charCache[UUID_CONTROL.replace(/-/g, '')];
+      if (!ctrlChar) throw new Error('Control characteristic not cached');
 
-      const authChar = await this.getCharacteristic(peripheral, UUID_AUTH);
-      const pinBuf = Buffer.alloc(4);
-      pinBuf.writeUInt32LE(parseInt(this.pin, 10), 0);
-      await authChar.writeAsync(pinBuf, true);
-
-      // Read current control config to preserve trickle/boost values
-      const ctrlChar = await this.getCharacteristic(peripheral, UUID_CONTROL);
-      const current  = await ctrlChar.readAsync();
-      this.log.info('CTRL before write: ' + Array.from(current).join(','));
-
-      // Control characteristic layout (6 bytes, all UInt16LE):
-      // [0-1] trickle RPM, [2-3] normal RPM, [4-5] boost RPM
-      // We write the target RPM into the normal speed slot [2-3]
+      // Read current config to preserve trickle + boost values
+      const current = await ctrlChar.readAsync();
       const targetRPM = Math.round((percent / 100) * 2400);
-      const buf = Buffer.from(current); // preserve existing trickle + boost values
-      buf.writeUInt16LE(targetRPM, 2);  // set normal speed
+      const buf = Buffer.from(current);
+      buf.writeUInt16LE(targetRPM, 2); // bytes 2-3 = normal speed slot
       await ctrlChar.writeAsync(buf, true);
-
-      this.log.info('Speed set to ' + percent + '% (' + targetRPM + ' RPM) — CTRL written: ' + Array.from(buf).join(','));
-    } catch (e) {
-      this.log.error('writeSpeed failed: ' + e.message);
-    } finally {
-      if (peripheral) { try { await peripheral.disconnectAsync(); } catch (_) {} }
-      // Resume polling after write
-      this.schedulePoll(2000);
+      this.log.info('Speed set to ' + percent + '% (' + targetRPM + ' RPM)');
+    } catch (err) {
+      this.log.error('writeSpeed failed: ' + err.message);
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-pax-calima",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Homebridge platform plugin for Pax Calima and Vent-Axia Svara Bluetooth LE bathroom extractor fans",
   "main": "index.js",
   "keywords": [