Frequently asked questions
Does it need the Marstek cloud or an account?
No. Home Assistant talks to the battery directly on your network. You still need the Marstek app once, to set up the battery and turn on Open API, the local interface the integration talks to.
Can I keep using the Marstek app?
Yes. The app and Home Assistant can both see the battery. A change made in the app shows up in Home Assistant the next time it asks the battery for data, within 30 seconds by default. Settings the Open API can't read back, such as depth of discharge, never show up. See Limitations. Marstek says enabling Open API may disable some app features to prevent conflicting commands.
Is it safe for my battery?
The integration is built to go easy on the battery. By default it sends one request at a time, it only offers controls the battery's firmware is known to accept, and it leaves risky requests off. Still, some Marstek firmware misbehaves when it is polled, and the Open API is provided by Marstek "as is". Keep the battery firmware up to date, and read Limitations. The project comes with no warranty.
Is it secure?
The Open API has no password. Anyone on the same network can read and control the battery once it's on. Keep the battery on a trusted network, not a guest network. The integration itself sends nothing outside your network.
How often does it update?
Power and charge every 30 seconds, solar every 60 seconds, and diagnostics every 5 minutes. You can change these under Configure on the battery. Going faster puts more load on the battery and isn't recommended. See Options.
Why is a sensor missing?
Most often the battery's firmware doesn't support it, so the integration leaves it out. Solar sensors only exist on Venus A and Venus D. Battery details such as temperature start disabled, and on older, fragile firmware they are left out completely. Venus C below firmware 155 has no grid meter sensors. See Entities and troubleshooting.
Why did my battery go unavailable?
Usually a network hiccup or a battery restart. The integration keeps the last values until three polls in a row have failed, then marks it unavailable. You can change that number under Configure > Network Settings (Failures before unavailable). Why a battery goes offline explains the different cases and how to tell them apart.
Is it as reliable as a Modbus integration?
Not quite, and it's worth knowing why. Modbus uses a wired connection and doesn't depend on the Open API at all. The Open API needs no extra hardware, but it runs over Wi-Fi, drops some replies, and older firmware can switch it off or reset settings when polled. On firmware 150 or newer, Venus A, D, and E 3.0 are not known to reset when polled. Venus C has its own caveat. If your battery keeps resetting anyway, read Limitations and consider a Modbus integration.
Can I run it next to a Modbus integration?
They use separate connections on the battery, so both can be installed. Both can also change the operating mode, though, so let only one of them control the battery. One owner reported having to disconnect Modbus before firmware 150 would install. If an update stalls, try that first.
Can it keep my grid import at zero?
Let the battery do that itself. In Auto mode it follows its CT meter and reacts within seconds. Home Assistant only sees new values every 30 seconds. An automation that chases a P1 meter (a reader on the data port of many European smart meters) by changing the power in Passive mode will lag behind and overshoot.
No Marstek CT meter, but a P1 reading or another grid meter in Home Assistant? AstraMeter can pose as a Marstek CT meter and feed it that reading, so Auto mode follows your existing meter.
Does it support peak shaving?
Not as a setting the battery enforces. The Marstek app's Peak shaving (maximum grid import) is not part of the Open API on firmware 150 or 151, so no Open API integration can read or change it. Marstek only offers it through its cloud link (MQTT) and Bluetooth. If a later firmware adds it, the integration will follow (#122).
You can still charge in the day and discharge in the evening with a manual schedule. That is a timetable, not a live cap on grid import, and it will not react as fast as Auto mode. The copy-paste example is weekday charging and evening discharge.
How do I get a notification when the battery is low?
Use the Battery low sensor. Home Assistant's battery triggers list it under Battery became low. A ready-to-paste automation, including one that stays quiet while the battery is already charging, is in Battery automations. The trip level follows the discharge cutoff unless you set a fixed percentage under Configure.
Can I show charging on the iPhone Lock Screen?
Yes, with the Home Assistant Companion app. This integration does not send the notification. A paste-ready automation updates about every 5% while Charging is on, and removes the activity when charging stops. The same page has a discharge example. See Lock Screen and Dynamic Island.
Does it work with more than one battery?
Yes. Add each battery separately. The Battery health dashboard shows them side by side.
Can I control the battery from the Energy dashboard?
No. The Energy dashboard only shows energy. Control comes from the Operating mode select, device actions, and services in automations. See Automations and services.
How do I update the integration?
HACS shows an update when a new release is out. Install it and restart Home Assistant. The changelog lists what changed.
How do I remove it?
Delete each battery under Settings > Devices & services > Marstek, then remove the integration in HACS and restart. See Installation and the README.
Where do I get help?
- Search Troubleshooting first.
- Then check existing issues, or open a new one with debug logs and diagnostics.
- Marstek support can't help with this integration. It is an independent project.