Loading...
Searching...
No Matches
Inlet.idl
/* SPDX-License-Identifier: BSD-3-Clause */
/*
* Copyright 2009 Raritan Inc. All rights reserved.
*/
#ifndef __PDUMODEL_INLET_IDL__
#define __PDUMODEL_INLET_IDL__
#include <EDevice.idl>
#include <Nameplate.idl>
#include <NumericSensor.idl>
#include <StateSensor.idl>
#include <Pole.idl>
#include <ResidualCurrentStateSensor.idl>
/**
* PDU Model
*/
module pdumodel {
/** %Inlet interface */
interface Inlet extends EDevice {
/** %Inlet metadata */
structure MetaData {
string label; ///< %Inlet label
string plugType; ///< Plug type
Nameplate namePlate; ///< %Nameplate information
Rating rating; ///< Numerical usage ratings
boolean hasWaveformSupport; ///< Whether waveform reading is supported on this inlet
boolean isDC; ///< Current type, \c true for DC, \c false for AC
};
/** %Inlet sensors */
structure Sensors {
sensors.NumericSensor voltage; ///< RMS voltage sensor (may be a VoltageMonitoringSensor)
sensors.NumericSensor current; ///< RMS current sensor
sensors.NumericSensor peakCurrent; ///< Peak current sensor
sensors.NumericSensor residualCurrent; ///< Residual current sensor
sensors.NumericSensor residualACCurrent; ///< AC Residual current sensor
///< (AC portion of residual operating current)
sensors.NumericSensor residualDCCurrent; ///< DC Residual current sensor
///< (DC portion of residual operating current)
sensors.NumericSensor activePower; ///< Active power sensor
sensors.NumericSensor reactivePower; ///< Reactive power sensor
sensors.NumericSensor apparentPower; ///< Apparent power sensor
sensors.NumericSensor powerFactor; ///< Power factor sensor
sensors.NumericSensor displacementPowerFactor; ///< Displacement power factor sensor
sensors.NumericSensor activeEnergy; ///< Active energy sensor
sensors.NumericSensor apparentEnergy; ///< Apparent energy sensor
sensors.NumericSensor unbalancedCurrent; ///< Current unbalance sensor
sensors.NumericSensor unbalancedLineLineCurrent; ///< Line-Line current unbalance sensor
sensors.NumericSensor unbalancedVoltage; ///< Voltage unbalance sensor
sensors.NumericSensor unbalancedLineLineVoltage; ///< Line-Line voltage unbalance sensor
sensors.NumericSensor lineFrequency; ///< Line AC frequency sensor
sensors.NumericSensor phaseAngle; ///< Phase angle sensor
sensors.NumericSensor crestFactor; ///< Crest factor sensor
sensors.NumericSensor voltageThd; ///< Voltage total harmonic distortion sensor
sensors.NumericSensor currentThd; ///< Current total harmonic distortion sensor
sensors.StateSensor powerQuality; ///< Power quality sensor
sensors.StateSensor surgeProtectorStatus; ///< Surge protector status sensor
ResidualCurrentStateSensor residualCurrentStatus; ///< Residual current monitor state sensor
};
/** %Inlet settings */
structure Settings {
string name; ///< User-defined name
};
/** Event: Inlet settings have been changed */
valueobject SettingsChangedEvent extends event.UserEvent {
Settings oldSettings; ///< Settings before change
Settings newSettings; ///< Settings after change
};
/** Event: Inlet has been enabled or disabled */
valueobject EnableStateChangedEvent extends event.UserEvent {
boolean enabled; ///< New enable state
};
/**
* Retrieve the inlet metadata.
*
* @return %Inlet metadata
*/
MetaData getMetaData();
/**
* Get the inlet sensors.
*
* @return %Inlet sensors
*/
Sensors getSensors();
/**
* Get the list of inlet poles.
*
* @return List of inlet poles
*/
vector<Pole> getPoles();
/**
* Get the list of inlet line pairs.
*
* @return List of inlet line pairs
*/
vector<MeteredLinePair> getLinePairs();
/**
* Retrieve the inlet settings.
*
* @return %Inlet settings
*/
Settings getSettings();
/**
* Change the inlet settings.
*
* @param settings New inlet settings
*
* @return 0 if OK
* @return 1 if any parameters are invalid
*/
int setSettings(in Settings settings);
/**
* Enable/disable PDU operation for this inlet.
*
* When PDU operation is disabled the sensors for this inlet and all
* children will no longer be updated, and outlet switching is no
* longer allowed. This can be useful for multi-inlet units if one
* inlet is temporarily expected to be powered down.
*
* @param enabled \c true to enable PDU operation
*/
void setEnabled(in boolean enabled);
/**
* Test whether PDU operation is enabled for this inlet.
*
* @return \c true if PDU operation is enabled
*/
boolean isEnabled();
};
}
#endif
pdumodel::EDevice
Common base interface for any kind of electrical device that is used in the PDU model,...
Definition EDevice.idl:27
pdumodel::Inlet
Inlet interface
Definition Inlet.idl:22
pdumodel::Inlet::getMetaData
MetaData getMetaData()
Retrieve the inlet metadata.
pdumodel::Inlet::setSettings
int setSettings(in Settings settings)
Change the inlet settings.
pdumodel::Inlet::isEnabled
boolean isEnabled()
Test whether PDU operation is enabled for this inlet.
pdumodel::Inlet::getSensors
Sensors getSensors()
Get the inlet sensors.
pdumodel::Inlet::getPoles
vector< Pole > getPoles()
Get the list of inlet poles.
pdumodel::Inlet::getSettings
Settings getSettings()
Retrieve the inlet settings.
pdumodel::Inlet::getLinePairs
vector< MeteredLinePair > getLinePairs()
Get the list of inlet line pairs.
pdumodel::Inlet::setEnabled
void setEnabled(in boolean enabled)
Enable/disable PDU operation for this inlet.
pdumodel::ResidualCurrentStateSensor
Residual current state sensor interface.
Definition ResidualCurrentStateSensor.idl:17
sensors::NumericSensor
A sensor with numeric readings.
Definition NumericSensor.idl:17
sensors::StateSensor
Sensor with discrete readings.
Definition StateSensor.idl:43
pdumodel
PDU Model.
Definition Ade.idl:12
sensors
Sensors Model.
Definition AccumulatingNumericSensor.idl:13
pdumodel::Inlet::EnableStateChangedEvent
Event: Inlet has been enabled or disabled.
Definition Inlet.idl:77
pdumodel::Inlet::EnableStateChangedEvent::enabled
boolean enabled
New enable state.
Definition Inlet.idl:78
pdumodel::Inlet::MetaData
Inlet metadata
Definition Inlet.idl:25
pdumodel::Inlet::MetaData::hasWaveformSupport
boolean hasWaveformSupport
Whether waveform reading is supported on this inlet.
Definition Inlet.idl:30
pdumodel::Inlet::MetaData::plugType
string plugType
Plug type.
Definition Inlet.idl:27
pdumodel::Inlet::MetaData::label
string label
Inlet label
Definition Inlet.idl:26
pdumodel::Inlet::MetaData::isDC
boolean isDC
Current type, true for DC, false for AC.
Definition Inlet.idl:31
pdumodel::Inlet::MetaData::rating
Rating rating
Numerical usage ratings.
Definition Inlet.idl:29
pdumodel::Inlet::MetaData::namePlate
Nameplate namePlate
Nameplate information
Definition Inlet.idl:28
pdumodel::Inlet::Sensors
Inlet sensors
Definition Inlet.idl:35
pdumodel::Inlet::Sensors::voltage
sensors::NumericSensor voltage
RMS voltage sensor (may be a VoltageMonitoringSensor)
Definition Inlet.idl:36
pdumodel::Inlet::Sensors::activeEnergy
sensors::NumericSensor activeEnergy
Active energy sensor.
Definition Inlet.idl:49
pdumodel::Inlet::Sensors::residualCurrent
sensors::NumericSensor residualCurrent
Residual current sensor.
Definition Inlet.idl:39
pdumodel::Inlet::Sensors::unbalancedLineLineCurrent
sensors::NumericSensor unbalancedLineLineCurrent
Line-Line current unbalance sensor.
Definition Inlet.idl:52
pdumodel::Inlet::Sensors::unbalancedVoltage
sensors::NumericSensor unbalancedVoltage
Voltage unbalance sensor.
Definition Inlet.idl:53
pdumodel::Inlet::Sensors::powerQuality
sensors::StateSensor powerQuality
Power quality sensor.
Definition Inlet.idl:60
pdumodel::Inlet::Sensors::currentThd
sensors::NumericSensor currentThd
Current total harmonic distortion sensor.
Definition Inlet.idl:59
pdumodel::Inlet::Sensors::unbalancedLineLineVoltage
sensors::NumericSensor unbalancedLineLineVoltage
Line-Line voltage unbalance sensor.
Definition Inlet.idl:54
pdumodel::Inlet::Sensors::residualDCCurrent
sensors::NumericSensor residualDCCurrent
DC Residual current sensor.
Definition Inlet.idl:42
pdumodel::Inlet::Sensors::crestFactor
sensors::NumericSensor crestFactor
Crest factor sensor.
Definition Inlet.idl:57
pdumodel::Inlet::Sensors::displacementPowerFactor
sensors::NumericSensor displacementPowerFactor
Displacement power factor sensor.
Definition Inlet.idl:48
pdumodel::Inlet::Sensors::peakCurrent
sensors::NumericSensor peakCurrent
Peak current sensor.
Definition Inlet.idl:38
pdumodel::Inlet::Sensors::lineFrequency
sensors::NumericSensor lineFrequency
Line AC frequency sensor.
Definition Inlet.idl:55
pdumodel::Inlet::Sensors::reactivePower
sensors::NumericSensor reactivePower
Reactive power sensor.
Definition Inlet.idl:45
pdumodel::Inlet::Sensors::residualCurrentStatus
ResidualCurrentStateSensor residualCurrentStatus
Residual current monitor state sensor.
Definition Inlet.idl:62
pdumodel::Inlet::Sensors::current
sensors::NumericSensor current
RMS current sensor.
Definition Inlet.idl:37
pdumodel::Inlet::Sensors::surgeProtectorStatus
sensors::StateSensor surgeProtectorStatus
Surge protector status sensor.
Definition Inlet.idl:61
pdumodel::Inlet::Sensors::powerFactor
sensors::NumericSensor powerFactor
Power factor sensor.
Definition Inlet.idl:47
pdumodel::Inlet::Sensors::unbalancedCurrent
sensors::NumericSensor unbalancedCurrent
Current unbalance sensor.
Definition Inlet.idl:51
pdumodel::Inlet::Sensors::apparentEnergy
sensors::NumericSensor apparentEnergy
Apparent energy sensor.
Definition Inlet.idl:50
pdumodel::Inlet::Sensors::residualACCurrent
sensors::NumericSensor residualACCurrent
AC Residual current sensor.
Definition Inlet.idl:40
pdumodel::Inlet::Sensors::apparentPower
sensors::NumericSensor apparentPower
Apparent power sensor.
Definition Inlet.idl:46
pdumodel::Inlet::Sensors::phaseAngle
sensors::NumericSensor phaseAngle
Phase angle sensor.
Definition Inlet.idl:56
pdumodel::Inlet::Sensors::activePower
sensors::NumericSensor activePower
Active power sensor.
Definition Inlet.idl:44
pdumodel::Inlet::Sensors::voltageThd
sensors::NumericSensor voltageThd
Voltage total harmonic distortion sensor.
Definition Inlet.idl:58
pdumodel::Inlet::SettingsChangedEvent
Event: Inlet settings have been changed.
Definition Inlet.idl:71
pdumodel::Inlet::SettingsChangedEvent::newSettings
Settings newSettings
Settings after change.
Definition Inlet.idl:73
pdumodel::Inlet::SettingsChangedEvent::oldSettings
Settings oldSettings
Settings before change.
Definition Inlet.idl:72
pdumodel::Inlet::Settings
Inlet settings
Definition Inlet.idl:66
pdumodel::Inlet::Settings::name
string name
User-defined name.
Definition Inlet.idl:67
pdumodel::Nameplate
Component nameplate information.
Definition Nameplate.idl:23
pdumodel::Rating
Numerical usage ratings.
Definition Nameplate.idl:15