Zum Inhalt springen
Smart laden

meters

Unter meters (Zähler) steht eine Liste von Geräten im Haus, die Leistung und Energie messen können, etwa für den Verbrauch, die PV-Erzeugung oder die Hausbatterie. Ein meter definiert einen Messpunkt für Energie und kann ein physisches Gerät sein (z. B. ein Zähler am Netzanschlusspunkt), ein PV-Wechselrichter (AC oder bei Hybridwechselrichtern auch DC) oder ein Batteriewechselrichter.

Wallboxen können einen eingebauten Zähler haben, oder der Zähler wird extern angeschlossen. Hat eine Wallbox einen internen Zähler, muss dafür in meters kein Eintrag angelegt werden. Hat die Wallbox keinen solchen Zähler, verwendet evcc den hier definierten Zähler, den du der Wallbox in der Ladepunkt-Konfiguration unter meter zuweist. Ohne Zähler nimmt evcc an, dass die eingestellte Ladeleistung auch tatsächlich genutzt wird.

evcc verwendet eine einheitliche Vorzeichenkonvention für Leistungs- und Stromwerte (power, powers, currents):

  • Positiv (+) für eingehende Energie: Netzbezug, PV-Erzeugung, Entladung der Hausbatterie
  • Negativ (-) für ausgehende Energie: Einspeisung, Standby-Verbrauch des PV-Wechselrichters, Ladung der Hausbatterie
  • Verbraucher (Wallbox, Aux-Zähler) sind immer positiv (+)

Liefert das Gerät die Werte mit umgekehrtem Vorzeichen, kann das in der Plugin-Konfiguration über scale: -1 korrigiert werden.

Die meters-Konfiguration ist eine Liste der vorhandenen Geräte.

Beispiel:

meters:
- name: grid
type: ...
- name: pv
type: ...
- name: battery
type: ...
- name: charge
type: ...
- name: aux
type: ...

Konfigurationen für bekannte Geräte findest du unter Geräte – Hausinstallation.

Im Folgenden werden die verschiedenen Parameter erklärt.


Eine Kurzbezeichnung des Zählers. Über diesen Wert wird in der Konfiguration des Standorts oder des Ladepunkts auf das Gerät verwiesen.

Beispiel:

name: wallbox1

Der evcc-spezifische Zählertyp, über den die Kommunikation mit dem Gerät läuft. Den passenden Typ für bekannte Geräte findest du unter Geräte – Hausinstallation.

Beispiel:

type: modbus

Im Folgenden sind die verschiedenen möglichen Typen und ihre weiteren Parameter dokumentiert:


Mit diesem Zählertyp lassen sich schwankende Messwerte glätten. Er funktioniert mit jeder Verwendung (usage). Der Parameter decay gibt an, mit wie viel Prozent der neue Wert in die Berechnung einfließt.

Beispiel:

meters:
- name: grid
type: movingaverage
decay: 0.1
meter:
type: template
template: solarlog
usage: grid
host: 192.0.2.2
...

In diesem Beispiel fließen 10% des neuen Werts ein. Nach 10 Zyklen fällt der älteste Wert aus der Berechnung heraus. Wie lange das dauert, hängt vom interval ab.


Geräte, die über die Modbus-Schnittstelle angebunden sind und vom Projekt MBMD (ModBus Measurement Daemon) unterstützt werden.

Beispiel:

type: modbus
power: Power
energy: Sum
soc: ChargeState
...

Zusätzlich zu den hier beschriebenen Parametern sind weitere Parameter notwendig. Diese sind in der Modbus-Dokumentation aufgeführt.

Definiert den MBMD-Messwert, der die Leistung liefert, typischerweise Power.

Beispiel:

power: Power

Definiert den MBMD-Messwert, der die Energie liefert, typischerweise Sum.

Beispiel:

energy: Sum

Definiert den MBMD-Messwert, der den Ladestand der Batterie liefert, typischerweise ChargeState.

Beispiel:

soc: ChargeState

Geräte vom Typ LG ESS Home 8/10.

Beispiel:

type: lgess
usage: grid
uri: https://192.0.2.2/
password: "DE200..."

Definiert, welche Messwerte hier benötigt werden.

Mögliche Werte:

  • grid: Für Messwerte am Netzanschlusspunkt
  • pv: Für Messwerte der PV-Erzeugung
  • battery: Für Messwerte der Hausbatterie

Definiert die URL des LG-ESS-Geräts im Heimnetzwerk.

Beispiel:

uri: https://192.0.2.2/

Hier muss die Registriernummer des Wechselrichters LG ESS HOME eingetragen werden.

Beispiel:

password: "DE200..."

Verwendet die Messwerte einer openWB-Wallbox.

Beispiel:

type: openwb
usage: grid
broker: 192.0.2.2

Definiert, welche Messwerte hier benötigt werden.

Mögliche Werte:

  • grid: Für Messwerte am Netzanschlusspunkt
  • pv: Für Messwerte der PV-Erzeugung
  • battery: Für Messwerte der Hausbatterie

Definiert den Hostnamen oder die IP-Adresse und den Port der openWB im Heimnetzwerk.

Beispiel:

broker: 192.0.2.2:1883

Für die Verwendung des SMA Home Managers 2.0, des SMA Energy Meters oder eines SMA-Wechselrichters. Die Geräte müssen das Speedwire-Protokoll unterstützen.

Beispiel:

type: sma
uri: 192.0.2.2
serial: 12345678
interface: eth0

Definiert den Hostnamen oder die IP-Adresse des Geräts im Heimnetzwerk.

Beispiel:

uri: 192.0.2.2

Definiert die Seriennummer des Geräts, von dem Messwerte empfangen werden sollen.

Beispiel:

serial: 12345678

Multicast-Nachrichten können nur auf einer bestimmten Netzwerkschnittstelle empfangen werden. Üblicherweise ist das die erste Schnittstelle im System. Ist das nicht die Schnittstelle, die mit dem Zähler verbunden ist, muss sie explizit angegeben werden.

Beispiel:

interface: eth0

tesla: Für die Verwendung der Messwerte einer Tesla Powerwall.

Beispiel:

type: tesla
usage: grid
uri: https://192.0.2.2/
password: "***"

Definiert, welche Messwerte hier benötigt werden.

Mögliche Werte:

  • grid: Für Messwerte am Netzanschlusspunkt
  • pv: Für Messwerte der PV-Erzeugung
  • battery: Für Messwerte der Hausbatterie

Definiert den Hostnamen oder die IP-Adresse des Geräts im Heimnetzwerk.

Beispiel:

uri: 192.0.2.2

Hier muss das Passwort für den Benutzer customer eingetragen werden.

Beispiel:

password: "DasPasswort"

Generische Implementierung, bei der die einzelnen Werte über Plugins definiert werden.

Beispiel:

type: custom
power: # Leistung (W)
source: # Plugin-Typ
...
energy: # Energie (kWh)
source: # Plugin-Typ
...
returnenergy: # Energie in Gegenrichtung (kWh)
source: # Plugin-Typ
...
soc: # Ladestand der Batterie (%)
source: # Plugin-Typ
...
capacity: # optional: Batteriekapazität (kWh)
currents: # Strom (A) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
powers: # Leistung (W) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
voltages: # Spannung (V) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
...

Plugin-Definition, die die Leistung in Watt (W) liefert.

Beispiel:

power: ... # Leistung (W)
source: # Plugin-Typ
...

Plugin-Definition, die die verbrauchte Energie in Kilowattstunden (kWh) liefert.

Beispiel:

energy: ... # Energie (kWh)
source: # Plugin-Typ
...

Plugin-Definition, die die Energie in Gegenrichtung in Kilowattstunden (kWh) liefert, z. B. die Einspeisung.

Beispiel:

returnenergy: ... # Energie in Gegenrichtung (kWh)
source: # Plugin-Typ
...

Plugin-Definition, die den Ladestand der Batterie in Prozent (%) liefert.

Beispiel:

soc: ... # Ladestand der Batterie (%)
source: # Plugin-Typ
...

Batteriekapazität in kWh. Sie dient dazu, den Gesamtladestand mehrerer Batterien zu ermitteln, und wird vom Optimizer genutzt, um das Laden der Batterie zu planen. Statt eines festen Werts kann jedes Float-Plugin die Kapazität aus dem Gerät auslesen. Der Wert wird einmal nach dem Start ausgelesen und danach beibehalten. Bis zum ersten erfolgreichen Auslesen gilt die Kapazität als unbekannt.

Beispiel:

capacity: # aus dem Gerät gelesen statt fester Wert
source: modbus
...

Eine Liste von Plugin-Definitionen, die den Strom in Ampere (A) pro Phase liefern.

Beispiel:

currents: # Strom (A) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
...

Eine Liste von Plugin-Definitionen, die die Leistung in Watt (W) pro Phase liefern.

Beispiel:

powers: # Leistung (W) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
...

Eine Liste von Plugin-Definitionen, die die Spannung in Volt (V) pro Phase liefern.

Beispiel:

voltages: # Spannung (V) pro Phase
- source: # Plugin-Typ Phase 1
...
- source: # Plugin-Typ Phase 2
...
- source: # Plugin-Typ Phase 3
...
...