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)