# batterX Home

Source: https://docs.evcc.io/en/meters/batterx-home

Supported features: battery-control

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| host | IP address or hostname | 192.0.2.2 |  |
| port | Port | 80 |  |
| 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. | true |  |
| capacity | Battery capacity | 50 kWh |  |
| minsoc | Minimum charge Lower limit as configured on the battery system. Used by optimizer. | 0 % |  |
| maxsoc | Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. | 100 % |  |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W | advanced |
| maxdischargepower | Maximum discharge power Maximum discharge power of the storage. |  W | advanced |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: batterX
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: true # 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)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: batterX
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: true # 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)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: batterX
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      port: 80 # Port, optional
      externalpv: true # 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: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and for grid charging. (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)
```