Omnibattery for Home Assistant

Omnibattery is your one stop Home Assistant integration designed to monitor and control pluggable solar batteries, as of today, the following ones are supported:

• Marstek Venus E and C (v2 and v3), Venus D and Venus A via Modbus TCP
• Zendure SolarFlow 4000 Mix Pro, 4000 Mix AC+, 3000 Mix AC+, 2400 AC+, 2400 AC Pro, 1600 AC+, 800 Pro, 800 Plus and 800 (Local API)
• Anker SOLIX Solarbank Max AC and Solarbank 4 E5000 Pro via Modbus TCP (thanks @wouterbouvy!)
• Sessy Home Battery (Looking for testers!!!)
• Hoymiles MS-A2 and HiBattery MQTT models

Key Features

• Mix and match different battery brands: Marstek, Zendure, Anker Solix, Sessy, Hoymiles MQTT and more to come!
• Zero Export/Import PD Controller: Keeps grid exchange near zero using a Proportional-Derivative algorithm.
• Integrated dashboard: All the controls and adjustments from a single place. Graphs and power flow diagram included!
• One-Click PD Profiles + Quality Sensor: Pick a tuning profile (Very smooth → Very aggressive) instead of tuning gains by hand; a control-quality sensor reports whether the result is stable, oscillating or sluggish.
• Multi-Battery Support: Manage up to 10 batteries with intelligent load sharing and SOC-based priority.
• Predictive Grid Charging: Automatically charges from the grid when solar forecast + battery won't cover tomorrow's consumption. Supports fixed time slots, dynamic pricing, and real-time pricing modes. An optional grid-charge margin (%) tops up the grid amount to hedge optimistic solar forecasts.
• Negative-price opportunistic charging: Optional Dynamic Pricing-only charging fills each battery to its configured maximum SOC during negative import-price slots, even without solar panels or a forecast energy deficit.
• Smart Pre-discharge / Anti-curtailment: Optional Dynamic Pricing-only planning creates battery headroom before forecast PV surplus at negative-injection prices, then blocks discharge during the protected window while preserving SOC floors and safety ownership.
• Time Slots: Per-battery windows with independent charge/discharge ticks, optional SOC and power overrides, and a manual mode that forces a fixed charge or discharge power. Up to 8 slots per integration.
• Weekly Full Charge: Forces 100% SOC once a week for LFP cell balancing.
• Solar-Aware Charge Delay: Holds back grid charging while solar can still cover the required energy.
• Peak Shaving: Reserves battery capacity to cover demand spikes above a configurable power threshold, keeping energy in reserve rather than covering all consumption.
• Load Exclusion: Mask high-power devices (e.g. EV chargers) so the battery doesn't try to cover them.

[!CAUTION] LIABILITY DISCLAIMER: This software is provided "as is", without warranty of any kind, express or implied. By using this integration, you acknowledge and agree that:

1. Use is at your own risk. The developer(s) assume NO RESPONSIBILITY or LIABILITY for any damage, loss, or harm resulting from the use of this software.
2. This includes, but is not limited to: damage to your batteries, inverters, home appliances, electrical system, fire, financial loss, or personal injury.
3. You are solely responsible for ensuring that your hardware is compatible and safely configured.
4. Interacting with high-voltage battery systems and Modbus registers always carries inherent risks. Incorrect settings or commands could potentially damage hardware.

If you do not agree to these terms, DO NOT install or use this integration.

Support

If you find this integration useful, you can support my work:

Documentation

Full documentation (configuration, features, entities, troubleshooting) is available at:

https://ffunes.github.io/Omnibattery/

Requirements

Requirement	Details
Battery	Marstek Venus E v2/v3, Venus A, Venus D, Zendure SolarFlow 4000 Mix Pro / 4000 Mix AC+ / 3000 Mix AC+, 2400 AC+, 2400 AC Pro, Anker SOLIX Solarbank Max AC / 4 E5000 Pro
Modbus bridge	Elfin-EW11 or compatible RS485-to-TCP converter. Venus E v3, Venus A and Venus D can also be connected via Ethernet with native Modbus TCP support. Anker Solarbank Max AC and 4 E5000 Pro use native Modbus TCP (enable in the Anker app under Third-Party Control; only one Modbus client at a time).
Wireless connection	Required for Zendure SolarFlow 4000 Mix AC+, 3000 Mix AC+, 2400 AC+ and 2400 AC Pro
Grid sensor	HA sensor measuring total grid consumption (e.g. Shelly EM3, Neurio, smart meter)
Network	Battery reachable by IP from Home Assistant
Home Assistant	Recent version (tested on 2024.x+)
Solar forecast (optional)	Prefer a sensor providing the production remaining today in kWh (Solcast, Forecast.Solar, …); whole-day sensors remain supported during the transition.

Installation

HACS (Recommended)

Search for "Omnibattery", install, and restart Home Assistant.

Manual

Download the release zip, extract the omnibattery folder, copy it to your Home Assistant custom_components directory, and restart.

Upgrading from Marstek Venus Energy Manager

Everything is preserved: all configuration (PD tuning, time slots, thresholds), entity IDs (marstek_venus_*), recorder history, long-term statistics, dashboards, automations, and daily energy counters.

[!IMPORTANT] You must pass through v2.0.6 of the old Marstek Venus Energy Manager integration before switching to Omnibattery. That release writes a configuration backup to HA's .storage that survives the domain switch. Skipping it means you may have to reconfigure everything from scratch if HACS deletes the old entries during the switch.

[!TIP] Take a full Home Assistant backup before starting (Settings → System → Backups → Create backup).

Step 1 — Write the backup while still on the old domain

In HACS, update Marstek Venus Energy Manager to v2.0.6 and restart Home Assistant. The integration loads and silently writes a backup of your entire configuration.

Step 2 — Switch to Omnibattery

Add the Omnibattery repository in HACS and install it, then restart.

Step 3 — Run the migration

After the restart, the old integration will appear broken or missing — this is expected. Go to:

Settings → Devices & Services → Add Integration → Omnibattery

The setup flow detects your existing configuration and presents a confirmation screen. Confirm to run the migration. It will:

• Recreate each config entry under the new omnibattery domain
• Repoint the entity registry without changing any entity ID or unique ID
• Copy the integration's .storage files (daily energy totals, accumulators, balance history)

Step 4 — Hard-refresh the browser

Press Ctrl+F5 so the renamed sidebar panel loads correctly.

---

Recovery: if you accidentally deleted the integration entirely

If the old config entries were deleted from Settings → Devices & Services before migrating, the backup written in Step 1 still survives. Go to Add Integration → Omnibattery — the flow will detect no live legacy entries but will find the backup and offer to restore it. Confirm to recreate everything from the backup.

---

Optional: rename system entities to omnibattery_*

After migration, system entities keep their old marstek_venus_system_* IDs. If you want to rename them, go to Settings → Devices & Services → Omnibattery → ⋯ → Recreate entity IDs. This renames them in-place with history preserved, but any automations, templates, or Energy dashboard entries that reference the old IDs must be updated manually.

Testbed Configuration

• Batteries: 1× Marstek Venus E v2, 1x Marstek Venus E v3 and 1x Zendure Solarflow 2400 AC+.
• Connectivity: Elfin-EW11 Modbus to WiFi converter.
• Metering: Shelly Pro 3EM Energy Meter.

Acknowledgements

Special thanks to ViperRNMC/marstek_venus_modbus for the Modbus register documentation that made this integration possible.