Ga naar inhoud
slim laden

meters

De lijst meters (meetapparaten) bevat de apparaten in huis die vermogen en energieverbruik, de productie van zonne-energie of het gebruik van de thuisbatterij kunnen meten. Een meter definieert een meetpunt voor energie en kan een fysiek apparaat zijn (bijv. een meter op het netaansluitpunt), een omvormer van het zonnepanelensysteem (AC of DC bij hybride omvormers) of een batterijomvormer.

Laders kunnen een ingebouwde meter hebben of een extern aangesloten meter gebruiken. Als een lader een ingebouwde meter heeft, hoeft daarvoor geen vermelding in meters te worden aangemaakt. Heeft de lader geen eigen meter, dan gebruikt evcc de meter die hier is geconfigureerd en in de configuratie van het laadpunt onder meter aan de lader is toegewezen. Is die er ook niet, dan gaat evcc ervan uit dat het ingestelde laadvermogen daadwerkelijk wordt gebruikt.

evcc gebruikt een consistente tekenconventie voor vermogens- en stroomwaarden (power, powers, currents):

  • Positief (+) voor inkomende energie: netafname, productie van zonne-energie, batterijontlading
  • Negatief (-) voor uitgaande energie: teruglevering, stand-byverbruik van de omvormer van het zonnepanelensysteem, laden van de thuisbatterij
  • Verbruikers (lader, aux-meters) zijn altijd positief (+)

Als het apparaat waarden met het omgekeerde teken levert, kan dit in de pluginconfiguratie worden gecorrigeerd met scale: -1.

De configuratie meters is een lijst van de verschillende beschikbare apparaten.

Voorbeeld:

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

Configuraties voor bekende apparaten vindt u onder Apparaten - Huisinstallatie.

Hieronder worden de verschillende parameters toegelicht.

Verplichte parameters

Section titled “Verplichte parameters”

name

Section titled “name”

Een korte aanduiding van de meter. De waarde wordt gebruikt om naar het apparaat te verwijzen in de configuratie van de locatie of van het laadpunt.

Voorbeeld:

name: charger1

type

Section titled “type”

Dit is het evcc-specifieke metertype waarmee met het apparaat wordt gecommuniceerd. Het passende type voor bekende apparaten vindt u onder Apparaten - Huisinstallatie.

Voorbeeld:

type: modbus

De verschillende mogelijke types en hun aanvullende parameters zijn hieronder beschreven:

Ondersteunde types

Section titled “Ondersteunde types”

movingaverage

Section titled “movingaverage”

Dit metertype kan schommelende meterwaarden afvlakken. Het kan voor elk gebruik van een meter (usage) worden ingezet. De parameter decay geeft aan welk percentage van de nieuwe waarde in de berekening wordt meegenomen.

Voorbeeld:

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

In dit voorbeeld wordt 10% van de nieuwe waarde meegenomen. Na 10 cycli valt de oudste waarde uit de berekening. Hoe lang dit duurt, hangt af van het interval.

modbus

Section titled “modbus”

Apparaten die via de Modbus-interface zijn aangesloten en door het project MBMD (ModBus Measurement Daemon) worden ondersteund.

Voorbeeld:

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

Verplichte parameters

Section titled “Verplichte parameters”

Naast de hier gedefinieerde parameters zijn nog andere parameters nodig. Deze staan in de documentatie over Modbus.

power
Section titled “power”

Definieert de MBMD-meetwaarde die het vermogen levert, meestal Power.

Voorbeeld:

power: Power
energy
Section titled “energy”

Definieert de MBMD-meetwaarde die de energie levert, meestal Sum.

Voorbeeld:

energy: Sum

Optionele parameters

Section titled “Optionele parameters”
soc
Section titled “soc”

Definieert de MBMD-meetwaarde die het laadniveau van de batterij levert, meestal ChargeState.

Voorbeeld:

soc: ChargeState

lgess

Section titled “lgess”

Apparaten van het type LG ESS Home 8/10.

Voorbeeld:

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

Verplichte parameters

Section titled “Verplichte parameters”
usage
Section titled “usage”

Definieert welke metingen hier nodig zijn.

Mogelijke waarden:

  • grid: voor metingen op het netaansluitpunt
  • pv: voor metingen van de productie van zonne-energie
  • battery: voor metingen van de thuisbatterij
uri
Section titled “uri”

Definieert de URL van het LG ESS-apparaat in het thuisnetwerk.

Voorbeeld:

uri: https://192.0.2.2/
password
Section titled “password”

Hier moet het registratienummer van de LG ESS HOME-omvormer worden ingevuld.

Voorbeeld:

password: "DE200..."

openwb

Section titled “openwb”

Gebruikt de metingen van een OpenWB-lader.

Voorbeeld:

type: openwb
usage: grid
broker: 192.0.2.2

Verplichte parameters

Section titled “Verplichte parameters”
usage
Section titled “usage”

Definieert welke metingen hier nodig zijn.

Mogelijke waarden:

  • grid: voor metingen op het netaansluitpunt
  • pv: voor metingen van de productie van zonne-energie
  • battery: voor metingen van de thuisbatterij
broker
Section titled “broker”

Definieert de hostnaam of het IP-adres en de poort van de OpenWB in het thuisnetwerk.

Voorbeeld:

broker: 192.0.2.2:1883

sma

Section titled “sma”

Voor het gebruik van de SMA Home Manager 2.0, de SMA Energy Meter of een SMA-omvormer. De apparaten moeten het Speedwire-protocol ondersteunen.

Voorbeeld:

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

Verplichte parameters

Section titled “Verplichte parameters”
uri
Section titled “uri”

Definieert de hostnaam of het IP-adres van het apparaat in het thuisnetwerk.

Voorbeeld:

uri: 192.0.2.2
serial
Section titled “serial”

Definieert het serienummer van het apparaat waarvan metingen moeten worden ontvangen.

Voorbeeld:

serial: 12345678

Optionele parameters

Section titled “Optionele parameters”
interface
Section titled “interface”

Multicastberichten kunnen alleen op een bepaalde netwerkinterface worden ontvangen. Meestal is dat de eerste interface van het systeem. Als dat niet de interface is die met de meter is verbonden, moet de interface expliciet worden opgegeven.

Voorbeeld:

interface: eth0

tesla

Section titled “tesla”

tesla: voor het gebruik van metingen van een Tesla Powerwall.

Voorbeeld:

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

Verplichte parameters

Section titled “Verplichte parameters”
usage
Section titled “usage”

Definieert welke metingen hier nodig zijn.

Mogelijke waarden:

  • grid: voor metingen op het netaansluitpunt
  • pv: voor metingen van de productie van zonne-energie
  • battery: voor metingen van de thuisbatterij
uri
Section titled “uri”

Definieert de hostnaam of het IP-adres van het apparaat in het thuisnetwerk.

Voorbeeld:

uri: 192.0.2.2
password
Section titled “password”

Hier moet het wachtwoord van de gebruiker customer worden ingevuld.

Voorbeeld:

password: "ThePassword"

custom

Section titled “custom”

Standaardimplementatie waarbij de afzonderlijke waarden via plugins worden gedefinieerd.

Voorbeeld:

  type: custom
  power: # Vermogen (W)
    source: # Plugintype
    ...
  energy: # Energie (kWh)
    source: # Plugintype
    ...
  returnenergy: # Energie in omgekeerde richting (kWh)
    source: # Plugintype
    ...
  soc: # Laadniveau batterij (%)
    source: # Plugintype
    ...
  capacity: # Optionele batterijcapaciteit (kWh)
  currents: # Stroom (A) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  powers: # Vermogen (W) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  voltages: # Spanning (V) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  ...

Verplichte parameters

Section titled “Verplichte parameters”
power
Section titled “power”

Plugindefinitie die het vermogen in watt (W) levert.

Voorbeeld:

  power: ... # Vermogen (W)
    source: # Plugintype
    ...

Optionele parameters

Section titled “Optionele parameters”
energy
Section titled “energy”

Plugindefinitie die de verbruikte energie in kilowattuur (kWh) levert.

Voorbeeld:

  energy: ... # Energie (kWh)
    source: # Plugintype
    ...
returnenergy
Section titled “returnenergy”

Plugindefinitie die de energie in omgekeerde richting in kilowattuur (kWh) levert, bijv. teruglevering.

Voorbeeld:

  returnenergy: ... # Energie in omgekeerde richting (kWh)
    source: # Plugintype
    ...

soc

Section titled “soc”

Plugindefinitie die het laadniveau van de batterij in procent (%) levert.

Voorbeeld:

  soc: ... # Laadniveau batterij (%)
    source: # Plugintype
    ...

capacity

Section titled “capacity”

De capaciteit van de batterij. Dit is alleen zinvol als er meerdere batterijen zijn. De waarde wordt dan gebruikt om het totale laadniveau te berekenen.

currents

Section titled “currents”

Een lijst van plugindefinities die de stroom in ampère (A) per fase leveren.

Voorbeeld:

  currents: # Stroom (A) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  ...

powers

Section titled “powers”

Een lijst van plugindefinities die het vermogen in watt (W) per fase leveren.

Voorbeeld:

  powers: # Vermogen (W) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  ...

voltages

Section titled “voltages”

Een lijst van plugindefinities die de spanning in volt (V) per fase leveren.

Voorbeeld:

  voltages: # Spanning (V) per fase
    - source: # Plugintype fase 1
      ...
    - source: # Plugintype fase 2
      ...
    - source: # Plugintype fase 3
      ...
  ...