Home Assistant

← PV, Battery, Grid, Meter

Home Assistant instances in your network will be auto-discovered and suitable entities (e.g. sensor.*) will be suggested.

Usage areas

Grid meter
Solar production
Battery
Charger meter
Smart consumer

Parameters

Name	Description	Level
`uri`	Home Assistant URI Example: `http://homeassistant.local:8123`	optional
`power`	Power Entity Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W"). Example: `sensor.house_power`	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit when discharging the battery in normal operation Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit when charging the battery from the grid Example: `95`	optional
`energy`	Energy Entity Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. Example: `sensor.house_energy`	advanced
`currentL1`	L1 Current Entity Entity ID for L1 current measurement in amperes Example: `sensor.house_current_l1`	advanced
`currentL2`	L2 Current Entity Entity ID for L2 current measurement in amperes Example: `sensor.house_current_l2`	advanced
`currentL3`	L3 Current Entity Entity ID for L3 current measurement in amperes Example: `sensor.house_current_l3`	advanced
`voltageL1`	L1 Voltage Entity Entity ID for L1 voltage measurement in volts Example: `sensor.house_voltage_l1`	advanced
`voltageL2`	L2 Voltage Entity Entity ID for L2 voltage measurement in volts Example: `sensor.house_voltage_l2`	advanced
`voltageL3`	L3 Voltage Entity Entity ID for L3 voltage measurement in volts Example: `sensor.house_voltage_l3`	advanced
`soc`	Battery State of Charge Entity ID for battery state of charge in percent Example: `sensor.battery_soc`	advanced
`modeNormal`	Normal Mode Script Script to put home battery to normal operation. Required when modeHold or modeCharge is set. The script is responsible for any necessary state changes on the HA side. Example: `script.battery_normal`	advanced
`modeHold`	Hold Mode Script Optional script to prevent the home battery from discharging. Example: `script.battery_hold`	advanced
`modeCharge`	Grid Charge Mode Script Optional script to grid-charge the home battery. Example: `script.battery_grid_charge`	advanced
`maxacpower` [W]	Maximum AC power of the hybrid inverter Default: `0` Example: `5000`	advanced
`maxchargepower` [W]	Maximum charge power For forced charging of the battery.	advanced
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

Grid meter Solar production Battery Smart consumer Charger meter

meters:
    - name: my_grid
      type: template
      template: homeassistant
      usage: grid
      uri: http://homeassistant.local:8123 # Home Assistant URI
      power: sensor.house_power # Power Entity, Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W").
      energy: sensor.house_energy # Energy Entity, Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. (optional)
      currentL1: sensor.house_current_l1 # L1 Current Entity, Entity ID for L1 current measurement in amperes (optional)
      currentL2: sensor.house_current_l2 # L2 Current Entity, Entity ID for L2 current measurement in amperes (optional)
      currentL3: sensor.house_current_l3 # L3 Current Entity, Entity ID for L3 current measurement in amperes (optional)
      voltageL1: sensor.house_voltage_l1 # L1 Voltage Entity, Entity ID for L1 voltage measurement in volts (optional)
      voltageL2: sensor.house_voltage_l2 # L2 Voltage Entity, Entity ID for L2 voltage measurement in volts (optional)
      voltageL3: sensor.house_voltage_l3 # L3 Voltage Entity, Entity ID for L3 voltage measurement in volts (optional)

meters:
    - name: my_pv
      type: template
      template: homeassistant
      usage: pv
      uri: http://homeassistant.local:8123 # Home Assistant URI
      power: sensor.house_power # Power Entity, Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W").
      energy: sensor.house_energy # Energy Entity, Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. (optional)
      currentL1: sensor.house_current_l1 # L1 Current Entity, Entity ID for L1 current measurement in amperes (optional)
      currentL2: sensor.house_current_l2 # L2 Current Entity, Entity ID for L2 current measurement in amperes (optional)
      currentL3: sensor.house_current_l3 # L3 Current Entity, Entity ID for L3 current measurement in amperes (optional)
      voltageL1: sensor.house_voltage_l1 # L1 Voltage Entity, Entity ID for L1 voltage measurement in volts (optional)
      voltageL2: sensor.house_voltage_l2 # L2 Voltage Entity, Entity ID for L2 voltage measurement in volts (optional)
      voltageL3: sensor.house_voltage_l3 # L3 Voltage Entity, Entity ID for L3 voltage measurement in volts (optional)
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional

meters:
    - name: my_battery
      type: template
      template: homeassistant
      usage: battery
      uri: http://homeassistant.local:8123 # Home Assistant URI
      power: sensor.house_power # Power Entity, Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W").
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
      maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (optional)
      energy: sensor.house_energy # Energy Entity, Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. (optional)
      currentL1: sensor.house_current_l1 # L1 Current Entity, Entity ID for L1 current measurement in amperes (optional)
      currentL2: sensor.house_current_l2 # L2 Current Entity, Entity ID for L2 current measurement in amperes (optional)
      currentL3: sensor.house_current_l3 # L3 Current Entity, Entity ID for L3 current measurement in amperes (optional)
      voltageL1: sensor.house_voltage_l1 # L1 Voltage Entity, Entity ID for L1 voltage measurement in volts (optional)
      voltageL2: sensor.house_voltage_l2 # L2 Voltage Entity, Entity ID for L2 voltage measurement in volts (optional)
      voltageL3: sensor.house_voltage_l3 # L3 Voltage Entity, Entity ID for L3 voltage measurement in volts (optional)
      soc: sensor.battery_soc # Battery State of Charge, Entity ID for battery state of charge in percent (optional)
      modeNormal: script.battery_normal # Normal Mode Script, Script to put home battery to normal operation. Required when modeHold or modeCharge is set. The script is responsible for any necessary state changes on the HA side. (optional)
      modeHold: script.battery_hold # Hold Mode Script, Optional script to prevent the home battery from discharging. (optional)
      modeCharge: script.battery_grid_charge # Grid Charge Mode Script, Optional script to grid-charge the home battery. (optional)
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)

meters:
    - name: my_aux
      type: template
      template: homeassistant
      usage: aux
      uri: http://homeassistant.local:8123 # Home Assistant URI
      power: sensor.house_power # Power Entity, Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W").
      energy: sensor.house_energy # Energy Entity, Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. (optional)
      currentL1: sensor.house_current_l1 # L1 Current Entity, Entity ID for L1 current measurement in amperes (optional)
      currentL2: sensor.house_current_l2 # L2 Current Entity, Entity ID for L2 current measurement in amperes (optional)
      currentL3: sensor.house_current_l3 # L3 Current Entity, Entity ID for L3 current measurement in amperes (optional)
      voltageL1: sensor.house_voltage_l1 # L1 Voltage Entity, Entity ID for L1 voltage measurement in volts (optional)
      voltageL2: sensor.house_voltage_l2 # L2 Voltage Entity, Entity ID for L2 voltage measurement in volts (optional)
      voltageL3: sensor.house_voltage_l3 # L3 Voltage Entity, Entity ID for L3 voltage measurement in volts (optional)

meters:
    - name: my_charger
      type: template
      template: homeassistant
      usage: charge
      uri: http://homeassistant.local:8123 # Home Assistant URI
      power: sensor.house_power # Power Entity, Entity ID for instantaneous power measurement in watts. The entity must provide numeric values only (e.g., "1234", not "1234 W").
      energy: sensor.house_energy # Energy Entity, Entity ID for cumulative energy measurement in kWh. Should provide total energy consumed/produced, not daily or interval values. (optional)
      currentL1: sensor.house_current_l1 # L1 Current Entity, Entity ID for L1 current measurement in amperes (optional)
      currentL2: sensor.house_current_l2 # L2 Current Entity, Entity ID for L2 current measurement in amperes (optional)
      currentL3: sensor.house_current_l3 # L3 Current Entity, Entity ID for L3 current measurement in amperes (optional)
      voltageL1: sensor.house_voltage_l1 # L1 Voltage Entity, Entity ID for L1 voltage measurement in volts (optional)
      voltageL2: sensor.house_voltage_l2 # L2 Voltage Entity, Entity ID for L2 voltage measurement in volts (optional)
      voltageL3: sensor.house_voltage_l3 # L3 Voltage Entity, Entity ID for L3 voltage measurement in volts (optional)