On Home Assistant 2026.10 or older? Open it in HACS
- Installs
- 52 sharing analytics
- GitHub stars
- 36
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v2.9.5,
- Category
- Energy, Solar and batteries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
ef_powerocean_tcpmodbus- Issues
- Report an issue
Shows in Vulpo Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.
Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.
About
EF-PowerOcean-TcpModbus is a local Modbus TCP integration for the EcoFlow PowerOcean home battery system. It polls the inverter over the local network, so no EcoFlow cloud account is needed, and the poll interval can be set between 2 and 30 seconds. It adds sensors for power flow, battery state including per-module charge, solar strings, AC phase values, energy totals and faults, which can feed the Energy dashboard. Optional battery controls offer a battery mode selector, charge and discharge power numbers, and switches such as grid feed-in, plus an action to set the battery command for automations. A control test action checks which control methods the inverter firmware follows and writes a report, and a diagnostics download is available. It is set up in the UI, and Modbus must first be enabled on the inverter by an installer.
Automatic summary of the README and code of MaxGrmm/EF-PowerOcean-TcpModbus. Something wrong, or are you the maintainer and want your own text here? Get in touch
Shows in Vulpo
Quick Toggle card, Select card, Chart card, Apple Watch, Control Center.Installs over time
#1,536 of 1,584 Marketplace integrations. Installs sharing analytics.
Supports
- Works locallyTalks to your devices on your own network. No vendor cloud in between.
- From the MarketplaceInstalled through the Marketplace, formerly HACS.
- Actively maintainedIts author released or pushed a change in the last six months.
Provides
- Switches
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
EcoFlow PowerOcean
- IP AddressLocal IP address of the inverter.
- Modbus TCP PortDefault is 502
Also asked when changing the connection.
EcoFlow PowerOcean
- Inverter modelSelect the inverter model.
- Battery module countCount of your battery modules.
- Maximum solar power [W]Maximum solar power
- Maximum grid power [W]Most your grid connection can import or export, set by your main fuse. Not the inverter rating: the house alone can draw more than that.
- Poll Interval [s]How often values are polled (2-30 seconds)
- Calculation of solar powerIn some inverters, the modbus register delivers 0W of solar power. This switch allows the solar power to be calculated from the individual powers of the string.
After setup
- Inverter modelSelect the inverter model.
- Battery module countCount of your battery modules.
- Maximum solar power [W]Maximum solar power
- Maximum grid power [W]Most your grid connection can import or export, set by your main fuse. Not the inverter rating: the house alone can draw more than that.
- Poll Interval [s]How often values are polled (2-30 seconds)
- Calculation of solar powerIn some inverters, the modbus register delivers 0W of solar power. This switch allows the solar power to be calculated from the individual powers of the string.
- Battery ReserveNative: the inverter enforces the reserve itself, like the one set in the EcoFlow app, but not every model accepts a change to it over Modbus. Emulated: the integration imitates the app's reserve with its own logic, while Modbus Control is on. Set for your model; change it only to test a model.
- Grid Import Total
- Grid Export Total
- Battery Charged Total
- Battery Discharged Total
- Solar Yield Total
- Reset all totals to the inverter's valuesRemoves every correction, so each total shows what the inverter reports. The values above are ignored.
Texts from the code of MaxGrmm/EF-PowerOcean-TcpModbus.
Entities
- Binary sensorsModbus Control, Self-powered Mode, Intelligent Mode, System Fault, System Powered On, Modbus Control (Device), BMS Connected
- NumbersBattery Charge Power, Battery Discharge Power, Grid Export Power, Grid Import Power, Solar Export Limit, Battery Charge Limit, Battery Reserve, LED Brightness
- SelectsBattery Mode
- SensorsSystem Modes, System Power Setpoint, Inverter Power Setpoint, Battery Power Setpoint, Battery Module Count, Battery SOC, Battery 1 SOC, Battery 2 SOC, Battery 3 SOC, Battery 4 SOC, Battery 5 SOC, Battery 6 SOC, and 95 more
- SwitchesModbus Control, Battery Saver Mode, Grid Feed-in, Charge to Battery Reserve
Actions
- Set battery commandSets the Battery Mode, its power and the Charge Limit in one step, optionally for a limited time. Meant for automations and battery planners.
- Inverter
- Mode
- Power
- Charge limit
- Expire in
- Run control testChecks which control methods this inverter's firmware follows, as scripts/control_feature_scan.py does, and writes a report to attach to a GitHub issue. If Modbus Control is on, the selected battery mode pauses for the test and resumes after it. The battery charges and discharges briefly at the test power, and the inverter is handed back to the EcoFlow app at the end. Takes about 10 minutes. The action returns at once; the Control Test sensor follows the run, and a notification says when the report is ready.
- Inverter
- Confirm
- Test power
- Cancel control testStops a running control test. The inverter is returned to the default method and handed back to the EcoFlow app.
- Inverter
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
Local Modbus TCP integration for the EcoFlow PowerOcean home battery system.
⚠️ This integration communicates directly with your device over your local network via Modbus TCP. No cloud connection required.
- Local polling – no EcoFlow cloud account needed
- Configurable poll interval (2–30 seconds, default 5 s)
- Real-time power flow: house consumption, grid import/export, solar generation, battery
- Optional Battery Controls: charge, discharge, hold, export, import or export solar first, with state-of-charge guards and a grid feed-in switch
- Full battery monitoring: SOC, voltage, current, power, temperature, remaining energy
- Per-module state of charge for up to 12 battery modules
- Per-string PV power, current and voltage (1–3 strings)
- Per-phase AC measurements: voltage, current, frequency
- Energy counters: daily and lifetime for grid, solar, battery charge/discharge, house consumption
- Operating mode, grid mode and system status as dedicated entities
- Fault reporting: active fault count, and the fault codes with their names where known
- Serial number and firmware version read from the device. The model it reports pre-fills the setup form; the model you select is the one the integration uses
Information
- Installs
- 52 sharing analytics
- GitHub stars
- 36
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v2.9.5,
- Category
- Energy, Solar and batteries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
ef_powerocean_tcpmodbus- Issues
- Report an issue
