Plugs & switches

EcoFlow Energy

shuette42/ecoflow-energy-ha · vv1.25.0

HACSCloud push

Home Assistant integration for EcoFlow energy devices: PowerOcean, PowerOcean Plus, Delta 2 Max, Delta 3, Smart Plug, Stream, Stream Micro, STREAM AC 5000 and STREAM 5000. Standard mode via the official API, plus a faster enhanced mode.

Documentation Source code

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

Many EcoFlow power stations and home-energy products are supported via the EcoFlow cloud, with a new local Modbus mode for three-phase PowerOcean. River 3 is listed but exposes no data.

Works20
Partly works1

Device	In Home Assistant	What they said	Source
EcoFlow Delta 2 Max	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Delta 3	Works Cloud	Exposes 36 entities Saved copy … RIVER family looks simply unmapped rather than broken. Two things that might help: 1. Map the `R655` prefix. The RIVER 3 is the same generation as the DELTA 3, so the `delta3` parsers may already fit; a `DEVICE_TYPE_RIVER3` reusing them would be a reasonable first attempt. 2. Independently of RIVER support: the options flow lists every device the cloud account returns, including ones the integration cannot handle. Greying out or flagging unsupported devices there would avoid the "ticked but silent" state I ran into. ### Alternatives Considered _No response_ ### Additio Excerpt saved from GitHub on 2026-10-23.	Issue #296 · 2026-08
EcoFlow DELTA Pro Ultra	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Ocean 2 (RE11, RE17)	Works Cloud	Support added in September 2026 Saved copy Ref #145 - the issue stays open until the reporter confirms on a released build. The Ocean 2 was skipped as an unsupported device with no route to changing that: the Developer API answers error 1006, so there is no polled data to build on, and its live telemetry arrives in a message this integration had never decoded. It is not a PowerOcean. It carries its own frame on `cmd_func` 254 / `cmd_id` 39 and shares no field layout with the `HJ31`/`J32x` line, so routing the prefix to the existing parser, what settled `HJ35`, `J32B` and `P231`, would have created a device whose readings could never … Excerpt saved from GitHub on 2026-10-23.	PR #421 · 2026-09
EcoFlow OCEAN Smart Electrical Panel 40	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow PowerOcean	Works Local	Cloud supported; three-phase variant can be read locally over Modbus/TCP Saved copy Summary Adds a third, separate connection type for a three-phase PowerOcean: Local (Modbus/TCP). It reads the inverter over the local network with no EcoFlow account and no cloud, read-only. EcoFlow support has to enable Modbus on the inverter first. - New client `ecoflow/modbus_local.py` (function code 3 only, one short connection per poll, word-swapped 32-bit values, base address 40001) and parser `ecoflow/parsers/powerocean_modbus.py`. - Own lean coordinator, 10 s poll, unavailable after three failed polls, no reauthentication (the entry holds no credentials). The serial is checked on the … Excerpt saved from GitHub on 2026-10-23.	PR #452 · 2026-10
EcoFlow PowerOcean Plus	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow PowerPulse 2	Works Cloud	Wallbox supported; charging-status labels considered confusing Saved copy Summary I would like to propose more accurate user-facing labels for three existing PowerPulse 2 charging states: - `available` → Unplugged - `preparing` → Vehicle connected - `finishing` → Charging session ended This request is intentionally limited to display labels/translations. I am not requesting changes to the internal enum strings, protocol parsing, entity IDs, or charging-control logic. The reason is that `preparing` and `finishing` are not necessarily short-lived transitional states. On my PowerPulse 2, both remained active for extended periods without charging power. ## Environment … Excerpt saved from GitHub on 2026-10-23.	Issue #590 · 2026-10
EcoFlow PowerStream	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow RIVER 2 Max	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow RIVER 3 Plus	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Smart Home Panel 2	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Smart Meter	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Smart Plug	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Solar Tracker	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Stream	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow STREAM 5000	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow STREAM AC 5000	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow Stream Micro	Works Cloud	Listed as supported Saved copy Supported devices: PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow WAVE 3	Works Cloud	Listed as supported Saved copy … PowerOcean; PowerOcean Plus; Delta 2 Max; Delta 3; Smart Plug; Stream; Stream Micro; PowerStream; STREAM AC 5000; STREAM 5000; Smart Meter; Solar Tracker; WAVE 3; PowerPulse 2; Ocean 2; OCEAN Smart Electrical Panel 40; DELTA Pro Ultra; Smart Home Panel 2; RIVER 3; RIVER 3 Plus; RIVER 2 Max; Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.. Excerpt saved from the README on 2026-10-23.	README
EcoFlow RIVER 3	Partly works Cloud	Selectable but exposes no entities; model prefix R655 not mapped Saved copy Device Type New Device Support ### Problem or Use Case The RIVER 3 is offered by the integration but never produces any usable entity. It is listed and selectable in the options flow, and the config entry records it as `online: 1`, so it looks supported. In practice it only yields the two diagnostic sensors (`mqtt_status`, `connection_mode`), both disabled by default, so no device data is ever exposed. ### Proposed Solution The device falls through `get_device_type()` and ends up as `DEVICE_TYPE_UNKNOWN`: - SN is `R655ZE1AXJ4H0035`, so the prefix is `R655`, which is not in `_SN_PREFIX_MAP` - … Excerpt saved from GitHub on 2026-10-23.	Issue #296 · 2026-08

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

Cloud push

Goes through the maker’s cloud, which sends updates as they happen. Needs the internet and an account.

Details

Installs (analytics)	640 (0.09%)
GitHub stars	48
Latest version	v1.25.0 (2026-10-22)
Set up in the UI	Yes
Maintainers	@shuette42
License	MIT

Devices listed in its README

PowerOcean
PowerOcean Plus
Delta 2 Max
Delta 3
Smart Plug
Stream
Stream Micro
PowerStream
STREAM AC 5000
STREAM 5000
Smart Meter
Solar Tracker
WAVE 3
PowerPulse 2
Ocean 2
OCEAN Smart Electrical Panel 40
DELTA Pro Ultra
Smart Home Panel 2
RIVER 3
RIVER 3 Plus
RIVER 2 Max
Backup Reserve (number, 0-100%) - minimum SoC the system keeps in reserve. Same slider as "Backup-Reserve" in the EcoFlow app.

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/shuette42/ecoflow-energy-ha
Source code: https://github.com/shuette42/ecoflow-energy-ha
Issues: https://github.com/shuette42/ecoflow-energy-ha/issues
HACS: https://hacs.xyz