Why do WMax or VRef values look wrong after reading?

All data registers in Model 121 use paired scale factor registers (for example wmax_sf at address 22). The raw register value must be multiplied by 10 raised to the power of the scale factor. If your client does not apply scale factors automatically, read the relevant _sf register and apply it before interpreting the value.

The gateway connects but no Model 121 registers are visible. What now?

SunSpec devices place Model 121 at a dynamic offset after the Common Model (Model 1) and any Nameplate Model (Model 120). The absolute Modbus address of register 0 in Model 121 varies per device. Scan from the SunSpec base address (typically 40000) using the model chaining protocol, or consult the device's PICS document for the exact start address.

Writing to VMin or VMax has no effect. Why?

Some SunSpec-certified inverters protect grid-parameter registers with a vendor-specific unlock mechanism (for example an SMA Grid Guard code). Confirm the device's PICS document to check whether Model 121 write registers require an unlock sequence before values are accepted, and that no other Modbus client holds an exclusive session.

Is it safe to write WMax or VAMax setpoints remotely without additional precautions?

Caution is required. Writing WMax, VAMax, VMin, VMax, or per-quadrant reactive power limits directly can override grid-compliance settings and may violate the grid-connection agreement or trip protection relays. Always verify the target value against the inverter's nameplate ratings and applicable grid codes before committing a write, and test in a controlled maintenance window.

Free Modbus template: SunSpec Model 121 — Basic Settings

Name: SunSpec Model 121 — Basic Settings
Brand: SunSpec
SKU: 9a31b86d-ee20-4ebb-952f-00e8305baadc

SunSpec Model 121 is the Inverter Controls Basic Settings model, part of the open SunSpec Alliance standard for distributed energy resource inverters. The template communicates over Modbus TCP and provides read/write access to the core operating limits that govern how a compliant inverter behaves on the grid: maximum active power (WMax), voltage reference and offset (VRef, VRefOfs), voltage window (VMin, VMax), apparent power ceiling (VAMax), per-quadrant reactive power and power factor limits, active power ramp rate (WGra), nominal grid frequency (ECPNomHz), and phase assignment (ConnPh). Paired scale factor registers ensure correct engineering-unit conversion. Any SunSpec-certified inverter implementing Model 121 can be monitored and configured through a single template in your ModbusCloud portal.

Registers (32)

32 read / 20 write

Name	Address	Function	Type	Unit	Access
id SunSpec model identifier, fixed value 121 for this model.	•••	•••	•••		R
l Model length, number of registers following this field.	•••	•••	•••		R
wmax Maximum active power output setpoint, in watts.	•••	•••	•••	W	R/W
vref Voltage reference at the point of common coupling, in volts.	•••	•••	•••	V	R/W
vrefofs Signed offset applied to the VRef voltage reference, in volts.	•••	•••	•••	V	R/W
vmax Maximum AC voltage operating limit setpoint, in volts.	•••	•••	•••	V	R/W
vmin Minimum AC voltage operating limit setpoint, in volts.	•••	•••	•••	V	R/W
vamax Maximum apparent power output setpoint, in volt-amperes.	•••	•••	•••	VA	R/W
varmaxq1 Maximum reactive power limit in quadrant 1, in var.	•••	•••	•••	var	R/W
varmaxq2 Maximum reactive power limit in quadrant 2, in var.	•••	•••	•••	var	R/W
varmaxq3 Maximum reactive power limit in quadrant 3, in var.	•••	•••	•••	var	R/W
varmaxq4 Maximum reactive power limit in quadrant 4, in var.	•••	•••	•••	var	R/W
wgra Default active power ramp rate, as percentage of WMax per second.	•••	•••	•••	% WMax/sec	R/W
pfminq1 Minimum power factor setpoint in quadrant 1, as cos(phi).	•••	•••	•••	cos()	R/W
pfminq2 Minimum power factor setpoint in quadrant 2, as cos(phi).	•••	•••	•••	cos()	R/W
pfminq3 Minimum power factor setpoint in quadrant 3, as cos(phi).	•••	•••	•••	cos()	R/W
pfminq4 Minimum power factor setpoint in quadrant 4, as cos(phi).	•••	•••	•••	cos()	R/W
varact VAr action mode when power flow direction changes, enumerated value.	•••	•••	•••		R/W
clctotva Apparent power calculation method: 1 vectorial, 2 arithmetic.	•••	•••	•••		R/W
maxrmprte Maximum ramp-up rate, as percentage of WGra.	•••	•••	•••	% WGra	R/W
ecpnomhz Nominal grid frequency setpoint, in hertz.	•••	•••	•••	Hz	R/W
connph Connected line conductor for single-phase inverters: L1, L2, or L3.	•••	•••	•••		R/W
wmax_sf Scale factor exponent applied to WMax register value.	•••	•••	•••		R
vref_sf Scale factor exponent applied to VRef register value.	•••	•••	•••		R
vrefofs_sf Scale factor exponent applied to VRefOfs register value.	•••	•••	•••		R
vminmax_sf Scale factor exponent applied to VMin and VMax register values.	•••	•••	•••		R
vamax_sf Scale factor exponent applied to VAMax register value.	•••	•••	•••		R
varmax_sf Scale factor exponent applied to VArMax register values.	•••	•••	•••		R
wgra_sf Scale factor exponent applied to WGra register value.	•••	•••	•••		R
pfmin_sf Scale factor exponent applied to PFMin register values.	•••	•••	•••		R
maxrmprte_sf Scale factor exponent applied to MaxRmpRte register value.	•••	•••	•••		R
ecpnomhz_sf Scale factor exponent applied to ECPNomHz register value.	•••	•••	•••		R

Loading registers…

SunSpec Model 121 — Basic Settings

Overview

Use cases

Installation

Things to watch for

Registers (32)

Working with Modbus in your projects?

Question about your setup?

More SunSpec templates

SunSpec Model 709 — DER Trip LF

SunSpec Model 139 — LVRTX

SunSpec Model 19 — PPP Link

SunSpec Model 601 — Tracker Controller DRAFT 2

SunSpec Model 64412 — DER Cyber Exploitation

SunSpec Model 135 — LFRT

More TCP templates

Algodue Energy meter UEM80-2D E

Sigenergy SigenStore EC (grid)

Fronius GEN24

HUAWEI SUN2000 Inverter & LUNA2000 battery

NIBE Nibe S-Series (SG Ready)

Fronius - Modbus TCP