homebridge-zwave-usb 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eliran Sapir
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# Homebridge Z-Wave USB
+
+[![Build and Test](https://github.com/sapireli/homebridge-zwave-usb/actions/workflows/build.yml/badge.svg)](https://github.com/user/homebridge-zwave-usb/actions/workflows/build.yml)
+
+A high-performance, native HomeKit integration for Z-Wave networks.
+
+Unlike legacy plugins, **Homebridge Z-Wave USB** is built on the modern **Z-Wave JS** driver (the same stack used by Home Assistant), offering unmatched speed, reliability, and device support.
+
+## Why this plugin?
+
+*   🚀 **Performance:** Direct communication with your USB stick. No intermediate MQTT brokers or slow translation layers.
+*   🔌 **Flexibility:** Run it standalone ("Direct Mode") OR connect it to an existing **Z-Wave JS UI** instance ("Remote Mode").
+*   🏠 **Native Feel:** Devices appear in Apple Home exactly as you expect. Multi-sensor devices are grouped logically.
+*   🔐 **Secure:** Full support for S2 Security (Locks, Garage Doors) with auto-generated keys.
+
+---
+
+## 🛠️ One Plugin, Three Architectures
+
+Choose the setup that fits your needs:
+
+| Mode | Best For... | Description |
+| :--- | :--- | :--- |
+| **Direct** | ⚡ **Speed & Simplicity** | The plugin owns the USB stick. Zero external dependencies. Ideal for Raspberry Pi setups. |
+| **Remote** | 🐳 **Docker / NAS** | Connects to **Z-Wave JS UI** running in a separate container. Perfect if you want the advanced Z-Wave control panel. |
+| **Host** | 🎛️ **Hybrid** | The plugin runs the Z-Wave network but exposes a server for **Z-Wave JS UI** to connect to for management/graphs. |
+
+---
+
+## 📦 Installation
+
+1.  **Install Homebridge**: [Official Instructions](https://github.com/homebridge/homebridge/wiki).
+2.  **Install Plugin**: 
+    ```bash
+    npm install -g homebridge-zwave-usb
+    ```
+3.  **Permissions (Linux/Pi)**: Ensure the user running Homebridge has access to serial ports:
+    ```bash
+    sudo usermod -a -G dialout $(whoami)
+    ```
+
+---
+
+## ⚙️ Configuration
+
+### Option A: Direct Mode (Recommended)
+*The simplest way to get started.*
+
+1.  Go to **Settings** in Homebridge UI.
+2.  **Serial Port**: Enter the persistent path to your stick.
+    > [!WARNING]
+    > **Do not use `/dev/ttyACM0`**. Use the stable path found in `/dev/serial/by-id/...`
+3.  **Security Keys**: Click the **"Auto-Generate Keys"** button.
+4.  **Save & Restart**.
+
+### Option B: Remote Mode (Z-Wave JS UI)
+*Connect to an existing Z-Wave JS UI instance.*
+
+1.  Ensure **Z-Wave JS UI** is running and "WS Server" is enabled (Settings -> Home Assistant / WS).
+2.  In Homebridge Plugin Settings:
+    *   **Serial Port**: Enter the WebSocket URL (e.g., `ws://localhost:3000` or `ws://192.168.1.50:3000`).
+3.  **Keys**: Leave blank. (Keys are managed inside Z-Wave JS UI).
+4.  **Save & Restart**.
+
+### Option C: Host Mode
+*Homebridge runs the network, but you want to view the graph in Z-Wave JS UI.*
+
+1.  Follow "Direct Mode" setup.
+2.  Check **"Enable Z-Wave Server"**.
+3.  In **Z-Wave JS UI**, set the driver mode to "Remote" and point it to `ws://YOUR_HOMEBRIDGE_IP:3000`.
+
+---
+
+## ✅ Supported Devices
+
+The plugin automatically maps Z-Wave capabilities to Apple HomeKit services:
+
+| Device Type | HomeKit Service | Notes |
+| :--- | :--- | :--- |
+| **Switches / Plugs** | Switch / Outlet | Instant status updates. |
+| **Dimmers** | Lightbulb | Brightness 0-100%. |
+| **Locks** | Lock Mechanism | Supports Secure (S0/S2) pairing. |
+| **Motion Sensors** | Motion Sensor | |
+| **Door/Window** | Contact Sensor | |
+| **Leak Sensors** | Leak Sensor | |
+| **Climate** | Temp / Humidity | Auto-converts Fahrenheit/Celsius. |
+| **Scene Controllers** | Programmable Switch | Supports Single, Double, Long press. |
+| **Battery** | Battery Service | Low battery alerts in Home app. |
+
+---
+
+## 🎮 Managing Your Network
+
+This plugin exposes a **"Z-Wave Controller"** accessory in Apple Home. You can use it to manage your mesh right from your phone:
+
+*   **Inclusion Mode:** Turn ON to pair a new device (timeout: 60s).
+*   **Exclusion Mode:** Turn ON to unpair/remove a device.
+*   **Heal Network:** Turn ON to rebuild mesh routes (do this after moving devices).
+
+---
+
+## ❓ Troubleshooting
+
+*   **Device not showing up?** Battery devices sleep. Wake them up (press the button) repeatedly after pairing until the interview completes.
+*   **Port Busy Error?** Ensure no other software (like Z-Wave JS UI) is trying to use the USB stick at the same time. If you want both, use **Remote Mode**.
+*   **Secure Inclusion Failed?** Ensure you have generated Security Keys in the settings.
+
+## Contributing
+
+Pull requests are welcome! Please ensure all changes pass `npm test` and `npm run build`.
+
+## Legal & Disclaimer
+
+**Homebridge Z-Wave USB** is an independent project and is not affiliated with, endorsed by, or sponsored by any of the following trademark owners:
+
+- **Apple, HomeKit, and Apple Home** are trademarks of Apple Inc., registered in the U.S. and other countries.
+- **Z-Wave and Z-Wave Plus** are registered trademarks of Silicon Labs and its subsidiaries.
+- **Homebridge** is a registered trademark of the Homebridge project.
+- **Aeotec, Zooz, and Home Assistant** are trademarks of their respective owners.
+
+This project is **not affiliated with, maintained, or supported by** the official **Z-Wave JS** or **Z-Wave JS UI** (formerly zwavejs2mqtt) projects. It is an independent wrapper for Homebridge.
+
+**DISCLAIMER:**
+This software is provided "as is", without warranty of any kind. The authors are not responsible for any damage, data loss, or security breaches that may occur. 
+**You use this software at your own risk.** 
+This includes, but is not limited to, the risk of:
+- Smart locks unlocking unexpectedly.
+- Z-Wave devices failing to respond.
+- Loss of configuration data.
+
+Always ensure you have backups of your Z-Wave controller keys and Homebridge configuration.
+
+## License
+
+MIT

package/config.schema.json

@@ -0,0 +1,128 @@
+{
+  "pluginAlias": "ZWaveUSB",
+  "pluginType": "platform",
+  "customUi": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "required": true,
+        "default": "Z-Wave USB"
+      },
+      "platform": {
+        "title": "Platform",
+        "type": "string",
+        "required": true,
+        "default": "ZWaveUSB",
+        "const": "ZWaveUSB"
+      },
+    "serialPort": {
+      "title": "Serial Port or WebSocket URL",
+      "type": "string",
+      "required": true,
+      "description": "Path to the serial port (e.g., /dev/ttyACM0) or WebSocket URL (e.g., ws://localhost:3000)."
+    },
+      "securityKeys": {
+        "title": "Security Keys",
+        "type": "object",
+        "properties": {
+          "S0_Legacy": {
+            "title": "S0 Legacy Key",
+            "type": "string",
+            "minLength": 32,
+            "maxLength": 32,
+            "pattern": "^[0-9a-fA-F]+$",
+            "description": "16-byte hex string (32 characters). REQUIRED for legacy secure devices."
+          },
+          "S2_Unauthenticated": {
+            "title": "S2 Unauthenticated Key",
+            "type": "string",
+            "minLength": 32,
+            "maxLength": 32,
+            "pattern": "^[0-9a-fA-F]+$",
+            "description": "16-byte hex string (32 characters)."
+          },
+          "S2_Authenticated": {
+            "title": "S2 Authenticated Key",
+            "type": "string",
+            "minLength": 32,
+            "maxLength": 32,
+            "pattern": "^[0-9a-fA-F]+$",
+            "description": "16-byte hex string (32 characters)."
+          },
+          "S2_AccessControl": {
+            "title": "S2 Access Control Key",
+            "type": "string",
+            "minLength": 32,
+            "maxLength": 32,
+            "pattern": "^[0-9a-fA-F]+$",
+            "description": "16-byte hex string (32 characters)."
+          }
+        }
+      },
+    "inclusionTimeoutSeconds": {
+      "title": "Inclusion Timeout (Seconds)",
+      "type": "integer",
+      "default": 60,
+      "minimum": 30,
+      "maximum": 300,
+      "description": "How long the inclusion mode stays active."
+    },
+    "enableServer": {
+      "title": "Enable Z-Wave Server (Host Mode)",
+      "type": "boolean",
+      "default": false,
+      "description": "Expose the Z-Wave Driver via WebSocket. Allows Z-Wave JS UI to connect to this plugin."
+    },
+    "serverPort": {
+      "title": "Server Port",
+      "type": "integer",
+      "default": 3000,
+      "minimum": 1024,
+      "maximum": 65535,
+      "description": "Port for the Z-Wave WebSocket Server (only if enabled).",
+      "condition": {
+        "function": {
+          "enableServer": true
+        }
+      }
+    },
+    "debug": {
+        "title": "Enable Debug Logging",
+        "type": "boolean",
+        "default": false,
+        "description": "If true, enables verbose logging for troubleshooting."
+      }
+    }
+  },
+  "layout": [
+    "name",
+    {
+      "key": "serialPort",
+      "description": "WARNING: Do not use /dev/ttyUSBX or /dev/ttyACMX serial devices, as those mappings can change over time. Instead, use the /dev/serial/by-id/X persistent path for your Z-Wave stick. On macOS, use /dev/tty.usbmodem..."
+    },
+    {
+      "type": "fieldset",
+      "title": "Z-Wave Security Keys",
+      "expandable": true,
+      "description": "These keys are used to connect securely to compatible devices. \n\nDirect/Host Mode: Use the 'Auto-Generate Keys' button in the settings UI.\n\nRemote Mode: These keys are IGNORED (set them in Z-Wave JS UI instead).\n\nWARNING: Backup your keys! If you lose them, you will have to factory reset your devices to re-pair them.",
+      "items": [
+        "securityKeys.S0_Legacy",
+        "securityKeys.S2_Unauthenticated",
+        "securityKeys.S2_Authenticated",
+        "securityKeys.S2_AccessControl"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Advanced",
+      "expandable": true,
+      "items": [
+        "inclusionTimeoutSeconds",
+        "debug"
+      ]
+    }
+  ]
+}

package/dist/accessories/AccessoryFactory.d.ts

@@ -0,0 +1,7 @@
+import { IZWaveNode } from '../zwave/interfaces';
+import { ZWaveAccessory } from './ZWaveAccessory';
+import { ZWaveUsbPlatform } from '../platform/ZWaveUsbPlatform';
+export declare class AccessoryFactory {
+    static create(platform: ZWaveUsbPlatform, node: IZWaveNode, homeId: number): ZWaveAccessory;
+    private static attachFeatures;
+}

package/dist/accessories/AccessoryFactory.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessoryFactory = void 0;
+const ZWaveAccessory_1 = require("./ZWaveAccessory");
+const BinarySwitchFeature_1 = require("../features/BinarySwitchFeature");
+const MultilevelSwitchFeature_1 = require("../features/MultilevelSwitchFeature");
+const LockFeature_1 = require("../features/LockFeature");
+const MultilevelSensorFeature_1 = require("../features/MultilevelSensorFeature");
+const ContactSensorFeature_1 = require("../features/ContactSensorFeature");
+const MotionSensorFeature_1 = require("../features/MotionSensorFeature");
+const LeakSensorFeature_1 = require("../features/LeakSensorFeature");
+const CentralSceneFeature_1 = require("../features/CentralSceneFeature");
+class AccessoryFactory {
+    static create(platform, node, homeId) {
+        const accessory = new ZWaveAccessory_1.ZWaveAccessory(platform, node, homeId);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const endpoints = node.getAllEndpoints();
+        for (const endpoint of endpoints) {
+            // Endpoint interface from zwave-js might differ from what we have in virtual node
+            this.attachFeatures(platform, accessory, node, endpoint);
+        }
+        return accessory;
+    }
+    static attachFeatures(platform, accessory, node, endpoint) {
+        const allValues = node.getDefinedValueIDs();
+        const values = allValues.filter(v => v.endpoint === endpoint.index);
+        const hasSwitch = endpoint.supportsCC(37);
+        const hasMultilevelSwitch = endpoint.supportsCC(38);
+        const hasLock = endpoint.supportsCC(98);
+        const hasSensorMultilevel = endpoint.supportsCC(49);
+        const hasNotification = endpoint.supportsCC(113);
+        const hasSensorBinary = endpoint.supportsCC(48);
+        const hasCentralScene = endpoint.supportsCC(91);
+        // 1. Lock
+        if (hasLock) {
+            accessory.addFeature(new LockFeature_1.LockFeature(platform, accessory.platformAccessory, endpoint));
+        }
+        // 2. Multilevel Switch (Dimmer)
+        if (hasMultilevelSwitch) {
+            accessory.addFeature(new MultilevelSwitchFeature_1.MultilevelSwitchFeature(platform, accessory.platformAccessory, endpoint));
+        }
+        // 3. Binary Switch
+        if (hasSwitch && !hasMultilevelSwitch) {
+            accessory.addFeature(new BinarySwitchFeature_1.BinarySwitchFeature(platform, accessory.platformAccessory, endpoint));
+        }
+        // 4. Multilevel Sensor
+        if (hasSensorMultilevel) {
+            accessory.addFeature(new MultilevelSensorFeature_1.MultilevelSensorFeature(platform, accessory.platformAccessory, endpoint));
+        }
+        // 5. Notification Sensors
+        if (hasNotification) {
+            // Water Alarm
+            if (values.some((v) => v.commandClass === 113 && (v.property === 'Water Alarm' || v.propertyKey === 'Water leak status'))) {
+                accessory.addFeature(new LeakSensorFeature_1.LeakSensorFeature(platform, accessory.platformAccessory, endpoint));
+            }
+            // Home Security - Motion
+            if (values.some((v) => v.commandClass === 113 && (v.property === 'Home Security' || v.propertyKey === 'Motion sensor status'))) {
+                accessory.addFeature(new MotionSensorFeature_1.MotionSensorFeature(platform, accessory.platformAccessory, endpoint));
+            }
+            // Access Control - Door/Window
+            if (values.some((v) => v.commandClass === 113 && (v.property === 'Access Control' || v.propertyKey === 'Door status'))) {
+                accessory.addFeature(new ContactSensorFeature_1.ContactSensorFeature(platform, accessory.platformAccessory, endpoint));
+            }
+        }
+        // 6. Binary Sensor (Legacy)
+        if (hasSensorBinary) {
+            // Default to ContactSensor for generic binary sensors
+            accessory.addFeature(new ContactSensorFeature_1.ContactSensorFeature(platform, accessory.platformAccessory, endpoint));
+        }
+        // 7. Central Scene (Buttons)
+        if (hasCentralScene) {
+            accessory.addFeature(new CentralSceneFeature_1.CentralSceneFeature(platform, accessory.platformAccessory, endpoint));
+        }
+    }
+}
+exports.AccessoryFactory = AccessoryFactory;

package/dist/accessories/ControllerAccessory.d.ts

@@ -0,0 +1,18 @@
+import { PlatformAccessory } from 'homebridge';
+import { ZWaveUsbPlatform } from '../platform/ZWaveUsbPlatform';
+import { IZWaveController } from '../zwave/interfaces';
+export declare class ControllerAccessory {
+    private readonly platform;
+    private readonly controller;
+    private inclusionService;
+    private exclusionService;
+    private healService;
+    readonly platformAccessory: PlatformAccessory;
+    constructor(platform: ZWaveUsbPlatform, controller: IZWaveController);
+    private handleSetInclusion;
+    private handleGetInclusion;
+    private handleSetExclusion;
+    private handleGetExclusion;
+    private handleSetHeal;
+    private handleGetHeal;
+}

package/dist/accessories/ControllerAccessory.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerAccessory = void 0;
+class ControllerAccessory {
+    platform;
+    controller;
+    inclusionService;
+    exclusionService;
+    healService;
+    platformAccessory;
+    constructor(platform, controller) {
+        this.platform = platform;
+        this.controller = controller;
+        const homeId = this.controller.homeId;
+        const uuid = this.platform.api.hap.uuid.generate(`ZWaveController-${homeId}`);
+        const existingAccessory = this.platform.accessories.find((accessory) => accessory.UUID === uuid);
+        if (existingAccessory) {
+            this.platformAccessory = existingAccessory;
+        }
+        else {
+            this.platform.log.info('Creating new Z-Wave Controller accessory');
+            this.platformAccessory = new this.platform.api.platformAccessory('Z-Wave Controller', uuid);
+            this.platform.api.registerPlatformAccessories('homebridge-zwave-usb', 'ZWaveUSB', [this.platformAccessory]);
+            this.platform.accessories.push(this.platformAccessory);
+        }
+        this.inclusionService =
+            this.platformAccessory.getService('Inclusion Mode') ||
+                this.platformAccessory.addService(this.platform.Service.Switch, 'Inclusion Mode', 'Inclusion');
+        this.exclusionService =
+            this.platformAccessory.getService('Exclusion Mode') ||
+                this.platformAccessory.addService(this.platform.Service.Switch, 'Exclusion Mode', 'Exclusion');
+        this.healService =
+            this.platformAccessory.getService('Heal Network') ||
+                this.platformAccessory.addService(this.platform.Service.Switch, 'Heal Network', 'Heal');
+        this.inclusionService
+            .getCharacteristic(this.platform.Characteristic.On)
+            .on('set', this.handleSetInclusion.bind(this))
+            .on('get', this.handleGetInclusion.bind(this));
+        this.exclusionService
+            .getCharacteristic(this.platform.Characteristic.On)
+            .on('set', this.handleSetExclusion.bind(this))
+            .on('get', this.handleGetExclusion.bind(this));
+        this.healService
+            .getCharacteristic(this.platform.Characteristic.On)
+            .on('set', this.handleSetHeal.bind(this))
+            .on('get', this.handleGetHeal.bind(this));
+        // Listen for controller events to sync state
+        this.controller.on('inclusion started', () => {
+            this.platform.log.info('Controller event: Inclusion Started');
+            this.inclusionService.updateCharacteristic(this.platform.Characteristic.On, true);
+            this.exclusionService.updateCharacteristic(this.platform.Characteristic.On, false);
+        });
+        this.controller.on('inclusion stopped', () => {
+            this.platform.log.info('Controller event: Inclusion Stopped');
+            this.inclusionService.updateCharacteristic(this.platform.Characteristic.On, false);
+        });
+        this.controller.on('exclusion started', () => {
+            this.platform.log.info('Controller event: Exclusion Started');
+            this.exclusionService.updateCharacteristic(this.platform.Characteristic.On, true);
+            this.inclusionService.updateCharacteristic(this.platform.Characteristic.On, false);
+        });
+        this.controller.on('exclusion stopped', () => {
+            this.platform.log.info('Controller event: Exclusion Stopped');
+            this.exclusionService.updateCharacteristic(this.platform.Characteristic.On, false);
+        });
+        this.controller.on('heal network done', () => {
+            this.platform.log.info('Controller event: Heal Network Done');
+            this.healService.updateCharacteristic(this.platform.Characteristic.On, false);
+        });
+    }
+    async handleSetInclusion(value, callback) {
+        if (value) {
+            this.platform.log.info('Requesting Inclusion Mode ON');
+            // We rely on the event listener to update the characteristic
+            // But for UI responsiveness, we might want to acknowledge the command
+            await this.controller.startInclusion();
+        }
+        else {
+            this.platform.log.info('Requesting Inclusion Mode OFF');
+            await this.controller.stopInclusion();
+        }
+        callback(null);
+    }
+    async handleGetInclusion(callback) {
+        callback(null, false);
+    }
+    async handleSetExclusion(value, callback) {
+        if (value) {
+            this.platform.log.info('Requesting Exclusion Mode ON');
+            await this.controller.startExclusion();
+        }
+        else {
+            this.platform.log.info('Requesting Exclusion Mode OFF');
+            await this.controller.stopExclusion();
+        }
+        callback(null);
+    }
+    async handleGetExclusion(callback) {
+        callback(null, false);
+    }
+    async handleSetHeal(value, callback) {
+        if (value) {
+            this.platform.log.info('Requesting Heal Network ON');
+            await this.controller.startHealing();
+        }
+        else {
+            this.platform.log.info('Requesting Heal Network OFF');
+            await this.controller.stopHealing();
+        }
+        callback(null);
+    }
+    async handleGetHeal(callback) {
+        callback(null, false);
+    }
+}
+exports.ControllerAccessory = ControllerAccessory;

package/dist/accessories/ZWaveAccessory.d.ts

@@ -0,0 +1,20 @@
+import { PlatformAccessory, Service } from 'homebridge';
+import { IZWaveNode } from '../zwave/interfaces';
+import { ZWaveUsbPlatform } from '../platform/ZWaveUsbPlatform';
+import { ZWaveFeature } from '../features/ZWaveFeature';
+export declare class ZWaveAccessory {
+    readonly platform: ZWaveUsbPlatform;
+    readonly node: IZWaveNode;
+    readonly homeId: number;
+    readonly platformAccessory: PlatformAccessory;
+    private features;
+    protected batteryService: Service | undefined;
+    private initialized;
+    constructor(platform: ZWaveUsbPlatform, node: IZWaveNode, homeId: number);
+    addFeature(feature: ZWaveFeature): void;
+    initialize(): void;
+    refresh(): void;
+    protected updateBattery(): void;
+    private handleGetBatteryLevel;
+    private handleGetStatusLowBattery;
+}

package/dist/accessories/ZWaveAccessory.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZWaveAccessory = void 0;
+class ZWaveAccessory {
+    platform;
+    node;
+    homeId;
+    platformAccessory;
+    features = [];
+    batteryService;
+    initialized = false;
+    constructor(platform, node, homeId) {
+        this.platform = platform;
+        this.node = node;
+        this.homeId = homeId;
+        const uuid = this.platform.api.hap.uuid.generate(`homebridge-zwave-usb-${this.homeId}-${this.node.nodeId}`);
+        const existingAccessory = this.platform.accessories.find((accessory) => accessory.UUID === uuid);
+        if (existingAccessory) {
+            this.platformAccessory = existingAccessory;
+        }
+        else {
+            const accessoryName = `Node ${this.node.nodeId}`;
+            this.platform.log.info(`Creating new accessory for ${accessoryName}`);
+            this.platformAccessory = new this.platform.api.platformAccessory(accessoryName, uuid);
+            this.platform.api.registerPlatformAccessories('homebridge-zwave-usb', 'ZWaveUSB', [this.platformAccessory]);
+            this.platform.accessories.push(this.platformAccessory);
+        }
+        // Battery Service (Native support)
+        if (this.node.supportsCC(128)) { // Battery CC
+            this.batteryService =
+                this.platformAccessory.getService(this.platform.Service.Battery) ||
+                    this.platformAccessory.addService(this.platform.Service.Battery);
+            this.batteryService
+                .getCharacteristic(this.platform.Characteristic.BatteryLevel)
+                .on('get', this.handleGetBatteryLevel.bind(this));
+            this.batteryService
+                .getCharacteristic(this.platform.Characteristic.StatusLowBattery)
+                .on('get', this.handleGetStatusLowBattery.bind(this));
+        }
+    }
+    addFeature(feature) {
+        this.features.push(feature);
+    }
+    initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.initialized = true;
+        // Initialize all features
+        for (const feature of this.features) {
+            feature.init();
+        }
+        this.refresh();
+    }
+    refresh() {
+        this.updateBattery();
+        for (const feature of this.features) {
+            feature.update();
+        }
+    }
+    updateBattery() {
+        if (!this.batteryService || !this.node.supportsCC(128)) {
+            return;
+        }
+        const value = this.node.getValue({
+            commandClass: 128,
+            property: 'level',
+        });
+        if (typeof value === 'number') {
+            this.batteryService.updateCharacteristic(this.platform.Characteristic.BatteryLevel, value);
+            this.batteryService.updateCharacteristic(this.platform.Characteristic.StatusLowBattery, value <= 20
+                ? this.platform.Characteristic.StatusLowBattery.BATTERY_LEVEL_LOW
+                : this.platform.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL);
+        }
+    }
+    async handleGetBatteryLevel(callback) {
+        if (!this.node.supportsCC(128)) {
+            callback(null, 100);
+            return;
+        }
+        const value = this.node.getValue({
+            commandClass: 128,
+            property: 'level',
+        });
+        callback(null, value || 100);
+    }
+    async handleGetStatusLowBattery(callback) {
+        if (!this.node.supportsCC(128)) {
+            callback(null, this.platform.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL);
+            return;
+        }
+        const value = this.node.getValue({
+            commandClass: 128,
+            property: 'level',
+        });
+        const level = value || 100;
+        callback(null, level <= 20
+            ? this.platform.Characteristic.StatusLowBattery.BATTERY_LEVEL_LOW
+            : this.platform.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL);
+    }
+}
+exports.ZWaveAccessory = ZWaveAccessory;

package/dist/features/BinarySwitchFeature.d.ts

@@ -0,0 +1,8 @@
+import { BaseFeature } from './ZWaveFeature';
+export declare class BinarySwitchFeature extends BaseFeature {
+    private service;
+    init(): void;
+    update(): void;
+    private handleGetOn;
+    private handleSetOn;
+}