@camstack/addon-provider-enpal 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this package are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Enpal solar box provider: InfluxDB 2.x source with the local device page as fallback, device adoption for PV, battery, grid, house and heat pump.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# @camstack/addon-provider-enpal
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Enpal solar box device-provider addon for CamStack — PV production, inverter, battery, grid import/export, house consumption and heat pump as Sensor devices with history.
+
+## What it does
+
+- **Enpal** (`provider-enpal`): add a box by its host; the box is a Hub device that polls the box's InfluxDB 2.x (or, as fallback, its local device page) and offers the data groups it actually reports for adoption.
+  - Node placement: `hub-only`.
+  - Capabilities: `device-provider`.
+
+Devices (each adopted from the box's discovery panel, only when the box reports them):
+
+| Device | Caps |
+| --- | --- |
+| PV production | `power-meter` (W, lifetime kWh) |
+| Battery | `battery` (state of charge), `power-meter` (signed W, V, A) |
+| Battery charged / discharged | `meter` (lifetime kWh) |
+| Grid import / export | `power-meter` (W, lifetime kWh) |
+| House consumption | `power-meter` |
+| Heat pump, hot water, outside temperature | `power-meter` / `numeric-sensor` |
+| Inverter / battery temperature, battery health | `numeric-sensor` |
+
+An unreachable box marks its devices offline; it never publishes zeros. A lifetime counter that drops for one poll is held at its previous value.
+
+## Settings
+
+- **Box host / IP** — the box on the LAN. The box does not advertise itself, so it is added by hand.
+- **Source** — `auto` (InfluxDB when a token is set, the device page otherwise or when InfluxDB cannot be read), `influx`, or `page`.
+- **InfluxDB access token** — issued by Enpal support (ask in the Enpal app chat). Stored in the keychain. Organisation (`enpal`), bucket (`solar`) and port (`8086`) default to the usual values.
+- **Poll interval** — 30 s by default, 10 s minimum.
+- **Invert battery power sign** — flip it when charging shows as negative.
+
+Firmware 8.51 and later render the device rows of the device page only through a web socket; on those boxes the page fallback finds nothing and InfluxDB is required.
+
+## Requirements
+
+- A CamStack hub on the same network as the box.

package/assets/icon.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#f5a623" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <circle cx="12" cy="12" r="4" />
+  <path d="M12 2v2" />
+  <path d="M12 20v2" />
+  <path d="M2 12h2" />
+  <path d="M20 12h2" />
+  <path d="M4.9 4.9l1.4 1.4" />
+  <path d="M17.7 17.7l1.4 1.4" />
+  <path d="M4.9 19.1l1.4-1.4" />
+  <path d="M17.7 6.3l1.4-1.4" />
+</svg>