--- title: "EF-PowerOcean-TcpModbus" description: "EF-PowerOcean-TcpModbus is a Marketplace integration for Home Assistant. It has 52 installs sharing analytics, works locally and was last updated November 13, 2026." canonical: "https://vulpo.app/integrations/marketplace/maxgrmm-ef-powerocean-tcpmodbus" url: "https://vulpo.app/integrations/marketplace/maxgrmm-ef-powerocean-tcpmodbus.md" last-updated: "2026-11-14" version: "1.4" --- # EF-PowerOcean-TcpModbus > EF-PowerOcean-TcpModbus is a Marketplace integration for Home Assistant. It has 52 installs sharing analytics, works locally and was last updated November 13, 2026. 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](https://vulpo.app/support) [Open in My Home Assistant](https://my.home-assistant.io/redirect/marketplace_repository/?owner=MaxGrmm&repository=EF-PowerOcean-TcpModbus&category=integration) On Home Assistant 2026.10 or older? [Open it in HACS](https://my.home-assistant.io/redirect/hacs_repository/?owner=MaxGrmm&repository=EF-PowerOcean-TcpModbus&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### EcoFlow PowerOcean - **IP Address**: Local IP address of the inverter. - **Modbus TCP Port**: Default is 502 Also asked when changing the connection. ### EcoFlow PowerOcean - **Inverter model**: Select the inverter model. - **Battery module count**: Count 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 power**: In 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 model**: Select the inverter model. - **Battery module count**: Count 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 power**: In 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 Reserve**: Native: 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 values**: Removes every correction, so each total shows what the inverter reports. The values above are ignored. Texts from the code of [MaxGrmm/EF-PowerOcean-TcpModbus](https://github.com/MaxGrmm/EF-PowerOcean-TcpModbus). ## Entities - **Binary sensors**: Modbus Control, Self-powered Mode, Intelligent Mode, System Fault, System Powered On, Modbus Control (Device), BMS Connected - **Numbers**: Battery Charge Power, Battery Discharge Power, Grid Export Power, Grid Import Power, Solar Export Limit, Battery Charge Limit, Battery Reserve, LED Brightness - **Selects**: Battery Mode - **Sensors**: System 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 - **Switches**: Modbus Control, Battery Saver Mode, Grid Feed-in, Charge to Battery Reserve ## Actions - **Set battery command**: Sets the Battery Mode, its power and the Charge Limit in one step, optionally for a limited time. Meant for automations and battery planners. Fields: Inverter, Mode, Power, Charge limit, Expire in - **Run control test**: Checks 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. Fields: Inverter, Confirm, Test power - **Cancel control test**: Stops a running control test. The inverter is returned to the default method and handed back to the EcoFlow app. Fields: Inverter ## Troubleshooting - **Diagnostics**: Downloads 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 From the README of [MaxGrmm/EF-PowerOcean-TcpModbus](https://github.com/MaxGrmm/EF-PowerOcean-TcpModbus#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Number: 52 installs sharing analytics; 36 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.9.5, last updated November 13, 2026 - Domain: `ef_powerocean_tcpmodbus` - Source: - Issues: 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 these numbers](https://vulpo.app/integrations/about) Last updated 2026-11-14. Source: https://vulpo.app/integrations/marketplace/maxgrmm-ef-powerocean-tcpmodbus --- - HTML version of this page: https://vulpo.app/integrations/marketplace/maxgrmm-ef-powerocean-tcpmodbus - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml