batterX Home

Supported features

Battery control: External control of home battery charging and discharging via evcc.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`host`	IP address or hostname Example: `192.0.2.2`	optional
`port`	Port Default: `80`	optional
`externalpv`	Needed when a second solar inverter is connected. This parameter is needed when the BatterX station is connected to another solar inverter. The total produced solar power can so be reported through one system. Further auxilary solar inverters do not need to be connected to evcc.	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
`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

meters:
    - name: my_grid
      type: template
      template: batterX
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: # Needed when a second solar inverter is connected., This parameter is needed when the BatterX station is connected to another solar inverter. The total produced solar power can so be reported through one system. Further auxilary solar inverters do not need to be connected to evcc. (optional)

meters:
    - name: my_pv
      type: template
      template: batterX
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: # Needed when a second solar inverter is connected., This parameter is needed when the BatterX station is connected to another solar inverter. The total produced solar power can so be reported through one system. Further auxilary solar inverters do not need to be connected to evcc. (optional)

meters:
    - name: my_battery
      type: template
      template: batterX
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: # Needed when a second solar inverter is connected., This parameter is needed when the BatterX station is connected to another solar inverter. The total produced solar power can so be reported through one system. Further auxilary solar inverters do not need to be connected to evcc. (optional)
      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)
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)