Skip to content

meters: document minsoc and maxsoc #1229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Gabik21 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

meters: document minsoc and maxsoc #1229

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions src/content/docs/de/reference/configuration/meters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/de/user-defined-devices.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |

Expand Down
8 changes: 8 additions & 0 deletions src/content/docs/en/reference/configuration/meters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/user-defined-devices.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |

Expand Down