From 46c19da4fbfbdaf9051fe9ee5d889e7672dec071 Mon Sep 17 00:00:00 2001 From: Kai Schmitz Date: Tue, 25 Mar 2025 18:00:09 +0100 Subject: [PATCH] Fix documentation for custom meter config: - add limitsoc setting - add notes about soc, limitsoc and batterymode - change comments in german YAML part to german --- docs/devices/meters.mdx | 32 ++++++++++++------- .../_generische_unterst\303\274tzung.mdx" | 32 ++++++++++++------- .../current/devices/meters.mdx | 10 +++++- .../devices/meters/_generic_support.mdx | 10 +++++- 4 files changed, 58 insertions(+), 26 deletions(-) diff --git a/docs/devices/meters.mdx b/docs/devices/meters.mdx index b3e3d0a90..9b5cd5587 100644 --- a/docs/devices/meters.mdx +++ b/docs/devices/meters.mdx @@ -12097,26 +12097,34 @@ Neuere Slimmelezer-Geräte verwenden eine andere Konfiguration. Probieren Sie di meters: - name: my_meter type: custom - power: # power (W) - source: # plugin type + power: # Leistung (W) + source: # Plugin Typ # ... - energy: # optional energy (kWh) - source: # plugin type + energy: # optional Energie (kWh) + source: # Plugin Typ # ... - soc: # optional battery soc (%) - source: # plugin type + soc: # optional Batterie SOC (%) + source: # Plugin Typ # ... - currents: # optional currents (A) - - source: # L1 plugin type + currents: # optional Ströme (A) + - source: # L1 Plugin Typ # ... - - source: # L2 plugin type + - source: # L2 Plugin Typ # ... - - source: # L3 plugin type + - source: # L3 Plugin Typ # ... - batterymode: # controllable (1: normal, 2: hold, 3: charge) - source: # plugin type + limitsoc: # optional SOC unteres Limit + source: # Plugin Typ + # ... + batterymode: # optional Batteriemodus (1: normal, 2: hold, 3: charge) + source: # Plugin Typ + # ... ``` +:::note +`limitsoc` wird von EVCC auf den aktuellen Wert von `soc` gesetzt um ein weiteres Entladen der Batterie z.B. beim Schnelladen zu verhindern. Alternativ kann `batterymode` konfiguriert werden und eine externe Steuerung übernimmt die Kontrolle über die Entladung bzw. Ladung der Batterie basierend auf dem von EVCC übermittelten Modus. Wenn `soc` und `limitsoc` konfiguriert sind wird `batterymode` ignoriert. +::: + ### Demobatterie diff --git "a/docs/devices/meters/_generische_unterst\303\274tzung.mdx" "b/docs/devices/meters/_generische_unterst\303\274tzung.mdx" index 2393a210b..189fa0ebe 100644 --- "a/docs/devices/meters/_generische_unterst\303\274tzung.mdx" +++ "b/docs/devices/meters/_generische_unterst\303\274tzung.mdx" @@ -4,22 +4,30 @@ meters: - name: my_meter type: custom - power: # power (W) - source: # plugin type + power: # Leistung (W) + source: # Plugin Typ # ... - energy: # optional energy (kWh) - source: # plugin type + energy: # optional Energie (kWh) + source: # Plugin Typ # ... - soc: # optional battery soc (%) - source: # plugin type + soc: # optional Batterie SOC (%) + source: # Plugin Typ # ... - currents: # optional currents (A) - - source: # L1 plugin type + currents: # optional Ströme (A) + - source: # L1 Plugin Typ # ... - - source: # L2 plugin type + - source: # L2 Plugin Typ # ... - - source: # L3 plugin type + - source: # L3 Plugin Typ # ... - batterymode: # controllable (1: normal, 2: hold, 3: charge) - source: # plugin type + limitsoc: # optional SOC unteres Limit + source: # Plugin Typ + # ... + batterymode: # optional Batteriemodus (1: normal, 2: hold, 3: charge) + source: # Plugin Typ + # ... ``` + +:::note +`limitsoc` wird von EVCC auf den aktuellen Wert von `soc` gesetzt um ein weiteres Entladen der Batterie z.B. beim Schnelladen zu verhindern. Alternativ kann `batterymode` konfiguriert werden und eine externe Steuerung übernimmt die Kontrolle über die Entladung bzw. Ladung der Batterie basierend auf dem von EVCC übermittelten Modus. Wenn `soc` und `limitsoc` konfiguriert sind wird `batterymode` ignoriert. +::: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/meters.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters.mdx index 0440a6c8a..f81ee032b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/devices/meters.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters.mdx @@ -12114,10 +12114,18 @@ meters: # ... - source: # L3 plugin type # ... - batterymode: # controllable (1: normal, 2: hold, 3: charge) + limitsoc: # optional lower soc limit (%) source: # plugin type + # ... + batterymode: # optional battery mode (1: normal, 2: hold, 3: charge) + source: # plugin type + # ... ``` +:::note +`limitsoc` is set to the current value of 'soc' by EVCC to block further discharge of a battery e.g. for quick charging. Alternatively you can configure `batterymode` and have an external control take care of the charging or discharging of the battery based on the given mode. When `soc` and `limitsoc` are configured `batterymode` will be ignored. +::: + ### Demo battery diff --git a/i18n/en/docusaurus-plugin-content-docs/current/devices/meters/_generic_support.mdx b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters/_generic_support.mdx index 6b161cf33..e2f8dd752 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/devices/meters/_generic_support.mdx +++ b/i18n/en/docusaurus-plugin-content-docs/current/devices/meters/_generic_support.mdx @@ -20,6 +20,14 @@ meters: # ... - source: # L3 plugin type # ... - batterymode: # controllable (1: normal, 2: hold, 3: charge) + limitsoc: # optional lower soc limit (%) source: # plugin type + # ... + batterymode: # optional battery mode (1: normal, 2: hold, 3: charge) + source: # plugin type + # ... ``` + +:::note +`limitsoc` is set to the current value of 'soc' by EVCC to block further discharge of a battery e.g. for quick charging. Alternatively you can configure `batterymode` and have an external control take care of the charging or discharging of the battery based on the given mode. When `soc` and `limitsoc` are configured `batterymode` will be ignored. +:::