https://github.com/dacarson/homebridge-pvs6

Homebridge plugin for SunStrong PVS6 solar monitoring — exposes Solar Production and Grid Meter as Eve Energy accessories with fakegato history.
https://github.com/dacarson/homebridge-pvs6

Last synced: 8 days ago
JSON representation

Homebridge plugin for SunStrong PVS6 solar monitoring — exposes Solar Production and Grid Meter as Eve Energy accessories with fakegato history.

Host: GitHub
URL: https://github.com/dacarson/homebridge-pvs6
Owner: dacarson
License: mit
Created: 2026-06-04T01:16:11.000Z (9 days ago)
Default Branch: main
Last Pushed: 2026-06-04T03:06:16.000Z (9 days ago)
Last Synced: 2026-06-04T04:23:00.340Z (9 days ago)
Language: TypeScript
Size: 74.2 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          # 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)

- **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 |

### 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 |

### Grid Export *(optional — enabled with `accessories.grid: 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 |

---

## 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

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/dacarson/homebridge-pvs6

Awesome Lists containing this project

README