# E3/DC

Source: https://docs.evcc.io/en/meters/e3-dc

The communication is done locally. evcc must be in the same network as the E3/DC system.

**Note**: Active battery control will override Smart-Power/Operating Range settings.

Supported features: battery-control

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| host | IP address or hostname | 192.0.2.2 |  |
| user | Username Identical with Web Portal or E3/DC App. |  |  |
| password | Password Identical with Web Portal or E3/DC App. |  |  |
| key | RSCP password Must be set on the screen of your E3/DC system at 'Personalize' > 'User Profile'. |  |  |
| port | Port | 5033 |  |
| 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 % |  |
| maxacpower | Maximum AC power of the hybrid inverter | 0 W | advanced |
| externalpower | Include external power Includes all connected external sources into the PV calculation (default). | true | advanced |
| dischargelimit | Discharge limit in W Limits discharge power in 'Hold' battery mode |  | advanced |
| 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: e3dc-rscp
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      user: # Username, Identical with Web Portal or E3/DC App.
      password: # Password, Identical with Web Portal or E3/DC App.
      key: # RSCP password, Must be set on the screen of your E3/DC system at 'Personalize' > 'User Profile'.
      port: 5033 # Port, optional
```

```yaml
meters:
    - name: my_pv
      type: template
      template: e3dc-rscp
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      user: # Username, Identical with Web Portal or E3/DC App.
      password: # Password, Identical with Web Portal or E3/DC App.
      key: # RSCP password, Must be set on the screen of your E3/DC system at 'Personalize' > 'User Profile'.
      port: 5033 # Port, optional
      maxacpower: 0 # Maximum AC power of the hybrid inverter (W), optional
      externalpower: true # Include external power, Includes all connected external sources into the PV calculation (default). (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: e3dc-rscp
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      user: # Username, Identical with Web Portal or E3/DC App.
      password: # Password, Identical with Web Portal or E3/DC App.
      key: # RSCP password, Must be set on the screen of your E3/DC system at 'Personalize' > 'User Profile'.
      port: 5033 # Port, 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)
      dischargelimit: # Discharge limit in W, Limits discharge power in 'Hold' battery mode (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)
```