Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
62 changes: 60 additions & 2 deletions docs/reference/configuration/meters.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
...
...
```

Expand Down Expand Up @@ -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**:

Expand All @@ -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
...
...
```
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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
...
...
```

Expand Down Expand Up @@ -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
...
...
```
Loading