/hassio-ecoflow-cloud

EcoFlow Cloud Integration for Home Assistant

Primary LanguagePython

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