Skip to content
Rabit edited this page Dec 15, 2024 · 4 revisions

Welcome to the ha-ef-ble wiki!

This page is made to help you to connect your HA to EcoFlow BLE device and do whatever you want.

Recognized devices:

  • Smart Home Panel 2 (EF-HD3####, FW Version: 4.0.0.122, WiFi Version: 2.0.1.20)
  • Delta Pro Ultra (EF-YJ####, FW Version: 5.0.0.25, WiFi Version: 2.0.2.4)

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.

Configuration

Install the integration as custom_component and it will automatically find the supported devices. If it did not find anything - you can try to add device manually, just go to HA integrations, click "Add Integration" button and select "EcoFlow BLE (Unofficial)". It will show you menu where you can select the device and provide your EcoFlow UserID there.

Two ways to find your UserID - it's sent to device when you bind it to your EcoFlow account and becomes integral part of the authentication mechanism, but usually user don't see it. It's only visible through:

  • If you have root on your device with ef app: from mmkv db. Look at the file /data/data/com.ecoflow/files/mmkv/mmkv.default - binary, but you can find user_id field.
  • By log in to ecoflow site: go to https://us.ecoflow.com/ , open dev console of your browser (press F12) and switch to "Network" tab. Then login and find POST to https://api-a.ecoflow.com/auth/login. The response contains json, which have data.user.userId field string.

After configuration device will be added and you can use it.

Additional help

Besides general Issues you can use this Home Assistant community thread to ask for questions or if you want to find some useful workaround.

Clone this wiki locally