meters
Målere (elmålere) er en liste over enheder i huset, der kan måle effekt- og energiforbrug, solproduktion eller brugen af hjemmebatteriet. En meter definerer et målepunkt for energi og kan være en fysisk enhed (f.eks. en måler ved tilslutningspunktet til elnettet), en solcelleinverter (AC eller DC ved hybridinvertere) eller en batteriinverter.
Opladere kan have en indbygget måler, eller der kan tilsluttes en ekstern. Hvis en oplader har en indbygget måler, behøver der ikke at blive oprettet en post til den under meters. Hvis opladeren ikke har en sådan måler, bruger evcc den måler, der er konfigureret her og tildelt opladeren under meter i konfigurationen af ladepunktet, eller går ud fra, at den indstillede ladeeffekt faktisk bliver brugt.
evcc bruger en ensartet fortegnskonvention for effekt- og strømværdier (power, powers, currents):
- Positiv (+) for indgående energi: import fra elnettet, solproduktion, batteriafladning
- Negativ (-) for udgående energi: eksport til elnettet, solcelleinverterens standbyforbrug, batteriopladning
- Forbrugsenheder (oplader, aux-målere) er altid positive (+)
Hvis enheden leverer værdier med modsat fortegn, kan det rettes i plugin-konfigurationen med scale: -1.
meters-konfigurationen er en liste over forskellige tilgængelige enheder.
Eksempel:
meters: - name: grid type: ... - name: pv type: ... - name: battery type: ... - name: charge type: ... - name: aux type: ...Konfigurationer til kendte enheder finder du under Enheder - Hjemmeinstallation.
Nedenfor forklares de forskellige parametre.
Påkrævede parametre
Sektion kaldt “Påkrævede parametre”En kort betegnelse for måleren. Værdien bruges, når der henvises til enheden i konfigurationen af anlægget eller ladepunktet.
Eksempel:
name: charger1Dette er den evcc-specifikke målertype, der muliggør kommunikationen med enheden. Den passende type til kendte enheder finder du under Enheder - Hjemmeinstallation.
Eksempel:
type: modbusDe forskellige mulige typer og deres yderligere parametre er dokumenteret nedenfor:
Understøttede typer
Sektion kaldt “Understøttede typer”movingaverage
Sektion kaldt “movingaverage”Denne målertype kan udjævne svingende måleværdier. Den kan bruges i alle måleranvendelser (usage). Parameteren decay angiver, hvor stor en procentdel af den nye værdi der indgår i beregningen.
Eksempel:
meters:- name: grid type: movingaverage decay: 0.1 meter: type: template template: solarlog usage: grid host: 192.0.2.2 ...I dette eksempel indgår 10 % af den nye værdi. Efter 10 cyklusser er den ældste værdi fjernet fra beregningen. Hvor lang tid det tager, afhænger af interval.
modbus
Sektion kaldt “modbus”Enheder, der er tilsluttet via Modbus-grænsefladen og understøttes af projektet MBMD (ModBus Measurement Daemon).
Eksempel:
type: modbus power: Power energy: Sum soc: ChargeState ...Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Ud over de parametre, der er defineret her, kræves yderligere parametre. De er beskrevet i Modbus-dokumentationen.
Definerer den MBMD-måleværdi, der leverer effekten, typisk Power.
Eksempel:
power: Powerenergy
Sektion kaldt “energy”Definerer den MBMD-måleværdi, der leverer energien, typisk Sum.
Eksempel:
energy: SumValgfrie parametre
Sektion kaldt “Valgfrie parametre”Definerer den MBMD-måleværdi, der leverer batteriets opladningsniveau, typisk ChargeState.
Eksempel:
soc: ChargeStateLG ESS Home 8/10-enheder.
Eksempel:
type: lgessusage: griduri: https://192.0.2.2/password: "DE200..."Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Definerer, hvilke målinger der skal bruges her.
Mulige værdier:
grid: til målinger ved tilslutningspunktet til elnettetpv: til målinger af solproduktionenbattery: til målinger af hjemmebatteriet
Definerer URL’en til LG ESS-enheden i hjemmenetværket.
Eksempel:
uri: https://192.0.2.2/password
Sektion kaldt “password”Her skal registreringsnummeret for LG ESS HOME-inverteren indtastes.
Eksempel:
password: "DE200..."openwb
Sektion kaldt “openwb”Til brug af målinger fra en OpenWB-oplader.
Eksempel:
type: openwbusage: gridbroker: 192.0.2.2Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Definerer, hvilke målinger der skal bruges her.
Mulige værdier:
grid: til målinger ved tilslutningspunktet til elnettetpv: til målinger af solproduktionenbattery: til målinger af hjemmebatteriet
broker
Sektion kaldt “broker”Definerer værtsnavnet eller IP-adressen og porten for OpenWB i hjemmenetværket.
Eksempel:
broker: 192.0.2.2:1883Til brug af SMA Home Manager 2.0, SMA Energy Meter eller en SMA-inverter. Enhederne skal understøtte Speedwire-protokollen.
Eksempel:
type: smauri: 192.0.2.2serial: 12345678interface: eth0Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Definerer enhedens værtsnavn eller IP-adresse i hjemmenetværket.
Eksempel:
uri: 192.0.2.2serial
Sektion kaldt “serial”Definerer serienummeret på den enhed, som målingerne skal modtages fra.
Eksempel:
serial: 12345678Valgfrie parametre
Sektion kaldt “Valgfrie parametre”interface
Sektion kaldt “interface”Multicast-meddelelser kan kun modtages på en bestemt netværksgrænseflade. Normalt er det systemets første grænseflade. Hvis det ikke er den grænseflade, der er forbundet med måleren, skal grænsefladen angives eksplicit.
Eksempel:
interface: eth0tesla: Til brug af målinger fra en Tesla Powerwall.
Eksempel:
type: teslausage: griduri: https://192.0.2.2/password: "***"Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Definerer, hvilke målinger der skal bruges her.
Mulige værdier:
grid: til målinger ved tilslutningspunktet til elnettetpv: til målinger af solproduktionenbattery: til målinger af hjemmebatteriet
Definerer enhedens værtsnavn eller IP-adresse i hjemmenetværket.
Eksempel:
uri: 192.0.2.2password
Sektion kaldt “password”Her skal adgangskoden til brugeren customer indtastes.
Eksempel:
password: "ThePassword"custom
Sektion kaldt “custom”Standardimplementering, hvor de enkelte værdier defineres via plugins.
Eksempel:
type: custom power: # Effekt (W) source: # Plugin-type ... energy: # Energi (kWh) source: # Plugin-type ... returnenergy: # Energi i modsat retning (kWh) source: # Plugin-type ... soc: # Batteriets opladningsniveau (%) source: # Plugin-type ... capacity: # Valgfri batterikapacitet (kWh) currents: # Strøm (A) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... powers: # Effekt (W) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... voltages: # Spænding (V) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... ...Påkrævede parametre
Sektion kaldt “Påkrævede parametre”Plugin-definition, der leverer effekten i watt (W).
Eksempel:
power: ... # Effekt (W) source: # Plugin-type ...Valgfrie parametre
Sektion kaldt “Valgfrie parametre”energy
Sektion kaldt “energy”Plugin-definition, der leverer den forbrugte energi i kilowatttimer (kWh).
Eksempel:
energy: ... # Energi (kWh) source: # Plugin-type ...returnenergy
Sektion kaldt “returnenergy”Plugin-definition, der leverer energien i modsat retning i kilowatttimer (kWh), f.eks. eksport til elnettet.
Eksempel:
returnenergy: ... # Energi i modsat retning (kWh) source: # Plugin-type ...Plugin-definition, der leverer batteriets opladningsniveau i procent (%).
Eksempel:
soc: ... # Batteriets opladningsniveau (%) source: # Plugin-type ...capacity
Sektion kaldt “capacity”Angivelse af batteriets kapacitet. Kun relevant, når der er flere batterier. Bruges til at bestemme det samlede opladningsniveau.
currents
Sektion kaldt “currents”En liste med plugin-definitioner, der leverer strømmen i ampere (A) pr. fase.
Eksempel:
currents: # Strøm (A) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... ...powers
Sektion kaldt “powers”En liste med plugin-definitioner, der leverer effekten i watt (W) pr. fase.
Eksempel:
powers: # Effekt (W) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... ...voltages
Sektion kaldt “voltages”En liste med plugin-definitioner, der leverer spændingen i volt (V) pr. fase.
Eksempel:
voltages: # Spænding (V) pr. fase - source: # Fase 1: plugin-type ... - source: # Fase 2: plugin-type ... - source: # Fase 3: plugin-type ... ...