buffcode / hassio-ecoflow-cloud

EcoFlow Cloud Integration for Home Assistant

EcoFlow Cloud Integration for Home Assistant

Inspired by hassio-ecoflow and ecoflow-mqtt-prometheus-exporter this integration uses EcoFlow MQTT Broker mqtt.ecoflow.com to monitor and control the device.

Installation

• Install as a custom repository via HACS
• Manually download and extract to the custom_components directory

Once installed, use Add Integration -> Ecoflow Cloud.

Disclaimers

⚠️ Originally developed for personal use without a goal to cover all available device attributes

Current state

DELTA_2 (sensors: 35, switches: 8, sliders: 6, selects: 5)

Sensors

• Main Battery Level
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C (1) Out Power
• Type-C (2) Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB QC (1) Out Power
• USB QC (2) Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Slave Battery Level (auto)
• Slave Battery Temperature (auto)
• Slave Min Cell Temperature (disabled)
• Slave Max Cell Temperature (disabled)
• Slave Battery Volts (disabled)
• Slave Min Cell Volts (disabled)
• Slave Max Cell Volts (disabled)
• Slave Cycles (auto)
• Slave In Power (auto)
• Slave Out Power (auto)
• Status

Switches

• Beeper
• USB Enabled
• AC Always On
• Prio Solar Charging
• AC Enabled
• X-Boost Enabled
• DC (12V) Enabled
• Backup Reserve Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• Backup Reserve Level
• Generator Auto Start Level
• Generator Auto Stop Level
• AC Charging Power

Selects

• DC (12V) Charge Current
• Screen Timeout
• Unit Timeout
• AC Timeout
• DC (12V) Timeout

RIVER_2 (sensors: 21, switches: 3, sliders: 3, selects: 5)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Type-C In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C (1) Out Power
• USB Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Status

Switches

• AC Enabled
• X-Boost Enabled
• DC (12V) Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• AC Charging Power

Selects

• DC (12V) Charge Current
• DC Mode
• Screen Timeout
• Unit Timeout
• AC Timeout

RIVER_2_MAX (sensors: 24, switches: 3, sliders: 3, selects: 5)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• Solar In Current
• Solar In Voltage
• AC In Power
• Type-C In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C Out Power
• USB Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Status

Switches

• AC Enabled
• X-Boost Enabled
• DC (12V) Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• AC Charging Power

Selects

• DC (12V) Charge Current
• DC Mode
• Screen Timeout
• Unit Timeout
• AC Timeout

RIVER_2_PRO (sensors: 22, switches: 3, sliders: 3, selects: 5)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Type-C In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C Out Power
• USB Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Status

Switches

• AC Enabled
• X-Boost Enabled
• DC (12V) Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• AC Charging Power

Selects

• DC (12V) Charge Current
• DC Mode
• Screen Timeout
• Unit Timeout
• AC Timeout

DELTA_PRO (sensors: 38, switches: 6, sliders: 6, selects: 4)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Solar In Power
• AC Out Power
• DC Out Power
• DC Car Out Power
• DC Anderson Out Power
• Type-C (1) Out Power
• Type-C (2) Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB QC (1) Out Power
• USB QC (2) Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Solar In Energy
• Battery Charge Energy from AC
• Battery Charge Energy from DC
• Battery Discharge Energy to AC
• Battery Discharge Energy to DC
• Slave 1 Battery Level (auto)
• Slave 1 Battery Temperature (auto)
• Slave 1 In Power (auto)
• Slave 1 Out Power (auto)
• Slave 2 Battery Level (auto)
• Slave 2 Battery Temperature (auto)
• Slave 2 In Power (auto)
• Slave 2 Out Power (auto)
• Status

Switches

• Beeper
• DC (12V) Enabled
• AC Enabled
• X-Boost Enabled
• AC Always On
• Backup Reserve Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• Backup Reserve Level
• Generator Auto Start Level
• Generator Auto Stop Level
• AC Charging Power

Selects

• DC (12V) Charge Current
• Screen Timeout
• Unit Timeout
• AC Timeout

RIVER_MAX (sensors: 27, switches: 4, sliders: 1, selects: 2)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• DC Out Power
• Type-C Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB (3) Out Power
• Remaining Time
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Slave Battery Level (auto)
• Slave Battery Temperature (auto)
• Slave Min Cell Temperature (disabled)
• Slave Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Slave Cycles (auto)
• Status

Switches

• Beeper
• AC Enabled
• DC (12V) Enabled
• X-Boost Enabled

Sliders (numbers)

• Max Charge Level (read-only)

Selects

• Unit Timeout
• AC Timeout

RIVER_PRO (sensors: 29, switches: 3, sliders: 1, selects: 2)

Sensors

• Main Battery Level
• Total In Power
• Total Out Power
• Solar In Current
• Solar In Voltage
• AC In Power
• AC Out Power
• DC Out Power
• Type-C Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB (3) Out Power
• Remaining Time
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Battery Current (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Cycles
• Slave Battery Level (auto)
• Slave Cycles (auto)
• Slave Battery Temperature (auto)
• Slave Battery Volts (disabled)
• Slave Battery Current (disabled)
• Slave Min Cell Volts (disabled)
• Slave Max Cell Volts (disabled)
• Status

Switches

• Beeper (read-only)
• AC Enabled (read-only)
• X-Boost Enabled (read-only)

Sliders (numbers)

• Max Charge Level (read-only)

Selects

• Unit Timeout (read-only)
• AC Timeout (read-only)

DELTA_MAX (sensors: 25, switches: 7, sliders: 5, selects: 0)

Sensors

• Main Battery Level
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C (1) Out Power
• Type-C (2) Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB QC (1) Out Power
• USB QC (2) Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Status

Switches

• Beeper
• USB Enabled
• AC Always On
• Prio Solar Charging
• AC Enabled
• X-Boost Enabled
• DC (12V) Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• Generator Auto Start Level
• Generator Auto Stop Level
• AC Charging Power

Selects

DELTA_2_MAX (sensors: 25, switches: 5, sliders: 5, selects: 3)

Sensors

• Main Battery Level
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• Solar In Power
• AC Out Power
• DC Out Power
• Type-C (1) Out Power
• Type-C (2) Out Power
• USB (1) Out Power
• USB (2) Out Power
• USB QC (1) Out Power
• USB QC (2) Out Power
• Charge Remaining Time
• Discharge Remaining Time
• Inv Out Temperature
• Cycles
• Battery Temperature
• Min Cell Temperature (disabled)
• Max Cell Temperature (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Status

Switches

• Beeper
• USB Enabled
• AC Always On
• AC Enabled
• X-Boost Enabled

Sliders (numbers)

• Max Charge Level
• Min Discharge Level
• Generator Auto Start Level
• Generator Auto Stop Level
• AC Charging Power

Selects

• Screen Timeout
• Unit Timeout
• AC Timeout

POWERSTREAM ^beta (sensors: 55, switches: 0, sliders: 0, selects: 0)

Due to limitations with the way that Ecoflow have implemented the communication between the device and app only a couple of fields at a time get updated. It may take several hours for all fields to receive data. However, launching the app and viewing the PowerStream should force all the fields to be updated at once.

PowerStream support is still in development.

Wishlist

• Ability to change settings
• Add Sensors to allow data to be displyed on the Energy Dashboard

Sensors

• Solar 1 Watts
• Solar 1 Input Potential
• Solar 1 Op Potential
• Solar 1 Currrent
• Solar 1 Tempurature
• Solar 1 Relay Status
• Solar 1 Error Code (disabled)
• Solar 1 Warning Code (disabled)
• Solar 1 tatus (disabled)
• Solar 2 Watts
• Solar 2 Input Potential
• Solar 2 Op Potential
• Solar 2 Current
• Solar 2 Tempurature
• Solar 2 Relay Status
• Solar 2 Error Code (disabled)
• Solar 2 Warning Code (disabled)
• Solar 2 Status (disabled)
• Battery Type (disabled)
• Battery Charge
• Battery Input Watts
• Battery Input Potential
• Battery Op Potential
• Battery Input Current
• Battery Tempurature
• Charge Time
• Discharge Time
• Battery Error Code (disabled)
• Battery Warning Code (disabled)
• Battery Status (disabled)
• LLC Input Potential (disabled)
• LLC Op Potential (disabled)
• LLC Error Code (disabled)
• LLC Warning Code (disabled)
• LLC Status (disabled)
• Inverter On/Off Status
• Inverter Output Watts
• Inverter Output Potential (disabled)
• Inverter Op Potential
• Inverter Output Current
• Inverter DC Current
• Inverter Frequency
• Inverter Tempurature
• Inverter Relay Status
• Inverter Error Code (disabled)
• Inverter Warning Code (disabled)
• Inverter Status (disabled)
• Other Loads
• Smart Plug Loads
• Rated Power
• Lower Battery Limit (disabled)
• Upper Battery Limit (disabled)
• Wireless Error Code (disabled)
• Wireless Warning Code (disabled)
• LED Brightness (disabled)
• Heartbeat Frequency (disabled)

Switches None

Sliders (numbers) None

Selects None

How to

• Add/update device