Skip to content
Docs
EN | DE

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

NameDescriptionValueLevel
uriHome Assistant URI
Example: http://homeassistant.local:8123
optional
powerPower 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
energyEnergy 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
currentL1L1 Current Entity

Entity ID for L1 current measurement in amperes

Example: sensor.house_current_l1
advanced
currentL2L2 Current Entity

Entity ID for L2 current measurement in amperes

Example: sensor.house_current_l2
advanced
currentL3L3 Current Entity

Entity ID for L3 current measurement in amperes

Example: sensor.house_current_l3
advanced
voltageL1L1 Voltage Entity

Entity ID for L1 voltage measurement in volts

Example: sensor.house_voltage_l1
advanced
voltageL2L2 Voltage Entity

Entity ID for L2 voltage measurement in volts

Example: sensor.house_voltage_l2
advanced
voltageL3L3 Voltage Entity

Entity ID for L3 voltage measurement in volts

Example: sensor.house_voltage_l3
advanced
socBattery State of Charge

Entity ID for battery state of charge in percent

Example: sensor.battery_soc
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.

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)
      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)