# Ferroamp EnergyHub

Source: https://docs.evcc.io/en/meters/ferroamp-energyhub

Modbus TCP has to be enabled for the EnergyHub by the installer or Ferroamp support.
The interface is only reachable via the EnergyHub's Ethernet interface.
Grid values are measured by the external current transformers (CTs) at the grid connection point.

Supported features: battery-control

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| modbus | Modbus Type (tcpip) |  |  |
| maxchargepower | Maximum charge power For forced charging of the battery. |  W |  |
| maxdischargepower | Maximum discharge power Maximum discharge power of the storage. |  W |  |
| 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 % |  |

## Configuration example for evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: ferroamp-energyhub
      usage: grid
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
```

```yaml
meters:
    - name: my_pv
      type: template
      template: ferroamp-energyhub
      usage: pv
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
```

```yaml
meters:
    - name: my_battery
      type: template
      template: ferroamp-energyhub
      usage: battery
      
      # Modbus TCP
      modbus: tcpip
      id: 1
      host:  # Hostname
      port: 502 # Port
      maxchargepower: # Maximum charge power (W), For forced charging of the battery.
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage.
      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)
```