homebridge-zwave-usb 2.1.0 → 2.2.0

package/README.md

@@ -15,6 +15,7 @@ A high-performance, production-grade [Homebridge](https://homebridge.io) integra
 - **Reactive Architecture**: Real-time status updates and automatic hardware recovery (hot-plugging support).
 - **Advanced Metadata Repair**: Automatically cleans up obsolete HomeKit services/characteristics during network updates.
 - **Log Piping**: Internal Z-Wave JS driver logs are piped directly into the Homebridge terminal for seamless debugging.
+- **OTA Firmware Updates**: Check for and install official manufacturer firmware updates directly from the Homebridge UI.
 
 ---
 
@@ -136,6 +137,15 @@ The plugin provides additional tools for network maintenance:
 - **Dual S2 PIN Entry**: When a device requires a PIN, you can enter it via the Homebridge terminal (`echo "12345" > s2_pin.txt`) or via the `S2 PIN Entry` characteristic in third-party HomeKit apps.
 - **Automated Reconciliation**: Orphaned accessories are automatically removed from HomeKit 60 seconds after startup if the node is no longer present in the Z-Wave network.
 
+## 🛠️ Maintenance & Firmware Updates
+
+The plugin includes a dedicated **Maintenance** tab within the Homebridge custom UI (accessible via the plugin settings).
+
+- **Node Overview**: View a complete list of all Z-Wave nodes in your network, including their status and current firmware versions.
+- **Official Updates**: Click "Check Update" to query the official Z-Wave JS Firmware Update Service. If a manufacturer-approved update is available, you can start the OTA transfer with a single click.
+- **Battery Device Support**: Firmware updates are supported for battery-powered devices. You will be prompted to manually wake the device after starting the process to initiate the transfer.
+- **Real-time Progress**: Monitor the progress of the firmware transfer via a live progress bar.
+
 ## ❓ Troubleshooting
 
 - **Device showing "No Response"?** Check the Homebridge logs. If the device is battery-powered, it may need to be "woken up" (usually by pressing a physical button on the device) to complete the interview.

package/dist/platform/ZWaveUsbPlatform.js

@@ -125,6 +125,34 @@ class ZWaveUsbPlatform {
                     }));
                     return sendJson(nodes);
                 }
+                if (normalizedUrl.startsWith('/nodes/') && normalizedUrl.endsWith('/name') && method === 'POST') {
+                    let body = '';
+                    req.on('data', (chunk) => (body += chunk));
+                    req.on('end', () => {
+                        try {
+                            const parts = normalizedUrl.split('/');
+                            const nodeId = parseInt(parts[2], 10);
+                            const { name } = JSON.parse(body);
+                            if (!this.zwaveController) {
+                                throw new Error('Controller not initialized');
+                            }
+                            this.zwaveController.setNodeName(nodeId, name);
+                            // Update Homebridge Accessory Name
+                            const accessory = this.zwaveAccessories.get(nodeId);
+                            if (accessory) {
+                                this.log.info(`Renaming HomeKit accessory for Node ${nodeId} to: ${name}`);
+                                accessory.platformAccessory.displayName = name;
+                                this.api.updatePlatformAccessories([accessory.platformAccessory]);
+                            }
+                            return sendJson({ success: true });
+                        }
+                        catch (err) {
+                            this.log.error(`Failed to rename node: ${err}`);
+                            return sendJson({ error: err instanceof Error ? err.message : String(err) }, 500);
+                        }
+                    });
+                    return;
+                }
                 if (normalizedUrl.startsWith('/firmware/updates/') && method === 'GET') {
                     const nodeId = parseInt(normalizedUrl.split('/').pop() || '0', 10);
                     this.zwaveController?.getAvailableFirmwareUpdates(nodeId)

package/dist/zwave/ZWaveController.d.ts

@@ -54,6 +54,11 @@ export declare class ZWaveController extends EventEmitter implements IZWaveContr
      * that can no longer be physically excluded.
      */
     removeFailedNode(nodeId: number): Promise<void>;
+    /**
+     * Updates the user-defined name for a node in the Z-Wave network.
+     * This name is persisted by Z-Wave JS in its cache files.
+     */
+    setNodeName(nodeId: number, name: string): void;
     getAvailableFirmwareUpdates(nodeId: number): Promise<unknown[]>;
     beginFirmwareUpdate(nodeId: number, update: unknown): Promise<void>;
     abortFirmwareUpdate(nodeId: number): Promise<void>;

package/dist/zwave/ZWaveController.js

@@ -670,6 +670,18 @@ class ZWaveController extends events_1.EventEmitter {
             throw err;
         }
     }
+    /**
+     * Updates the user-defined name for a node in the Z-Wave network.
+     * This name is persisted by Z-Wave JS in its cache files.
+     */
+    setNodeName(nodeId, name) {
+        const node = this.nodes.get(nodeId);
+        if (!node) {
+            throw new Error(`Node ${nodeId} not found`);
+        }
+        this.log.info(`Updating name for Node ${nodeId} to: "${name}"`);
+        node.name = name;
+    }
     async getAvailableFirmwareUpdates(nodeId) {
         if (nodeId === 1) {
             this.log.debug('Node 1 is the controller; skipping firmware update check.');

package/dist/zwave/interfaces.d.ts

@@ -20,6 +20,7 @@ export interface IZWaveController extends EventEmitter {
     startHealing(): Promise<boolean>;
     stopHealing(): Promise<boolean>;
     removeFailedNode(nodeId: number): Promise<void>;
+    setNodeName(nodeId: number, name: string): void;
     setS2Pin(pin: string): void;
     getAvailableFirmwareUpdates(nodeId: number): Promise<unknown[]>;
     beginFirmwareUpdate(nodeId: number, update: unknown): Promise<void>;

package/homebridge-ui/public/index.html

@@ -172,6 +172,7 @@
           const tr = document.createElement('tr');
           const status = statusMap[node.status] || 'Unknown';
           const progress = node.firmwareProgress;
+          const nodeName = node.name || node.label || 'Node ' + node.nodeId;
 
           let actionHtml = '';
           if (progress) {
@@ -184,12 +185,17 @@
           } else if (node.nodeId === 1) {
             actionHtml = `<span class="badge badge-light">Controller</span>`;
           } else {
-            actionHtml = `<button class="btn btn-sm btn-outline-primary check-update" data-nodeid="${node.nodeId}">Check Update</button>`;
+            actionHtml = `
+              <div class="btn-group">
+                <button class="btn btn-sm btn-outline-secondary rename-node" data-nodeid="${node.nodeId}" data-name="${nodeName}">Rename</button>
+                <button class="btn btn-sm btn-outline-primary check-update" data-nodeid="${node.nodeId}">Check Update</button>
+              </div>
+            `;
           }
 
           tr.innerHTML = `
             <td>${node.nodeId}</td>
-            <td>${node.name || node.label || 'Node ' + node.nodeId}</td>
+            <td id="node-name-${node.nodeId}">${nodeName}</td>
             <td><span class="badge badge-${status === 'Alive' || status === 'Awake' ? 'success' : 'secondary'}">${status}</span></td>
             <td>${node.firmwareVersion || 'Unknown'}</td>
             <td id="node-action-${node.nodeId}">${actionHtml}</td>
@@ -197,6 +203,25 @@
           tbody.appendChild(tr);
         });
 
+        // Add event listeners for rename buttons
+        document.querySelectorAll('.rename-node').forEach((btn) => {
+          btn.addEventListener('click', async (e) => {
+            const nodeId = e.target.getAttribute('data-nodeid');
+            const currentName = e.target.getAttribute('data-name');
+            const newName = prompt(`Enter new name for Node ${nodeId}:`, currentName);
+
+            if (newName !== null && newName !== currentName && newName.trim() !== '') {
+              try {
+                await window.homebridge.request('rename-node', { nodeId, name: newName.trim() });
+                window.homebridge.toast.success(`Node ${nodeId} renamed to ${newName}`);
+                loadNodes();
+              } catch (err) {
+                window.homebridge.toast.error(err.message);
+              }
+            }
+          });
+        });
+
         // Add event listeners for check buttons
         document.querySelectorAll('.check-update').forEach((btn) => {
           btn.addEventListener('click', async (e) => {

package/homebridge-ui/server.js

@@ -11,6 +11,10 @@ class UiServer extends HomebridgePluginUiServer {
       return await this.ipcRequest('/nodes', 'GET');
     });
 
+    this.onRequest('rename-node', async ({ nodeId, name }) => {
+      return await this.ipcRequest(`/nodes/${nodeId}/name`, 'POST', { name });
+    });
+
     this.onRequest('check-firmware', async (nodeId) => {
       return await this.ipcRequest(`/firmware/updates/${nodeId}`, 'GET');
     });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-zwave-usb",
   "displayName": "Homebridge Z-Wave USB",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A Homebridge dynamic platform plugin for Z-Wave USB controllers using zwave-js.",
   "license": "Polyform-Noncommercial-1.0.0",
   "funding": {