Saltar a contenido

Complete Marstek register table (English only)

This table documents the Marstek register definitions used by Omnibattery. It is intentionally maintained in English only so addresses, types, scales, and safety notes have one technical source.

Read before writing

Rows described as switches, selects, numbers, schedules, or commands can change battery operation. Use Omnibattery entities where possible and verify the configured hardware family before any direct write.

Key / Name Description Type Bytes Scale Unit a d e_v12 e_v3
device_name Device name (string) char 20 - - 31000 31000 31000 31000
sn_code Device serial / SN code char 20 - - 31200
software_version Device software version uint16 2 0.01 - 31100
bms_version BMS firmware version uint16 2 - - 30204 30204 31102 30204
vms_version VMS firmware version uint16 2 - - 30202 30202 30202
ems_version EMS firmware version (special formatting) uint16 2 1 - 30200 30200 31101 30200
mac_address MAC address char 12 - - 30304 30304 30402 30304
comm_module_firmware Communication module firmware char 12 - - 30350 30350 30800 30350
wifi_signal_strength WiFi RSSI uint16 2 -1 dBm 30303 30303 30303 30303
bluetooth_status Bluetooth connectivity/status uint16 2 - - 30301 30301 30301 30301
wifi_status (binary) WiFi connected (0/1) uint16 2 1 - 30300 30300 30300 30300
cloud_status (binary) Cloud connected (0/1) uint16 2 1 - 30302 30302 30302 30302
battery_soc State of charge uint16 2 1 % 32104 32104 32104 37005
battery_soc_pack_1 Pack 1 state of charge (issue #350) uint16 2 0.1 % 34002 34002
battery_soc_pack_2 Pack 2 state of charge (issue #350) uint16 2 0.1 % 34102 34102
battery_soc_pack_3 Pack 3 state of charge (issue #350) uint16 2 0.1 % 34202 34202
battery_soc_pack_4 Pack 4 state of charge (issue #350) uint16 2 0.1 % 34302 34302
battery_soc_pack_5 Pack 5 state of charge (issue #350) uint16 2 0.1 % 34402 34402
battery_soc_pack_6 Pack 6 state of charge (issue #350) uint16 2 0.1 % 34502 34502
battery_total_energy Total stored energy uint16 2 0.001 kWh 32105 32105 32105 32105
battery_voltage Battery voltage uint16 2 0.01 V 30100 30100 32100 30100
battery_current Battery current int16 2 0.1/0.01 A 30101 30101 32101 30101
battery_power Battery power int16/32 2/4 1 W 30001 30001 32102 30001
total_charging_energy Total charging energy uint32 4 0.01 kWh 33000 33000 33000 33000
total_discharging_energy Total discharging energy int32 4 0.01 kWh 33002 33002 33002 33002
total_daily_charging_energy Total daily charging energy uint32 4 0.01 kWh 33004 33004 33004 33004
total_daily_discharging_energy Total daily discharging energy int32 4 0.01 kWh 33006 33006 33006 33006
total_monthly_charging_energy Total monthly charging energy uint32 4 0.01 kWh 33008 33008 33008 33008
total_monthly_discharging_energy Total monthly discharging energy int32 4 0.01 kWh 33010 33010 33010 33010
battery_cycle_count Native cycle counter uint16 2 1 - 34003 34003 34003
ac_voltage AC voltage uint16 2 0.1 V 32200 32200 32200 32200
ac_current AC current int16 2 0.004/0.01 A 37004 37004 32201 37004
ac_power AC power int16/32 2/4 1 W 30006 30006 32202 30006
ac_frequency AC frequency int16 2 0.1/0.01 Hz 32204 32204 32204 32204
ac_offgrid_voltage AC offgrid voltage uint16 2 0.1 V 32300 32300 32300 32300
ac_offgrid_current AC offgrid current uint16 2 0.01 A 32301 32301 32301 32301
ac_offgrid_power AC offgrid power int32 4 1 W 32302 32302 32302 32302
internal_temperature Internal device temperature int16 2 0.1 °C 35000 35000 35000 35000
internal_mos1_temperature MOS1 internal temperature int16 2 0.1 °C 35001 35001 35001 35001
internal_mos2_temperature MOS2 internal temperature int16 2 0.1 °C 35002 35002 35002 35002
max_cell_temperature Max cell temperature int16 2 0.1/1 °C 35010 35010 35010 35010
max_cell_voltage Max cell voltage uint16 2 0.001 V 37007 37007 37007 37007
min_cell_voltage Min cell voltage uint16 2 0.001 V 37008 37008 37008 37008
max_cell_voltage_pack_n Pack n max cell voltage — 34005 + 100·(n−1), n = 1..7 (issue #439) int16 2 0.001 V 34005 34005
min_cell_voltage_pack_n Pack n min cell voltage — 34006 + 100·(n−1), n = 1..7 (issue #439) int16 2 0.001 V 34006 34006
battery_1_cell_1_voltage Battery pack 1 cell 1 voltage int16 2 0.001 V 34018 34018 34018
battery_1_cell_2_voltage Battery pack 1 cell 2 voltage int16 2 0.001 V 34019 34019 34019
battery_1_cell_3_voltage Battery pack 1 cell 3 voltage int16 2 0.001 V 34020 34020 34020
battery_1_cell_4_voltage Battery pack 1 cell 4 voltage int16 2 0.001 V 34021 34021 34021
battery_1_cell_5_voltage Battery pack 1 cell 5 voltage int16 2 0.001 V 34022 34022 34022
battery_1_cell_6_voltage Battery pack 1 cell 6 voltage int16 2 0.001 V 34023 34023 34023
battery_1_cell_7_voltage Battery pack 1 cell 7 voltage int16 2 0.001 V 34024 34024 34024
battery_1_cell_8_voltage Battery pack 1 cell 8 voltage int16 2 0.001 V 34025 34025 34025
battery_1_cell_9_voltage Battery pack 1 cell 9 voltage int16 2 0.001 V 34026 34026 34026
battery_1_cell_10_voltage Battery pack 1 cell 10 voltage int16 2 0.001 V 34027 34027 34027
battery_1_cell_11_voltage Battery pack 1 cell 11 voltage int16 2 0.001 V 34028 34028 34028
battery_1_cell_12_voltage Battery pack 1 cell 12 voltage int16 2 0.001 V 34029 34029 34029
battery_1_cell_13_voltage Battery pack 1 cell 13 voltage int16 2 0.001 V 34030 34030 34030
battery_1_cell_14_voltage Battery pack 1 cell 14 voltage int16 2 0.001 V 34031 34031
battery_1_cell_15_voltage Battery pack 1 cell 15 voltage int16 2 0.001 V 34032 34032
battery_1_cell_16_voltage Battery pack 1 cell 16 voltage int16 2 0.001 V 34033 34033
battery_2_cell_1_voltage Battery pack 2 cell 1 voltage int16 2 0.001 V 34118
battery_2_cell_2_voltage Battery pack 2 cell 2 voltage int16 2 0.001 V 34119
battery_2_cell_3_voltage Battery pack 2 cell 3 voltage int16 2 0.001 V 34120
battery_2_cell_4_voltage Battery pack 2 cell 4 voltage int16 2 0.001 V 34121
battery_2_cell_5_voltage Battery pack 2 cell 5 voltage int16 2 0.001 V 34122
battery_2_cell_6_voltage Battery pack 2 cell 6 voltage int16 2 0.001 V 34123
battery_2_cell_7_voltage Battery pack 2 cell 7 voltage int16 2 0.001 V 34124
battery_2_cell_8_voltage Battery pack 2 cell 8 voltage int16 2 0.001 V 34125
battery_2_cell_9_voltage Battery pack 2 cell 9 voltage int16 2 0.001 V 34126
battery_2_cell_10_voltage Battery pack 2 cell 10 voltage int16 2 0.001 V 34127
battery_2_cell_11_voltage Battery pack 2 cell 11 voltage int16 2 0.001 V 34128
battery_2_cell_12_voltage Battery pack 2 cell 12 voltage int16 2 0.001 V 34129
battery_2_cell_13_voltage Battery pack 2 cell 13 voltage int16 2 0.001 V 34130
battery_3_cell_1_voltage Battery pack 3 cell 1 voltage int16 2 0.001 V 34218
battery_3_cell_2_voltage Battery pack 3 cell 2 voltage int16 2 0.001 V 34219
battery_3_cell_3_voltage Battery pack 3 cell 3 voltage int16 2 0.001 V 34220
battery_3_cell_4_voltage Battery pack 3 cell 4 voltage int16 2 0.001 V 34221
battery_3_cell_5_voltage Battery pack 3 cell 5 voltage int16 2 0.001 V 34222
battery_3_cell_6_voltage Battery pack 3 cell 6 voltage int16 2 0.001 V 34223
battery_3_cell_7_voltage Battery pack 3 cell 7 voltage int16 2 0.001 V 34224
battery_3_cell_8_voltage Battery pack 3 cell 8 voltage int16 2 0.001 V 34225
battery_3_cell_9_voltage Battery pack 3 cell 9 voltage int16 2 0.001 V 34226
battery_3_cell_10_voltage Battery pack 3 cell 10 voltage int16 2 0.001 V 34227
battery_3_cell_11_voltage Battery pack 3 cell 11 voltage int16 2 0.001 V 34228
battery_3_cell_12_voltage Battery pack 3 cell 12 voltage int16 2 0.001 V 34229
battery_3_cell_13_voltage Battery pack 3 cell 13 voltage int16 2 0.001 V 34230
battery_4_cell_1_voltage Battery pack 4 cell 1 voltage int16 2 0.001 V 34318
battery_4_cell_2_voltage Battery pack 4 cell 2 voltage int16 2 0.001 V 34319
battery_4_cell_3_voltage Battery pack 4 cell 3 voltage int16 2 0.001 V 34320
battery_4_cell_4_voltage Battery pack 4 cell 4 voltage int16 2 0.001 V 34321
battery_4_cell_5_voltage Battery pack 4 cell 5 voltage int16 2 0.001 V 34322
battery_4_cell_6_voltage Battery pack 4 cell 6 voltage int16 2 0.001 V 34323
battery_4_cell_7_voltage Battery pack 4 cell 7 voltage int16 2 0.001 V 34324
battery_4_cell_8_voltage Battery pack 4 cell 8 voltage int16 2 0.001 V 34325
battery_4_cell_9_voltage Battery pack 4 cell 9 voltage int16 2 0.001 V 34326
battery_4_cell_10_voltage Battery pack 4 cell 10 voltage int16 2 0.001 V 34327
battery_4_cell_11_voltage Battery pack 4 cell 11 voltage int16 2 0.001 V 34328
battery_4_cell_12_voltage Battery pack 4 cell 12 voltage int16 2 0.001 V 34329
battery_4_cell_13_voltage Battery pack 4 cell 13 voltage int16 2 0.001 V 34330
battery_5_cell_1_voltage Battery pack 5 cell 1 voltage int16 2 0.001 V 34418
battery_5_cell_2_voltage Battery pack 5 cell 2 voltage int16 2 0.001 V 34419
battery_5_cell_3_voltage Battery pack 5 cell 3 voltage int16 2 0.001 V 34420
battery_5_cell_4_voltage Battery pack 5 cell 4 voltage int16 2 0.001 V 34421
battery_5_cell_5_voltage Battery pack 5 cell 5 voltage int16 2 0.001 V 34422
battery_5_cell_6_voltage Battery pack 5 cell 6 voltage int16 2 0.001 V 34423
battery_5_cell_7_voltage Battery pack 5 cell 7 voltage int16 2 0.001 V 34424
battery_5_cell_8_voltage Battery pack 5 cell 8 voltage int16 2 0.001 V 34425
battery_5_cell_9_voltage Battery pack 5 cell 9 voltage int16 2 0.001 V 34426
battery_5_cell_10_voltage Battery pack 5 cell 10 voltage int16 2 0.001 V 34427
battery_5_cell_11_voltage Battery pack 5 cell 11 voltage int16 2 0.001 V 34428
battery_5_cell_12_voltage Battery pack 5 cell 12 voltage int16 2 0.001 V 34429
battery_5_cell_13_voltage Battery pack 5 cell 13 voltage int16 2 0.001 V 34430
battery_6_cell_1_voltage Battery pack 6 cell 1 voltage int16 2 0.001 V 34518
battery_6_cell_2_voltage Battery pack 6 cell 2 voltage int16 2 0.001 V 34519
battery_6_cell_3_voltage Battery pack 6 cell 3 voltage int16 2 0.001 V 34520
battery_6_cell_4_voltage Battery pack 6 cell 4 voltage int16 2 0.001 V 34521
battery_6_cell_5_voltage Battery pack 6 cell 5 voltage int16 2 0.001 V 34522
battery_6_cell_6_voltage Battery pack 6 cell 6 voltage int16 2 0.001 V 34523
battery_6_cell_7_voltage Battery pack 6 cell 7 voltage int16 2 0.001 V 34524
battery_6_cell_8_voltage Battery pack 6 cell 8 voltage int16 2 0.001 V 34525
battery_6_cell_9_voltage Battery pack 6 cell 9 voltage int16 2 0.001 V 34526
battery_6_cell_10_voltage Battery pack 6 cell 10 voltage int16 2 0.001 V 34527
battery_6_cell_11_voltage Battery pack 6 cell 11 voltage int16 2 0.001 V 34528
battery_6_cell_12_voltage Battery pack 6 cell 12 voltage int16 2 0.001 V 34529
battery_6_cell_13_voltage Battery pack 6 cell 13 voltage int16 2 0.001 V 34530
mppt1_voltage MPPT1 array voltage uint16 2 0.1 V 30020 30020
mppt1_current MPPT1 array current uint16 2 0.1 A 30024 30024
mppt1_power MPPT1 array power uint16 2 0.1 W 30037 30037
mppt2_voltage MPPT2 array voltage uint16 2 0.1 V 30021 30021
mppt2_current MPPT2 array current uint16 2 0.1 A 30025 30025
mppt2_power MPPT2 array power uint16 2 0.1 W 30038 30038
mppt3_voltage MPPT3 array voltage uint16 2 0.1 V 30022 30022
mppt3_current MPPT3 array current uint16 2 0.1 A 30026 30026
mppt3_power MPPT3 array power uint16 2 0.1 W 30039 30039
mppt4_voltage MPPT4 array voltage uint16 2 0.1 V 30023 30023
mppt4_current MPPT4 array current uint16 2 0.1 A 30027 30027
mppt4_power MPPT4 array power uint16 2 0.1 W 30040 30040
inverter_state Inverter / device state uint16 2 1 - 35100 35100 35100 35100
fault_status Fault status bits uint64 8 - - 36100
alarm_status Alarm status bits uint32 4 - - 36000
modbus_address Modbus slave/unit id uint16 2 - - 41100 41100 41100 41100
rs485_control_mode (switch) RS485 control mode (write commands) uint16 2 - - 42000 42000 42000 42000
backup_function (switch) Backup function control uint16 2 - - 41200 41200 41200 41200
force_mode (select) Force mode (None/Charge/Discharge) uint16 2 - - 42010 42010 42010 42010
user_work_mode (select) User Work Mode (manual/anti_feed/trade) uint16 2 - - 43000 43000 43000 43000
discharge_limit_mode (binary) Discharge limit mode (diagnostic) uint16 2 - - 41010
grid_standard (select) Grid standard / region selection uint16 2 - - 44100
charge_to_soc (number) Charge/discharge to SOC (0-100%) uint16 2 1 % 42011 42011 42011 42011
set_charge_power (number) Forcible charge power setpoint uint16 2 - W 42020 42020 42020 42020
set_discharge_power (number) Forcible discharge power setpoint uint16 2 - W 42021 42021 42021 42021
max_charge_power (number) Max allowed charge power uint16 2 - W 44002 44002 44002 44002
max_discharge_power (number) Max allowed discharge power uint16 2 - W 44003 44003 44003 44003
charging_cutoff_capacity (number) Charging cutoff (percentage) uint16 2 0.1 % 44000
discharging_cutoff_capacity Discharging cutoff (percentage) uint16 2 0.1 % 44001
reset_device (button) Reset device command uint16 2 - - 41000 41000 41000 41000
factory_reset (button) Factory reset command uint16 2 - - 41001 41001 41001 41001
schedule_1_days Schedule 1 days (bitmask) bit 2 - - 43100 43100 43100 43100
schedule_1_start Schedule 1 start (HHMM) uint 2 - min 43101 43101 43101 43101
schedule_1_end Schedule 1 end (HHMM) uint 2 - min 43102 43102 43102 43102
schedule_1_mode Schedule 1 mode (numeric) int16 2 - W 43103 43103 43103 43103
schedule_1_enabled Schedule 1 enabled (0/1) uint 2 - - 43104 43104 43104 43104
schedule_2_days Schedule 2 days (bitmask) bit 2 - - 43105 43105 43105 43105
schedule_2_start Schedule 2 start (HHMM) uint 2 - min 43106 43106 43106 43106
schedule_2_end Schedule 2 end (HHMM) uint 2 - min 43107 43107 43107 43107
schedule_2_mode Schedule 2 mode (numeric) int16 2 - W 43108 43108 43108 43108
schedule_2_enabled Schedule 2 enabled (0/1) uint 2 - - 43109 43109 43109 43109
schedule_3_days Schedule 3 days (bitmask) bit 2 - - 43110 43110 43110 43110
schedule_3_start Schedule 3 start (HHMM) uint 2 - min 43111 43111 43111 43111
schedule_3_end Schedule 3 end (HHMM) uint 2 - min 43112 43112 43112 43112
schedule_3_mode Schedule 3 mode (numeric) int16 2 - W 43113 43113 43113 43113
schedule_3_enabled Schedule 3 enabled (0/1) uint 2 - - 43114 43114 43114 43114
schedule_4_days Schedule 4 days (bitmask) bit 2 - - 43115 43115 43115 43115
schedule_4_start Schedule 4 start (HHMM) uint 2 - min 43116 43116 43116 43116
schedule_4_end Schedule 4 end (HHMM) uint 2 - min 43117 43117 43117 43117
schedule_4_mode Schedule 4 mode (numeric) int16 2 - W 43118 43118 43118 43118
schedule_4_enabled Schedule 4 enabled (0/1) uint 2 - - 43119 43119 43119 43119
schedule_5_days Schedule 5 days (bitmask) bit 2 - - 43120 43120 43120 43120
schedule_5_start Schedule 5 start (HHMM) uint 2 - min 43121 43121 43121 43121
schedule_5_end Schedule 5 end (HHMM) uint 2 - min 43122 43122 43122 43122
schedule_5_mode Schedule 5 mode (numeric) int16 2 - W 43123 43123 43123 43123
schedule_5_enabled Schedule 5 enabled (0/1) uint 2 - - 43124 43124 43124 43124
schedule_6_days Schedule 6 days (bitmask) bit 2 - - 43125 43125 43125 43125
schedule_6_start Schedule 6 start (HHMM) uint 2 - min 43126 43126 43126 43126
schedule_6_end Schedule 6 end (HHMM) uint 2 - min 43127 43127 43127 43127
schedule_6_mode Schedule 6 mode (numeric) int16 2 - W 43128 43128 43128 43128
schedule_6_enabled Schedule 6 enabled (0/1) uint 2 - - 43129 43129 43129 43129
round_trip_efficiency_total Round-trip efficiency (total charge/discharge energies) calculated - - %
round_trip_efficiency_monthly Round-trip efficiency (monthly charge/discharge) calculated - - %
conversion_efficiency Conversion efficiency (battery ↔ AC) calculated - - %
stored_energy Stored battery energy (SOC × capacity) calculated - - kWh
battery_cycle_count_calc Cycle count calculated from total discharge and capacity calculated - - -

Notes: - Columns a, d, e_v12 and e_v3 correspond to the active Python definitions in custom_components/omnibattery/const/registers_va.py, registers_vd.py, registers_v2.py, registers_v3.py, and registers_common.py. - Venus A/D battery_soc is the aggregate at 32104; 34002 is pack 1's own SOC. The per-pack block is laid out with a stride of 100 — pack n starts at 34000 + 100·(n−1), SOC at offset +2, that pack's max/min cell voltage at +5/+6, its 16 individual cells at +18 — not as one flat run, so the column a cell addresses above are renumbered accordingly. - max_cell_voltage/min_cell_voltage on Venus A/D are pack 1's, not the battery's (issues #415, #439): firmware v150 reads 37007 and 34005 through the same source pointer 0x20014FC4, and 37008/34006 through 0x20014FC6. No device-wide max/min register exists. A Venus A/D charges one pack at a time (register 32111 is the active pack index), so 37007 describes the pack under load only while slot 1 happens to be the active one. - Bytes shows the typical byte size for the key (each Modbus register = 2 bytes). - Blank cells mean that the selected hardware definition does not expose that key, or that the value is calculated and has no direct Modbus register. - The rs485_control_mode switch (register 42000) uses write commands (command_on=21930, command_off=21947) to trigger RS485 control operations; use with caution. - For access to registers in the 42000–42999 range, the battery must be set to RS485 control mode. - Schedule Time format: start and end are entered as HHMM 24-hour integers (for example 0830 = 08:30). Use values within the valid range shown in the YAML for each device; ensure start is earlier than end for a single active period. - Schedule Day selection: the underlying schedule_*_days register uses a bitmask to represent multiple days, but the integration currently exposes it as a single-select option in Home Assistant. Due to this limitation you cannot select multiple days from the integration UI. - Schedule Mode values: schedule_*_mode accepts the following ranges: - -1 = Self consumption mode - 100 to 2500 = Charge power (W) - -100 to -2500 = Discharge power (W)