A local, cloud-free Home Assistant integration for the EcoFlow River 3 Plus portable power station. It reads battery, power and temperature data directly over USB (serial + HID) — no EcoFlow cloud account, no MQTT broker, no internet connection required.
If you want to monitor your EcoFlow River 3 Plus in Home Assistant 100% locally, this is for you.
Keywords: EcoFlow River 3 Plus, Home Assistant, HACS, local USB, no cloud, no MQTT, portable power station, battery monitoring, solar, energy dashboard.
- 🔌 100% local USB communication — no cloud, no MQTT, no internet
- ⚙️ Easy setup via the UI — config flow with automatic USB device discovery
- 🔋 Battery monitoring — charge level, time remaining, charge/discharge ETA
- ⚡ Power monitoring — total in/out, AC, solar/DC, USB-A and USB-C loads
- 🌡️ Temperature sensors — system and battery temperature
- 🟢 AC input state as a binary sensor
- 📈 Energy Dashboard ready — power sensors with proper device classes
| Entity | Type | Default |
|---|---|---|
| Charge level (%) | Sensor (Battery) | ✅ |
| Discharge time remaining (min) | Sensor (Duration) | ✅ |
| Output power (W) | Sensor (Power) | ✅ |
| AC input active | Binary sensor (Power) | ✅ |
| Input power (W) | Sensor (Power) | Diagnostic |
| AC input power (W) | Sensor (Power) | Diagnostic |
| Solar/DC input power (W) | Sensor (Power) | Diagnostic |
| AC output power (W) | Sensor (Power) | Diagnostic |
| DC output power (W) | Sensor (Power) | Diagnostic |
| USB-A output power (W) | Sensor (Power) | Diagnostic |
| USB-C output power (W) | Sensor (Power) | Diagnostic |
| Charge time remaining (min) | Sensor (Duration) | Diagnostic |
| System temperature (°C) | Sensor (Temperature) | Diagnostic |
| Battery temperature (°C) | Sensor (Temperature) | Diagnostic |
Entities marked Diagnostic are disabled by default — enable them in the entity settings if you need them.
- Open HACS in Home Assistant
- Click the menu (
⋮) → Custom repositories - Add
https://github.com/makerwolf/ecoflow-river3-plus-usband choose category Integration - Install EcoFlow River 3 Plus USB
- Restart Home Assistant
- Go to Settings → Devices & Services → Add Integration and search for EcoFlow River 3 Plus USB (it is usually auto-discovered when the device is plugged in)
- Copy
custom_components/ecoflow_river3_plusinto your Home Assistantconfig/custom_components/directory - Restart Home Assistant
- Add the integration via Settings → Devices & Services
- Home Assistant 2025.12.0 or newer
- The EcoFlow River 3 Plus connected via USB to the Home Assistant host
- Access to both the USB serial and HID interfaces of the device (USB passthrough on VMs/containers)
- Proxmox VE host with a Home Assistant OS VM (USB passthrough)
- Bare-metal Home Assistant OS
- No compatible HID interface found — make sure both USB interfaces are passed through to Home Assistant and that the user running Home Assistant has permission to access the HID device. On a VM, verify the USB device is mapped to the VM and not claimed by the host.
- Device not auto-discovered — add the integration manually via Settings → Devices & Services → Add Integration.
This integration is based on the excellent reverse-engineering work in
greyltc/r3pcomms.
Credit where credit is due — without that project this would have required
significantly more effort.
Issues and pull requests are welcome on the issue tracker.
This is an unofficial, community-maintained integration and is not affiliated with, endorsed by, or supported by EcoFlow. EcoFlow and River are trademarks of their respective owners. Use at your own risk.