Skip to content

Will it work for me? ​

Short answer: it works with Venus A, Venus C, Venus D, Venus E 3.0, and Venus E mini. Venus E 2.0 can be added too, with an experimental-support warning. Venus C and Venus E 2.0 share one serious caveat.

The table uses a few battery terms. Depth of discharge is how low the battery may discharge. UPS mode is a backup-power mode. The CT meter is the clamp-on meter at your fuse box that measures grid power. The glossary has the rest.

Supported batteries ​

BatteryWorks?What to know
Venus E 3.0YesThe most tested model. Depth of discharge, LED, Bluetooth, and UPS mode from firmware 150. Ten schedule slots.
Venus AYesAdds solar (PV) sensors. The extra controls need firmware 150, as on Venus E 3.0.
Venus DYesAdds up to four solar (PV) inputs. The extra controls need firmware 150.
Venus E miniMostlySix schedule slots. Depth of discharge, LED, and Bluetooth controls. UPS mode on firmware 301. Firmware 301 refuses passive mode. Add it by IP address, and keep it on a network with the usual home router settings. See Venus E mini notes.
Venus CWith a caveatHome Assistant's regular requests can stop Auto mode from charging on excess solar. Depth of discharge, the panel LED, and Bluetooth from firmware 158. UPS is not offered. Read the caveat.
Venus E 2.0ExperimentalSame HMG-50 board and the same features as Venus C on the same firmware. Support is community-tested. Home Assistant shows a repair warning and still adds the battery.
Other Marstek devices with Open APIMaybeTreated as an unknown model and given only the safest features. Untested.

What each model can do ​

The integration reads the model and the firmware number and only creates the controls that firmware accepts. A cell is what a new install gets.

Venus E 3.0Venus AVenus DVenus E miniVenus C and Venus E 2.0
Solar sensorsNoYesYes, four inputsNoNo
Grid meter powerYesYesYesYesFrom firmware 155
Depth of discharge, panel LED, BluetoothFrom firmware 150From firmware 150From firmware 150Any known firmwareFrom firmware 158
UPS modeFrom firmware 150From firmware 150From firmware 150From firmware 150 (tested on 301)No
Passive modeYesYesYesYes, except firmware 301Yes
Manual schedule slots0–90–90–90–50–9
Open API reset warningBelow firmware 150Below firmware 150Below firmware 150Below firmware 150, or an unknown numberBelow firmware 156

Venus C and Venus E 2.0 also share one Wi-Fi channel between Open API and the battery's own meter. Read the caveat before leaving Auto mode on.

How do I tell Venus E 2.0 from Venus E 3.0?

Check the model name in the Marstek app or on the label. Venus E 3.0 reports itself as VenusE 3.0 or VNSE3-0. Venus E 2.0 reports VenusE. Adding a Venus E 2.0 shows a warning and continues. It does not become a Venus E 3.0.

Firmware matters ​

Marstek ships features through firmware updates, and older firmware misbehaves more. The integration reads the firmware number from the battery and turns features on or off to match. A control your battery would reject is left off the device page, instead of showing up and failing.

To see your battery's firmware number, open its device page in Home Assistant (Settings > Devices & services > Marstek > your battery). It is listed under Device info. Home Assistant shows it the way the battery reports it, so app version 147.6 appears as 1476.

  • Firmware 150 or newer on Venus A, D, and E 3.0 unlocks depth of discharge, the panel LED, Bluetooth advertising, and UPS mode. On Venus C and Venus E 2.0, depth of discharge, the panel LED, and Bluetooth start at firmware 158 (Open API ver 1581 is the 158.1 beta and counts as 158). UPS stays off on that board: firmware 158 accepts the command and then reports Manual.
  • Firmware below 150 on those models is known to switch its Open API off, and sometimes reset its settings, when Home Assistant asks it for data at regular intervals. Venus C below 156 and Venus E mini 145 are treated the same way to be safe. Home Assistant shows a warning in Settings > System > Repairs for these versions. Update the battery in the Marstek app if you can. See troubleshooting.
  • After a firmware update, the integration notices the new version on its own within about 10 minutes and adds or removes controls. You don't need to remove and re-add the battery.

Tested firmware versions ​

Every row in the test matrix is covered by the automated tests, which simulate each version. Most versions have also been tested on Marstek's own unmodified firmware, running in an emulator (a program that imitates the battery's hardware on a computer). A few versions have no public firmware download, so they are only simulated.

  • Venus E 3.0: 144, 145, 147, 147.6, 148, 149, 150, 151
  • Venus A: 148, 148.7, 149, 149.1, 150, 150.9, 151
  • Venus D: 145, 147, 149, 149.2, 150, 151
  • Venus C: 153, 155, 156, 158, 158.1
  • Venus E 2.0: the same HMG-50 images, reporting VenusE
  • Venus E mini: 145, 301

Missing yours? Open a firmware coverage issue. Owner reports are the best evidence there is.

Venus C caveat ​

Venus C uses a different controller board than Venus A, D, and E 3.0. Marstek calls it HMG-50. On that board, the Open API and the battery's own link to its grid meter share one Wi-Fi channel. When Home Assistant asks the battery for data, some meter readings get lost. In Auto (self-consumption) mode, enough lost readings make the battery think the meter is gone. It then stops charging from excess solar (#82).

None of the firmware checked so far fixes this. 158 and the 158.1 beta still use one hard-coded Wi-Fi receive channel (+QIURC: "recv",3), the same path as 153, 155 and 156.

On Venus E 2.0 firmware 158, one owner got charging, discharging and Auto working from their own script. The script spaced its commands about 30 seconds apart (#121). This integration can add that battery. The meter channel is unchanged, so the same stall can still happen.

If you own a Venus C:

  • Make Home Assistant ask less often: raise the polling intervals under Configure > Polling Intervals.
  • Read grid power from your meter's own integration (HomeWizard P1, Shelly) instead of from the battery.
  • If Auto mode keeps stalling, poll less, or stop polling the battery for a while. That is the only reliable fix known today.
  • Looking at other integrations? Most of the Modbus ones (they use a wired connection) in the comparison don't list Venus C. hm2mqtt does, over MQTT.

Venus E 2.0 uses the same controller board. The integration adds it and shows a repair warning that support is experimental. You can ignore that warning. The controls match Venus C on the same firmware: depth of discharge, Panel LED, and Bluetooth advertising from 158, and not before. UPS is not one of them.

Venus E mini notes ​

Venus E mini works, but it differs from the other models in a few ways (#86):

  • Add it by IP address. It doesn't answer when Home Assistant searches the network, so it won't show up in the list of found batteries. Choose Enter IP/port manually when you add the battery.
  • Keep it on a normal /24 home network. Firmware 301 sends its replies to an address that only works when the network uses the usual home-router subnet mask, 255.255.255.0 (also written /24).
  • Six schedule slots, not ten. Manual schedules with a power value work since integration version 1.3.2. If one is refused, turn off any schedule in the Marstek app that overlaps it.
  • No Passive mode on firmware 301. The firmware doesn't have it, so the integration leaves it out. Auto, AI, Manual, and UPS work.
  • Depth of discharge, the panel LED, and Bluetooth advertising are available.

Venus E mini troubleshooting has the details.

What else you need ​

  • Home Assistant 2025.10 or newer.
  • The same network. Home Assistant and the battery must be able to reach each other. Automatic discovery only finds the battery when both are on the same network. If the battery is on a separate network (VLAN), it still works when you type its IP address.
  • Open API switched on in the Marstek app. Before you start covers this.

Next ​

Go through Before you start, then follow Getting started.