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: 45, switches: 8, sliders: 6, selects: 5)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Solar In 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 Design Capacity (disabled)
• Slave Full Capacity (disabled)
• Slave Remain Capacity (disabled)
• Slave State of Health
• 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: 29, switches: 3, sliders: 3, selects: 5)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Battery Charging State
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Type-C In Power
• Solar In 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: 32, switches: 5, sliders: 4, selects: 5)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Battery Charging State
• Total In Power
• Total Out Power
• Solar In Current
• Solar In Voltage
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Type-C In Power
• Solar In 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
• AC Always On
• X-Boost Enabled
• DC (12V) Enabled
• Backup Reserve Enabled

Sliders (numbers)

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

Selects

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

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

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Battery Charging State
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Type-C In Power
• Solar In 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: 53, switches: 6, sliders: 6, selects: 4)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Solar In 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 Design Capacity (disabled)
• Slave 1 Full Capacity (disabled)
• Slave 1 Remain Capacity (disabled)
• Slave 1 State of Health
• Slave 1 Battery Temperature (auto)
• Slave 1 In Power (auto)
• Slave 1 Out Power (auto)
• Slave 2 Battery Level (auto)
• Slave 2 Design Capacity (disabled)
• Slave 2 Full Capacity (disabled)
• Slave 2 Remain Capacity (disabled)
• Slave 2 State of Health
• 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: 40, switches: 4, sliders: 1, selects: 2)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• 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)
• Solar In Energy
• Battery Charge Energy from AC
• Battery Charge Energy from DC
• Battery Discharge Energy to AC
• Battery Discharge Energy to DC
• Slave Battery Level (auto)
• Slave Design Capacity (disabled)
• Slave Full Capacity (disabled)
• Slave Remain Capacity (disabled)
• 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: 37, switches: 3, sliders: 1, selects: 2)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• Total In Power
• Total Out Power
• Solar In Current
• Solar In Voltage
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• 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 Current (disabled)
• Battery Volts (disabled)
• Min Cell Volts (disabled)
• Max Cell Volts (disabled)
• Cycles
• Slave Battery Level (auto)
• Slave Design Capacity (disabled)
• Slave Full Capacity (disabled)
• Slave Remain Capacity (disabled)
• Slave Cycles (auto)
• Slave Battery Temperature (auto)
• Slave Battery Current (disabled)
• Slave Battery Volts (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_MINI (sensors: 33, switches: 4, sliders: 3, selects: 4)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Solar In 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 (disabled)
• Battery 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
• Status

Switches

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

Sliders (numbers)

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

Selects

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

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

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Solar In 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: 60, switches: 7, sliders: 6, selects: 3)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• State of Health
• Battery Level
• Total In Power
• Total Out Power
• AC In Power
• AC Out Power
• AC In Volts
• AC Out Volts
• Solar (1) In Power
• Solar (2) In 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 1 Battery Level (auto)
• Slave 1 Design Capacity (disabled)
• Slave 1 Full Capacity (disabled)
• Slave 1 Remain Capacity (disabled)
• Slave 1 Battery Temperature (auto)
• Slave 1 Min Cell Temperature (disabled)
• Slave 1 Max Cell Temperature (disabled)
• Slave 1 Battery Volts (disabled)
• Slave 1 Min Cell Volts (disabled)
• Slave 1 Max Cell Volts (disabled)
• Slave 1 Cycles (auto)
• Slave 1 State of Health (auto)
• Slave 1 In Power (auto)
• Slave 1 Out Power (auto)
• Slave 2 Battery Level (auto)
• Slave 2 Design Capacity (disabled)
• Slave 2 Full Capacity (disabled)
• Slave 2 Remain Capacity (disabled)
• Slave 2 Battery Temperature (auto)
• Slave 2 Min Cell Temperature (disabled)
• Slave 2 Max Cell Temperature (disabled)
• Slave 2 Battery Volts (disabled)
• Slave 2 Min Cell Volts (disabled)
• Slave 2 Max Cell Volts (disabled)
• Slave 2 Cycles (auto)
• Slave 2 State of Health (auto)
• Slave 2 In Power (auto)
• Slave 2 Out Power (auto)
• Status

Switches

• Beeper
• USB Enabled
• AC Always On
• 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

• Screen Timeout
• Unit Timeout
• AC Timeout

POWERSTREAM (sensors: 57, switches: 0, sliders: 0, selects: 0)

Sensors

• Solar 1 Watts
• Solar 1 Input Potential
• Solar 1 Op Potential
• Solar 1 Currrent
• Solar 1 Temperature
• Solar 1 Relay Status
• Solar 1 Error Code (disabled)
• Solar 1 Warning Code (disabled)
• Solar 1 Status (disabled)
• Solar 2 Watts
• Solar 2 Input Potential
• Solar 2 Op Potential
• Solar 2 Current
• Solar 2 Temperature
• 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 Temperature
• 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 Temperature
• 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)
• Status

Switches

Sliders (numbers)

Selects

GLACIER (sensors: 33, switches: 3, sliders: 3, selects: 0)

Sensors

• Main Battery Level
• Main Design Capacity (disabled)
• Main Full Capacity (disabled)
• Main Remain Capacity (disabled)
• Battery Level
• Battery Charging State
• Total In Power
• Total Out Power
• Motor 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)
• Battery Present
• XT60 State
• Fan Level
• Ambient Temperature
• Exhaust Temperature
• Water Temperature
• Left Temperature
• Right Temperature
• Dual Zone Mode
• Ice Time Remain
• Ice Percentage
• Ice Make Mode
• Ice Alert
• Ice Water Level OK
• Status

Switches

• Beeper
• Eco Mode
• Power

Sliders (numbers)

• Left Set Temperature
• Combined Set Temperature
• Right Set Temperature

Selects

How to

• Add/update device