homebridge-pvs6 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dacarson
+
+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,198 @@
+# homebridge-pvs6
+
+A [Homebridge](https://homebridge.io) plugin for the [SunStrong PVS6](https://sunstrong.com) solar monitoring system. Exposes solar production and grid metering as **Eve Energy** accessories in Apple HomeKit, with real-time power, cumulative energy, voltage, and native Eve app history.
+
+---
+
+## Features
+
+- **Solar Production** accessory — always registered; real-time PV output (W), lifetime generation (kWh), line voltage (V)
+- **Grid Import + Grid Export** accessory pair — optional (default enabled); each shows non-negative watts and its own Eve app history
+- Import and Export accessories are always registered together as a pair, making import/export history immediately readable as separate graphs
+- Up to 7 days of native power history in the Eve app via [fakegato-history](https://github.com/simont77/fakegato-history)
+- Polls the PVS6 **local** FCGI API — no SunStrong Connect, no cloud dependency
+- Automatically identifies production and consumption CT meters from the PVS6 device list
+- Designed to complement [homebridge-rainforest-eagle3](https://github.com/dacarson/homebridge-rainforest-eagle3) for a complete solar + grid picture in Apple Home
+
+---
+
+## Supported Hardware
+
+| Device | Status |
+|---|---|
+| SunStrong PVS6 (firmware build 61840+) | Supported |
+| PVS5 | Not supported |
+| PVS2 | Not supported |
+
+---
+
+## How It Works
+
+The PVS6 exposes a local HTTPS varserver API that this plugin polls on a configurable interval. It reads two data streams:
+
+- **Livedata** — aggregate solar production and net grid power computed by the PVS6
+- **Meter data** — per-phase detail from the CT meters (voltage, cumulative energy)
+
+The plugin automatically identifies the production meter (model suffix `p`, e.g. `PVS6M0400p`) and consumption meter (model suffix `c`, e.g. `PVS6M0400c`) from the device list.
+
+All accessories render as **smart plugs** in Apple Home:
+
+- **Solar Production** — always registered; `On` when the panels are producing power
+- **Grid Import** — `On` when importing from the grid; zero watts when net-exporting
+- **Grid Export** — `On` when net-exporting solar to the grid; zero watts when importing
+
+Grid Import and Grid Export are always registered together — enabling `accessories.grid` creates both.
+
+---
+
+## Requirements
+
+- [Homebridge](https://homebridge.io) v1.6 or later
+- Node.js 18 or later
+- SunStrong PVS6 on the same local network as your Homebridge host
+- The PVS6's **full serial number** (printed on the unit label)
+
+---
+
+## Installation
+
+Install via the Homebridge UI plugin search, or from the command line:
+
+```bash
+npm install -g homebridge-pvs6
+```
+
+---
+
+## Configuration
+
+Add a platform entry to your Homebridge `config.json`:
+
+Minimal config (solar only — grid disabled):
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "PVS6",
+      "name": "PVS6",
+      "host": "192.168.1.x",
+      "serialNumber": "ZT231385000549A1234",
+      "accessories": { "grid": false }
+    }
+  ]
+}
+```
+
+Standard config (solar + grid import/export pair):
+
+```json
+{
+  "platforms": [
+    {
+      "platform": "PVS6",
+      "name": "PVS6",
+      "host": "192.168.1.x",
+      "serialNumber": "ZT231385000549A1234",
+      "pollInterval": 10,
+      "solarName": "Solar Production",
+      "gridName": "Grid Meter - Import",
+      "gridExportName": "Grid Meter - Export"
+    }
+  ]
+}
+```
+
+### Configuration Options
+
+| Field | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `platform` | string | yes | — | Must be `PVS6` |
+| `host` | string | yes | — | IP address or hostname of the PVS6 on your local network |
+| `serialNumber` | string | yes | — | Full PVS6 serial number. The last 5 characters are used as the API password |
+| `pollInterval` | integer | no | `10` | Seconds between polls. Minimum enforced: `5` |
+| `accessories.grid` | boolean | no | `true` | Enable the Grid Import + Grid Export accessory pair. Set `false` to disable both |
+| `solarName` | string | no | `"Solar Production"` | HomeKit display name for the Solar Production accessory |
+| `gridName` | string | no | `"Grid Meter - Import"` | HomeKit display name for the Grid Import accessory |
+| `gridExportName` | string | no | `"Grid Meter - Export"` | HomeKit display name for the Grid Export accessory |
+
+### Finding Your Serial Number
+
+The serial number is printed on the label on the PVS6 unit (format: `ZT...`). It is also visible in the SunStrong Connect app. The last 5 characters of the serial number are used as the local API login password — no separate password configuration is required.
+
+---
+
+## HomeKit Accessories
+
+### Solar Production
+
+| Characteristic | Source | Notes |
+|---|---|---|
+| On | `pv_p > 0` | True when panels are actively generating |
+| OutletInUse | Always `true` | Required by Eve Energy |
+| Eve Watts | `pv_p × 1000` | Real-time solar output in Watts |
+| Eve kWh | `pv_en` | Lifetime generation in kWh |
+| Eve Voltage | Production meter `v12V` | AC line voltage |
+
+### Grid Import
+
+| Characteristic | Source | Notes |
+|---|---|---|
+| On | `net_p > 0` | True when importing from grid |
+| OutletInUse | Always `true` | Required by Eve Energy |
+| Eve Watts | `max(0, net_p) × 1000` | Import watts; zero when net-exporting |
+| Eve kWh | `posLtea3phsumKwh` | Lifetime imported energy from consumption CT meter |
+| Eve Voltage | Consumption meter `v12V` | AC line voltage |
+
+### Grid Export *(optional — enabled with `showGridExport: true`)*
+
+| Characteristic | Source | Notes |
+|---|---|---|
+| On | `net_p < 0` | True when net-exporting solar to the grid |
+| OutletInUse | Always `true` | Required by Eve Energy |
+| Eve Watts | `max(0, −net_p) × 1000` | Export watts; zero when importing |
+| Eve kWh | `negLtea3phsumKwh` | Lifetime exported energy from consumption CT meter |
+| Eve Voltage | Consumption meter `v12V` | AC line voltage |
+
+---
+
+## Error Handling
+
+The plugin is designed to be resilient to transient PVS6 failures:
+
+- If the PVS6 is unreachable at startup, authentication retries every 30 seconds
+- Overlapping poll cycles are skipped — only one request is in flight at a time
+- Poll cycles are skipped (not fatal) on timeout (>10 s), JSON parse errors, or HTTP 5xx responses
+- HTTP 5xx triggers a short backoff to avoid overwhelming the PVS6's embedded HTTP server
+- HTTP 401 during polling triggers silent re-authentication with a 60-second backoff
+- Missing fields in a partial response retain their last known-good values
+- HomeKit characteristics remain visible and frozen at last-known values during outages
+
+---
+
+## Building from Source
+
+```bash
+git clone https://github.com/dacarson/homebridge-pvs6.git
+cd homebridge-pvs6
+npm install
+npm run build
+```
+
+To develop with live rebuilds:
+
+```bash
+npm run watch
+```
+
+---
+
+## Related Plugins
+
+- [homebridge-rainforest-eagle3](https://github.com/dacarson/homebridge-rainforest-eagle3) — Rainforest EAGLE-200 grid meter, designed to sit alongside this plugin in Apple Home
+
+---
+
+## License
+
+Apache-2.0

package/config.schema.json

@@ -0,0 +1,64 @@
+{
+  "pluginAlias": "PVS6",
+  "pluginType": "platform",
+  "singular": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "PVS6"
+      },
+      "host": {
+        "title": "Host",
+        "type": "string",
+        "placeholder": "192.168.1.x",
+        "description": "IP address or hostname of the PVS6 on your local network."
+      },
+      "serialNumber": {
+        "title": "Serial Number",
+        "type": "string",
+        "placeholder": "ZT231385000549F1084",
+        "description": "Full PVS6 serial number. The last 5 characters are used as the login password."
+      },
+      "pollInterval": {
+        "title": "Poll Interval (seconds)",
+        "type": "integer",
+        "default": 10,
+        "minimum": 5,
+        "description": "How often to poll the PVS6 for new data. Minimum 5 seconds."
+      },
+      "accessories": {
+        "title": "Accessories",
+        "type": "object",
+        "properties": {
+          "grid": {
+            "title": "Enable Grid Meter accessories (Import + Export pair)",
+            "type": "boolean",
+            "default": true
+          }
+        }
+      },
+      "solarName": {
+        "title": "Solar Accessory Display Name",
+        "type": "string",
+        "default": "Solar Production",
+        "description": "HomeKit display name for the Solar Production accessory."
+      },
+      "gridName": {
+        "title": "Grid Import Accessory Display Name",
+        "type": "string",
+        "default": "Grid Meter - Import",
+        "description": "HomeKit display name for the Grid Import accessory."
+      },
+      "gridExportName": {
+        "title": "Grid Export Accessory Display Name",
+        "type": "string",
+        "default": "Grid Meter - Export",
+        "description": "HomeKit display name for the Grid Export accessory."
+      }
+    },
+    "required": ["host", "serialNumber"]
+  }
+}

package/dist/eveCharacteristics.d.ts

@@ -0,0 +1,14 @@
+import { API, Characteristic } from 'homebridge';
+export declare const EVE_ENERGY_SERVICE_UUID = "E863F10A-079E-48FF-8F27-9C2605A29F52";
+export declare const EVE_WATT_UUID = "E863F10D-079E-48FF-8F27-9C2605A29F52";
+export declare const EVE_KWH_UUID = "E863F10C-079E-48FF-8F27-9C2605A29F52";
+export type EveCharClass = {
+    new (): Characteristic;
+    UUID: string;
+};
+export interface EveChars {
+    EveWatts: EveCharClass;
+    EveKWh: EveCharClass;
+}
+export declare function createEveCharacteristics(api: API): EveChars;
+//# sourceMappingURL=eveCharacteristics.d.ts.map

package/dist/eveCharacteristics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eveCharacteristics.d.ts","sourceRoot":"","sources":["../src/eveCharacteristics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,uBAAuB,yCAAyC,CAAC;AAC9E,eAAO,MAAM,aAAa,yCAAyC,CAAC;AACpE,eAAO,MAAM,YAAY,yCAAyC,CAAC;AAInE,MAAM,MAAM,YAAY,GAAG;IAAE,QAAO,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,CAuC3D"}

package/dist/eveCharacteristics.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVE_KWH_UUID = exports.EVE_WATT_UUID = exports.EVE_ENERGY_SERVICE_UUID = void 0;
+exports.createEveCharacteristics = createEveCharacteristics;
+exports.EVE_ENERGY_SERVICE_UUID = 'E863F10A-079E-48FF-8F27-9C2605A29F52';
+exports.EVE_WATT_UUID = 'E863F10D-079E-48FF-8F27-9C2605A29F52';
+exports.EVE_KWH_UUID = 'E863F10C-079E-48FF-8F27-9C2605A29F52';
+function createEveCharacteristics(api) {
+    const { hap } = api;
+    class EveWatts extends hap.Characteristic {
+        constructor() {
+            super('Eve Watts', EveWatts.UUID, {
+                format: "float" /* Formats.FLOAT */,
+                unit: 'W',
+                minValue: -100000,
+                maxValue: 100000,
+                minStep: 0.1,
+                perms: ["pr" /* Perms.PAIRED_READ */, "ev" /* Perms.NOTIFY */],
+            });
+            this.value = this.getDefaultValue();
+        }
+    }
+    EveWatts.UUID = exports.EVE_WATT_UUID;
+    class EveKWh extends hap.Characteristic {
+        constructor() {
+            super('Eve kWh', EveKWh.UUID, {
+                format: "float" /* Formats.FLOAT */,
+                unit: 'kWh',
+                minValue: 0,
+                maxValue: 1000000,
+                minStep: 0.001,
+                perms: ["pr" /* Perms.PAIRED_READ */, "ev" /* Perms.NOTIFY */],
+            });
+            this.value = this.getDefaultValue();
+        }
+    }
+    EveKWh.UUID = exports.EVE_KWH_UUID;
+    return {
+        EveWatts: EveWatts,
+        EveKWh: EveKWh,
+    };
+}
+//# sourceMappingURL=eveCharacteristics.js.map

package/dist/eveCharacteristics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eveCharacteristics.js","sourceRoot":"","sources":["../src/eveCharacteristics.ts"],"names":[],"mappings":";;;AAeA,4DAuCC;AApDY,QAAA,uBAAuB,GAAG,sCAAsC,CAAC;AACjE,QAAA,aAAa,GAAG,sCAAsC,CAAC;AACvD,QAAA,YAAY,GAAG,sCAAsC,CAAC;AAWnE,SAAgB,wBAAwB,CAAC,GAAQ;IAC/C,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAEpB,MAAM,QAAS,SAAQ,GAAG,CAAC,cAAc;QAGvC;YACE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE;gBAChC,MAAM,6BAAe;gBACrB,IAAI,EAAE,GAAa;gBACnB,QAAQ,EAAE,CAAC,MAAM;gBACjB,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,GAAG;gBACZ,KAAK,EAAE,uDAAiC;aACzC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,CAAC;;IAZe,aAAI,GAAG,qBAAa,CAAC;IAevC,MAAM,MAAO,SAAQ,GAAG,CAAC,cAAc;QAGrC;YACE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE;gBAC5B,MAAM,6BAAe;gBACrB,IAAI,EAAE,KAAe;gBACrB,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,uDAAiC;aACzC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,CAAC;;IAZe,WAAI,GAAG,oBAAY,CAAC;IAetC,OAAO;QACL,QAAQ,EAAE,QAAmC;QAC7C,MAAM,EAAE,MAAiC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/gridExportAccessory.d.ts

@@ -0,0 +1,13 @@
+import { PlatformAccessory } from 'homebridge';
+import { PVS6Platform } from './platform';
+import { PVS6Reading } from './pvs6Client';
+export declare class GridExportAccessory {
+    private readonly platform;
+    private readonly service;
+    private readonly historyService;
+    private lastPowerW;
+    private lastEnergyKWh;
+    constructor(platform: PVS6Platform, accessory: PlatformAccessory, FakeGatoHistoryService: any, displayName: string, serialNumber: string);
+    updateValues(reading: PVS6Reading): void;
+}
+//# sourceMappingURL=gridExportAccessory.d.ts.map

package/dist/gridExportAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridExportAccessory.d.ts","sourceRoot":"","sources":["../src/gridExportAccessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAW,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,qBAAa,mBAAmB;IAS5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;IAErC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;gBAGP,QAAQ,EAAE,YAAY,EACvC,SAAS,EAAE,iBAAiB,EAE5B,sBAAsB,EAAE,GAAG,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM;IA2CtB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAoBzC"}

package/dist/gridExportAccessory.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GridExportAccessory = void 0;
+const eveCharacteristics_1 = require("./eveCharacteristics");
+class GridExportAccessory {
+    constructor(platform, accessory, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    FakeGatoHistoryService, displayName, serialNumber) {
+        this.platform = platform;
+        this.lastPowerW = 0;
+        this.lastEnergyKWh = 0;
+        const { Characteristic } = platform;
+        const { EveWatts, EveKWh } = platform.eveChars;
+        const infoService = accessory.getService(platform.Service.AccessoryInformation) ??
+            accessory.addService(platform.Service.AccessoryInformation);
+        infoService
+            .setCharacteristic(Characteristic.Manufacturer, 'SunStrong')
+            .setCharacteristic(Characteristic.Model, 'PVS6')
+            .setCharacteristic(Characteristic.SerialNumber, `${serialNumber}-grid-export`);
+        const existingService = accessory.services.find(s => s.UUID === eveCharacteristics_1.EVE_ENERGY_SERVICE_UUID);
+        this.service = existingService ??
+            accessory.addService(new platform.api.hap.Service(displayName, eveCharacteristics_1.EVE_ENERGY_SERVICE_UUID));
+        this.service.setCharacteristic(Characteristic.Name, displayName);
+        // On = true when exporting (lastPowerW > 0); always non-negative so the comparison is natural.
+        this.service
+            .getCharacteristic(Characteristic.On)
+            .onGet(() => this.lastPowerW > 0)
+            .onSet(async () => {
+            this.service.updateCharacteristic(Characteristic.On, this.lastPowerW > 0);
+        });
+        this.service
+            .getCharacteristic(Characteristic.OutletInUse)
+            .onGet(() => true);
+        this.service
+            .getCharacteristic(EveWatts)
+            .onGet(() => this.lastPowerW);
+        this.service
+            .getCharacteristic(EveKWh)
+            .onGet(() => this.lastEnergyKWh);
+        this.historyService = new FakeGatoHistoryService('energy', accessory, { storage: 'fs' });
+    }
+    updateValues(reading) {
+        const { Characteristic } = this.platform;
+        const { EveWatts, EveKWh } = this.platform.eveChars;
+        // Non-negative: positive when net-exporting, zero when importing.
+        this.lastPowerW = Math.max(0, -reading.netPowerW);
+        this.lastEnergyKWh = reading.gridExportKWh;
+        this.service.updateCharacteristic(Characteristic.On, this.lastPowerW > 0);
+        this.service.updateCharacteristic(Characteristic.OutletInUse, true);
+        this.service.updateCharacteristic(EveWatts, this.lastPowerW);
+        this.service.updateCharacteristic(EveKWh, this.lastEnergyKWh);
+        this.historyService.addEntry({
+            time: Math.round(Date.now() / 1000),
+            power: this.lastPowerW,
+        });
+        this.platform.log.debug(`Grid Export: ${this.lastPowerW}W  ${this.lastEnergyKWh}kWh`);
+    }
+}
+exports.GridExportAccessory = GridExportAccessory;
+//# sourceMappingURL=gridExportAccessory.js.map

package/dist/gridExportAccessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridExportAccessory.js","sourceRoot":"","sources":["../src/gridExportAccessory.ts"],"names":[],"mappings":"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"}

package/dist/gridImportAccessory.d.ts

@@ -0,0 +1,13 @@
+import { PlatformAccessory } from 'homebridge';
+import { PVS6Platform } from './platform';
+import { PVS6Reading } from './pvs6Client';
+export declare class GridImportAccessory {
+    private readonly platform;
+    private readonly service;
+    private readonly historyService;
+    private lastPowerW;
+    private lastEnergyKWh;
+    constructor(platform: PVS6Platform, accessory: PlatformAccessory, FakeGatoHistoryService: any, displayName: string, serialNumber: string);
+    updateValues(reading: PVS6Reading): void;
+}
+//# sourceMappingURL=gridImportAccessory.d.ts.map

package/dist/gridImportAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridImportAccessory.d.ts","sourceRoot":"","sources":["../src/gridImportAccessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAW,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,qBAAa,mBAAmB;IAS5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAM;IAErC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;gBAGP,QAAQ,EAAE,YAAY,EACvC,SAAS,EAAE,iBAAiB,EAE5B,sBAAsB,EAAE,GAAG,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM;IA2CtB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAoBzC"}

package/dist/gridImportAccessory.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GridImportAccessory = void 0;
+const eveCharacteristics_1 = require("./eveCharacteristics");
+class GridImportAccessory {
+    constructor(platform, accessory, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    FakeGatoHistoryService, displayName, serialNumber) {
+        this.platform = platform;
+        this.lastPowerW = 0;
+        this.lastEnergyKWh = 0;
+        const { Characteristic } = platform;
+        const { EveWatts, EveKWh } = platform.eveChars;
+        const infoService = accessory.getService(platform.Service.AccessoryInformation) ??
+            accessory.addService(platform.Service.AccessoryInformation);
+        infoService
+            .setCharacteristic(Characteristic.Manufacturer, 'SunStrong')
+            .setCharacteristic(Characteristic.Model, 'PVS6')
+            .setCharacteristic(Characteristic.SerialNumber, `${serialNumber}-grid`);
+        const existingService = accessory.services.find(s => s.UUID === eveCharacteristics_1.EVE_ENERGY_SERVICE_UUID);
+        this.service = existingService ??
+            accessory.addService(new platform.api.hap.Service(displayName, eveCharacteristics_1.EVE_ENERGY_SERVICE_UUID));
+        this.service.setCharacteristic(Characteristic.Name, displayName);
+        // On = true when importing (lastPowerW > 0); always non-negative so the comparison is natural.
+        this.service
+            .getCharacteristic(Characteristic.On)
+            .onGet(() => this.lastPowerW > 0)
+            .onSet(async () => {
+            this.service.updateCharacteristic(Characteristic.On, this.lastPowerW > 0);
+        });
+        this.service
+            .getCharacteristic(Characteristic.OutletInUse)
+            .onGet(() => true);
+        this.service
+            .getCharacteristic(EveWatts)
+            .onGet(() => this.lastPowerW);
+        this.service
+            .getCharacteristic(EveKWh)
+            .onGet(() => this.lastEnergyKWh);
+        this.historyService = new FakeGatoHistoryService('energy', accessory, { storage: 'fs' });
+    }
+    updateValues(reading) {
+        const { Characteristic } = this.platform;
+        const { EveWatts, EveKWh } = this.platform.eveChars;
+        // Non-negative: zero when net-exporting, positive when importing.
+        this.lastPowerW = Math.max(0, reading.netPowerW);
+        this.lastEnergyKWh = reading.gridImportKWh;
+        this.service.updateCharacteristic(Characteristic.On, this.lastPowerW > 0);
+        this.service.updateCharacteristic(Characteristic.OutletInUse, true);
+        this.service.updateCharacteristic(EveWatts, this.lastPowerW);
+        this.service.updateCharacteristic(EveKWh, this.lastEnergyKWh);
+        this.historyService.addEntry({
+            time: Math.round(Date.now() / 1000),
+            power: this.lastPowerW,
+        });
+        this.platform.log.debug(`Grid Import: ${this.lastPowerW}W  ${this.lastEnergyKWh}kWh`);
+    }
+}
+exports.GridImportAccessory = GridImportAccessory;
+//# sourceMappingURL=gridImportAccessory.js.map

package/dist/gridImportAccessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridImportAccessory.js","sourceRoot":"","sources":["../src/gridImportAccessory.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export = _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;yBAIvB,KAAK,GAAG,KAAG,IAAI;AAAzB,kBAEE"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+const settings_1 = require("./settings");
+const platform_1 = require("./platform");
+module.exports = (api) => {
+    api.registerPlatform(settings_1.PLATFORM_NAME, platform_1.PVS6Platform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,yCAA2C;AAC3C,yCAA0C;AAE1C,iBAAS,CAAC,GAAQ,EAAQ,EAAE;IAC1B,GAAG,CAAC,gBAAgB,CAAC,wBAAa,EAAE,uBAAY,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,27 @@
+import { API, Characteristic, DynamicPlatformPlugin, Logger, PlatformAccessory, PlatformConfig, Service } from 'homebridge';
+import { EveChars } from './eveCharacteristics';
+export declare class PVS6Platform implements DynamicPlatformPlugin {
+    readonly Service: typeof Service;
+    readonly Characteristic: typeof Characteristic;
+    readonly api: API;
+    readonly eveChars: EveChars;
+    readonly log: Logger;
+    readonly accessories: PlatformAccessory[];
+    private readonly client;
+    private readonly config;
+    private readonly pollIntervalMs;
+    private solarAccessory?;
+    private gridImportAccessory?;
+    private gridExportAccessory?;
+    private pollTimer?;
+    private pollInFlight;
+    private backedOff;
+    constructor(log: Logger, config: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private setupAccessories;
+    private getOrCreateAccessory;
+    private startAuthAndPolling;
+    private startPolling;
+    private enterBackoff;
+}
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,OAAO,EACR,MAAM,YAAY,CAAC;AAOpB,OAAO,EAA4B,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAO1E,qBAAa,YAAa,YAAW,qBAAqB;IACxD,SAAgB,OAAO,EAAE,OAAO,OAAO,CAAC;IACxC,SAAgB,cAAc,EAAE,OAAO,cAAc,CAAC;IACtD,SAAgB,GAAG,EAAE,GAAG,CAAC;IACzB,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,SAAgB,WAAW,EAAE,iBAAiB,EAAE,CAAM;IAEtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAElD,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAGxB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,GAAG;IA8CV,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAKtD,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,YAAY;IAmDpB,OAAO,CAAC,YAAY;CAOrB"}