Use of XML for the data semantic of DER Object Models

DRAFT 2003-09-05 (has been automatically created from a XML file through a transformation)

These examples are intended:

Benefit: DEFINE THE DATA SEMANTIC ONCE IN XML -- USE THEM MANY TIMES for different views!!!

Copyright of transformation (c) 2003 by Karlheinz, Michael, and Johannes Schwarz, SCC

Send comment to Karlheinz or to Michael or to Johannes

Brief tables of LN classes defined in IDER Oblect Models

(Tables provide just DATA Class Name and Explanation)

LN: DRCT   Name: DER Controller

The DER Controller Logical Node defines the characteristics of the environment of the DER device, and its connection into the local and (optionally) the utility Electric Power System (EPS).

DRCT class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameController nameplate information
Configuration Settings
GenConfigRole of device within the power system
GenConfig.OwnerOwner of device
GenConfig.SysNameName of local power system
GenConfig.DevNameName of device within system
GenConfig.LocGPS location of device
GenConfig.ConnectLocal EPS only or interconnected with Utility EPS
DRCktCharacteristics of the local or utility power grid circuit to which the DER generator is connected
DRCkt.CktIDCircuit Id
DRCkt.CktPhsCircuit phases
DRCkt.LinLenmLine length in meters
DRCkt.ContCurContinuous current
DRCkt.VRtgMax voltage rating
DRCkt.PosiSqZPositive impedance
DRCkt.NegSqZNegative impedance
DRCkt.ZeroSqZZero impedance
DRCkt.KoZero sequence compensation factor
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Status Information
EPSConnDER is connected to Utility EPS, or to Local EPS
GenConnDER is connected to or disconnected from load
LocEPSSwStatus of disconnect switch for starting device in Local EPS only
AutoManAutomatic or Manual mode
GenModeOperational or in test/off-line mode,
GenReadyGenerator is ready to be connected to load
LoadModeBase load or load following
DCPowStatDC Power Status
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Measured Values
ContTimeController on time
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Controls
AutoManCtlSets operations mode to automatic or manual
GenModeSets generator into test mode or operational mode
GenConnConnects generator to load, or disconnects generator from load
LoadModeSets generator mode as base load or as load following
GenSyncStarts synchronizing generator to EPS
EmgStopRemote emergency stop
FaultAckAcknowledge fault clearing
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)
Control Settingss
LoadLvlSetpoints for operating in base load mode
LoadLvl.DerateTarDerated target %
LoadLvl.LdGovWkW target
LoadLvl.LdGovVarkVar target
LoadLvl.LdGovVarMxMax kVar
LoadLvl.RampLdLoad or Unload
LoadLvl.LdShutDownStop/Don’t Stop
LoadLvl.LdShareRampLoad Share/Don’t
LoadLvl.AltAppkW% kW
ImExLevThe setpoint for maintaining constant import/export to EPS
PowerFactThe setpoint for maintaining fixed power factor
FreqLvlThe setpoint for maintaining fixed frequency
VoltLvlThe voltage setpoint for maintaining fixed voltage level
StartCntTmsTime before starting
StopDlyTmsTime delay before stopping
Provided by editors (12)
Provided by editors (13)
Provided by editors (14)

LN: DRGN   Name: Generator

The following Logical Node defines the DER generator characteristics. Each DER unit has a generator. Although each type of DER provides different prime movers for its generator, thus requiring different prime mover logical nodes, the general operational characteristics of these generators are the same across all DER types. Therefore, only one UCA DER generator model is required.

DRGN class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameGenerator nameplate information
Configuration Settings
GenRtgElectrical ratings of generator
GenRtg.ConnectTypeType of connection
GenRtg.VolRtVoltage level rating
GenRtg.AmpRtgContinuous current rating
GenRtg.HzRtgNominal frequency
GenRtg.TempRtgMax temperature rating
GenRtg.FltCurRtgMax fault current rating
GenRtg.FltDurRtgTmmsMax fault duration rating
GenRtg.VolAmpRtgMax volt-amps rating
GenRtg.VolAmprRtgMax var rating
GenRtg.PwrFactRtgPower factor rating
GenRtg.VTPhsVoltage transformer phases
GenRtg.CTPhsCurrent transformer phases
GenSetGenerator operations settings
GenSet.MaxLodRampRtMax load ramp rate
GenSet.MaxLodRampRtMax unload ramp rate
GenSet.EmgRampRtEmergency ramp rate
GenSet.MaxWattOutMax Watt output
GenSet.RtWattRated Watts
GenSet.MinWattOutMin Watt output
GenSet.MaxVarOutMax VAr output
GenSet.RotDirRotation direction
GenSet.GenDisconLevGenerator disconnect level
GenSet.GenLodDrpSetGenerator load droop setting
GenSet.RaiseBaseLodSpRtRaise baseload setpoint rate
GenSet.LBaseLodSpRtLower baseload setpoint rate
GenPIDProportional, integral, and derivative gain parameters for automatic control
GenPID.PropGainProportional gain
GenPID.IntgrlGainIntegral gain
GenPID.DerivatGainDerivative gain
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Status Information
GenStGenerator status
GenOpStGeneration operational state: starting up, shutting down, ramping, at disconnect level,
GenSyncGenerator is synchronized to EPS, or not
GenExcitExcitation state
ParlStParalleling status
GenAlarmGeneration alarms: high/low voltage, high/low current, etc.
VoltDroopVoltage droop status
RampLdSwRamp Load/Unload Switch
DCPowStatDC Power Status
OperTimTotal time generator has operated
GenOnCntThe number of times that the generator has been turned on
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Measured Values
TotkWhTotal kWh delivered
PerkWhkWh in period since last reset
TotStartsCount of total number of starts
PerStartsCount of starts since reset
GenOprTimTime in msec as the generator becomes ready after the GenOnOff command was issued
GenStbTmrTimer for stabilization time
GenCoolDnTimer for generator to cool down
AVR% Duty Cycle
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Controls
GenCtlStarts or stops the generator
GenRLRaises or lowers the generation level
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)

LN: DSYN   Name: DER Synchronizer

The GSYN logical node compares various voltages to ascertain whether or not they are synchronized with each other. When a synchronous condition exists between the compared voltages, closing of the generator breaker is permitted.

DSYN class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameSynchronizer nameplate information
Configuration Settingss
GenPIDConfiguration parameters for proportion-integral-derivative algorithms
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
GenHzFrequency at generator
EPSHzFrequency on utility or local EPS
GenVGenerator voltage
RunVThe reference utility voltage for synchronism check logic
InVV compared with RunV by the sync check logic
AngDiffDifference in phase angle between the RunV and the InV
SyncVDifference in voltage magnitude between RunV and InV
SyncHzDifference in frequency between RunV and InV
GnSynDurTime interval that the sync process is in progress.
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Status Information
SyncStStatus of the synchronization logic
SynchEnaSynchronization enabled
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Controls
StartSynchStart synchronization
EnaHzSyncEnable slip frequency synchronization
EnaDdBusEnable generator breaker to close on dead bus
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)
Control Settingss
FreqLvlThe setpoint for maintaining fixed frequency
VoltLvlThe voltage setpoint for maintaining fixed voltage level
Provided by editors (12)
Provided by editors (13)
Provided by editors (14)

LN: DCOV   Name: DER Converter/Inverter

DCOV defines the characteristics of the converter and/or inverter, which converts the generator output voltage and/or frequency to levels compatible with the local or utility grid. The different prime mover LNs and the MMSU LN handle the actual measurements of converter inputs and outputs.

DCOV class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameConverter nameplate information
Configuration Settingss
EENameGenerator nameplate information
ConvConfigRole of converter/inverter within the power system
ConvConfig.OwnerOwner of device
ConvConfig.SysNameName of local power system
ConvConfig.DevNameName of device within system
ConvConfig.LocGPS location of device
ConvTypeType of converter/inverter
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
VertInpAmpInverter input current
VertOutAmpInverter output current (rms)
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Status Information
VertStatStatus of converter/inverter
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)

LN: DIES   Name: Diesel Engine

The diesel engine characteristics covered in the DIES logical node reflect those required for remote monitoring of critical diesel engine functions and states. The DIES LN attributes contain strictly non-electrical objects, even though typically a diesel genset consists of a combined diesel engine and generator.

DIES class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameDiesel nameplate information
Configuration Settingss
DiesConfigRole of device within the power system
DiesConfig.OwnerOwner of device
DiesConfig.SysNameName of local power system
DiesConfig.DevNameName of device within system
DiesConfig.LocGPS location of device
DiesRtgRatings of the engine
DiesRtg.TypFuelType of fuel
DiesRtg.AvgCalFuelAverage calorie content of fuel
DiesRtg.MaxTurbPresMax turb pressure
DiesRtg.MaxInletTempMax inlet temperature
DiesRtg.MaxOutletTempMax outlet temperature
DiesRtg.MinSpdMin speed
DiesRtg.MaxSpdMax speed
DiesRtg.HeatRtCurvesHeat rate curves
DiesFuelType of fuel used by diesel engine
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
OilPresOil pressure
DiesTempEngine temperature
DiesRPMDiesel engine speed
GenFrqDiesel engine gen frequency
EngTrqEngine torque
EngTimEngine timing
EngFuelEngine fuelling ??Set or MV?
AirPresAir pressure
CoolPresCoolant pressure
CoolTempCoolant temperature
ManiPresIntake manifold pressure
ManiTempIntake manifold temperature
WaterTempAftercooler water temperature
BlowFlowBlowby flow
BatVoltBattery voltage
FuelPresFuel Rail pressure
TimPresTiming Rail pressue
FuelTempFuel temperature
FuelAmpFuel Rail actuator current
TimAmp1Timing rail actuator current
TimAmp2Timing rail actuator current
PumpAmpFuel pump actuator current
BatVoltBattery charger alt flash volts
TotCumFuelCumulative fuel consumption
CumFuelCumulative fuel since reset
EngRunTimEngine running time
FuelRateFuel usage rate
FuelCalCalorie content of fuel
FuelLvl1Fuel level in tank #1
FuelLvl2Fuel level in tank #2
OilPresOil pressure
DiesTempEngine temperature
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Status Information
DiesOnOffDiesel is on or is off
DiesModeOperational or in test/off-line mode
SpdDroopSpeed droop status
OilPresStOil pressure status
CoolPresStCoolant pressure status
CustSw1Status of customer switch 1
CustSw2Status of customer switch 2
DiesAlmDiesel engine alarms
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Controls
DiesCtlStart / stop diesel engine
CrankCrank relay driver command
FuelShutFuel shutoff valve driver command
Emerg CtlEmergency start / stop diesel engine
DiagEnaDiagnostic mode enable
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)
Control Settingss
TrgSpdFinal target engine speed
DiesFreqDiesel generator frequency
EngTrqSetDesired engine torque
DrpAdjDroop adjustment
Provided by editors (12)
Provided by editors (13)
Provided by editors (14)

LN: DFCL   Name: Fuel Cell

The fuel cell characteristics covered in the DFCL logical node reflect those required for remote monitoring of critical functions and states of the fuel cell itself.

DFCL class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameFuel Cell nameplate information
Configuration Settingss
DflcConfigRole of device within the power system
DflcConfig.OwnerOwner of device
DflcConfig.SysNameName of local power system
DflcConfig.DevNameName of device within system
DflcConfig.LocGPS location of device
DflcRtgRatings of the Fuel Cell
DflcRtg.xxxx
DflcRtg.xyxy
DflcOnOffFuel cell is on or is off
DflcModeOperational or in test/off-line mode,
DflcAlmFuel cell alarms
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
DCVoltDC volts at stack
DCAmpFuel cell DC amps
HydrPresHydrogen pressure
HydrFlowRateHydrogen (or reformate) flow rate
AirFlowRateAir or oxygen flow rate
FuelFlowRateFuel (non-hydrogen) flow rate
WaterLvlWater level
ReformTempReformer temperature
CoolTempCoolant temperature
FuClHydroHydrogen available
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Controls
FuClCtlStart / stop fuel cell
FuelShutFuel shutoff valve driver command
Emerg CtlEmergency start / stop fuel cell
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Control Settingss
?T..
?T..
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)

LN: DPHV   Name: Photovoltaics System Characteristics

The photovoltaics system characteristics covered in the DPHV logical node reflect those required for remote monitoring of critical photovoltaic functions and states.

DPHV class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENamePhotovoltaics nameplate information
Configuration Settingss
DphvConfigRole of device within the power system
DphvConfig.OwnerOwner of device
DphvConfig.SysNameName of local power system
DphvConfig.DevNameName of device within system
DphvConfig.LocGPS location of device
DphvRtgRatings of the photovoltaic system
DphvRtg.xxxx
DphvRtg.xyxy
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
PVAmpPV amps
PVDCvoltDC volts at PV
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Controls
PVCtlStart / stop PV
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)
Control Settingss
?T..
?T..
Provided by editors (9)
Provided by editors (10)
Provided by editors (11)

LN: FUEL   Name: Fuel Systems

The fuel system characteristics covered in the FUEL logical node reflect those required for remote monitoring and control of critical fuel system functions and states. These may vary significantly based on the type of DER.

FUEL class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameFuel nameplate information
Configuration Settingss
FuelConfigRole of fuel system within the power system
FuelConfig.OwnerOwner of device
FuelConfig.SysNameName of local power system
FuelConfig.DevNameName of device within system
FuelConfig.LocGPS location of device
FuelRtgRatings of the photovoltaic system
FuelRtg.xxxx
FuelRtg.xyxy
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
FuelLvlFuel level
FuelPresFuel pressure
FuelRateFuel flow rate
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Status Information
FuelOnOffFuel system is on or is off
FuelAlmFuel system alarms
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)

LN: BATT   Name: Battery Systems

The battery system characteristics covered in the BATT logical node reflect those required for remote monitoring and control of critical auxiliary battery system functions and states. These may vary significantly based on the type of DER.

BATT class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameBattery nameplate information
Configuration Settingss
BattConfigRole of battery system within the power system
BattConfig.OwnerOwner of device
BattConfig.SysNameName of local power system
BattConfig.DevNameName of device within system
BattConfig.LocGPS location of device
BattRtgRatings of the battery system
BattRtg.xxxx
BattRtg.xyxy
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
BattVoltInternal battery voltage
BattAmpInternal battery current
BattTempInternal battery temperature
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)
Status Information
BattOnOffBattery system is on or is off
BattAlmBattery system alarms
Provided by editors (6)
Provided by editors (7)
Provided by editors (8)

LN: ENVR   Name: Environmental Conditions

The characteristics of the environment of the DER system cover meteorological and other key environmental parameters. In addition, many of the environmental sensors may be located remotely from the instantiated logical node. This logical node may therefore represent a collection of environmental information from many sources. The need for different objects may vary significantly based on the type of DER.

ENVR class
DATA ClassExplanationRequireddon't know
Common Logical Node Information
EENameEnvironmental Conditions nameplate information
Configuration Settingss
DphvConfigRole of device within the power system
DphvConfig.OwnerOwner of device
DphvConfig.SysNameName of local power system
DphvConfig.DevNameName of device within system
DphvConfig.LocGPS location of device
Provided by editors (0)
Provided by editors (1)
Provided by editors (2)
Measured Values
WindVelWind velocity
AmbTempAmbient temperature
HumidityHumidity
CloudCvrCloud cover level
Provided by editors (3)
Provided by editors (4)
Provided by editors (5)