homebridge-pax-calima 2.4.0 → 2.4.1

package/README.md

@@ -4,11 +4,11 @@
 
 Full HomeKit integration for **Pax Calima** and **Vent-Axia Lo-Carbon Svara** Bluetooth LE bathroom extractor fans.
 
-Compatible devices:
+**Compatible devices:**
 - **Pax Calima** — Sweden, Norway, Denmark, Finland, Spain, Portugal
-- **Vent-Axia Lo-Carbon Svara** (White & Black) — UK
+- **Vent-Axia Lo-Carbon Svara** White & Black — UK
 
-All are hardware-identical and share the same BLE protocol and MAC prefix (`58:2b:db`).
+All are hardware-identical, sharing the same BLE protocol and MAC prefix (`58:2b:db`).
 
 ---
 
@@ -22,7 +22,7 @@ All are hardware-identical and share the same BLE protocol and MAC prefix (`58:2
 | **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 |
+| **Silent Hours** | Toggle — suppresses automatic boosting during quiet periods |
 | **Automations** | Full HomeKit automation support on all sensors |
 
 ---
@@ -30,11 +30,23 @@ All are hardware-identical and share the same BLE protocol and MAC prefix (`58:2
 ## Requirements
 
 - Homebridge `^1.6.0` or `^2.0.0`
-- Node.js `>= 18`
+- Node.js `>= 18.20.4`
 - A Bluetooth LE adapter on the Homebridge host
 
+### Homebridge 2.0 Compliance
+
+This plugin is fully compliant with Homebridge 2.0:
+- Implemented as a **dynamic platform** (`registerPlatform` with `true` flag)
+- Waits for `didFinishLaunching` before any BLE or accessory operations
+- All errors caught and logged — no unhandled exceptions
+- No analytics, no tracking, no post-install scripts
+- Accessories restored from cache without re-registration
+- Compatible with Node.js 18, 20 and 22
+
 ### Raspberry Pi / Homebridge OS — one-time setup
 
+The `noble` BLE library requires elevated network capabilities. Run **once** after installation on the **Homebridge terminal**:
+
 ```bash
 sudo setcap cap_net_raw+eip /opt/homebridge/bin/node
 ```
@@ -45,6 +57,8 @@ If Bluetooth shows as `poweredOff`:
 sudo rfkill unblock bluetooth
 ```
 
+If the above does not resolve the issue, a full Pi power cycle may be required to reinitialise the BLE stack cleanly.
+
 ---
 
 ## Installation
@@ -61,7 +75,7 @@ npm install -g homebridge-pax-calima
 
 ## Configuration
 
-No configuration needed for auto-discovery. To set a custom name or PIN per fan:
+Auto-discovery requires **no configuration**. To set a custom name or PIN per fan:
 
 ```json
 {
@@ -92,35 +106,39 @@ Each fan appears as a single accessory with:
 - **Temperature** — °C
 - **Light** — lux
 
-> Accessories appear in the **Home app**, not the Homebridge UI accessories tab. This is correct for child bridge plugins.
+> Accessories appear in the **Home app**, not the Homebridge UI accessories tab. This is correct behaviour for child bridge plugins.
 
 ---
 
 ## Fan Speed Control — Wiring Mode
 
-The fan supports two installation wiring modes:
+The fan supports two installation wiring modes selected at installation time:
 
-**Intermittent mode** — fan is off by default, triggered by sensors or timer. BLE speed commands work fully; the slider controls the fan directly.
+**Intermittent mode** — fan is off by default, triggered by sensors or timer. BLE speed commands are fully respected and 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.
+**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 speed 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.
+In always-on mode, the sensors and automations remain fully functional and represent the primary value of the integration — particularly for bathroom and wetroom use where humidity, temperature and light thresholds enable powerful Apple Home automations.
+
+To enable full speed control, switch to intermittent wiring mode per the fan's 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.
+Humidity and light values are guaranteed fresh on every poll — the plugin uses a connect→read→disconnect cycle which forces the device's GATT server to return live readings rather than cached values.
+
+The light sensor detects occupancy via movement and shadow rather than acting as a precision lux meter. Small variances from a handheld reference device are normal and expected, particularly with ceiling or wall mounting angles.
 
-For lux-based automations, use **Eve** or **Hesperus** which support lux thresholds synced to HomeKit.
+For lux-based automations use **Eve** or **Hesperus**, which support lux thresholds synced back 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`.
+**Fan not discovered** — run `hciconfig` on the Pi; confirm `UP RUNNING`. If showing `RF-KILL` run `sudo rfkill unblock bluetooth`. If still not found, perform a full Pi power cycle to reinitialise the BLE stack.
 
-**Authentication failed** — default PIN is `012345`. If changed in the official app, add the fan to the `fans` config with the correct PIN.
+**Authentication failed** — default PIN is `012345`. If changed in the official app, add the fan to the `fans` config array with the correct PIN.
 
 **Speed slider has no effect** — fan is wired in always-on mode. See wiring note above. All sensors work normally.
 
@@ -130,24 +148,25 @@ For lux-based automations, use **Eve** or **Hesperus** which support lux thresho
 
 ## Release Notes
 
+### 2.4.1
+- **Fixed:** Humidity and light sensors returning stale values — root cause identified as the device's GATT server only refreshing sensor values on a new connection. Poll cycle reverted to proven connect→auth→read→disconnect pattern which guarantees live readings on every poll
+- **Fixed:** Characteristics discovered and cached once per poll cycle — eliminates the intermittent `Characteristic not found` errors seen in 2.4.0
+- **Fixed:** Overlapping poll guard prevents concurrent BLE connections
+- **Improved:** `writeSpeed` correctly skips if a poll is in progress to avoid BLE conflicts
+- **Improved:** Node.js minimum version updated to `18.20.4` per Homebridge 2.0 specification
+- **Documented:** Homebridge 2.0 compliance details added to README
+
 ### 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
+- **Rebuilt:** Persistent connection architecture — connect once, cache characteristics, poll with direct reads. Fast RPM and temperature updates confirmed. Humidity and light subsequently found to return stale GATT cached values on persistent connections — resolved in 2.4.1
 
 ### 2.3.2
-- Documented always-on vs intermittent wiring mode behaviour for speed control
+- Documented always-on vs intermittent wiring mode behaviour
 
 ### 2.3.1
-- Identified correct control characteristic; added write diagnostics
+- Identified correct control characteristic; write diagnostics added
 
 ### 2.3.0 / 2.2.1 / 2.1.0
-- Sensor characteristic UUIDs and byte mappings confirmed via live device
+- Sensor UUIDs and byte mappings confirmed via live device dump
 - BLE initialisation fixes for Homebridge 2.0
 - Duplicate accessory registration resolved
 

package/index.js

@@ -4,14 +4,14 @@ const noble = require('@abandonware/noble');
 
 let Service, Characteristic, Categories, API, PlatformAccessory;
 
-// ── 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
+// ── Verified BLE UUIDs (confirmed via live device dump April 2026) ────────────
+const UUID_AUTH    = '4cad343a-209a-40b7-b911-4d9b3df569b2'; // PIN auth — write once per connection
+const UUID_STATUS  = '528b80e8-c47a-4c0a-bdf1-916a7748f412'; // RPM (offset 6 UInt16LE) + temp (offset 2 UInt16LE / 6)
+const UUID_SENSOR  = 'a22eae12-dba8-49f3-9c69-1721dcff1d96'; // humidity (offset 0 UInt8 × 2) + lux (offset 2 UInt16BE)
+const UUID_CONTROL = '1488a757-35bc-4ec8-9a6b-9ecf1502778e'; // speed config: [trickle|normal|boost] as UInt16LE pairs
 
 const MAC_PREFIX   = '58:2b:db';
-const POLL_MS      = 10000; // 10s — responsive for shower humidity spikes
+const POLL_MS      = 10000;  // 10s — responsive for shower humidity spikes
 const RECONNECT_MS = 15000;
 
 module.exports = (homebridge) => {
@@ -21,30 +21,28 @@ module.exports = (homebridge) => {
   API               = homebridge;
   PlatformAccessory = homebridge.platformAccessory;
 
-  // true = dynamic platform, required for Homebridge 2.0
+  // 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.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');
-
       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(() => {
         if (noble.state === 'poweredOn') this.startDiscovery();
@@ -53,7 +51,8 @@ class PaxCalimaPlatform {
   }
 
   // Called by Homebridge for each cached accessory on startup.
-  // We hold them until startDiscovery() confirms BLE is ready.
+  // Held until startDiscovery() confirms BLE is ready — prevents polling
+  // before the BLE stack is initialised.
   configureAccessory(accessory) {
     const mac = accessory.context && accessory.context.mac;
     this.log.info('Restoring cached accessory: ' + accessory.displayName);
@@ -67,9 +66,9 @@ class PaxCalimaPlatform {
     if (this.discoveryStarted) return;
     this.discoveryStarted = true;
 
-    // Spin up handlers for all cached (previously registered) accessories
+    // Spin up BLE handlers for all previously registered accessories
     for (const { accessory, mac } of this.cachedAccessories) {
-      this.log.info('Connecting to cached fan: ' + mac);
+      this.log.info('Starting handler for cached fan: ' + mac);
       new PaxCalimaAccessory(this.log, accessory, mac, this.pinForMac(mac));
     }
     this.cachedAccessories = [];
@@ -115,21 +114,18 @@ class PaxCalimaAccessory {
     this.lightLevel  = 0.0001;
     this.silentHours = false;
 
-    // BLE connection state
-    this.peripheral  = null;
-    this.charCache   = {};   // uuid (stripped) → characteristic — populated once per connection
-    this.connected   = false;
-    this.pollTimer   = null;
+    this.pollTimer = null;
+    this.polling   = false; // guard against overlapping cycles
 
     this.setupServices();
-    this.connect();          // connect immediately — BLE is ready by the time we're constructed
+    this.schedulePoll(0); // BLE is ready by the time constructor is called
   }
 
   // ── HomeKit services ────────────────────────────────────────────────────────
   setupServices() {
     const n = this.accessory.displayName;
 
-    // Fan — always reports as active; speed reflects live RPM
+    // Fan — always 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)
@@ -145,7 +141,7 @@ class PaxCalimaAccessory {
     this.boostButton.getCharacteristic(Characteristic.ProgrammableSwitchEvent)
       .setProps({ validValues: [0] });
 
-    // Silent Hours — suppresses automatic boosting overnight
+    // Silent Hours — suppresses automatic boosting during quiet periods
     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)
@@ -171,56 +167,75 @@ class PaxCalimaAccessory {
     this.log.info('Services ready: ' + n);
   }
 
-  // ── BLE connection ──────────────────────────────────────────────────────────
-  async connect() {
-    this.log.info('Connecting to ' + this.mac + '...');
+  // ── Poll cycle: connect → auth → read → disconnect → wait → repeat ──────────
+  // The device's GATT server only returns fresh sensor values on a new connection.
+  // A persistent connection returns cached values for humidity and light.
+  // We therefore use short-lived connections — proven reliable in testing.
+  schedulePoll(delayMs) {
+    if (this.pollTimer) clearTimeout(this.pollTimer);
+    this.pollTimer = setTimeout(() => this.poll(), delayMs);
+  }
+
+  async poll() {
+    if (this.polling) { this.schedulePoll(POLL_MS); return; }
+    this.polling = true;
+    let peripheral = null;
 
     try {
-      // 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();
+      peripheral = await this.findPeripheral();
+      await peripheral.connectAsync();
+
+      // Discover and cache all characteristics for this connection
+      const charCache = {};
+      const services = await peripheral.discoverServicesAsync();
       for (const svc of services) {
         const chars = await svc.discoverCharacteristicsAsync();
-        for (const c of chars) {
-          this.charCache[c.uuid.replace(/-/g, '')] = c;
-        }
+        for (const c of chars) charCache[c.uuid.replace(/-/g, '')] = c;
       }
 
-      // Authenticate once — stays valid for the life of this connection
-      const authChar = this.charCache[UUID_AUTH.replace(/-/g, '')];
+      // Authenticate
+      const authChar = 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');
 
-      this.connected = true;
+      // Read status: RPM + temperature
+      const statusChar = charCache[UUID_STATUS.replace(/-/g, '')];
+      if (!statusChar) throw new Error('Status characteristic not found');
+      const statusData = await statusChar.readAsync();
+      this.currentRPM  = Math.max(0, statusData.readUInt16LE(6));
+      this.temperature = Math.round((statusData.readUInt16LE(2) / 6) * 10) / 10;
 
-      // 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);
-      });
+      // Read sensors: humidity + lux — fresh values guaranteed on each new connection
+      const sensorChar = charCache[UUID_SENSOR.replace(/-/g, '')];
+      if (!sensorChar) throw new Error('Sensor characteristic not found');
+      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));
 
-      // Start polling immediately
-      this.poll();
+      // Push all values to HomeKit
+      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);
+
+      this.log.info('Poll: RPM=' + this.currentRPM + ' Speed=' + speed +
+        '% Hum=' + this.humidity + '% Temp=' + this.temperature +
+        'C Light=' + this.lightLevel + 'lx');
 
     } catch (err) {
-      this.log.error('Connection failed: ' + err.message);
-      this.connected = false;
-      setTimeout(() => this.connect(), RECONNECT_MS);
+      this.log.warn('Poll error: ' + err.message);
+    } finally {
+      // Always disconnect cleanly — required for fresh sensor reads next cycle
+      if (peripheral) { try { await peripheral.disconnectAsync(); } catch (_) {} }
+      this.polling = false;
+      this.schedulePoll(POLL_MS);
     }
   }
 
-  // Targeted scan — resolves as soon as our specific MAC is seen, removes its own listener
+  // Targeted scan — resolves as soon as our MAC is seen, removes its own listener
   findPeripheral() {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
@@ -241,73 +256,47 @@ class PaxCalimaAccessory {
     });
   }
 
-  // ── 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;
-      }
-    }
-
-    // Schedule next poll
-    this.pollTimer = setTimeout(() => this.poll(), POLL_MS);
-  }
-
   // ── Fan speed write ─────────────────────────────────────────────────────────
+  // Note: in always-on wiring mode the fan's onboard controller will reassert
+  // its own speed setpoint after each write. See README for details.
   async writeSpeed(percent) {
-    if (!this.connected) {
-      this.log.warn('Cannot set speed — not connected');
+    if (this.polling) {
+      this.log.warn('Speed write skipped — poll in progress');
       return;
     }
+    let peripheral = null;
     try {
-      const ctrlChar = this.charCache[UUID_CONTROL.replace(/-/g, '')];
-      if (!ctrlChar) throw new Error('Control characteristic not cached');
+      peripheral = await this.findPeripheral();
+      await peripheral.connectAsync();
+
+      const charCache = {};
+      const services = await peripheral.discoverServicesAsync();
+      for (const svc of services) {
+        const chars = await svc.discoverCharacteristicsAsync();
+        for (const c of chars) charCache[c.uuid.replace(/-/g, '')] = c;
+      }
 
-      // Read current config to preserve trickle + boost values
-      const current = await ctrlChar.readAsync();
+      const authChar = 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);
+
+      const ctrlChar = charCache[UUID_CONTROL.replace(/-/g, '')];
+      if (!ctrlChar) throw new Error('Control characteristic not found');
+
+      // Preserve existing trickle + boost values, update normal speed slot only
+      const current   = await ctrlChar.readAsync();
       const targetRPM = Math.round((percent / 100) * 2400);
-      const buf = Buffer.from(current);
-      buf.writeUInt16LE(targetRPM, 2); // bytes 2-3 = normal speed slot
+      const buf       = Buffer.from(current);
+      buf.writeUInt16LE(targetRPM, 2);
       await ctrlChar.writeAsync(buf, true);
       this.log.info('Speed set to ' + percent + '% (' + targetRPM + ' RPM)');
+
     } catch (err) {
       this.log.error('writeSpeed failed: ' + err.message);
+    } finally {
+      if (peripheral) { try { await peripheral.disconnectAsync(); } catch (_) {} }
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-pax-calima",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Homebridge platform plugin for Pax Calima and Vent-Axia Svara Bluetooth LE bathroom extractor fans",
   "main": "index.js",
   "keywords": [
@@ -17,7 +17,7 @@
   ],
   "engines": {
     "homebridge": "^1.6.0 || ^2.0.0",
-    "node": ">=18.0.0"
+    "node": ">=18.20.4"
   },
   "dependencies": {
     "@abandonware/noble": "1.9.2-26"