Thanks to visit codestin.com
Credit goes to github.com

Skip to content

rabits/ha-ef-ble

Repository files navigation

EcoFlow BLE

hacs_badge Validation hassfest Validation HACS

Unofficial EcoFlow BLE devices Home Assistant integration will allow you to communicate with a number of EcoFlow devices through bluetooth and monitor their status / control parameters.

Recognized devices:

Smart Home Panel 2 (EF-HD3####, FW Version: 4.0.0.122, WiFi Version: 2.0.1.20)
Sensors
Battery Level
Input Power
Output Power
Grid Power
Power In Use
Circuit Power (Each Circuit)
Circuit Current (Each Circuit)
Channel Power (Each Channel)
Channel Battery Level (Each Channel)
Channel Battery Temperature (Each Channel)
Channel Connected (Each Channel)
Channel Control Status (Each Channel)
Channel Enabled (Each Channel)
Channel Output Power (Each Channel)
Channel PV HV Input Power (Each Channel)
Channel PV LV Input Power (Each Channel)
Delta Pro Ultra (EF-YJ####, FW Version: 5.0.0.25, WiFi Version: 2.0.2.4)
Sensors
Battery Level
Individual Battery Levels (disabled)
Input Power
Output Power
Low Voltage Solar Power
High Voltage Solar Power
AC L1 (1) Output Power
AC L1 (2) Output Power
AC L2 (1) Output Power
AC L2 (2) Output Power
AC TT-30R Output Power
AC L14-30P Output Power
AC I/O Output Power
River 3 (Plus, UPS, Plus Wireless) (EF-R3####)
Sensors Switches Sliders Selects
AC Input Energy AC Port Backup Reserve Level Led Mode⁺
AC Input Power DC Port Max Charge Limit DC Charging Type
AC Output Energy Backup Reserve Min Discharge Limit
AC Output Power AC Charging Speed
Main Battery Level ⁺ DC Charging Max Amps
Battery Level
DC 12V Port Output Energy
DC 12V Port Output Power
DC Input Energy
DC Input Power
Input Energy Total
Input Power Total
Output Energy Total
Output Power Total
USB A Output Energy
USB A Output Power
USB C Output Energy
USB C Output Power
Battery Input Power (disabled)
Battery Output Power (disabled)
Cell Temperature (disabled)

⁺ Only available on Plus variant

NOTE: AC Input Energy sensor is not working as intended - this is a bug in firmware. If you need this sensor, create integral helper from AC Input Power instead. Also see this issue.

WARNING: This integration allows to set Backup Reserve Limit to Min Discharge Limit that may cause your AC ports to turn off it it hits this limit. The official application allows you to do the same, so it is also possible to set it from this integration but be aware that this is most likely a bug. See more info in this issue.

Delta 3 (Classic, Plus, Max, Max Plus, Ultra) (EF-D3####)
Sensors Switches Sliders
Main Battery Level AC Ports Backup Reserve Level
Battery Level DC Ports Max Charge Limit
AC Input Power Backup Reserve Min Discharge Limit
AC Output Power USB Ports ¹ AC Charging Speed
DC 12V Port Output Power DC Charging Max Amps
DC Port Input Power DC (2) Charging Max Amps ⁺
DC Port Input State
DC Port (2) Input Power⁺
DC Port (2) Input State⁺
Solar Power
Solar Power (2) ⁺
Input Power Total
Output Power Total
USB A Output Power
USB A (2) Output Power
USB C Output Power
USB C (2) Output Power
AC Plugged In
Battery Input Power (disabled)
Battery Output Power (disabled)
Cell Temperature (disabled)

⁺ Only available on Plus variant
¹ Not available on Classic

NOTE: Delta 3 models do not expose energy sensors - to use it for Energy dashboard, you have to create it yourself, see this section from the official Home Assistant FAQ

Delta Pro 3 (EF-DP3####)
Sensors Switches Sliders
Main Battery Level AC Ports Backup Reserve Level
Battery Level DC Ports Max Charge Limit
AC Input Power Backup Reserve Min Discharge Limit
AC LV Output Power AC Charging Speed
AC HV Output Power
DC 12V Output Power
DC LV Input Power
DC LV Input State
DC HV Input Power
DC HV Input State
Solar LV Power
Solar HV Power
Input Power Total
Output Power Total
USB A Output Power
USB A (2) Output Power
USB C Output Power
USB C (2) Output Power
AC Plugged In
Cell Temperature (disabled)

NOTE: Delta 3 Pro does not expose energy sensors - to use it for Energy dashboard, you have to create it yourself, see this section from the official Home Assistant FAQ

Smart Generator (3000, 4000)
Sensors Switches Sliders Selects
Output Power Engine Gas Weight Performance Mode
AC Output Power Self Start DC Output Power⁴ Gas Unit
Engine State LPG Level Monitoring
Fuel Type AC Ports
Gas Consumption
Abnormal State
Internal Battery Power
Internal Battery State
XT150 Battery Level ⁴
XT150 Charge Type ⁴

⁴ Only available on 4000 variant

Alternator Charger
Sensors Switches Sliders Selects
Battery Level Charger Start Voltage Charger Mode
Battery Temperature Reverse Charging Current
DC Power Charging Current
Battery Voltage Power Limit
STREAM (AC, AC Pro, Max, Pro, Ultra, Ultra X)
Sensors Switches Sliders Selects
Battery Level Feed Grid Feed Grid Power Limit Energy Strategy
Grid Power AC (1) ᴬᴹᴾᵁ Backup Reserve Level
Grid Voltage AC (2) ᴬᴾᵁ Charge Limit
Grid Frequency Discharge Limit
Load from Battery Base Load Power ¹
Load from Grid
Load from PVᴹᴾᵁ
AC (1) Power ᴬᴹᴾᵁ
AC (2) Power ᴬᴾᵁ
PV (1) Poweri ᴹᴾᵁ
PV (2) Power ᴹᴾᵁ
PV (3) Power ᴾᵁ
PV (4) Power ᵁ
Cell Temperature (disabled)

ᴬ Only available on AC Pro variant
ᴹ Only available on Max variant
ᴾ Only available on Pro variant
ᵁ Only available on Ultra and Ultra X variants
¹ Not available when there's no base load timeframe or more than 1 timeframe configured.

Wave 3
Sensors Sliders Switches
Battery Level Charge Limit Power
Ambient Temperature Discharge Limit
Ambient Humidity
Operating Mode
Condensate Water Level
Cell Temperature (disabled)
Fan Level
Drainage Mode
Input Power
Output Power
Indoor Supply Air Temperature
Indoor Return Air Temperature
Outdoor Ambient Temperature
Condenser Temperature
Evaporator Temperature
Compressor Discharge Temperature
Sleep State
Delta 2 (Delta 3 1500)
Sensors Switches Sliders
Battery Level AC Ports Max Charge Limit
Input Power DC 12V Port Min Discharge Limit
Output Power USB Ports
AC Input Power
AC Output Power
DC Output Power
DC 12V Output Voltage
DC 12V Output Current
USB A Output Power
USB C Output Power
Cell Temperature (disabled)

NOTICE: this integration utilizes Bluetooth LE of the EF device, which is supporting just one connection at a time - so if you want to manage the device through BLE from your phone, you will need to disable this device in HA for that and later re-enable it to continue to collect data. It's an internal EF device limitation, so not much to do here...

WARNING: Support & Warranty

Sorry, limited support and no warranty - you on your own and I take no responsibility for any of your actions. We all grown-ups here and know that we deal with quite dangerous voltages and storage devices that could injure or cause death. So make sure you know what you doing for each and every step - otherwise you can't use the provided information in this repository or integration.

In case you see some issues with your device after using this integration - ecoflow support could be unable to help you. Author of the integration is not connected to EcoFlow anyhow and they can't support anything you will find here.

Usage

Install the integration as custom_component and it will automatically find the supported devices. It will also require your user id that was created during initialization of your device with app.

Please refer to the wiki page to find more info: https://github.com/rabits/ha-ef-ble/wiki

Development & Reverse

Information about how that was reversed you can find here: https://github.com/rabits/ef-ble-reverse

If you want to help with this integration - your changes will be most welcomed, but I recommend to create a ticket first to discuss the needed features or upcoming changes to make sure they fit the purpose of the integration.

Legal

This repository is not for sale.

The work was done in order to localize devices and make them available / controllable in disaster situations (unavailability of internet or cut-off the ecoflow servers). The official application allows to connect via bluetooth, but to do that you have to login to the server. No server is here and you screwed.

The requests to ecoflow usually ends up in support department and generally ignored, so there is no way to get support from them. That gave me right to take it in my own hands and use my knowledge & time to make my own way. There is no intention to harm any people anyhow - just to make sure you will be safe in emergency situation, which is critical for such a product.

About

Unofficial EcoFlow BLE Home Assistant integration

Topics

Resources

License

Stars

Watchers

Forks

Contributors 5

Languages