Register Map

Read-only input registers 30000–35017, transcribed from the FuturaPulse hybrid inverter Modbus protocol v0.0.3.

183 values across 34 coalesced read ranges, in twelve sections matching the chapters of the source document.

This project never writes

The writable holding registers (40001–49999, FC 0x03/0x06/0x10) are deliberately absent from this map. Only function codes 0x04 and 0x03 reads are implemented.

Addressing

Document register numbers are used verbatim as the Modbus PDU address — no 30000 offset is subtracted.

That is confirmed twice over: by the source document's own example frames (01 04 75 94 … reads register 30100) and by live traffic from a Si-Dongle-L.

# reads register 31002 directly, no offset arithmetic
sitsolar-dongle <host> --sn ... --read 31002:2

Word order

32-bit values are big-endian pairs: the low address holds the high word.

31002~31003  ->  (0, 50010)  ->  0x0000C352  ->  50.010 Hz
                 high  low

This is an easy way to silently read zero

Because the high word sits at the low address, reading a single 16-bit register out of a 32-bit pair returns only the high word. For lifetime counters that word is frequently 0, so the value reads as zero while the real figure sits one register over.

This is exactly the bug that was fixed: every lifetime total was reported as zero. As a cross-check, the decoded totals now match the vendor cloud exactly — all_charge 600.2, all_discharge 570.1, all_pv_to_battery_level 437.6, all_battery_to_grid_capacity 317.7, totalOngridPower 446.5, totalBuyGridPower 51.8 kWh.

Data types

Type	Registers	Meaning
`U16`	1	Unsigned 16-bit integer.
`S16`	1	Two's complement signed 16-bit integer.
`U32`	2	Unsigned, high word first.
`S32`	2	Signed, high word first.
`ASCII`	`length`	Two characters per register, NUL padded.
`BITFIELD`	1	Each bit is an independent flag.

The scale column converts the raw integer into the unit. For example 31000 phase_r_voltage has scale 0.1 and unit V, so a raw 2301 decodes as 230.1 V.

Enums and bit fields are decoded into human-readable names: enumerations become label, and bit fields become the active_bits list. Run sitsolar-dongle --list to see every register with its scale, unit, and notes.

Sections

Section	Range	Values
`device_info`	`30000–30082`	14
`operation_data`	`30100–30109`	8
`error_info`	`30200–30211`	12
`temperatures`	`30301–30316`	5
`ARM_data`	`30400–30421`	8
`DC_side`	`30500–30508`	9
`AC_side`	`31000–31040`	18
`EPS_parameters`	`32001–32026`	15
`battery_parameters`	`32040–32093`	33
`meter_parameters`	`33001–33043`	17
`generation_info`	`34001–34043`	27
`Italy_self-test`	`35001–35017`	17

Use --section to poll one of these in isolation, e.g. --section "AC_side".

Full map

The tables below are generated directly from registers.py, so they cannot drift from the implementation.

device_info

30000–30099 — 14 value(s)

Address	Key	Name	Type	Unit	Notes
`30000`	`device_type`	Device type	U16		6 enum labels
`30001~30010`	`serial_number`	Serial number	ASCII (10)
`30011~30019`	`model`	Inverter model	ASCII (9)
`30020~30025`	`brand`	Brand info	ASCII (6)
`30026~30033`	`manufacturer`	Manufacturer	ASCII (8)
`30034`	`inverter_version`	Inverter version	U16
`30041~30045`	`dsp1_version`	DSP1 version	ASCII (5)
`30046~30050`	`dsp2_version`	DSP2 version	ASCII (5)
`30061`	`dsp1_bootloader`	DSP1 bootloader version	U16
`30062`	`dsp2_bootloader`	DSP2 bootloader version	U16
`30070~30074`	`dsp_protocol_version`	DSP protocol version	ASCII (5)
`30075~30079`	`safety_code_version`	Safety code version	ASCII (5)
`30080`	`modbus_id`	Modbus ID	U16
`30081~30082`	`rated_power`	Rated power	U32	W

operation_data

30100–30199 — 8 value(s)

Address	Key	Name	Type	Unit	Notes
`30100`	`operation_status`	Operation status	U16		7 enum labels
`30101`	`auto_start_remaining`	Auto start time remaining	U16	s
`30103`	`mppt_input_type`	MPPT input type	U16		5 enum labels
`30104`	`mppt_string_number`	MPPT string number	U16
`30105`	`pv_string_number`	PV string number	U16
`30106`	`dc_power_flags`	DC power lose or updating signs	BITFIELD		2 named bits
`30108`	`safety_code_changed`	Safety code change flag bit	U16		2 enum labels
`30109`	`dsp_ac_power_off`	DSP AC power off	U16		2 enum labels

error_info

30200–30299 — 12 value(s)

Address	Key	Name	Type	Notes
`30200`	`dsp_error1`	DSP error 1	U16
`30201`	`dsp_error2`	DSP error 2	U16
`30202`	`dsp_error3`	DSP error 3	U16
`30203`	`dsp_error4`	DSP error 4	U16
`30204`	`dsp_error5`	DSP error 5	U16
`30205`	`dsp_error6`	DSP error 6	U16
`30206`	`dsp_error7`	DSP error 7	U16
`30207`	`dsp_warning1`	DSP warning 1	BITFIELD	14 named bits
`30208`	`dsp_warning2`	DSP warning 2	BITFIELD	10 named bits
`30209`	`dsp_warning3`	DSP warning 3	BITFIELD	11 named bits
`30210`	`dsp_warning4`	DSP warning 4	BITFIELD	the protocol document gives no chart for 30210, so its bits are unknown; codes 249+ would belong to this word
`30211`	`dsp_warning5`	DSP warning 5	U16	Chart 11: carries a decimal warning code, not a bit mask. 200 means no warning. 25 enum labels

temperatures

30300–30399 — 5 value(s)

Address	Key	Name	Type	Scale	Unit
`30301`	`cabin_temperature`	Cabin temperature	S16	`0.1`	°C
`30303`	`boost_module1_temperature`	Boost module 1 temperature	S16	`0.1`	°C
`30305`	`buckboost_temperature`	Buckboost temperature	S16	`0.1`	°C
`30307`	`dc_ac_module_temperature`	DC/AC module temperature	S16	`0.1`	°C
`30316`	`heat_sink_temperature`	Heat sink temperature	S16	`0.1`	°C

ARM_data

30400–30499 — 8 value(s)

Address	Key	Name	Type	Notes
`30400~30404`	`arm_protocol_version`	ARM protocol version	ASCII (5)
`30405~30406`	`arm_software_code_id`	ARM software code ID	ASCII (2)
`30407~30411`	`arm_software_version`	ARM software version	ASCII (5)
`30412~30416`	`bms_software_version`	BMS software version	ASCII (5)	depends on battery
`30417`	`arm_bootloader_version`	ARM bootloader version	U16
`30419`	`arm_error`	ARM error code	U16
`30420`	`arm_bit_errors1`	ARM bit errors 1	BITFIELD
`30421`	`arm_bit_errors2`	ARM bit errors 2	BITFIELD

DC_side

30500–30999 — 9 value(s)

Address	Key	Name	Type	Scale	Unit
`30500`	`total_pv_power`	Total PV power	U16	`0.01`	kW
`30501`	`pv1_voltage`	PV 1 voltage	U16	`0.1`	V
`30502`	`pv1_current`	PV 1 current	U16	`0.1`	A
`30503`	`pv1_power`	PV 1 power	U16	`0.01`	kW
`30504`	`pv1_energy_today`	E-Today (PV 1)	U16	`0.1`	kWh
`30505`	`pv2_voltage`	PV 2 voltage	U16	`0.1`	V
`30506`	`pv2_current`	PV 2 current	U16	`0.1`	A
`30507`	`pv2_power`	PV 2 power	U16	`0.01`	kW
`30508`	`pv2_energy_today`	E-Today (PV 2)	U16	`0.1`	kWh

AC_side

31000–31999 — 18 value(s)

Address	Key	Name	Type	Scale	Unit	Notes
`31000`	`phase_r_voltage`	R-phase voltage	U16	`0.1`	V
`31001`	`phase_r_current`	R-phase current	U16	`0.01`	A
`31002~31003`	`grid_frequency`	Grid frequency	U32	`0.001`	Hz
`31004~31005`	`phase_r_power`	R-phase power	S32		W
`31006`	`phase_s_voltage`	S-phase voltage	U16	`0.1`	V
`31007`	`phase_s_current`	S-phase current	U16	`0.01`	A
`31010~31011`	`phase_s_power`	S-phase power	S32		W
`31012`	`phase_t_voltage`	T-phase voltage	U16	`0.1`	V
`31013`	`phase_t_current`	T-phase current	U16	`0.01`	A
`31016~31017`	`phase_t_power`	T-phase power	S32		W	the document's table says S16 but gives the range 31016_{31017; the R and S phases are S32 at the same offset, so treat as S32}
	`31018~31019`	`inverter_p`	P_Inv	S32		W
	`31020~31021`	`inverter_q`	Q_Inv	S32		var
	`31022`	`power_factor`	Power factor	S16	`0.001`		reads a near-constant 0.999 and equals P/(3103931040) to within 0.005, but contradicts P/sqrt(P^2+Q2) _{= 0.89 measured on the same poll. The vendor's own cloud publishes the same 0.999, so this is a firmware/setpoint value, not the instantaneous PF (the spec has a separate writable 46056 Power factors adjust)}
	`31035`	`grid_line_rs`	RS grid line voltage	U16	`0.1`	V
	`31036`	`grid_line_st`	ST grid line voltage	U16	`0.1`	V
	`31037`	`grid_line_tr`	TR grid line voltage	U16	`0.1`	V
	`31038`	`grid_n_pe_voltage`	Grid N-PE voltage	S16	`0.1`	V
	`31039~31040`	`apparent_power`	Inverter output apparent power	U32		VA	the spec calls this apparent power, but it tracks P (3101831019) within 1-2 W: 419 VA vs 417 W, 425 VA vs 424 W, i.e. it is P/power_factor. True apparent power is V*I and sqrt(P^2+Q2), which agree with each other at ~470 VA -- about 50 VA higher. Do not use as S for a VA sensor; compute sqrt(P^2+Q2) instead

EPS_parameters

32000–32039 — 15 value(s)

Address	Key	Name	Type	Scale	Unit
`32001`	`eps_voltage_r`	EPS voltage R	U16	`0.1`	V
`32002`	`eps_current_r`	EPS current R	U16	`0.1`	A
`32005~32006`	`eps_p_r`	EPS P_R	S32		W
`32007`	`eps_voltage_s`	EPS voltage S	U16	`0.1`	V
`32008`	`eps_current_s`	EPS current S	U16	`0.1`	A
`32011~32012`	`eps_p_s`	EPS P_S	S32		W
`32013`	`eps_voltage_t`	EPS voltage T	U16	`0.1`	V
`32014`	`eps_current_t`	EPS current T	U16	`0.1`	A
`32017~32018`	`eps_p_t`	EPS P_T	S32		W
`32019~32020`	`eps_total_p`	EPS total P	S32		W
`32021~32022`	`eps_total_q`	EPS total Q	S32		var
`32023`	`eps_voltage_rs`	EPS Voltage RS	U16	`0.1`	V
`32024`	`eps_voltage_st`	EPS Voltage ST	U16	`0.1`	V
`32025`	`eps_voltage_tr`	EPS Voltage TR	U16	`0.1`	V
`32026`	`eps_voltage_n_pe`	EPS Voltage N_PE	U16	`0.1`	V

battery_parameters

32040–32999 — 33 value(s)

Address	Key	Name	Type	Scale	Unit	Notes
`32040`	`battery_status`	Battery status	U16			4 enum labels
`32051`	`bms_status`	BMS communication status	U16			3 enum labels
`32055`	`battery_voltage`	Battery voltage	U16	`0.1`	V
`32056`	`battery_current`	Battery current	S16	`0.01`	A	positive = discharge
`32057~32058`	`battery_power`	Battery power	S32		W	positive = discharge
`32063`	`battery_temperature`	Battery temperature	S16	`0.1`	°C
`32064`	`battery_soc`	Battery SOC	U16		%
`32065`	`battery_soh`	Battery SOH	U16		%
`32069`	`forbid_charge`	Forbid charge flag	U16			2 enum labels
`32070`	`forbid_discharge`	Forbid discharge flag	U16			2 enum labels
`32071`	`forced_mode_request`	Battery request forced charge or discharge	U16			3 enum labels
`32072`	`battery_error1`	Battery error 1	U16
`32073`	`battery_error2`	Battery error 2	U16
`32074`	`battery_error3`	Battery error 3	U16
`32075`	`battery_warning1`	Battery warning 1	U16
`32076`	`battery_warning2`	Battery warning 2	U16
`32077`	`battery_warning3`	Battery warning 3	U16
`32078`	`battery_protection1`	Battery protection 1	U16
`32079`	`battery_protection2`	Battery protection 2	U16
`32080`	`battery_protection3`	Battery protection 3	U16
`32081`	`battery_cycles`	Cycles	U16
`32082`	`max_charge_voltage`	Max charge voltage	U16	`0.1`	V
`32083`	`max_charge_current`	Max charge current	U16	`0.01`	A
`32084`	`min_discharge_voltage`	Min discharge voltage	U16	`0.1`	V
`32085`	`max_discharge_current`	Max discharge current	S16	`0.01`	A
`32086`	`highest_cell_voltage`	Highest cell voltage	U16	`0.001`	V
`32087`	`highest_voltage_cell`	Highest voltage cell No.	U16
`32088`	`lowest_cell_voltage`	Lowest cell voltage	U16	`0.001`	V
`32089`	`lowest_voltage_cell`	Lowest voltage cell No.	U16
`32090`	`highest_cell_temperature`	Highest cell temperature	S16	`0.1`	°C
`32091`	`highest_temperature_cell`	Highest temperature cell No.	U16
`32092`	`lowest_cell_temperature`	Lowest cell temperature	S16	`0.1`	°C
`32093`	`lowest_temperature_cell`	Lowest temperature cell No.	U16

meter_parameters

33000–33999 — 17 value(s)

Address	Key	Name	Type	Scale	Unit	Notes
`33001`	`meter_r_voltage`	Meter R-phase voltage	U16	`0.1`	V
`33002`	`meter_r_current`	Meter R-phase current	S16	`0.1`	A	the spec's 0.1 scale is doubtful: 14 -> 1.4 A implies V*I ~= 327 VA while total P reads 0-1 W and Q reads 25 var (S ~= 25 VA). A 0.01 scale would give 0.14 A -> 33 VA, which fits. Voltage and power both agree with the vendor cloud
`33003`	`meter_r_frequency`	Meter R-phase frequency	U16	`0.01`	Hz
`33004~33005`	`meter_r_power`	Meter R-phase power	S32		W
`33006`	`meter_s_voltage`	Meter S-phase voltage	U16	`0.1`	V
`33007`	`meter_s_current`	Meter S-phase current	S16	`0.1`	A
`33008`	`meter_s_frequency`	Meter S-phase frequency	U16	`0.01`	Hz
`33009~33010`	`meter_s_power`	Meter S-phase power	S32		W
`33011`	`meter_t_voltage`	Meter T-phase voltage	U16	`0.1`	V
`33012`	`meter_t_current`	Meter T-phase current	S16	`0.1`	A
`33013`	`meter_t_frequency`	Meter T-phase frequency	U16	`0.01`	Hz
`33014~33015`	`meter_t_power`	Meter T-phase power	S32		W
`33016~33017`	`meter_total_p`	Meter total P	S32		W	positive = generation, negative = consumption
`33018~33019`	`meter_total_q`	Meter total Q	S32		var
`33020`	`meter_power_factor`	Meter power factor	S16	`0.01`		self-consistent, unlike the inverter's 31022: with P at 0-1 W and Q at 25 var, P/sqrt(P^2+Q2) is ~0.00-0.04 and the register reads 0.00. Any small value here just means grid exchange is near zero, so this number carries no information in self-consumption mode
`33040~33041`	`energy_to_grid_total`	E-Total to grid	U32	`0.1`	kWh	sell to grid
`33042~33043`	`energy_from_grid_total`	E-Total from grid	U32	`0.1`	kWh	buy from grid

generation_info

34000–34999 — 27 value(s)

Address	Key	Name	Type	Scale	Unit
`34001~34002`	`energy_from_inverter_total`	E-Total from inverter	U32	`0.1`	kWh
`34003~34004`	`energy_to_inverter_total`	E-Total to inverter	U32	`0.1`	kWh
`34005~34006`	`energy_from_pv_total`	E-Total from PV	U32	`0.1`	kWh
`34007~34008`	`energy_to_battery_total`	E-Total to battery	U32	`0.1`	kWh
`34009~34010`	`energy_from_battery_total`	E-Total from battery	U32	`0.1`	kWh
`34011~34012`	`energy_grid_to_battery_total`	E-Total from grid to battery	U32	`0.1`	kWh
`34013~34014`	`energy_to_eps_total`	E-Total to EPS	U32	`0.1`	kWh
`34015~34016`	`hours_generation_total`	H-Total of generation	U32		h
`34019~34020`	`hours_eps_total`	H-Total of EPS	U32		h
`34021`	`energy_today_dc`	E-today (DC generation)	U16	`0.1`	kWh
`34022`	`energy_today_battery_charge`	E-today (battery charge)	U16	`0.1`	kWh
`34023`	`energy_today_battery_discharge`	E-today (battery discharge)	U16	`0.1`	kWh
`34024`	`energy_today_grid_charge`	E-today (grid charge)	U16	`0.1`	kWh
`34025`	`energy_today_sell_to_grid`	E-today (sell to grid)	U16	`0.1`	kWh
`34026`	`energy_today_buy_from_grid`	E-today (buy from grid)	U16	`0.1`	kWh
`34027`	`energy_today_eps`	E-today (EPS consumption)	U16	`0.1`	kWh
`34028`	`hours_today_generation`	H-Today of generation	U16	`0.1`	h
`34029`	`energy_today_battery_from_pv`	E-today (battery charge from PV)	U16	`0.1`	kWh
`34030`	`energy_today_eps_from_pv`	E-today (EPS consume PV power)	U16	`0.1`	kWh
`34031`	`energy_today_pv_sell_to_grid`	E-today (PV sell to grid)	U16	`0.1`	kWh
`34032`	`energy_today_battery_sell_to_grid`	E-today (battery sell to grid)	U16	`0.1`	kWh
`34033`	`energy_today_battery_eps`	E-today (battery power EPS)	U16	`0.1`	kWh
`34034~34035`	`energy_total_pv_charge_battery`	E-total (PV charge battery)	U32	`0.1`	kWh
`34036~34037`	`energy_total_eps_from_pv`	E-total (EPS consume PV)	U32	`0.1`	kWh
`34038~34039`	`energy_total_pv_sell_to_grid`	E-total (PV sell to grid)	U32	`0.1`	kWh
`34040~34041`	`energy_total_battery_to_grid`	E-total (battery discharge to grid)	U32	`0.1`	kWh
`34042~34043`	`energy_total_battery_to_eps`	E-total (battery discharge to EPS)	U32	`0.1`	kWh

Italy_self-test

35000–35999 — 17 value(s)

Address	Key	Name	Type	Scale	Unit	Notes
`35001`	`ips_result`	IPS result	U16			3 enum labels
`35002`	`ov_test_voltage_s1`	59.S1 ten minute overvoltage test voltage	U16	`0.1`	V
`35003`	`ov_test_time_s1`	59.S1 ten minute overvoltage test time	U16	`0.1`	s
`35004`	`ov_test_max_voltage_s2`	59.S2 max voltage in overvoltage test	U16	`0.1`	V
`35005`	`ov_test_time_s2`	59.S2 overvoltage test time	U16	`0.1`	s
`35006`	`uv_test_min_voltage_s1`	27.S1 min voltage in undervoltage test	U16	`0.1`	V
`35007`	`uv_test_time_s1`	27.S1 undervoltage test time	U16	`0.1`	s
`35008`	`uv_test_min_voltage_s2`	27.S2 min voltage in undervoltage test	U16	`0.1`	V
`35009`	`uv_test_time_s2`	27.S2 undervoltage test time	U16	`0.1`	s
`35010`	`of_test_max_freq_s1`	81>.S1 max frequency in overfrequency test	U16	`0.01`	Hz
`35011`	`of_test_time_s1`	81>.S1 max time in overfrequency test	U16	`0.1`	s
`35012`	`uf_test_min_freq_s1`	81<.S1 min frequency in underfrequency test	U16	`0.01`	Hz
`35013`	`uf_test_time_s1`	81<.S1 min time in underfrequency test	U16	`0.1`	s
`35014`	`of_test_max_freq_s2`	81>.S2 max frequency in overfrequency test	U16	`0.01`	Hz
`35015`	`of_test_time_s2`	81>.S2 max time in overfrequency test	U16	`0.1`	s
`35016`	`uf_test_min_freq_s2`	81<.S2 min frequency in underfrequency test	U16	`0.01`	Hz
`35017`	`uf_test_time_s2`	81<.S2 max time in underfrequency test	U16	`0.1`	s

Totals: 183 values across 34 read ranges.

Coalesced read ranges:

30000–30034, 30041–30050, 30061–30062, 30070–30082, 30100–30101, 30103–30106, 30108–30109, 30200–30211, 30301–30301, 30303–30303, 30305–30305, 30307–30307, 30316–30316, 30400–30417, 30419–30421, 30500–30508, 31000–31007, 31010–31013, 31016–31022, 31035–31040, 32001–32002, 32005–32008, 32011–32014, 32017–32026, 32040–32040, 32051–32051, 32055–32058, 32063–32065, 32069–32093, 33001–33020, 33040–33043, 34001–34016, 34019–34043, 35001–35017

Where the document disagrees with the hardware

Every entry below was checked against a live 3K-HS and against the vendor's own cloud API — which is what the official app displays. Each one is also recorded in the notes field of the corresponding register and printed by sitsolar-dongle --list.

Register	Document says	What it actually does
`31039~31040`	Inverter output apparent power	Tracks P within 1–2 W (419 VA vs 417 W, 425 VA vs 424 W) — it looks like `P / power_factor`. True apparent power is `V·I`, which agrees with `√(P²+Q²)` at ≈ 470 VA, about 50 VA higher. Compute `√(P²+Q²)` for a VA sensor.
`31022`	Power factor	Sits at a near-constant `0.999`. It equals `P / (31039~31040)` but contradicts `P/√(P²+Q²) ≈ 0.89`. The vendor cloud publishes the same `0.999`, so this is a setpoint rather than a measurement — see the writable `46056 Power factors adjust`.
`33002`	Meter R-phase current, scale `0.1`	`14 → 1.4 A` implies `V·I ≈ 327 VA` while meter P reads 0–1 W and Q reads 25 var. A `0.01` scale (`0.14 A` → 33 VA) fits instead. Voltage and power both agree with the cloud.
`33020`	Meter power factor, scale `0.01`	Self-consistent — it is `≈ P/√(P²+Q²)` with P at a fraction of a watt — but in self-consumption mode grid exchange is near zero, so the number carries no information.
`30211`	DSP warning 5, "more details in Appendix 11"	Not a bit field. Appendix 1 / Chart 11 is a table of decimal warning codes.

For a VA sensor, compute it yourself

31039~31040 is not usable as apparent power. Use √(P²+Q²) from 31018~31019 (inverter_p) and 31020~31021 (inverter_q), which agrees with V·I.

The warning codes

30207–30210 are four ordinary bit-field words (Charts 8–10). Chart 11 addresses their combined space with:

code = 201 + 16·word_index + bit_index

That formula reproduces every row of the chart — 201/204/213 from word 0, 219/225/230 from word 1, 241/247 from word 2 — which is what shows 30211 carries a code rather than a mask.

200 means no warning

The first possible code is 201, so the value 200 means no warning at all — which is what a healthy unit reports.

30210 has no chart in the document, so its bits are unknown; codes 249 and up would belong to that word.

The 25 known labels are carried in the register's enum map and surface as the label field of a decoded reading.

Other quirks worth knowing

Item	Detail
`31016~31017` T-phase power	Documented as `S16`, but the address spans two registers and the R/S phases are `S32` at the same offset — so it is treated as `S32` here.
`32056` `battery_current`	Positive means discharge, not charge.
`32057~32058` `battery_power`	Positive means discharge.
`33016~33017` `meter_total_p`	Positive = generation, negative = consumption.
`30412~30416` `bms_software_version`	Depends on which battery is attached; may be absent.

Caveats & Troubleshooting — firmware differences and connection limits.
CLI Reference — --list, --section, and --key.