From 89fee209b16e43fb0059e67e704cae5e33b4d081 Mon Sep 17 00:00:00 2001 From: Gabik21 Date: Fri, 23 Oct 2026 21:00:51 +0200 Subject: [PATCH] meters: document minsoc and maxsoc --- src/content/docs/de/reference/configuration/meters.md | 8 ++++++++ src/content/docs/de/user-defined-devices.mdx | 2 +- src/content/docs/en/reference/configuration/meters.md | 8 ++++++++ src/content/docs/en/user-defined-devices.mdx | 2 +- 4 files changed, 18 insertions(+), 2 deletions(-) diff --git a/src/content/docs/de/reference/configuration/meters.md b/src/content/docs/de/reference/configuration/meters.md index 163c6ddb1..d7fe42739 100644 --- a/src/content/docs/de/reference/configuration/meters.md +++ b/src/content/docs/de/reference/configuration/meters.md @@ -384,6 +384,8 @@ Standard Implementierung, bei welchem die einzelnen Werte über [Plugins](/de/us soc: # Batterie SOC (%) source: # Plugin Typ ... + minsoc: 10 # Minimaler Batterie-SOC (%) + maxsoc: 90 # Maximaler Batterie-SOC (%) capacity: # optional Batterie Kapazität (kWh) currents: # Stromstärke (A) pro Phase - source: # Phase 1 Plugin Typ @@ -479,6 +481,12 @@ Dient dazu, den Gesamt-Ladestand zu ermittlen. --- +#### `minsoc` und `maxsoc` + +Optionale untere und obere Grenzen des Batterie-Ladestands in Prozent. Trage hier die am Batteriesystem eingestellten Grenzen ein. evcc berücksichtigt sie bei der Berechnung des nutzbaren SOC-Bereichs, unter anderem für den Optimizer und das Netzladen. Die Standardwerte sind `0` und `100`. + +--- + #### `currents` Eine Liste von Plugin Definitionen um die Stromstärke in A pro Phase zurückzugeben. diff --git a/src/content/docs/de/user-defined-devices.mdx b/src/content/docs/de/user-defined-devices.mdx index df8a5fc79..db18a2826 100644 --- a/src/content/docs/de/user-defined-devices.mdx +++ b/src/content/docs/de/user-defined-devices.mdx @@ -138,7 +138,7 @@ Echte Zählerstände liefern genauere Langzeitstatistiken. | Attribut | Typ | Erfordert | Kontext | Beschreibung | | ------------- | ----- | --------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `limitsoc` | `int` | nein | `battery` | Setze Ladeziel für Batterie in %. Das Ladeziel wird aus den konfigurierten `MinSoc`, `MaxSoc` und dem aktuellen Ladestand (Attribut `soc`) berechnet. | +| `limitsoc` | `int` | nein | `battery` | Setze Ladeziel für Batterie in %. Das Ladeziel wird aus den konfigurierten `minsoc`, `maxsoc` und dem aktuellen Ladestand (Attribut `soc`) berechnet. | | `curtail` | `int` | nein | `pv` | Setze Einspeiselimit in % der Nennleistung der Erzeugung (0 bis 100, `100` = kein Limit). Nur zusammen mit `curtailed`. Siehe [Einspeisebegrenzer](#curtailer). | | `batterymode` | `int` | nein | `battery` | Setze den Steuerungsmodus der Batterie direkt. Die Modi sind unten aufgeführt. | diff --git a/src/content/docs/en/reference/configuration/meters.md b/src/content/docs/en/reference/configuration/meters.md index dfa0dfa3f..30ee1d660 100644 --- a/src/content/docs/en/reference/configuration/meters.md +++ b/src/content/docs/en/reference/configuration/meters.md @@ -380,6 +380,8 @@ Standard implementation, in which individual values are defined via [plugins](/e soc: # Battery SOC (%) source: # Plugin Type ... + minsoc: 10 # Minimum battery SOC (%) + maxsoc: 90 # Maximum battery SOC (%) capacity: # Optional Battery Capacity (kWh) currents: # Current (A) per phase - source: # Phase 1 Plugin Type @@ -473,6 +475,12 @@ Indication of battery capacity. Only useful when multiple batteries are present. --- +#### `minsoc` and `maxsoc` + +Optional lower and upper battery charge limits in percent. Set these to the limits configured on the battery system. evcc uses them when calculating the battery's usable SOC range, including for the optimizer and grid charging. The defaults are `0` and `100`. + +--- + #### `currents` A list of plugin definitions to return current in amperes (A) per phase. diff --git a/src/content/docs/en/user-defined-devices.mdx b/src/content/docs/en/user-defined-devices.mdx index 3be6e303b..99d15ef4a 100644 --- a/src/content/docs/en/user-defined-devices.mdx +++ b/src/content/docs/en/user-defined-devices.mdx @@ -137,7 +137,7 @@ Real meter readings give more accurate long-term statistics. | Attribute | Type | Required | Context | Description | | ------------- | ----- | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `limitsoc` | `int` | no | `battery` | Set charging target for battery in %. The charging target is calculated from the configured `MinSoc`, `MaxSoc` and the current charge level (attribute `soc`). | +| `limitsoc` | `int` | no | `battery` | Set charging target for battery in %. The charging target is calculated from the configured `minsoc`, `maxsoc` and the current charge level (attribute `soc`). | | `curtail` | `int` | no | `pv` | Set grid export limit in % of the nominal production power (0 to 100, `100` = no limit). Only together with `curtailed`. See [Curtailment Device](#curtailer). | | `batterymode` | `int` | no | `battery` | Set the battery control mode directly. The modes are listed below. |