Climate

EcoFlow BLE (Unofficial)

rabits/ha-ef-ble · vv1.3.0

HACSLocal push

Unofficial EcoFlow BLE Home Assistant integration

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`switch`	Switch or outlet
`climate`	Thermostat
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

Local Bluetooth support covers a growing list of EcoFlow Delta, panel, charger and generator models; new devices need diagnostics from users.

Works7
Requested3

Device	In Home Assistant	What they said	Source
EcoFlow Alternator Charger	Works Local	Support merged Saved copy This PR adds support for Smart Generators 3000 and partially 4000 (more sensors will be added on request) as requested in #2. PR also adds support for Alternator Charger requested in #35. Excerpt saved from GitHub on 2026-10-23.	PR #64 · 2025-08
EcoFlow Delta 2	Works Local	Initial support merged with v2 packets Saved copy … parameters. Fields are then implemented with the same interface as protobuf fields with RawData messages as their defs. PR also adds initial support for Delta 2 and Delta 3 1500 (which actually has code name Delta 2 Plus) and few controls. Excerpt saved from GitHub on 2026-10-23.	PR #109 · 2025-12
EcoFlow Delta Pro Ultra X	Works Local	First-pass support merged (EF-P10, SN P101) Saved copy This PR adds first-pass support for the EcoFlow Delta Pro Ultra X (`EF-P10`, SN prefix `P101`) on top of the V4 wire format from #307, and bundles two connection-layer changes the DPU X needs to authenticate at all: a sentinel-format / unencrypted variant of the V2/V3 framing ("type 0 encryption"), and a short-circuit in the auth wait when the device starts pushing heartbeat frames before the integration's auth state machine has run. Full list of changes: - Added type 0 (unencrypted) packet framing - introduces a sentinel-format variant of the V2/V3 framing where the high-nibble bit on the … Excerpt saved from GitHub on 2026-10-23.	PR #326 · 2026-05
EcoFlow E980 (Delta 2 Black variant)	Works Local	Maintainer fork identifies device correctly; diagnostics supplied Saved copy … searched existing issues and there isn't already a request for this device - [x] I've read the Requesting Support for New Devices wiki page ### Device model DELTA 2 Black ### Firmware version V1.0.2.176 ### Serial number prefix R701 ### Bluetooth connection you tested with ESPHome bluetooth proxy ### Diagnostics collection status Attached a diagnostics dump ### Diagnostics Hi! I have an EcoFlow E980 (which is commercially a professional/black variant of the DELTA 2). It broadcasts via BLE with the local name prefix `u-EF-R702...` but its actual Serial Number starts with `R701`. I have … Excerpt saved from GitHub on 2026-10-23.	Issue #386 · 2026-06
EcoFlow Rapid Pro 320W charger	Works Local	Battery, power, per-port telemetry and switches; merged Saved copy Summary ### High Level TLDR Adds the EcoFlow Rapid Pro 320W GaN charger (serial prefix `P521`, advertised as `EF-P52*`). It exposes battery, power, and per-port telemetry, plus a switch for each of the six ports. Two small connection tweaks were needed: the charger only accepts the local auth token as lowercase hex, and it uses a fixed local auth identity so the config flow does not need to ask for a user ID. ### Root Cause (why the existing code did not work for this device) - No device class matched the `P521` serial prefix, so the charger was not discovered. - The charger rejects the auth … Excerpt saved from GitHub on 2026-10-23.	PR #529 · 2026-10
EcoFlow Smart Generator 3000/4000	Works Local	3000 supported, 4000 partially; more sensors on request Saved copy This PR adds support for Smart Generators 3000 and partially 4000 (more sensors will be added on request) as requested in #2. PR also adds support for Alternator Charger requested in #35. Excerpt saved from GitHub on 2026-10-23.	PR #64 · 2025-08
EcoFlow Smart Home Panel 3	Works Local	Initial support merged (SN HR62, HR63, HR6C) Saved copy This PR adds support for the Smart Home Panel 3 (SN prefixes HR62, HR63, HR6C). The implementation is ported into our controls/field system and was informed by the community work in https://github.com/rabits/ha-ef-ble/pull/389, with field semantics verified against the decompiled EcoFlow app. Unlike the other protobuf panels, the SHP3 streams its telemetry in the V4 wire format and expects config writes back as V4 frames, so the write path differs from the V3 `_send_config_packet` used elsewhere. All changes: - Added the `shp3` device with battery, per-phase grid (L1/L2/L3 power, voltage, … Excerpt saved from GitHub on 2026-10-23.	PR #394 · 2026-07
EcoFlow DELTA Max 2000	Requested Local	Unsupported serial prefix DAEB; diagnostics being collected Saved copy Hallo, I repeated the diagnostic capture on the same DELTA Max entry while the unit was actively working. During the capture the EcoFlow app showed approximately: * 98% battery * 0 W input * 1976 W output (1975 W AC) Later it showed: * 93.75% battery * 263 W input * 0 W output I have attached the new diagnostics file and screenshots from the EcoFlow app. Regarding the serial number discrepancy: the EcoFlow app identifies this DELTA Max with the DAEB family/prefix, while Home Assistant / EcoFlow BLE reports it as EF-HZ310314, serial prefix HZ31. This is the same physical DELTA Max. … Excerpt saved from GitHub on 2026-10-23.	Issue #449 · 2026-08
EcoFlow Power Kits Power Hub	Requested Local	Draft PR closed; awaiting verified daylight capture Saved copy … searched open and closed issues and found no existing request for this device - [x] I read the new-device support and diagnostics guidance ## Device model EcoFlow Power Kits Power Hub ## Firmware version Not confirmed yet. ## Serial number prefix `M109` ## Bluetooth connection tested Internal Bluetooth adapter on macOS. ## Diagnostics collection status The device connects and authenticates over local BLE. A 100-packet diagnostic was collected locally while developing the parser, but that local capture was intentionally generated without encryption and will not be uploaded. I will add a fresh … Excerpt saved from GitHub on 2026-10-23.	Issue #440 · 2026-07
EcoFlow PowerOcean / PowerOcean Plus	Requested Local	Support in open PR; new message set Saved copy This PR adds support for the PowerOcean and PowerOcean Plus home storage systems, building on the work @andyrozman did in his own fork. These devices speak a message set none of the existing families use: the standard models report through `jt_s1_sys` and the Plus through `re307_sys`, and both send their state as several separate reports keyed by command id rather than one heartbeat, so the device classes dispatch on that id and merge whichever report arrived. Full list of changes: - `PowerOceanBase` plus a class per model. - Battery packs become indexed field groups, one set per pack: level, … Excerpt saved from GitHub on 2026-10-23.	PR #499 · 2026-09

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Found automatically over

Bluetooth

Details

Installs (analytics)	1,358 (0.19%)
GitHub stars	421
Latest version	v1.3.0 (2026-10-20)
Set up in the UI	Yes
Maintainers	@rabits
License	Apache-2.0

Devices listed in its README

Sensors
Battery Level
Input Power
Output Power
Grid Power
Power In Use
Power Status (grid, battery, oil, etc.)
Grid Status (grid outage)
Storm Made
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 Force Charge (Each Channel)
Channel Output Power (Each Channel)
Channel PV HV Input Power (Each Channel)
Channel PV LV Input Power (Each Channel)
Battery Power
System Load
Load From Grid
PV Power Total
Grid Connection Status
Grid Energized
Charge Time Remaining
Discharge Time Remaining
L1 / L2 / L3 Power
L1 / L2 / L3 Voltage
L1 / L2 / L3 Current
Circuit Voltage (Each Circuit)
Circuit Status (Each Circuit)
Channel Type (Each Channel)
Channel Signal Line (Each Channel)
AC 5P8 In Power
AC 5P8 Out Power
AC C20 In Power
AC L1 (1) Out Power
AC L1 (2) Out Power
AC L2 (1) Out Power
AC L2 (2) Out Power
AC L14 Out Power
AC TT Out Power
Anderson Out Power
Battery Level (each battery) ¹
Cell Temperature (each battery) ¹
HV Solar Power
LV Solar Power
USB-C (1) Out Power
USB-C (2) Out Power
USB (1) Out Power
USB (2) Out Power
AC 5P8 In Current
AC 5P8 In Voltage
AC 5P8 In Type
AC 5P8 Out Current
AC 5P8 Out Power Factor
AC 5P8 Out Type
AC 5P8 Out Voltage
AC 5P8 Work Mode
AC Allowed
AC C20 In Current
AC C20 In Voltage
AC C20 Input Type
AC L1 (1) Out Current
AC L1 (1) Out Power Factor
AC L1 (1) Out Voltage
AC L1 (2) Out Current
AC L1 (2) Out Power Factor
AC L1 (2) Out Voltage
AC L2 (1) Out Current
AC L2 (1) Out Power Factor
AC L2 (1) Out Voltage
AC L2 (2) Out Current
AC L2 (2) Out Power Factor
AC L2 (2) Out Voltage
AC L14 Out Current
AC L14 Out Power Factor

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

Fork	Stars	Last push	Description
GnoX/ha-ef-ble	★ 14	2026-10-08	Unofficial EcoFlow BLE Home Assistant integration

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/rabits/ha-ef-ble/wiki
Source code: https://github.com/rabits/ha-ef-ble
Issues: https://github.com/rabits/ha-ef-ble/issues
HACS: https://hacs.xyz