EPM¶
Note
This page is generated by python script generate_cet.py.
Commands¶
disable¶
Description: Transition from state Enabled to Disabled.
- EFDB_Topic:
SALGeneric_command_disable
- Category:
csc
enable¶
Description: Transition from state Disabled to Enabled.
- EFDB_Topic:
SALGeneric_command_enable
- Category:
csc
exitControl¶
Description: Transition from state Standby to Offline. Most CSCs will quit, but CSCs that support the enterControl command will keep running.
- EFDB_Topic:
SALGeneric_command_exitControl
- Category:
csc
setLogLevel¶
Description: Set the logging level.
- EFDB_Topic:
SALGeneric_command_setLogLevel
- Category:
csc
level¶
- IDL_Type:
int
- Units:
unitless
Description: Logging level, as a Python logging level: error=40, warning=30, info=20, debug=10.
subsystem¶
- IDL_Type:
string
- Units:
unitless
Description: If this CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to this CSC itself.
standby¶
Description: Transition from state Offline/Available, Disabled or Fault to Standby.
- EFDB_Topic:
SALGeneric_command_standby
- Category:
csc
start¶
Description: Transition from state Standby to Disable, in a specified configuration.
- EFDB_Topic:
SALGeneric_command_start
- Category:
csc
configurationOverride¶
- IDL_Type:
string
- Units:
unitless
- Description:
Configuration override in the form [{name}][:{version}]. For salobj-based CSCs: name is a filename with “.yaml” suffix and version is a git hash; for example:
“foo.yaml” specifies just a file. Two or three config files are loaded: “_init.yaml”, “_{site}.yaml” (if present), and “foo.yaml”.
“:37bf936” specifies just a git hash. One or two config files are loaded from the specified git commit: “_init.yaml” and “_{site}.yaml” (if present.
“bar.yaml:HEAD~2” specifies both a file and a git hash. Two or three config files are read from the specified git commit: “_init.yaml”, “_{site}.yaml” (if present), and “bar.yaml”.
Events¶
configurationApplied¶
Description: Information about this CSC’s current configuration overrides.
- EFDB_Topic:
SALGeneric_logevent_configurationApplied
- Category:
configurable
configurations¶
- IDL_Type:
string
- Units:
unitless
Description: A comma-separated list of configurations applied. If configuration comes from a clone of a git repo, or similar directory, then it will be a list of file names, without the file extension. Ignore whitespace after commas.
version¶
- IDL_Type:
string
- Units:
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type:
string
- Units:
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL. This should always match the same-named field in configurationsAvailable.
schemaVersion¶
- IDL_Type:
string
- Units:
unitless
Description: Version of config schema used by this CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”. This should always match the same-named field in configurationsAvailable.
otherInfo¶
- IDL_Type:
string
- Units:
unitless
Description: A comma-separated list of event topics (without the logevent prefix) used to publish the entire set of configuration parameters loaded by this CSC, and any other pertinent information. Ignore whitespace after commas.
configurationsAvailable¶
Description: Available configuration overrides for this CSC.
- EFDB_Topic:
SALGeneric_logevent_configurationsAvailable
- Category:
configurable
overrides¶
- IDL_Type:
string
- Units:
unitless
Description: Available overrides as a comma-separated list. Each entry is a possible value of the configurationOverride field of the start command. Ignore whitespace after commas.
version¶
- IDL_Type:
string
- Units:
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type:
string
- Units:
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL.
schemaVersion¶
- IDL_Type:
string
- Units:
unitless
Description: Version of config schema used by this CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”.
errorCode¶
Description: Output when this CSC goes into the Fault state as an explanation of the problem.
- EFDB_Topic:
SALGeneric_logevent_errorCode
- Category:
csc
errorCode¶
- IDL_Type:
long
- Units:
unitless
Description: A numeric error code.
errorReport¶
- IDL_Type:
string
- Units:
unitless
Description: An string providing detailed information about the error.
traceback¶
- IDL_Type:
string
- Units:
unitless
Description: An optional stack trace of the error condition.
heartbeat¶
Description: Event output at regular intervals (typcally once per second) to show that the SAL component is alive.
- EFDB_Topic:
SALGeneric_logevent_heartbeat
- Category:
mandatory
heartbeat¶
- IDL_Type:
boolean
- Units:
unitless
Description: Deprecated field that you should ignore.
logLevel¶
Description: Current logging level.
- EFDB_Topic:
SALGeneric_logevent_logLevel
- Category:
mandatory
level¶
- IDL_Type:
int
- Units:
unitless
Description: Current logging level, a Python logging level: error=40, warning=30, info=20, debug=10.
subsystem¶
- IDL_Type:
string
- Units:
unitless
Description: If this CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to this CSC itself.
logMessage¶
Description: A log message.
- EFDB_Topic:
SALGeneric_logevent_logMessage
- Category:
mandatory
name¶
- IDL_Type:
string
- Units:
unitless
Description: Log name.
level¶
- IDL_Type:
int
- Units:
unitless
Description: Message level, a Python logging level: error=40, warning=30, info=20, debug=10.
message¶
- IDL_Type:
string
- Units:
unitless
Description: Log message.
traceback¶
- IDL_Type:
string
- Units:
unitless
Description: Exception traceback; “” if not an exception.
filePath¶
- IDL_Type:
string
- Units:
unitless
Description: Path to source file.
functionName¶
- IDL_Type:
string
- Units:
unitless
Description: Function or method name.
lineNumber¶
- IDL_Type:
long
- Units:
unitless
Description: Line number in the file specified by filePath.
process¶
- IDL_Type:
long
- Units:
unitless
Description: Process ID.
timestamp¶
- IDL_Type:
double
- Units:
second
Description: The time at which the condition being reported was observed (TAI unix seconds). 0 if unspecified.
simulationMode¶
Description: Current simulation mode.
- EFDB_Topic:
SALGeneric_logevent_simulationMode
- Category:
csc
mode¶
- IDL_Type:
int
- Units:
unitless
Description: Current simulation mode; 0 for normal operation (no simulation); other supported values are specific to each CSC.
softwareVersions¶
Description: Current versions of software in use by CSC.
- EFDB_Topic:
SALGeneric_logevent_softwareVersions
- Category:
mandatory
salVersion¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: This is the current version of SAL generation.
xmlVersion¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: This is the current version of CSC XML.
openSpliceVersion¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: This is the current version of OpenSplice.
cscVersion¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: The software version of this CSC.
subsystemVersions¶
- IDL_Type:
string
- Units:
unitless
Description: A comma delimited list of key=value pairs relating subsystem name (key) to its version number (value). This may be left blank if there are no subsystems within this CSC.
summaryState¶
Description: Current summary state of this CSC.
- EFDB_Topic:
SALGeneric_logevent_summaryState
- Category:
csc
summaryState¶
- IDL_Type:
long
- Units:
unitless
Description: High level state machine state identifier.
Telemetry¶
- BatteryStatus:
Charging=1
Discharging=2
Floating=3
Resting=4
- OnOff:
ON=1
OFF=2
pdu¶
Description: Telemetry for Netbooter PDU devices.
- EFDB_Topic:
EPM_pdu
systemDescription¶
- IDL_Type:
string
- Units:
unitless
Description: The value of the SNMP System Description field.
acCurrentDraw¶
- IDL_Type:
float
- Units:
A
Description: AC current draw.
acMaxDraw¶
- IDL_Type:
float
- Units:
A
Description: AC maximum current draw detected.
powerOutletStatus¶
- IDL_Type:
int
- Units:
unitless
- Count:
2
Description: Power Outlet Status.
scheiderPm5xxx¶
Description: Telemetry for Scheider PM5XXX devices.
- EFDB_Topic:
EPM_scheiderPm5xxx
systemDescription¶
- IDL_Type:
string
- Units:
unitless
Description: The value of the SNMP System Description field.
serialNumber¶
- IDL_Type:
string
- Units:
unitless
Description: PM556x - Unit Serial Number
measuredLineVoltageVan¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Van - (Volts)
measuredLineVoltageVbn¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Vbn - (Volts)
measuredLineVoltageVcn¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Vcn - (Volts)
measuredLineVoltageVab¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Vab - (Volts)
measuredLineVoltageVbc¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Vbc - (Volts)
measuredLineVoltageVca¶
- IDL_Type:
float
- Units:
V
Description: Measured Line Voltage - Vca - (Volts)
loadCurrentA¶
- IDL_Type:
float
- Units:
A
Description: Measured Load Current - Phase A - (Amps)
loadCurrentB¶
- IDL_Type:
float
- Units:
A
Description: Measured Load Current - Phase B - (Amps)
loadCurrentC¶
- IDL_Type:
float
- Units:
A
Description: Measured Load Current - Phase C - (Amps)
neutralCurrent¶
- IDL_Type:
float
- Units:
A
Description: Measured Neutral Current - (Amps)
systemFrequency¶
- IDL_Type:
float
- Units:
Hz
Description: Measured System Frequency (Hz)
activePowerA¶
- IDL_Type:
float
- Units:
kW
Description: Active Power - Phase A - (kW)
activePowerB¶
- IDL_Type:
float
- Units:
kW
Description: Active Power - Phase B - (kW)
activePowerC¶
- IDL_Type:
float
- Units:
kW
Description: Active Power - Phase C - (kW)
reactivePowerA¶
- IDL_Type:
float
- Units:
kW
Description: Reactive Power - Phase A - (kVar)
reactivePowerB¶
- IDL_Type:
float
- Units:
kW
Description: Reactive Power - Phase B - (kVar)
reactivePowerC¶
- IDL_Type:
float
- Units:
kW
Description: Reactive Power - Phase C - (kVar)
apparentPowerA¶
- IDL_Type:
float
- Units:
kW
Description: Apparent Power - Phase A - (kVA)
apparentPowerB¶
- IDL_Type:
float
- Units:
kW
Description: Apparent Power - Phase B - (kVA)
apparentPowerC¶
- IDL_Type:
float
- Units:
kW
Description: Apparent Power - Phase C - (kVA)
powerFactorA¶
- IDL_Type:
float
- Units:
unitless
Description: Power Factor - Phase A
powerFactorB¶
- IDL_Type:
float
- Units:
unitless
Description: Power Factor - Phase B
powerFactorC¶
- IDL_Type:
float
- Units:
unitless
Description: Power Factor - Phase C
displacementPowerFactorA¶
- IDL_Type:
float
- Units:
unitless
Description: Displacement Power Factor - Phase A
displacementPowerFactorB¶
- IDL_Type:
float
- Units:
unitless
Description: Displacement Power Factor - Phase B
displacementPowerFactorC¶
- IDL_Type:
float
- Units:
unitless
Description: Displacement Power Factor - Phase C
totalPowerFactor¶
- IDL_Type:
float
- Units:
unitless
Description: Total Power Factor - Phase (A, B, C)
totalDisplacementPowerFactor¶
- IDL_Type:
float
- Units:
unitless
Description: Total Displacement Power Factor - Phase (A, B, C)
totalActivePower¶
- IDL_Type:
float
- Units:
kW
Description: Total Active Power - Phase (A,B,C) - (kW)
totalReactivePower¶
- IDL_Type:
float
- Units:
kW
Description: Total Reactive Power - Phase (A,B,C) - (kVar)
totalApparentPower¶
- IDL_Type:
float
- Units:
kW
Description: Total Apparent Power - Phase (A,B,C) - (kVA)
activeEnergyDelivered¶
- IDL_Type:
float
- Units:
J
Description: Accumulated Energy - Active Energy Delivered - (Wh)
reactiveEnergyDelivered¶
- IDL_Type:
float
- Units:
J
Description: Accumulated Energy - Reactive Energy Delivered - (VARh)
apparentEnergyDelivered¶
- IDL_Type:
float
- Units:
J
Description: Accumulated Energy - Apparent Energy Delivered - (VAh)
resetDateTime¶
- IDL_Type:
string
- Units:
unitless
Description: Accumulated Energy - Date /Time of Last Reset
xups¶
Description: Telemetry for XUPS devices.
- EFDB_Topic:
EPM_xups
systemDescription¶
- IDL_Type:
string
- Units:
unitless
Description: The value of the SNMP System Description field.
batteryCapacity¶
- IDL_Type:
float
- Units:
unitless
Description: Battery percent charge.
batteryTimeRemaining¶
- IDL_Type:
float
- Units:
s
Description: Battery run time in seconds before UPS turns off due to low battery.
batteryVoltage¶
- IDL_Type:
float
- Units:
V
Description: Battery voltage as reported by the UPS meters.
envAmbientTemp¶
- IDL_Type:
float
- Units:
deg_C
Description: The reading of the ambient temperature in the vicinity of the UPS or SNMP agent.
batteryCurrent¶
- IDL_Type:
float
- Units:
A
Description: Battery Current as reported by the UPS metering. Current is positive when discharging, negative when recharging the battery.
inputCurrent¶
- IDL_Type:
float
- Units:
A
- Count:
3
Description: The measured input current from the UPS meters in amps.
inputPower¶
- IDL_Type:
float
- Units:
W
- Count:
3
Description: The measured input real power in watts.
inputVoltage¶
- IDL_Type:
float
- Units:
V
- Count:
3
Description: The measured input voltage from the UPS meters in volts.
inputFrequency¶
- IDL_Type:
float
- Units:
Hz
Description: The utility line frequency in tenths of Hz.
outputCurrent¶
- IDL_Type:
float
- Units:
A
- Count:
3
Description: The measured UPS output current in amps.
outputPower¶
- IDL_Type:
float
- Units:
W
- Count:
3
Description: The measured real output power in watts.
outputVoltage¶
- IDL_Type:
float
- Units:
V
- Count:
3
Description: The measured output voltage from the UPS metering in volts.
outputFrequency¶
- IDL_Type:
float
- Units:
Hz
Description: The measured UPS output frequency in tenths of Hz.
outputLoad¶
- IDL_Type:
float
- Units:
unitless
Description: The UPS output load in percent of rated capacity.
bypassVoltage¶
- IDL_Type:
float
- Units:
V
- Count:
3
Description: The measured UPS bypass voltage in volts.
bypassFrequency¶
- IDL_Type:
float
- Units:
Hz
Description: The bypass frequency in tenths of Hz.
batteryAbmStatus¶
- IDL_Type:
int
- Units:
unitless
Description: Gives the status of the Advanced Battery Management; batteryFloating(3) status means that the charger is temporarily charging the battery to its float voltage; batteryResting(4) is the state when the battery is fully charged and none of the other actions (charging/discharging/floating) is being done.