homebridge-pax-calima 2.4.3 → 2.4.5

package/README.md

@@ -4,7 +4,7 @@
 
 If you have a **Pax Calima** or **Vent-Axia Lo-Carbon Svara** extractor fan, this plugin connects it directly to HomeKit via Bluetooth. Once set up, your fan appears in the Home app with live temperature and fan speed — and you can build automations around all of them.
 
-[![Homebridge 2.0 Ready](https://img.shields.io/badge/Homebridge-2.0%20Ready-brightgreen)](https://github.com/homebridge/homebridge/wiki/Updating-To-Homebridge-v2.0)
+[![Homebridge 2 Ready](https://img.shields.io/badge/Homebridge-2%20Ready-brightgreen)](https://github.com/homebridge/homebridge/wiki/Updating-To-Homebridge-v2.0)
 [![npm](https://img.shields.io/npm/v/homebridge-pax-calima)](https://www.npmjs.com/package/homebridge-pax-calima)
 
 ---
@@ -178,20 +178,30 @@ Go to Homebridge UI → plugin settings → Remove Accessory Cache, then restart
 
 ---
 
-## Homebridge 2.0 compliance
+## Homebridge 2 compatibility
 
-This plugin meets all Homebridge 2.0 requirements:
+This plugin is compatible with Homebridge 2:
 - Registered as a dynamic platform
-- Waits for `didFinishLaunching` before any BLE or accessory work
-- All errors caught and logged — no unhandled exceptions
+- Waits for `didFinishLaunching` before starting BLE or accessory work
+- Uses the Homebridge 2-compatible `Accessory.getServiceById()` API for the optional Silent Hours service
 - No analytics, tracking or post-install scripts
-- Accessories restored from cache cleanly without re-registration
-- Compatible with Node.js 18, 20 and 22
+- Accessories restore cleanly from cache without re-registration
+- Requires Node.js 18.20.4 or later
+- Live-tested on Homebridge 2.4.0 (HAP 2.2.2) with Node.js 24.19.0
 
 ---
 
 ## Release notes
 
+### 2.4.5
+- **Fixed:** Homebridge 2 compatibility for the optional Silent Hours switch. Homebridge 2 removed `Accessory.getServiceByUUIDAndSubType()`; both lookups now use the supported `Accessory.getServiceById()` API.
+- **Verified:** Live-tested successfully on Homebridge 2.4.0 (HAP 2.2.2) with Node.js 24.19.0 on Homebridge OS.
+- No BLE protocol, fan control, sensor mapping, configuration, or accessory behaviour changes.
+
+### 2.4.4
+- **Fixed:** Silent Hours time fields no longer show a raw regex pattern as validation hint in the Homebridge UI — replaced with plain human-readable placeholder text (e.g. `23:00`) and a description
+- **Improved:** Invalid time format now logs a clear warning message rather than silently disabling the schedule
+
 ### 2.4.3
 - **Silent Hours** reworked — now supports a config schedule (`silentHoursStart` / `silentHoursEnd`) that runs automatically, an optional HomeKit switch (`showSilentSwitch: true`) for Goodnight scenes and irregular schedules, or both together. The switch takes priority when toggled manually; the schedule runs as a background default. Any existing Silent Hours switch from earlier versions is automatically removed unless `showSilentSwitch` is enabled.
 - **Light sensor** (`showLight`) added as opt-in — confirmed via live testing that the characteristic returns a static value regardless of lighting conditions.

package/config.schema.json

@@ -13,22 +13,20 @@
       "silentHoursStart": {
         "title": "Silent Hours — Start Time",
         "type": "string",
-        "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$",
-        "placeholder": "e.g. 23:00",
-        "description": "When the fan stops boosting at night. 24-hour format. Leave blank to disable the schedule."
+        "placeholder": "23:00",
+        "description": "When the fan stops boosting at night. Enter in 24-hour format, e.g. 23:00. Leave blank to disable the schedule."
       },
       "silentHoursEnd": {
         "title": "Silent Hours — End Time",
         "type": "string",
-        "pattern": "^([01]?[0-9]|2[0-3]):[0-5][0-9]$",
-        "placeholder": "e.g. 07:00",
-        "description": "When the fan resumes boosting in the morning. Both start and end must be set for the schedule to activate."
+        "placeholder": "07:00",
+        "description": "When the fan resumes boosting in the morning. Enter in 24-hour format, e.g. 07:00. Both start and end must be set for the schedule to activate."
       },
       "showSilentSwitch": {
         "title": "Show Silent Hours Switch in Home",
         "type": "boolean",
         "default": false,
-        "description": "Adds a Silent Hours on/off switch to your accessory in the Home app. Useful for including in a Goodnight scene or automation. If a schedule is also set, the switch takes priority when toggled manually. Good for shift workers or irregular schedules."
+        "description": "Adds a Silent Hours on/off switch to your accessory in the Home app. Useful for including in a Goodnight scene or automation. Good for shift workers or irregular schedules."
       },
       "showHumidity": {
         "title": "Show Humidity Sensor",
@@ -57,8 +55,8 @@
             "mac": {
               "title": "MAC Address",
               "type": "string",
-              "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)"
+              "placeholder": "58:2b:db:xx:xx:xx",
+              "description": "MAC address of the fan — found in the official Pax or Vent-Axia app under About Device."
             },
             "pin": {
               "title": "PIN Code",

package/index.js

@@ -15,13 +15,19 @@ const MAC_PREFIX   = '58:2b:db';
 const POLL_MS      = 10000;
 const RECONNECT_MS = 15000;
 
-function parseTime(str) {
+function parseTime(str, label) {
   if (!str || typeof str !== 'string') return null;
   const parts = str.split(':');
-  if (parts.length !== 2) return null;
+  if (parts.length !== 2 || parts[0] === '' || parts[1] === '') {
+    console.warn('[PaxCalima] ' + (label || 'Silent Hours') + ' time "' + str + '" is not valid — use 24-hour format e.g. 23:00. Silent Hours schedule disabled.');
+    return null;
+  }
   const hour   = parseInt(parts[0], 10);
   const minute = parseInt(parts[1], 10);
-  if (isNaN(hour) || isNaN(minute) || hour < 0 || hour > 23 || minute < 0 || minute > 59) return null;
+  if (isNaN(hour) || isNaN(minute) || hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+    console.warn('[PaxCalima] ' + (label || 'Silent Hours') + ' time "' + str + '" is out of range — use 24-hour format e.g. 23:00. Silent Hours schedule disabled.');
+    return null;
+  }
   return { hour, minute };
 }
 
@@ -124,8 +130,8 @@ class PaxCalimaAccessory {
     this.showHumidity     = options.showHumidity     || false;
     this.showLight        = options.showLight        || false;
     this.showSilentSwitch = options.showSilentSwitch || false;
-    this.silentStart      = parseTime(options.silentHoursStart);
-    this.silentEnd        = parseTime(options.silentHoursEnd);
+    this.silentStart      = parseTime(options.silentHoursStart, 'silentHoursStart');
+    this.silentEnd        = parseTime(options.silentHoursEnd, 'silentHoursEnd');
 
     this.currentRPM  = 0;
     this.humidity    = 0;
@@ -169,7 +175,7 @@ class PaxCalimaAccessory {
     // Silent Hours switch — opt-in via showSilentSwitch: true
     // Coexists with config schedule — switch state takes priority on next poll
     if (this.showSilentSwitch) {
-      this.silentService = this.accessory.getServiceByUUIDAndSubType(Service.Switch, 'silent-hours')
+      this.silentService = this.accessory.getServiceById(Service.Switch, 'silent-hours')
         || this.accessory.addService(new Service.Switch(n + ' Silent Hours', 'silent-hours'));
       this.silentService.getCharacteristic(Characteristic.On)
         .onGet(() => this.silentHours)
@@ -180,7 +186,7 @@ class PaxCalimaAccessory {
       this.log.info('Silent Hours switch enabled');
     } else {
       // Remove switch if it was registered in a previous version
-      const existing = this.accessory.getServiceByUUIDAndSubType(Service.Switch, 'silent-hours');
+      const existing = this.accessory.getServiceById(Service.Switch, 'silent-hours');
       if (existing) {
         this.accessory.removeService(existing);
         this.log.info('Silent Hours switch removed — use config schedule or enable showSilentSwitch');

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "homebridge-pax-calima",
   "displayName": "Vent-Axia Svara / Pax Calima",
-  "version": "2.4.3",
-  "description": "Bring your Pax Calima or Vent-Axia Svara bathroom fan into Apple Home via Bluetooth — live temperature and fan speed with Silent Hours scheduling and full automation support.",
+  "version": "2.4.5",
+  "description": "Bring your Pax Calima or Vent-Axia Svara bathroom fan into Apple Home via Bluetooth \u2014 live temperature and fan speed with Silent Hours scheduling and full automation support.",
   "main": "index.js",
   "keywords": [
     "homebridge-plugin",