All devices

GoodWe · Solar inverter

MT G2 / SMT / SDT G2 / MS / DNS / XS grid-connected string inverters (Modbus protocol V1.10, Customer Edition) Modbus register map

Serial device: in Modbus Connect, choose “Add to existing device” and pick the serial (RTU) device you created on your COM port.

Default configuration

Protocol
Modbus RTU over RS-485
Unit ID
247
Addressing
0-based
Byte order
Big endian
Word order
High word first
Baud rate
9600
Parity
None
Data bits
8
Stop bits
1

To read this device over Modbus RTU in Modbus Connect:

  1. In Modbus Connect, add a serial (RTU) device on your COM port with the serial settings and unit ID shown above.
  2. Click Add to Modbus Connect (or open the downloaded JSON), choose “Add to existing device” and pick that serial device. Its registers, byte order and word order are added; the serial device keeps its own line settings.

The “Add device” tab creates a Modbus TCP device (IP address and port), so use it only when you reach this device through a Modbus RTU-to-TCP gateway set to the serial settings above.

Register map

AddressCountNameTypeUnitScaleAccess
01
Start-up voltage
(60.0~600.0V)
UInt16V0.1RW
11
Reconnection time
UInt16s1RW
21
Grid Voltage Lower Limit
[0.15*Vn,1*Vn]
UInt16V0.1RW
31
Grid Voltage Upper Limit
[1*Vn,1.36*Vn]
UInt16V0.1RW
41
Grid Frequency Lower Limit
UInt16Hz0.01RW
51
Grid Frequency Upper Limit
UInt16Hz0.01RW
161
Device RTC Time Year/Month
High Byte Year/Low Byte Month 13-99/1-12
UInt16-1RW
171
Device RTC Time Day/Hour
High Byte Day/Low Byte Hour 1-31/0-23
UInt16-1RW
181
Device RTC Time Minute/Second
High Byte Minute/Low Byte Second 0-59/0-59
UInt16-1RW
2561
Active power adjustment
Corresponding to 0%-10 0% Active Power Note: Single-phase models only support writing and do not store data
UInt16%1RW
2571
Power factor adjustment (PF reactive power)
Note: Single-phase models only support writing; 1-20: PF =(Set value -1 00)/100, corresponding to lagging 0.99 to 0.8; 80-100: PF = Set value /10 0, corresponding to leading 0.80 to 1;
UInt16-1RW
2582
Reactive power adjustment amount
Note: Single-phase units are not supported. Setting range is [- 60%*Pn, 60%*Pn]。
Int32var1RW
2621
Inverter load increase/decrease (ARP limit)
High byte: Load reduction or recovery amplitude (less than 0 indicates load reduction, greater than 0 indicates load increase,128 indicates full load recovery), unit is %. Low byte: Command ID
Int16%1W
2651
Reactive power adjustment (percentage)
(-60%~60%) , Note: Single-phase units are not supported.
Int16%1RW
2671
Anti-backflow communication timeout
Unit: seconds (Taiwan safety standard only) Note: Supported only by SMT
UInt16s1RW
2881
Power On (Grid Connection Allowed Self-check)
Register write 0 takes effect
UInt16-1W
2891
Power Off (Grid Connection Not Allowed Self-check)
Register write 0 takes effect
UInt16-1W
2901
Restart
Register write 0 takes effect
UInt16-1W
2911
Grid-connected power limit switch
0- Off,1- On Note: Supported only by SDTG2/SMT
UInt16-1RW
2921
Backflow upstream power percentage
Note: Supported only by SDTG2/SMT
UInt16%1RW
2931
Active power adjustment (MT)
ARM 11 Version Import Note: Supported only by MT
UInt16%0.1RW
3121
Shadow scan switch
0- Off,1- On
UInt16-1RW
5128
Device serial number (16 ASCII characters)
ASCII Code,16 characters
Ascii-1R
5285
Device model (10 ASCII characters)
ASCII Code,10 characters
Ascii-1R
5442
Error code
See Table 8-2
UInt32-1R
5462
Total energy fed to grid (E-Total)
UInt32kWh0.1R
5482
Total feeding hours (h-Total)
UInt32h1R
5501
Vpv1 / PV1 Input Voltage
UInt16V0.1R
5511
Vpv2 / PV2 Input Voltage
Note: Single MPPT Model Not Supported
UInt16V0.1R
5521
Ipv1 / PV1 Input Current
UInt16A0.1R
5531
Ipv2 / PV2 Input Current
Note: Single MPPT Model Not Supported
UInt16A0.1R
5541
Vac1 / L1 Phase Voltage
UInt16V0.1R
5551
Vac2 / L2 Phase Voltage
Note: Not supported by single-phase model
UInt16V0.1R
5561
Vac3 / L3 Phase Voltage
Note: Not supported by single-phase model
UInt16V0.1R
5571
Iac1 / L1 Phase Current
UInt16A0.1R
5581
Iac2 / L2 Phase Current
Note: Not supported by single-phase model
UInt16A0.1R
5591
Iac3 / L3 Phase Current
Note: Not supported by single-phase model
UInt16A0.1R
5601
Fac1 / L1 Phase Frequency
UInt16Hz0.01R
5611
Fac2 / L2 Phase Frequency
Note: Not supported by single-phase model
UInt16Hz0.01R
5621
Fac3 / L3 Phase Frequency
Note: Not supported by single-phase model
UInt16Hz0.01R
5631
Inverter current output power (Pac)
For Non-MT/SMT Models
UInt16W1R
5641
Work mode
0:cWaitMode 1:cNormalMode 2:cFaultMode
UInt16-1R
5651
Inverter internal temperature
UInt16°C0.1R
5661
Daily energy generation (E-Day)
UInt16kWh0.1R
7681
PV1 voltage (MT/SMT block)
UInt16V0.1R
7691
PV2 voltage (MT/SMT block)
UInt16V0.1R
7701
Ipv1 / PV1 Input Current
UInt16A0.1R
7711
Ipv2 / PV2 Input Current
UInt16A0.1R
7721
Vac1 / L1 Phase Voltage
UInt16V0.1R
7731
Vac2 / L2 Phase Voltage
UInt16V0.1R
7741
Vac3 / L3 Phase Voltage
UInt16V0.1R
7751
Iac1 / L1 Phase Current
UInt16A0.1R
7761
Iac2 / L2 Phase Current
UInt16A0.1R
7771
Iac3 / L3 Phase Current
UInt16A0.1R
7781
Fac1 / L1 Phase Frequency
UInt16Hz0.01R
7791
Fac2 / L2 Phase Frequency
UInt16Hz0.01R
7801
Fac3 / L3 Phase Frequency
UInt16Hz0.01R
7821
Work mode (MT/SMT block)
0:cWaitMode 1:cNormalMode 2:cFaultMode
UInt16-1R
7831
Inverter internal temperature (MT/SMT block)
UInt16°C0.1R
7842
Error code
See Table 8-2
UInt32-1R
7862
Total energy fed to grid (E-Total, MT/SMT block)
UInt32kWh0.1R
7882
Total feeding hours (h-Total, MT/SMT block)
UInt32h1R
7901
Firmware version
UInt16-1R
7911
Warning code
UInt16-1R
7931
Function status bits
See Table 8-3
UInt16-1R
7961
DC bus voltage
UInt16V0.1R
7971
DC bus neutral point voltage
UInt16V0.1R
7991
Safety standards code
Safety Standards Code
UInt16-1R
8001
Daily energy generation (E-Day, MT/SMT block)
UInt16kWh0.1R
8041
Vpv5 / PV5 Input Voltage
Dedicated for SMT50 /60K Models
UInt16V0.1R
8051
Ipv5 / PV5 Input Current
Dedicated for SMT50 /60K Models
UInt16A0.1R
8061
Vpv6 / PV6 Input Voltage
Dedicated for SMT50 /60K Models
UInt16V0.1R
8071
Ipv6 / PV6 Input Current
Dedicated for SMT50 /60K Models
UInt16A0.1R
8141
Power factor (SMT)
Dedicated for SMT
Int16-0.001R
8271
RTC year and month
High Byte: Year; Low Byte : Month
UInt16-1R
8281
RTC day and hour
High Byte: Day; Low Byte : Hour
UInt16-1R
8291
RTC minute and second
High Byte: Minute; Low Byte : seconds
UInt16-1R
8301
Manufacturer identification code
For Hanergy
UInt16-1R
8311
Wireless signal strength (RSSI)
WiFi/GPRS Valid
UInt16%1R
8502
AC power (Pac)
UInt32W1R
8521
ARM software version
UInt16-1R
8531
GPRS burn-in mode
0x00: Normal Mode 0x01: Aging Mode
UInt16-1R
8551
Vpv3 / PV3 Input Voltage
UInt16V0.1R
8561
Vpv4 / PV4 Input Voltage
UInt16V0.1R
8571
Ipv3 / PV3 Input Current
UInt16A0.1R
8581
Ipv4 / PV4 Input Current
UInt16A0.1R
8591
Istr1/String 1 Electricity Current
UInt16A0.1R
8601
Istr2/String 2 Electricity Current
UInt16A0.1R
8611
Istr3/String 3 Electricity Current
UInt16A0.1R
8621
Istr4/String 4 Electricity Current
UInt16A0.1R
8631
Istr5/String 5 Electricity Current
UInt16A0.1R
8641
Istr6/String 6 Electricity Current
UInt16A0.1R
8651
Istr7/String7 Electric Current
UInt16A0.1R
8661
Istr8/String8 Electric Current
UInt16A0.1R
8671
Istr9/String9 Electric Current
UInt16A0.1R
8681
Istr10/String 10 Current
UInt16A0.1R
8691
Istr11/String 11 Current
UInt16A0.1R
8701
Istr12/String 12 Current
UInt16A0.1R
8711
Istr13/String 13 Current
UInt16A0.1R
8721
Istr14/String 14 Current
UInt16A0.1R
8731
Istr15/String 15 Current
UInt16A0.1R
8741
Istr16/String 16 Current
UInt16A0.1R
8791
PID and surge protection module status bits
UInt16-1R
8801
Output control status
Applicable to Japanese models:0- Uncontrolled, 1-Controlled Medium
UInt16-1R
8861
Power factor (MT/SDT G2)
Power Factor Note: MT/SDTG2 Dedicated
UInt16-0.001R
8932
AC reactive power (MT/SMT/SDT G2)
AC Reactive Power Note: MT/SMT/SDTG2 Dedicated
Int32kvar0.001R
8951
Insulation impedance (ISO measured value)
ISO Measured Value
UInt16kΩ1R
8961
Leakage current
Leakage Current Value
UInt16mA1R
10002
Current magnitude phase R
UInt32A0.1R
10022
Current magnitude phase S
UInt32A0.1R
10042
Current magnitude phase T
UInt32A0.1R
10062
Voltage magnitude phase R
UInt32V0.1R
10082
Voltage magnitude phase S
UInt32V0.1R
10102
Voltage magnitude phase T
UInt32V0.1R
10122
Three-phase active power
UInt32kW0.1R
10142
Three-phase reactive power
UInt32kW0.001R
10162
Three-phase power factor
Int32-0.001R
10182
Frequency (three-phase block)
UInt32Hz0.1R
10202
Status flag 1
Refer to Table 8-5
UInt32-1R
20001
Power factor adjustment (MT)
Note: MT supports
Int16-0.001RW
20011
Operation mode (power factor / Q(V) dispatch)
Refer to Table 8-6
UInt16-1RW
20021
Reactive power adjustment (MT dispatch)
Int16%0.1RW
20031
Active power adjustment (MT dispatch)
UInt16%0.1RW
301151
Grid AB line voltage
UInt16V0.1R
301161
Grid BC line voltage
UInt16V0.1R
301171
Grid CA line voltage
UInt16V0.1R
301332
AC apparent power
UInt32kVA0.001R
301372
Total input power
Int32kW0.001R
320861
Conversion efficiency
UInt16%0.01R
372071
Operation flag 7
Refer to Table 8-7 for details
UInt16-1R
404911
Taiwan safety standard Vpset
Taiwan Safety Standards ( Un default 220 V) (1.05~1.1)*Un
UInt16V0.1RW
404921
Taiwan safety standard PF adjustment
Taiwan safety standard dedicated (80-100) Note: Exclusive to SMT models use
UInt16%0.01RW
404931
Taiwan Safety Standards Reactive Power Adjustment Amount
Taiwan safety standard dedicated (-60%~60%) Note: Exclusive to SMT models use
Int16%1RW
404941
Taiwan safety standard active power Adjustment value
Taiwan safety standard dedicated (1,100) Note: Exclusive to SMT models use
UInt16%1RW
404951
Taiwan VPC Curve Switch
Taiwan safety standard dedicated 0- Off, 1- On Note: Exclusive to SMT models use
UInt16-1RW
424042
Fixed active power derating
Note: Exclusive to SMT models use
Int32W1RW
424151
Reactive power compensation (Q/Qn)
Qn is 60% of Pn Note: Exclusive to SMT models use
Int16% of Qn0.1RW
424391
Active power dispatch enable
0: Accept third-party dispatch commands 1: Disable; do not accept thirdparty dispatch commands Note: Exclusive to SMT models use
UInt16-1RW

Read this device live with Modbus Connect, free for Windows, macOS and Linux

Related guides

Notes

Source: GoodWe "Inverter MODBUS Communication Protocol - Grid-Connected MT G2/SMT/SDT G2/MS/DNS/XS Series (Customer Edition)", V1.10, 2025-05-09, 20 pp. GoodWe serves its library through a JS finder, so the file read is the distributor mirror https://www.nbservis.cz/GW_manualy/MTG2SMTSDTG2MSDNSXS_Modbus_V1_10_250509-en.pdf (SHA-256 4267498c618658f3bf17b18f9ee3d11c0ef6ca68522b8a104d88fe0eae54e813). Transport per the overview and section 4: Modbus RTU at 9600 bps; section 1 fixes each byte at 8 data bits with one start bit and one stop bit and prints no parity bit, so the None parity follows Modbus RTU default rather than a printed value; section 5 gives machine address 1-247 with factory default 247 (set with SolarGo or the display). Section 6: 03H reads and 10H writes, so every row is a holding register. Section 2 returns long integers high word first, hence HighFirst. Addresses are the document register numbers used as wire addresses: the table prints each number in decimal and hex (0x00, 0x0100) and section 9 writes register 256 by sending 0x0100, so the seed is zero-based. Units follow the document apart from library spellings (KWH/kWh, Hr/h, KW and kw/kW, kVar and Var/kvar, "degre eC"/degC, N/A/empty); 1014 keeps the document kW on the reactive-power row. Model coverage: 546-566 (0x222-0x236) apply only to non-MT models; 768-799 (0x300-0x31F) are the MT/SMT block; 563 is the non-MT/SMT output-power row; 804-807 are SMT 50/60K only; the 0x9E2x and 0xA5xx rows plus 886 are SMT-only. Register 42439 prints as "Power dispatch disable" although it is the active-power dispatch enable (0 = accept third-party dispatch, 1 = disable). Bit-field rows (544 error code, 793 function bits, 879 PID/surge bits, 1020 status flag 1, 37207 operation flag 7) are UInt16/UInt32 here and must be decoded with tables 8-2 to 8-7, which are not register lists and are not seeded. The GoodWe ET/EH/BT/BH storage map is a different document and is seeded separately as goodwe-et-eh.

Related devices