Skip to content

Add model 64416 (DERGridForming) — grid-forming inverter control model#277

Open
dersecure wants to merge 1 commit into
sunspec:masterfrom
dersecure:dersec/add-model-64416
Open

Add model 64416 (DERGridForming) — grid-forming inverter control model#277
dersecure wants to merge 1 commit into
sunspec:masterfrom
dersecure:dersec/add-model-64416

Conversation

@dersecure

@dersecure dersecure commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds model 64416 (DERGridForming), a proposed vendor model for
grid-forming (GFM) inverter control. As distributed energy resources increasingly
operate as grid-forming voltage sources, there is no SunSpec model that exposes
the GFM control surface over Modbus. This model fills that gap.

The model covers, in one block:

Category Points
Mode / state GridMd, GridSt
Control law CtrlAlg, DroopP, DroopQ, InertiaH, Damping (damping ratio), DampTms, VirtualX, VirtualR, FilterTms
Setpoints / ramps WSet, VarSet, VRef, HzRef, PRmpUp/Dn, VRmp, HzRmp
Current limiting & protection IMaxCont, IMaxTrans, IMaxDur, LimMode, IInst, ROCOFLim, MaxAng
Observability (R) ThetaInv, EInv, ROCOF, PInert, PDroop, PRef, PSync, PDamper, AngStroke, SyncStat, ModeDemoted
Black-start & islanding BSEna, BSVRamp, BSHzRamp, BSDwell, AIOvr
Synchronization SyncEna, SyncVTol, SyncHzTol, SyncAngTol
Multi-unit coordination UnitRole, UnitID, LeaderHzGain

Informative detail fields on the control-law and protection points cite
grid-forming tuning references (ERCOT AGS-ESR minimum inertia, IEEE 2800
ride-through capabilities) so integrators have concrete starting points.

Notes for reviewers

  • Model number 64416 is proposed — happy to move it to whatever number
    SunSpec assigns for this contribution.
  • JSON only. json/model_64416.json validates against schema.json
    (make check passes). An smdx/ counterpart can follow if desired — the repo
    currently has json-only models as well.
  • No copyrighted third-party content is included; the model is an original
    definition. Contributor CLA is signed.

Proposed DER grid-forming (GFM) control model covering mode/state,
control-law parameters (droop, virtual inertia, damping ratio, virtual
impedance), setpoints and ramps, current limiting, observability
(internal angle/voltage, RoCoF, power decomposition), black-start,
synchronization, and multi-unit coordination.

Informative detail fields cite grid-forming tuning references
(ERCOT AGS-ESR, IEEE 2800). JSON validates against schema.json.
@cla-bot cla-bot Bot added the cla-signed label Jul 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant