# EcoFlow Stream

Source: https://docs.evcc.io/en/meters/ecoflow-stream

To use the EcoFlow Stream meter you need:
- A valid Access Key from the EcoFlow Developer Console
- The corresponding Secret Key
- The main device serial number of your Stream system

These credentials can be obtained through the EcoFlow Developer Console after registering your application.

In normal operation the Backup Reserve is set to `minsoc`, for grid charging to `maxsoc`.

**Note**: Active battery control overwrites the Backup Reserve configured in the EcoFlow app.
The device requires the Backup Reserve to exceed the discharge limit by 3, lower `minsoc`
values are raised accordingly. Without `minsoc` the battery discharges down to the device's
own discharge limit.

Supported features: battery-control

## Parameters

| Name | Description | Default / example | |
| --- | --- | --- | --- |
| accesskey | Access Key Access Key from EcoFlow Developer Console |  |  |
| secretkey | Secret Key Secret Key from EcoFlow Developer Console |  |  |
| serial | Serial Serial number of the main device in your Stream system, normally the first device of your system |  |  |
| 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 % |  |
| region | API Region If you sometimes see error code 8513, like for example Starlink users do, automatic region detection fails. Here, you can set the API region manually. Possible values: auto (default), europe, or america. (auto, europe, america) | auto | advanced |
| cache | Cache Time interval for data refresh | 30s | 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: ecoflow-stream
      usage: grid
      accesskey: # Access Key, Access Key from EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key from EcoFlow Developer Console
      serial: # Serial, Serial number of the main device in your Stream system, normally the first device of your system
      region: auto # API Region, If you sometimes see error code 8513, like for example Starlink users do, automatic region detection fails. Here, you can set the API region manually. Possible values: auto (default), europe, or america. [auto, europe, america] (optional)
      cache: 30s # Cache, Time interval for data refresh (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: ecoflow-stream
      usage: pv
      accesskey: # Access Key, Access Key from EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key from EcoFlow Developer Console
      serial: # Serial, Serial number of the main device in your Stream system, normally the first device of your system
      region: auto # API Region, If you sometimes see error code 8513, like for example Starlink users do, automatic region detection fails. Here, you can set the API region manually. Possible values: auto (default), europe, or america. [auto, europe, america] (optional)
      cache: 30s # Cache, Time interval for data refresh (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: ecoflow-stream
      usage: battery
      accesskey: # Access Key, Access Key from EcoFlow Developer Console
      secretkey: # Secret Key, Secret Key from EcoFlow Developer Console
      serial: # Serial, Serial number of the main device in your Stream system, normally the first device of your system
      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)
      region: auto # API Region, If you sometimes see error code 8513, like for example Starlink users do, automatic region detection fails. Here, you can set the API region manually. Possible values: auto (default), europe, or america. [auto, europe, america] (optional)
      cache: 30s # Cache, Time interval for data refresh (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)
```