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.

For active battery control, maxsoc must be set. 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: External control of home battery charging and discharging via evcc.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`accesskey`	Access Key Access Key from EcoFlow Developer Console	optional
`secretkey`	Secret Key Secret Key from EcoFlow Developer Console	optional
`serial`	Serial Serial number of the main device in your Stream system, normally the first device of your system	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and for grid charging. Example: `95`	optional
`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. Default: `auto`	advanced
`cache`	Cache Time interval for data refresh Default: `30s` Example: `5m`	advanced
`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 meterSolar productionBattery

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)

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)

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: 25 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 95 # 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)