README.md

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

Sensors

• Main Battery Level
• 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 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: 24, switches: 3, sliders: 3, selects: 5)

Sensors

• Main 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: 27, switches: 5, sliders: 4, selects: 5)

Sensors

• Main 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: 25, switches: 3, sliders: 3, selects: 5)

Sensors

• Main 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: 40, switches: 6, sliders: 6, selects: 4)

Sensors

• Main 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 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: 34, switches: 4, sliders: 1, selects: 2)

Sensors

• Main Battery Level
• 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 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: 31, 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
• 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 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_MINI (sensors: 28, switches: 4, sliders: 3, selects: 4)

Sensors

• Main 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: 27, switches: 7, sliders: 5, selects: 0)

Sensors

• Main Battery Level
• 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: 27, switches: 5, sliders: 5, selects: 3)

Sensors

• Main Battery Level
• 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
• 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: 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 None

Sliders (numbers) None

Selects None

How to

• Add/update device