DERSettings

Class Description

Distributed energy resource settings

Attributes

NameTypeDescription
setGradWUInt16Set default rate of change (ramp rate) of active power output due to command or internal action, defined in %setWMax / second. Resolution is in hundredths of a percent/second. A value of 0 means there is no limit. Interpreted as a percentage change in output capability limit per second when used as a default ramp rate.
setMaxChargeRateWActivePowerMaximum rate of energy transfer received by the storage device, in Watts. Defaults to rtgMaxChargeRateW.
setMaxDischargeRateWActivePowerMaximum rate of energy transfer delivered by the storage device, in Watts. Defaults to rtgMaxDischargeRateW.
setMaxVAApparentPowerSet limit for maximum apparent power capability of the DER (in VA). Defaults to rtgMaxVA.
setMaxVarNegReactivePowerSet limit for maximum reactive power received by the DER (in var). If present, SHALL be a negative value >= rtgMaxVarNeg (default). If absent, defaults to negative setMaxVar.
setMaxVarReactivePowerSet limit for maximum reactive power delivered by the DER (in var). SHALL be a positive value <= rtgMaxVar (default).
setMaxWActivePowerSet limit for maximum active power capability of the DER (in W). Defaults to rtgMaxW.
setMinPFOverExcitedPowerFactorSet minimum Power Factor displacement limit of the DER when injecting reactive power (over-excited); SHALL be a positive value between 0.0 (typically > 0.7) and 1.0. SHALL be >= rtgMinPFOverExcited (default).
setMinPFUnderExcitedPowerFactorSet minimum Power Factor displacement limit of the DER when absorbing reactive power (under-excited); SHALL be a positive value between 0.0 (typically > 0.7) and 0.9999. If present, SHALL be >= rtgMinPFUnderExcited (default). If absent, defaults to setMinPFOverExcited.
setVRefVoltageRMSThe nominal AC voltage (RMS) at the utility's point of common coupling.
setVRefOfsVoltageRMSThe nominal AC voltage (RMS) offset between the DER's electrical connection point and the utility's point of common coupling.
updatedTimeTimeTypeSpecifies the time at which the DER information was last updated.
setSoftGradWUInt16Set soft-start rate of change (soft-start ramp rate) of active power output due to command or internal action, defined in %setWMax / second. Resolution is in hundredths of a percent/second. A value of 0 means there is no limit. Interpreted as a percentage change in output capability limit per second when used as a ramp rate.
setESHighVoltInt16Enter service voltage high. Specified as an effective percent voltage, defined as (100% * (locally measured voltage - setVRefOfs) / setVRef), in hundredths of a percent.
setESLowVoltInt16Enter service voltage low. Specified as an effective percent voltage, defined as (100% * (locally measured voltage - setVRefOfs) / setVRef), in hundredths of a percent.
setESHighFreqUInt16Enter service frequency high. Specified in hundredths of Hz.
setESLowFreqUInt16Enter service frequency low. Specified in hundredths of Hz.
setESDelayUInt32Enter service delay, in hundredths of a second.
setESRandomDelayUInt32Enter service randomized delay, in hundredths of a second.
setMaxChargeRateVAApparentPowerApparent power charge maximum. Maximum apparent power the DER can absorb from the grid in Volt-Amperes. May differ from the apparent power maximum (setMaxVA).
setMaxACurrentRMSAC current maximum. Maximum AC current in RMS Amperes.
modesEnabledDERControlTypeBitmap indicating the DER Controls enabled on the device. See DERControlType for values. If a control is supported (see DERCapability::modesSupported), but not enabled, the control will not be executed if encountered.
setMaxWhWattHourMaximum energy storage capacity of the DER, in WattHours. Note: this may be different from physical capability.
setMaxDischargeRateVAApparentPowerApparent power discharge maximum. Maximum apparent power the DER can deliver to the grid in Volt-Amperes. May differ from the apparent power maximum (setMaxVA).
setMaxAhAmpereHourMaximum usable energy storage capacity of the DER, in AmpHours. Note: this may be different from physical capability.
setESRampTmsUInt32Enter service ramp time, in hundredths of a second.
setVNomVoltageRMSAC voltage nominal setting.
setMinVVoltageRMSAC voltage minimum setting.
setMaxVVoltageRMSAC voltage maximum setting.

Relationships

Inherits from

Descendant classes

  • No descendant classes

Associations

None