homebridge-shelly-blu-trv 1.0.7 → 1.0.8

package/README.md

@@ -97,6 +97,41 @@ To ensure coverage is sufficient:
 - Check coverage threshold (lines): `npm run check-coverage` (configured to require at least 80% lines by default, set `COVERAGE_THRESHOLD` env to override)
 
 
+## Publishing
+
+### Manual device configuration (fallback when discovery unavailable) ✅
+
+If your Shelly BLU Gateway Gen3 does not expose the `/status` discovery endpoint (returns 404) or discovery is otherwise unavailable, you can manually configure TRV devices in the gateway entry of your Homebridge config. The plugin will use this list when discovery fails or returns no devices.
+
+Example gateway configuration with manual devices:
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "ShellyBluTRV",
+      "gateways": [
+        {
+          "host": "10.0.0.171",
+          "token": "<optional-auth-token>",
+          "pollInterval": 60,
+          "devices": [
+            { "id": 100, "name": "Living TRV" },
+            { "id": 101, "name": "Kitchen TRV" }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+Notes:
+
+- `id` is the TRV numeric id assigned by the gateway; the plugin uses this id for polling and state updates.
+- If `name` is omitted, a default name `BLU TRV <id>` will be used.
+- When both discovery and manual `devices` are available, discovery takes precedence.
+
 ## Publishing
 
 - The repository contains two publishing workflows:

package/config.schema.json

@@ -24,6 +24,17 @@
               "title": "Polling interval (seconds)",
               "default": 60,
               "minimum": 15
+            },
+            "devices": {
+              "type": "array",
+              "title": "Manual TRV devices (optional)",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": { "type": "number", "title": "TRV ID", "required": true },
+                  "name": { "type": "string", "title": "Display name" }
+                }
+              }
             }
           }
         }

package/dist/platform.js

@@ -40,10 +40,21 @@ class ShellyBluPlatform {
             try {
                 trvs = await api.discoverTrvs();
                 this.log.info(`[ShellyBluPlatform] Discovered ${trvs.length} TRV(s) on gateway ${gw.host}`);
+                // If discovery returned nothing but user provided manual devices, use them
+                if ((!trvs || trvs.length === 0) && gw.devices && gw.devices.length > 0) {
+                    this.log.warn(`[ShellyBluPlatform] Discovery returned no devices; using manual device list for gateway ${gw.host}`);
+                    trvs = gw.devices.map((d) => ({ id: d.id, name: d.name || `BLU TRV ${d.id}` }));
+                }
             }
             catch (error) {
-                this.log.error(`[ShellyBluPlatform] Failed to discover devices on gateway ${gw.host}: ${error instanceof Error ? error.message : String(error)}`);
-                continue;
+                if (gw.devices && gw.devices.length > 0) {
+                    this.log.warn(`[ShellyBluPlatform] Discovery failed for gateway ${gw.host}, using manual device list: ${error instanceof Error ? error.message : String(error)}`);
+                    trvs = gw.devices.map((d) => ({ id: d.id, name: d.name || `BLU TRV ${d.id}` }));
+                }
+                else {
+                    this.log.error(`[ShellyBluPlatform] Failed to discover devices on gateway ${gw.host}: ${error instanceof Error ? error.message : String(error)}`);
+                    continue;
+                }
             }
             for (const trv of trvs) {
                 const uuid = this.api.hap.uuid.generate(`${gw.host}-${trv.id}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-shelly-blu-trv",
   "displayName": "Shelly BLU TRV",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Homebridge plugin for Shelly BLU TRV thermostats via Shelly BLU Gateway Gen3",
   "license": "MIT",
   "author": "agiplv",