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

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,39 @@
-# 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 provider for CamStack: the box is an integration, and the equipment it reports (photovoltaic, battery, grid, house, heat pump) is adopted as Container devices with history. There is no device for the box itself.
+
+## What it does
+
+- **Enpal** (`provider-enpal`): add an integration with the box's host. The addon polls the box's InfluxDB 2.x (or, as fallback, its local device page) and offers one Container per piece of equipment the box actually reports. Adopting a container adopts its children.
+  - Node placement: `hub-only`.
+  - Capabilities: `device-provider`, `device-adoption`.
+
+Containers and their children (a container is offered only when the box reported at least one of its values; a child only when the box reported its value):
+
+| Container | Child | Caps |
+| --- | --- | --- |
+| Photovoltaic | Production | `power-meter` (W, lifetime kWh) |
+| | Inverter temperature | `numeric-sensor` |
+| Battery | Battery | `battery` (state of charge), `power-meter` (signed W, V, A) |
+| | Energy charged / discharged | `meter` (lifetime kWh) |
+| | Temperature, Health | `numeric-sensor` |
+| Grid | Import, Export | `power-meter` (W, lifetime kWh) |
+| House | Consumption | `power-meter` |
+| Heat pump | Consumption | `power-meter` |
+| | Hot water temperature, Outside temperature | `numeric-sensor` |
+
+Removing the integration removes its devices. 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.
+
+## Integration settings
+
+- **Box host / IP** — the box on the LAN. The box does not advertise itself, so the integration 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>