Attribute |
Scope |
Type |
opModConnect
|
Public
|
boolean
|
Notes:
|
Set DER as connected (true) or disconnected (false). Used in conjunction with ramp rate when re-connecting. Implies galvanic isolation. If galvanic isolation is not supported, a value of false implies de-energize. If both opModConnect and opModEnergize are present, the values are logically ANDed to determine the connection state.<br/>
|
|
opModDeltaVar
|
Public
|
ReactivePowerDeltaControlType
|
Notes:
|
Change in reactive power, in var. This DERControl mode is relative to the current reactive power input or output at the time the DERControl begins.<br/>
|
|
opModDeltaW
|
Public
|
ActivePowerDeltaControlType
|
Notes:
|
Change in active power, in Watts. This DERControl Mode is relative to the current active power input or output at the time the DERControl begins.<br/>
|
|
opModEnergize
|
Public
|
boolean
|
Notes:
|
Set DER as energized (true) or de-energized (false). Used in conjunction with ramp rate when re-energizing. If both opModConnect and opModEnergize are present, the values are logically ANDed to determine the connection state.<br/>
|
|
opModFixedPFAbsorbW
|
Public
|
PowerFactorWithExcitationControlType
|
Notes:
|
The opModFixedPFAbsorbW function specifies a requested fixed Power Factor (PF) setting for when active power is being absorbed. The actual displacement SHALL be within the limits established by setMinPFOverExcited and setMinPFUnderExcited. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedVar) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
|
|
opModFixedPFInjectW
|
Public
|
PowerFactorWithExcitationControlType
|
Notes:
|
The opModFixedPFInjectW function specifies a requested fixed Power Factor (PF) setting for when active power is being injected. The actual displacement SHALL be within the limits established by setMinPFOverExcited and setMinPFUnderExcited. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedVar) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
|
|
opModFixedV
|
Public
|
SignedPerCentControlType
|
Notes:
|
The opModFixedV function specifies a requested voltage setpoint, in %setVNom (in hundredths).<br/>
|
|
opModFixedVar
|
Public
|
FixedVarControlType
|
Notes:
|
The opModFixedVar function specifies the delivered or received reactive power setpoint. The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedPFInjectW) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
|
|
opModFixedW
|
Public
|
SignedPerCentControlType
|
Notes:
|
The opModFixedW function specifies a requested received (e.g., charge) or delivered (e.g., discharge) active power setpoint, in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value (in hundredths).<br/>
|
|
opModFreqDroop
|
Public
|
FreqDroopType
|
Notes:
|
Specifies a frequency-watt operation. This operation limits active power generation or consumption when the line frequency deviates from nominal by a specified amount.<br/>
|
|
opModFreqWatt
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 0. The Frequency-Watt function limits active power generation or consumption when the line frequency deviates from nominal by a specified amount. The Frequency-Watt curve is specified as an array of Frequency-Watt pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies a frequency in Hz. The y value specifies a corresponding active power output in %setMaxW.<br/>
|
|
opModGridConnectPermit
|
Public
|
boolean
|
Notes:
|
Permits (true) or disallows (false) a grid reconnection. This DERControl Mode is likely to be more useful for microgrid controllers.<br/>
|
|
opModHFRTMayTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 1. The High Frequency Ride-Through (HFRT) function is specified by one or two duration-frequency curves that define the operating region under high frequency conditions. Each HFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "may trip" region.<br/>
|
|
opModHFRTMustTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 2. The High Frequency Ride-Through (HFRT) function is specified by a duration-frequency curve that defines the operating region under high frequency conditions. Each HFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "must trip" region.<br/>
|
|
opModHVRTMayTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 3. The High Voltage Ride-Through (HVRT) function is specified by one, two, or three duration-volt curves that define the operating region under high voltage conditions. Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percentage voltage, defined as ((locally measured voltage - setVRefOfs / setVRef). This DERControl Mode specifies the "may trip" region.<br/>
|
|
opModHVRTMomentaryCessation
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 4. The High Voltage Ride-Through (HVRT) function is specified by duration-volt curves that define the operating region under high voltage conditions. Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "momentary cessation" region.<br/>
|
|
opModHVRTMustTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 5. The High Voltage Ride-Through (HVRT) function is specified by duration-volt curves that define the operating region under high voltage conditions. Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "must trip" region.<br/>
|
|
opModIslandPermit
|
Public
|
boolean
|
Notes:
|
Permits (true) or disallows (false) grid islanding. This DERControl Mode is likely to be more useful for microgrid controllers.<br/>
|
|
opModLFRTMayTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 6. The Low Frequency Ride-Through (LFRT) function is specified by one or two duration-frequency curves that define the operating region under low frequency conditions. Each LFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "may trip" region.<br/>
|
|
opModLFRTMustTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 7. The Low Frequency Ride-Through (LFRT) function is specified by a duration-frequency curve that defines the operating region under low frequency conditions. Each LFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "must trip" region.<br/>
|
|
opModLVRTMayTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 8. The Low Voltage Ride-Through (LVRT) function is specified by one, two, or three duration-volt curves that define the operating region under low voltage conditions. Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "may trip" region.<br/>
|
|
opModLVRTMomentaryCessation
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 9. The Low Voltage Ride-Through (LVRT) function is specified by duration-volt curves that define the operating region under low voltage conditions. Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "momentary cessation" region.<br/>
|
|
opModLVRTMustTrip
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 10. The Low Voltage Ride-Through (LVRT) function is specified by duration-volt curves that define the operating region under low voltage conditions. Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "must trip" region.<br/>
|
|
opModMaxLimPctVAAbsorb
|
Public
|
PerCentControlType
|
Notes:
|
The opModMaxLimPctVAAbsorb function sets the maximum apparent power absorption level at the electrical reference point as a percentage of set capacity (%setMaxChargeRateVA, in hundredths). If issued simultaneously with other active or reactive power modes/controls, this mode/control SHOULD take precedence.<br/>
|
|
opModMaxLimPctVAInject
|
Public
|
PerCentControlType
|
Notes:
|
The opModMaxLimPctVAInject function sets the maximum apparent power injection level at the electrical reference point as a percentage of set capacity (%setMaxVA, in hundredths). If issued simultaneously with other active or reactive power modes/controls, this mode/control SHOULD take precedence.<br/>
|
|
opModMaxLimPctVarAbsorb
|
Public
|
UnsignedFixedVarControlType
|
Notes:
|
The opModMaxLimPctVarAbsorb function sets the maximum reactive power absorption level at the electrical reference point as a percentage of set capacity (in hundredths). The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
|
|
opModMaxLimPctVarInject
|
Public
|
UnsignedFixedVarControlType
|
Notes:
|
The opModMaxLimPctVarInject function sets the maximum reactive power injection level at the electrical reference point as a percentage of set capacity (in hundredths). The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
|
|
opModMaxLimPctWAbsorb
|
Public
|
PerCentControlType
|
Notes:
|
The opModMaxLimPctWAbsorb function sets the maximum active power absorption level at the electrical reference point as a percentage of set capacity (%setMaxChargeRateW, in hundredths). This limitation may be met e.g. by increasing PV output or by decreasing active power used to charge associated storage or power other loads.<br/>
|
|
opModMaxLimVarAbsorb
|
Public
|
UnsignedReactivePowerControlType
|
Notes:
|
The opModMaxLimVarAbsorb function sets the maximum reactive power absorption level at the electrical reference point.<br/>
|
|
opModMaxLimVarInject
|
Public
|
UnsignedReactivePowerControlType
|
Notes:
|
The opModMaxLimVarInject function sets the maximum reactive power injection level at the electrical reference point.<br/>
|
|
opModMaxLimW
|
Public
|
PerCentControlType
|
Notes:
|
The opModMaxLimW function sets the maximum active power generation level at the electrical reference point as a percentage of set capacity (%setMaxW, in hundredths). This limitation may be met e.g. by reducing PV output or by using excess PV output to charge associated storage or power other loads.<br/>Note: opModMaxLimW is inconsistently named for historical reasons as its units are PerCent instead of ActivePower. Its preferred name would have been opModMaxLimPctWInject.<br/>
|
|
opModMaxLimWAbsorb
|
Public
|
UnsignedActivePowerControlType
|
Notes:
|
The opModMaxLimWAbsorb function sets the maximum active power absorption level at the electrical reference point. This limitation may be met e.g. by increasing PV output or by decreasing active power used to charge associated storage or power other loads.<br/>
|
|
opModMaxLimWInject
|
Public
|
UnsignedActivePowerControlType
|
Notes:
|
The opModMaxLimWInject function sets the maximum active power generation level at the electrical reference point. This limitation may be met e.g. by reducing PV output or by using excess PV output to charge associated storage or power other loads.<br/>
|
|
opModTargetV
|
Public
|
VoltageRMSControlType
|
Notes:
|
Target output power, in Volts.<br/>
|
|
opModTargetVar
|
Public
|
ReactivePowerControlType
|
Notes:
|
Target reactive power, in var. This DERControl Mode is likely to be more useful for aggregators, as individual DERs may not be able to maintain a target setting.<br/>
|
|
opModTargetW
|
Public
|
ActivePowerControlType
|
Notes:
|
Target output power, in Watts. This DERControl Mode is likely to be more useful for aggregators, as individual DERs may not be able to maintain a target setting.<br/>
|
|
opModVoltVar
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 11. The static volt-var function provides over- or under-excited var compensation as a function of measured voltage. The volt-var curve is specified as an array of volt-var pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef) and SHOULD support a domain of at least 0 - 135. If VRef is present in DERCurve, then the x value of each pair is additionally multiplied by (VRef / 10000). The y value specifies a target var output interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
|
|
opModVoltWatt
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 12. The Volt-Watt varies active power as a function of measured voltage. The Volt-Watt curve is specified as an array of Volt-Watt pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef) and SHOULD support a domain of at least 0 - 135. The y value specifies an active power setting interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW or %statWAvail.<br/>
|
|
opModWattPF
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 13. The Watt-PF function varies Power Factor (PF) as a function of delivered or received active power. The Watt-PF curve is specified as an array of Watt-PF coordinates that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies a watt setting in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value, (-100 to 100). The PF output setting is an unsigned displacement in the y value with the excitation set according to the excitation boolean. These settings are not expected to be updated very often during the life of the installation, therefore only a single curve is required. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedPFInjectW) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
|
|
opModWattVar
|
Public
|
DERCurveLink
|
Notes:
|
Specify DERCurveLink for curveType == 14. The Watt-Var function varies vars as a function of delivered or received active power. The Watt-Var curve is specified as an array of Watt-Var pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies a watt setting in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value, (-100 to 100). The y value specifies a target var output interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
|
|
rampTms
|
Public
|
UInt16
|
Notes:
|
Requested ramp time, in hundredths of a second, for the device to transition from the current DERControl Mode(s) to the new DERControl Mode(s). If absent, use default ramp rate (setGradW). Resolution is 1/100 sec.<br/>
|
|