SunSpec SunSpec Model 702 — DER Capacity Modbus TCP template

SunSpec Model 702 — DER Capacity

SunSpec Model 702 is a standardised DER Capacity information model used across IEEE 1547-2018 compliant inverters, battery storage systems, and other distributed energy resources. Via Modbus TCP, this template reads the device's rated capacity block, covering active power, apparent power, reactive power injection and absorption, charge and discharge rates, and voltage and current limits. It also exposes the matching writable setpoint registers, letting you push updated operating limits to the device directly from the portal. Seven scale-factor registers ensure all values decode correctly regardless of device resolution. The template gives installers an authoritative nameplate view without opening a manual.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
51, read and write
Brand
SunSpec
Last updated

Registers (51)

51 read, 19 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
idRead
lRead
wmaxrtgWRead
wovrextrtgWRead
wovrextrtgpfRead
wundextrtgWRead
wundextrtgpfRead
vamaxrtgVARead
varmaxinjrtgVarRead
varmaxabsrtgVarRead
wchartemaxrtgWRead
wdischartemaxrtgWRead
vachartemaxrtgVARead
vadischartemaxrtgVARead
vnomrtgVRead
vmaxrtgVRead
vminrtgVRead
amaxrtgARead
pfovrextrtgRead
pfundextrtgRead
reactsusceptrtgSRead
noropcatrtgRead
abnopcatrtgRead
ctrlmodesRead
intislandcatrtgRead
wmaxWRead and write
wmaxovrextWRead and write
wovrextpfRead and write
wmaxundextWRead and write
wundextpfRead and write
vamaxVARead and write
varmaxinjVarRead and write
varmaxabsVarRead and write
wchartemaxWRead and write
wdischartemaxWRead and write
vachartemaxVARead and write
vadischartemaxVARead and write
vnomVRead and write
vmaxVRead and write
vminVRead and write
amaxARead and write
pfovrextRead and write
pfundextRead and write
intislandcatRead and write
w_sfRead
pf_sfRead
va_sfRead
var_sfRead
v_sfRead
a_sfRead
s_sfRead

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Use cases

  • Verify that wmaxrtg and wchartemaxrtg match the device nameplate after commissioning a new battery or inverter.
  • Monitor vnomrtg, vmaxrtg, and vminrtg to confirm a site operates within its declared AC voltage envelope.
  • Track varmaxinjrtg and varmaxabsrtg to document reactive power capability for grid-connection paperwork.
  • Alert when the wmax setpoint drifts below wmaxrtg, indicating an unintended power curtailment is active.
  • Audit ctrlmodes to confirm which IEEE 1547-2018 control functions, such as volt-var or watt-var, are enabled on each device.

Installation

  1. Enable Modbus TCP on the DER device via its web interface or commissioning tool, under the communication or Modbus section, and note the assigned IP address and TCP port (default 502).

  2. Connect the DER device and the ModbusCloud Gateway to the same IP network, confirm reachability with a ping, and ensure no firewall blocks port 502.

  3. In your ModbusCloud portal, add a new device, select the Modbus TCP transport, enter the device IP address and port, then import the SunSpec Model 702 DER Capacity template and assign the correct Modbus unit ID.

  4. Trigger a manual poll and spot-check the id register for value 702 and the wmaxrtg register against the device datasheet to confirm the model is discovered at the correct base address.

Things to watch for

All power and voltage values read as zero or absurdly large numbers. Why?

SunSpec Model 702 uses signed 16-bit scale factor registers (w_sf, v_sf, va_sf, var_sf, a_sf, pf_sf, s_sf). Each raw value must be multiplied by 10 raised to the scale factor. If your client ignores these registers or reads them as unsigned, every scaled value will appear wrong. Confirm your polling client applies the scale factors before displaying results.

The gateway connects but the id register does not return 702. What now?

Model 702 base address is dynamic in SunSpec devices: the register block follows after the Common Model and any models that precede it in the device register map. Perform a SunSpec model discovery walk starting at register 40001 to locate the actual base address, then configure that offset in the template assignment.

Writing a new wmax setpoint has no visible effect on device output. Why?

Some DER devices require an associated control-enable register from Model 704 (DER AC Controls) to be set before capacity setpoints in Model 702 take effect. Check the device documentation for any enable flag or operating mode that must be activated. Also confirm the written value does not exceed wmaxrtg, as out-of-range writes may be silently rejected.

Is it safe to write setpoints like wmax or vmax during live operation?

Writing to RW registers in Model 702 directly affects the device operating limits. An incorrect wmax, vmax, or amax value can trip protection functions, cause the device to disconnect from the grid, or in some implementations violate utility interconnection agreements. Always verify target values against the rated registers and test during low-load periods.

Want to see how it works?

Electrician working in an open distribution board