diff --git a/docs/reference/configuration/meters.md b/docs/reference/configuration/meters.md index de55e1c17..1dc008bf2 100644 --- a/docs/reference/configuration/meters.md +++ b/docs/reference/configuration/meters.md @@ -8,7 +8,13 @@ _Meters_ (Strommessgeräte) ist eine Liste von in der Hausinstallation vorhanden Wallboxen können intern ein Messgerät eingebaut haben, oder es kann auch extern angeschlossen sein. Falls eine Wallbox ein internes Strommessgerät hat, dann muss in `meters` **kein** Eintrag dafür angelegt werden. Falls die Wallbox keinen solchen Zähler hat, wird evcc den hier konfigurierten und der Wallbox im Ladepunkt unter [`meter`](loadpoints#meter) zugewiesenen Zähler verwenden, oder annehmen dass die eingestellte Ladeleistung auch tatsächlich genutzt wird. -evcc benutzt positive (+) Werte für eingehende Ströme (Netzbezug, PV Erzeugung, Hausbatterie-Entladung) und negative (-) Werte für ausgehende Ströme (Netzeinspeisung, PV Wechselrichter Ruhestrombedarf oder Hausbatterie-Ladung). Jeder anderweitiger Strombedarf, inklusive der Wallbox, ist immer ein positiver (+) Wert. +evcc verwendet eine einheitliche Vorzeichen-Konvention für Leistungs- und Stromwerte (`power`, `powers`, `currents`): + +- **Positiv (+)** für eingehende Energie: Netzbezug, PV-Erzeugung, Hausbatterie-Entladung +- **Negativ (-)** für ausgehende Energie: Netzeinspeisung, PV-Wechselrichter Ruhestrombedarf, Hausbatterie-Ladung +- **Verbraucher** (Wallbox, Aux-Zähler) sind immer **positiv (+)** + +Liefert das Gerät die Werte mit umgekehrtem Vorzeichen, kann dies in der [Plugin-Konfiguration](/docs/devices/plugins) über `scale: -1` korrigiert werden. Die `meters` Konfiguration ist eine Liste von verschiedenen vorhandenen Geräten. @@ -382,6 +388,20 @@ Standard Implementierung, bei welchem die einzelnen Werte über [Plugins](/docs/ ... - source: # Phase 3 Plugin Typ ... + powers: # Leistung (W) pro Phase + - source: # Phase 1 Plugin Typ + ... + - source: # Phase 2 Plugin Typ + ... + - source: # Phase 3 Plugin Typ + ... + voltages: # Spannung (V) pro Phase + - source: # Phase 1 Plugin Typ + ... + - source: # Phase 2 Plugin Typ + ... + - source: # Phase 3 Plugin Typ + ... ... ``` @@ -443,7 +463,7 @@ Dient dazu, den Gesamt-SOC zu ermittlen. #### `currents` -Eine Liste von Plugin Definitionen um die Stromstärke in A pro Phase zurückzugeben +Eine Liste von Plugin Definitionen um die Stromstärke in A pro Phase zurückzugeben. **Beispiel**: @@ -457,3 +477,41 @@ Eine Liste von Plugin Definitionen um die Stromstärke in A pro Phase zurückzug ... ... ``` + +--- + +#### `powers` + +Eine Liste von Plugin Definitionen um die Leistung in W pro Phase zurückzugeben. + +**Beispiel**: + +```yaml + powers: # Leistung (W) pro Phase + - source: # Phase 1 Plugin Typ + ... + - source: # Phase 2 Plugin Typ + ... + - source: # Phase 3 Plugin Typ + ... + ... +``` + +--- + +#### `voltages` + +Eine Liste von Plugin Definitionen um die Spannung in V pro Phase zurückzugeben. + +**Beispiel**: + +```yaml + voltages: # Spannung (V) pro Phase + - source: # Phase 1 Plugin Typ + ... + - source: # Phase 2 Plugin Typ + ... + - source: # Phase 3 Plugin Typ + ... + ... +``` diff --git a/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/meters.md b/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/meters.md index 42c5f8166..2c2ce056d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/meters.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/reference/configuration/meters.md @@ -8,7 +8,13 @@ _Meters_ (current measurement devices) is a list of devices in the house that ca Chargers may have an integrated meter or it can be externally connected. If a charger has an internal current measurement device, no entry for it needs to be created in `meters`. If the charger doesn't have such a meter, evcc will use the meter configured here and assigned to the charger under [`meters`](loadpoints#meter) in the charging point configuration, or assume that the charging power set is actually being used. -evcc uses positive (+) values for incoming currents (grid consumption, PV generation, house battery discharge) and negative (-) values for outgoing currents (grid feed-in, PV inverter standby consumption, or house battery charging). Any other current consumption, including from the charger, is always a positive (+) value. +evcc uses a consistent sign convention for power and current values (`power`, `powers`, `currents`): + +- **Positive (+)** for incoming energy: grid consumption, PV generation, house battery discharge +- **Negative (-)** for outgoing energy: grid feed-in, PV inverter standby consumption, house battery charging +- **Consumers** (charger, aux meters) are always **positive (+)** + +If the device returns values with the opposite sign, this can be corrected in the [plugin configuration](/docs/devices/plugins) using `scale: -1`. The `meters` configuration is a list of different available devices. @@ -378,6 +384,20 @@ Standard implementation, in which individual values are defined via [plugins](/d ... - source: # Phase 3 Plugin Type ... + powers: # Power (W) per phase + - source: # Phase 1 Plugin Type + ... + - source: # Phase 2 Plugin Type + ... + - source: # Phase 3 Plugin Type + ... + voltages: # Voltage (V) per phase + - source: # Phase 1 Plugin Type + ... + - source: # Phase 2 Plugin Type + ... + - source: # Phase 3 Plugin Type + ... ... ``` @@ -451,3 +471,41 @@ A list of plugin definitions to return current in amperes (A) per phase. ... ... ``` + +--- + +#### `powers` + +A list of plugin definitions to return power in watts (W) per phase. + +**For example**: + +```yaml + powers: # Power (W) per phase + - source: # Phase 1 Plugin Type + ... + - source: # Phase 2 Plugin Type + ... + - source: # Phase 3 Plugin Type + ... + ... +``` + +--- + +#### `voltages` + +A list of plugin definitions to return voltage in volts (V) per phase. + +**For example**: + +```yaml + voltages: # Voltage (V) per phase + - source: # Phase 1 Plugin Type + ... + - source: # Phase 2 Plugin Type + ... + - source: # Phase 3 Plugin Type + ... + ... +```