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.
Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Eine Kurzbezeichnung des Zählers. Über diesen Wert wird in der Konfiguration des Standorts oder des Ladepunkts auf das Gerät verwiesen.
Beispiel:
name: wallbox1Der 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: modbusIm Folgenden sind die verschiedenen möglichen Typen und ihre weiteren Parameter dokumentiert:
Unterstützte Typen
Abschnitt betitelt „Unterstützte Typen“movingaverage
Abschnitt betitelt „movingaverage“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 ...Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“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: PowerDefiniert den MBMD-Messwert, der die Energie liefert, typischerweise Sum.
Beispiel:
energy: SumOptionale Parameter
Abschnitt betitelt „Optionale Parameter“Definiert den MBMD-Messwert, der den Ladestand der Batterie liefert, typischerweise ChargeState.
Beispiel:
soc: ChargeStateGeräte vom Typ LG ESS Home 8/10.
Beispiel:
type: lgessusage: griduri: https://192.0.2.2/password: "DE200..."Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Definiert, welche Messwerte hier benötigt werden.
Mögliche Werte:
grid: Für Messwerte am Netzanschlusspunktpv: Für Messwerte der PV-Erzeugungbattery: Für Messwerte der Hausbatterie
Definiert die URL des LG-ESS-Geräts im Heimnetzwerk.
Beispiel:
uri: https://192.0.2.2/password
Abschnitt betitelt „password“Hier muss die Registriernummer des Wechselrichters LG ESS HOME eingetragen werden.
Beispiel:
password: "DE200..."Verwendet die Messwerte einer openWB-Wallbox.
Beispiel:
type: openwbusage: gridbroker: 192.0.2.2Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Definiert, welche Messwerte hier benötigt werden.
Mögliche Werte:
grid: Für Messwerte am Netzanschlusspunktpv: Für Messwerte der PV-Erzeugungbattery: 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:1883Fü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: smauri: 192.0.2.2serial: 12345678interface: eth0Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Definiert den Hostnamen oder die IP-Adresse des Geräts im Heimnetzwerk.
Beispiel:
uri: 192.0.2.2Definiert die Seriennummer des Geräts, von dem Messwerte empfangen werden sollen.
Beispiel:
serial: 12345678Optionale Parameter
Abschnitt betitelt „Optionale Parameter“interface
Abschnitt betitelt „interface“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: eth0tesla: Für die Verwendung der Messwerte einer Tesla Powerwall.
Beispiel:
type: teslausage: griduri: https://192.0.2.2/password: "***"Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Definiert, welche Messwerte hier benötigt werden.
Mögliche Werte:
grid: Für Messwerte am Netzanschlusspunktpv: Für Messwerte der PV-Erzeugungbattery: Für Messwerte der Hausbatterie
Definiert den Hostnamen oder die IP-Adresse des Geräts im Heimnetzwerk.
Beispiel:
uri: 192.0.2.2password
Abschnitt betitelt „password“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 ... ...Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Plugin-Definition, die die Leistung in Watt (W) liefert.
Beispiel:
power: ... # Leistung (W) source: # Plugin-Typ ...Optionale Parameter
Abschnitt betitelt „Optionale Parameter“Plugin-Definition, die die verbrauchte Energie in Kilowattstunden (kWh) liefert.
Beispiel:
energy: ... # Energie (kWh) source: # Plugin-Typ ...returnenergy
Abschnitt betitelt „returnenergy“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 ...capacity
Abschnitt betitelt „capacity“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 ...currents
Abschnitt betitelt „currents“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 ... ...voltages
Abschnitt betitelt „voltages“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 ... ...