Marstek Modbus Suite for Home Assistant (Marketplace integration)

Installs: 1.2k sharing analytics
GitHub stars: 14
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 3.1.2, October 21, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Brand: Marstek
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: marstek_modbus
Source: github.com/sphings79/marstek-modbus-suite
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Marstek Modbus Suite is a custom integration that reads and controls Marstek Venus batteries over local Modbus TCP. It supports the Venus A, D, E v1/v2 and E v3, and works without a Marstek account, cloud or MQTT broker. It adds sensors, switches, numbers, selects, buttons and binary sensors, covering charge and discharge power, work and forced mode, backup and RS485 switches, and six schedules. The integration also adds its own sidebar panel with overview, cell, pack, control and system views, and needs no custom cards. Schedules that overlap on a shared day are refused, and polling intervals and the wait between Modbus requests can be changed in the options. It is set up in the UI by entering the IP address, port, unit ID and device version.

Automatic summary of the README and code of sphings79/marstek-modbus-suite. Something wrong, or are you the maintainer and want your own text here? Get in touch

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.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect to Marstek Modbus Suite

IP Address
Port
Unit ID
Device Version

Discovered devices

Device

Name the device

Device name

After setup

Modbus Unit ID
High priority interval (s)
Low priority interval (s)
Ultra-low interval (s)
IP Address
Port
Unit ID
Wait between messages (ms)Pause between two Modbus requests. Default is 80 ms. Every increase lengthens each poll cycle and the integration's startup; raise it only when a gateway drops responses otherwise.
Show DEV registers
No single-read fallbackWhen a block read fails, its registers are not read one by one afterwards. They stay unavailable until the next cycle. For analysis only; takes effect immediately.
Discharge floor (%)
Number of packs (0 = detect automatically)

Texts from the code of sphings79/marstek-modbus-suite.

Entities

Binary sensorsModbus Connection, WiFi Status, Cloud Status, BMS Lock, BMS Factory Mode, Discharge Limit
ButtonsReset Device, Factory Reset, LED Test, Read Inverter Input PB1, Inverter EEPROM Test, Pack Coding (Battery Pack Recovery), DEV 45027 BMS master reboot, DEV 45028 BMS factory reset, DEV 45002 Inverter off until reboot, DEV 45002 Inverter sleep request (brief stop), DEV 45020 PV restart (50 W reference), DEV 45021 PV off, and 3 more
NumbersSet Charge Power, Set Discharge Power, Max Charge Power, Max Discharge Power, Charging Cutoff Capacity, Discharging Cutoff Capacity, Charge to SoC, Schedule 1 Start, Schedule 2 Start, Schedule 3 Start, Schedule 4 Start, Schedule 5 Start, and 19 more
SelectsUser Work Mode, Force Mode, Grid Standard, Schedule 1 Days, Schedule 2 Days, Schedule 3 Days, Schedule 4 Days, Schedule 5 Days, Schedule 6 Days, Modbus device polling
SensorsBattery Pack 1 Voltage, Battery Pack 2 Voltage, Battery Pack 1 Current, Battery Pack 2 Current, Battery Pack 3 Voltage, Battery Pack 3 Current, Battery Pack 4 Voltage, Battery Pack 4 Current, Battery Pack 5 Voltage, Battery Pack 5 Current, Battery Pack 6 Voltage, Battery Pack 7 Voltage, and 339 more
SwitchesBackup Function, RS485 Control Mode, Schedule 1 Enabled, Schedule 2 Enabled, Schedule 3 Enabled, Schedule 4 Enabled, Schedule 5 Enabled, Schedule 6 Enabled

Actions

Set Wi-Fi credentialsWrites the Wi-Fi network name and password to the communication module of a Venus D, Venus A or Venus E v3. Advanced: needs Options > DEV registers > Show DEV registers. The firmware stores the credentials in an EEPROM area that overlaps another setting (a firmware bug), so a wrong or aborted write can leave the module with wrong credentials. Use it only when the battery is reachable another way (the app, a cable) to correct it. The password is never read back and never logged.Fields: Battery, SSID, Password