meters
Měřiče (elektroměry) jsou zařízení v domě, která dokážou měřit výkon a spotřebu energie, výrobu ze soláru nebo využití domácí baterie. meter definuje bod měření energie a může jít o fyzické zařízení (např. měřič v předávacím místě sítě), solární střídač (AC, nebo u hybridních střídačů DC) nebo bateriový střídač.
Nabíječky mohou mít integrovaný měřič, nebo může být měřič připojen externě. Pokud má nabíječka vlastní měřič, není pro ni potřeba vytvářet záznam v meters. Pokud nabíječka takový měřič nemá, použije evcc měřič nakonfigurovaný zde a přiřazený nabíječce v konfiguraci nabíjecího bodu pod meter, nebo předpokládá, že se nastavený nabíjecí výkon skutečně odebírá.
evcc používá pro hodnoty výkonu a proudu (power, powers, currents) jednotnou znaménkovou konvenci:
- Kladné (+) pro energii, která přichází: odběr ze sítě, výroba ze soláru, vybíjení domácí baterie
- Záporné (-) pro energii, která odchází: export do sítě, pohotovostní spotřeba solárního střídače, nabíjení domácí baterie
- Spotřebiče (nabíječka, pomocné měřiče) jsou vždy kladné (+)
Pokud zařízení vrací hodnoty s opačným znaménkem, lze to opravit v konfiguraci pluginu pomocí scale: -1.
Konfigurace meters je seznam různých dostupných zařízení.
Příklad:
meters: - name: grid type: ... - name: pv type: ... - name: battery type: ... - name: charge type: ... - name: aux type: ...Konfigurace známých zařízení najdete v části Zařízení – domácí instalace.
Níže jsou vysvětleny jednotlivé parametry.
Povinné parametry
Sekce “Povinné parametry”name
Sekce “name”Krátké označení měřiče. Hodnota se používá při odkazování na zařízení v konfiguraci lokality nebo nabíjecího bodu.
Příklad:
name: charger1type
Sekce “type”Typ, přes který evcc s měřičem komunikuje. Vhodný typ pro známá zařízení najdete v části Zařízení – domácí instalace.
Příklad:
type: modbusJednotlivé možné typy a jejich další parametry jsou popsány níže:
Podporované typy
Sekce “Podporované typy”movingaverage
Sekce “movingaverage”Tento typ měřiče dokáže vyhladit kolísající naměřené hodnoty. Lze ho použít pro všechna využití měřiče (usage). Parametr decay udává, kolik procent nové hodnoty se započítá do výpočtu.
Příklad
meters:- name: grid type: movingaverage decay: 0.1 meter: type: template template: solarlog usage: grid host: 192.0.2.2 ...V tomto příkladu se započítá 10 % nové hodnoty. Po 10 cyklech se nejstarší hodnota z výpočtu odstraní. Jak dlouho to trvá, závisí na interval.
modbus
Sekce “modbus”Zařízení připojená přes rozhraní Modbus a podporovaná projektem MBMD (ModBus Measurement Daemon).
Příklad:
type: modbus power: Power energy: Sum soc: ChargeState ...Povinné parametry
Sekce “Povinné parametry”Kromě zde definovaných parametrů jsou nutné další parametry. Jsou uvedeny v dokumentaci Modbus.
power
Sekce “power”Definuje naměřenou hodnotu MBMD pro výkon, obvykle Power.
Příklad:
power: Powerenergy
Sekce “energy”Definuje naměřenou hodnotu MBMD pro energii, obvykle Sum.
Příklad:
energy: SumVolitelné parametry
Sekce “Volitelné parametry”soc
Sekce “soc”Definuje naměřenou hodnotu MBMD pro stav nabití baterie, obvykle ChargeState.
Příklad:
soc: ChargeStatelgess
Sekce “lgess”Zařízení LG ESS Home 8/10.
Příklad:
type: lgessusage: griduri: https://192.0.2.2/password: "DE200..."Povinné parametry
Sekce “Povinné parametry”usage
Sekce “usage”Definuje, která měření jsou zde potřeba.
Možné hodnoty:
grid: pro měření v předávacím místě sítěpv: pro měření výroby ze solárubattery: pro měření domácí baterie
uri
Sekce “uri”Definuje URL zařízení LG ESS v domácí síti.
Příklad:
uri: https://192.0.2.2/password
Sekce “password”Sem je potřeba zadat registrační číslo střídače LG ESS HOME.
Příklad:
password: "DE200..."openwb
Sekce “openwb”Použití měření z nabíječky OpenWB
Příklad:
type: openwbusage: gridbroker: 192.0.2.2Povinné parametry
Sekce “Povinné parametry”usage
Sekce “usage”Definuje, která měření jsou zde potřeba.
Možné hodnoty:
grid: pro měření v předávacím místě sítěpv: pro měření výroby ze solárubattery: pro měření domácí baterie
broker
Sekce “broker”Definuje název hostitele nebo IP adresu a port zařízení OpenWB v domácí síti.
Příklad:
broker: 192.0.2.2:1883sma
Sekce “sma”Pro použití SMA Home Manageru 2.0, SMA Energy Meteru nebo střídače SMA. Zařízení musí podporovat protokol Speedwire.
Příklad:
type: smauri: 192.0.2.2serial: 12345678interface: eth0Povinné parametry
Sekce “Povinné parametry”uri
Sekce “uri”Definuje název hostitele nebo IP adresu zařízení v domácí síti.
Příklad:
uri: 192.0.2.2serial
Sekce “serial”Definuje sériové číslo zařízení, ze kterého se mají přijímat měření.
Příklad:
serial: 12345678Volitelné parametry
Sekce “Volitelné parametry”interface
Sekce “interface”Multicastové zprávy lze přijímat pouze na jednom konkrétním síťovém rozhraní. Obvykle je to první rozhraní v systému. Pokud to není rozhraní připojené k měřiči, je potřeba rozhraní zadat explicitně.
Příklad:
interface: eth0tesla
Sekce “tesla”tesla: Pro měření ze zařízení Tesla Powerwall.
Příklad:
type: teslausage: griduri: https://192.0.2.2/password: "***"Povinné parametry
Sekce “Povinné parametry”usage
Sekce “usage”Definuje, která měření jsou zde potřeba.
Možné hodnoty:
grid: pro měření v předávacím místě sítěpv: pro měření výroby ze solárubattery: pro měření domácí baterie
uri
Sekce “uri”Definuje název hostitele nebo IP adresu zařízení v domácí síti.
Příklad:
uri: 192.0.2.2password
Sekce “password”Sem je potřeba zadat heslo uživatele customer.
Příklad:
password: "ThePassword"custom
Sekce “custom”Standardní implementace, u které se jednotlivé hodnoty definují pomocí pluginů.
Příklad:
type: custom power: # Výkon (W) source: # Typ pluginu ... energy: # Energie (kWh) source: # Typ pluginu ... returnenergy: # Energie v opačném směru (kWh) source: # Typ pluginu ... soc: # Stav nabití baterie (%) source: # Typ pluginu ... capacity: # Volitelná kapacita baterie (kWh) currents: # Proud (A) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... powers: # Výkon (W) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... voltages: # Napětí (V) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... ...Povinné parametry
Sekce “Povinné parametry”power
Sekce “power”Definice pluginu, který vrací výkon ve wattech (W).
Příklad:
power: ... # Výkon (W) source: # Typ pluginu ...Volitelné parametry
Sekce “Volitelné parametry”energy
Sekce “energy”Definice pluginu, který vrací spotřebovanou energii v kilowatthodinách (kWh).
Příklad:
energy: ... # Energie (kWh) source: # Typ pluginu ...returnenergy
Sekce “returnenergy”Definice pluginu, který vrací energii v opačném směru v kilowatthodinách (kWh), např. export do sítě.
Příklad:
returnenergy: ... # Energie v opačném směru (kWh) source: # Typ pluginu ...soc
Sekce “soc”Definice pluginu, který vrací stav nabití baterie v procentech (%).
Příklad:
soc: ... # Stav nabití baterie (%) source: # Typ pluginu ...capacity
Sekce “capacity”Údaj o kapacitě baterie. Má smysl pouze při více bateriích. Slouží k určení celkového stavu nabití.
currents
Sekce “currents”Seznam definic pluginů, které vracejí proud v ampérech (A) pro každou fázi.
Příklad:
currents: # Proud (A) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... ...powers
Sekce “powers”Seznam definic pluginů, které vracejí výkon ve wattech (W) pro každou fázi.
Příklad:
powers: # Výkon (W) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... ...voltages
Sekce “voltages”Seznam definic pluginů, které vracejí napětí ve voltech (V) pro každou fázi.
Příklad:
voltages: # Napětí (V) na fázi - source: # Typ pluginu pro fázi 1 ... - source: # Typ pluginu pro fázi 2 ... - source: # Typ pluginu pro fázi 3 ... ...