Skip to content

rabits/ha-ef-ble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

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 Current (Each Channel)
Delta Pro Ultra (EF-YJ####, FW Version: 5.0.0.25, WiFi Version: 2.0.2.4)
Sensors
Battery Level
Input Power
Output Power
Low Voltage Solar Power
High Voltage Solar Power
River 3 (Plus, UPS) (EF-R3####, FW Version: 1.0.0.0)
Sensors Switches Sliders Selects
AC Input Energy AC Port Backup Reserve Level Led Mode (Plus only)
AC Input Power DC Port Max Charge Limit
AC Output Energy Backup Reserve Min Discharge Limit
AC Output Power
Main Battery Level (Plus only)
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)
Delta 3 (Plus, 1500) (EF-D3####, FW Version: 6.49.76.57)
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
DC 12V Port Output Power
DC Port Input Power
DC Port Input State
DC Port (2) Input Power (Plus only)
DC Port (2) Input State (Plus only)
Solar Power
Solar Power (2) (Plus only)
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)
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 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)

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.