Raritan PX2/PX3 JSON-RPC API
Inlet.idl
1 /* SPDX-License-Identifier: BSD-3-Clause */
2 /*
3  * Copyright 2009 Raritan Inc. All rights reserved.
4  */
5 
6 #ifndef __PDUMODEL_INLET_IDL__
7 #define __PDUMODEL_INLET_IDL__
8 
9 #include <EDevice.idl>
10 #include <Nameplate.idl>
11 #include <NumericSensor.idl>
12 #include <StateSensor.idl>
13 #include <Pole.idl>
14 #include <ResidualCurrentStateSensor.idl>
15 
16 /**
17  * PDU Model
18  */
19 module pdumodel {
20 
21  /** %Inlet interface */
22  interface Inlet_2_0_6 extends EDevice {
23 
24  /** %Inlet metadata */
25  structure MetaData {
26  string label; ///< %Inlet label
27  string plugType; ///< Plug type
28  Nameplate_2_0_0 namePlate; ///< %Nameplate information
29  Rating_2_0_0 rating; ///< Numerical usage ratings
30  };
31 
32  /** %Inlet sensors */
33  structure Sensors {
34  sensors.NumericSensor_4_0_4 voltage; ///< RMS voltage sensor
35  sensors.NumericSensor_4_0_4 current; ///< RMS current sensor
36  sensors.NumericSensor_4_0_4 peakCurrent; ///< Peak current sensor
37  sensors.NumericSensor_4_0_4 residualCurrent; ///< Residual current sensor
38  sensors.NumericSensor_4_0_4 residualACCurrent; ///< AC Residual current sensor
39  ///< (AC portion of residual operating current)
40  sensors.NumericSensor_4_0_4 residualDCCurrent; ///< DC Residual current sensor
41  ///< (DC portion of residual operating current)
42  sensors.NumericSensor_4_0_4 activePower; ///< Active power sensor
43  sensors.NumericSensor_4_0_4 reactivePower; ///< Reactive power sensor
44  sensors.NumericSensor_4_0_4 apparentPower; ///< Apparent power sensor
45  sensors.NumericSensor_4_0_4 powerFactor; ///< Power factor sensor
46  sensors.NumericSensor_4_0_4 displacementPowerFactor; ///< Displacement power factor sensor
47  sensors.NumericSensor_4_0_4 activeEnergy; ///< Active energy sensor
48  sensors.NumericSensor_4_0_4 apparentEnergy; ///< Apparent energy sensor
49  sensors.NumericSensor_4_0_4 unbalancedCurrent; ///< Current unbalance sensor
50  sensors.NumericSensor_4_0_4 lineFrequency; ///< Line AC frequency sensor
51  sensors.NumericSensor_4_0_4 phaseAngle; ///< Phase angle sensor
52  sensors.NumericSensor_4_0_4 crestFactor; ///< Crest factor sensor
53  sensors.StateSensor_4_0_4 powerQuality; ///< Power quality sensor
54  sensors.StateSensor_4_0_4 surgeProtectorStatus; ///< Surge protector status sensor
55  ResidualCurrentStateSensor_2_0_4 residualCurrentStatus; ///< Residual current monitor state sensor
56  };
57 
58  /** %Inlet settings */
59  structure Settings {
60  string name; ///< User-defined name
61  };
62 
63  /** Event: Inlet settings have been changed */
64  valueobject SettingsChangedEvent extends event.UserEvent {
65  Settings oldSettings; ///< Settings before change
66  Settings newSettings; ///< Settings after change
67  };
68 
69  /** Event: Inlet has been enabled or disabled */
70  valueobject EnableStateChangedEvent extends event.UserEvent {
71  boolean enabled; ///< New enable state
72  };
73 
74  /**
75  * Retrieve the inlet metadata.
76  *
77  * @return %Inlet metadata
78  */
80 
81  /**
82  * Get the inlet sensors.
83  *
84  * @return %Inlet sensors
85  */
87 
88  /**
89  * Get the list of inlet poles.
90  *
91  * @return List of inlet poles
92  */
93  vector<Pole_7_0_0> getPoles();
94 
95  /**
96  * Retrieve the inlet settings.
97  *
98  * @return %Inlet settings
99  */
101 
102  /**
103  * Change the inlet settings.
104  *
105  * @param settings New inlet settings
106  *
107  * @return 0 if OK
108  * @return 1 if any parameters are invalid
109  */
110  int setSettings(in Settings settings);
111 
112  /**
113  * Enable/disable PDU operation for this inlet.
114  *
115  * When PDU operation is disabled the sensors for this inlet and all
116  * children will no longer be updated, and outlet switching is no
117  * longer allowed. This can be useful for multi-inlet units if one
118  * inlet is temporarily expected to be powered down.
119  *
120  * @param enabled \c true to enable PDU operation
121  */
122  void setEnabled(in boolean enabled);
123 
124  /**
125  * Test whether PDU operation is enabled for this inlet.
126  *
127  * @return \c true if PDU operation is enabled
128  */
129  boolean isEnabled();
130  };
131 
132 }
133 
134 #endif
pdumodel::Inlet_2_0_6::MetaData::namePlate
Nameplate_2_0_0 namePlate
Nameplate information
Definition: Inlet.idl:28
pdumodel::Inlet_2_0_6::Sensors::phaseAngle
sensors::NumericSensor_4_0_4 phaseAngle
Phase angle sensor.
Definition: Inlet.idl:51
pdumodel::Inlet_2_0_6::Sensors::current
sensors::NumericSensor_4_0_4 current
RMS current sensor.
Definition: Inlet.idl:35
pdumodel::Inlet_2_0_6::Settings::name
string name
User-defined name.
Definition: Inlet.idl:60
pdumodel::Inlet_2_0_6::Sensors::powerQuality
sensors::StateSensor_4_0_4 powerQuality
Power quality sensor.
Definition: Inlet.idl:53
pdumodel::Inlet_2_0_6::Sensors::activePower
sensors::NumericSensor_4_0_4 activePower
Active power sensor.
Definition: Inlet.idl:42
sensors
Sensors Model.
Definition: AccumulatingNumericSensor.idl:13
pdumodel::Inlet_2_0_6::Sensors::residualACCurrent
sensors::NumericSensor_4_0_4 residualACCurrent
AC Residual current sensor.
Definition: Inlet.idl:38
pdumodel::Rating_2_0_0
Numerical usage ratings.
Definition: Nameplate.idl:15
pdumodel::Inlet_2_0_6::setEnabled
void setEnabled(in boolean enabled)
Enable/disable PDU operation for this inlet.
pdumodel::Inlet_2_0_6::Sensors::powerFactor
sensors::NumericSensor_4_0_4 powerFactor
Power factor sensor.
Definition: Inlet.idl:45
pdumodel::Inlet_2_0_6::Sensors
Inlet sensors
Definition: Inlet.idl:33
pdumodel::Inlet_2_0_6::Sensors::surgeProtectorStatus
sensors::StateSensor_4_0_4 surgeProtectorStatus
Surge protector status sensor.
Definition: Inlet.idl:54
pdumodel::ResidualCurrentStateSensor_2_0_4
Residual current state sensor interface.
Definition: ResidualCurrentStateSensor.idl:17
pdumodel::Inlet_2_0_6::Sensors::residualDCCurrent
sensors::NumericSensor_4_0_4 residualDCCurrent
DC Residual current sensor.
Definition: Inlet.idl:40
pdumodel::Inlet_2_0_6::Sensors::unbalancedCurrent
sensors::NumericSensor_4_0_4 unbalancedCurrent
Current unbalance sensor.
Definition: Inlet.idl:49
pdumodel::Inlet_2_0_6::isEnabled
boolean isEnabled()
Test whether PDU operation is enabled for this inlet.
pdumodel::Inlet_2_0_6::getPoles
vector< Pole_7_0_0 > getPoles()
Get the list of inlet poles.
pdumodel
PDU Model.
Definition: Ade.idl:12
sensors::StateSensor_4_0_4
Sensor with discrete readings.
Definition: StateSensor.idl:43
pdumodel::Inlet_2_0_6::Sensors::lineFrequency
sensors::NumericSensor_4_0_4 lineFrequency
Line AC frequency sensor.
Definition: Inlet.idl:50
pdumodel::Inlet_2_0_6::Sensors::reactivePower
sensors::NumericSensor_4_0_4 reactivePower
Reactive power sensor.
Definition: Inlet.idl:43
pdumodel::Inlet_2_0_6::getSettings
Settings getSettings()
Retrieve the inlet settings.
pdumodel::Inlet_2_0_6::getMetaData
MetaData getMetaData()
Retrieve the inlet metadata.
pdumodel::Nameplate_2_0_0
Component nameplate information.
Definition: Nameplate.idl:23
pdumodel::Inlet_2_0_6::MetaData::label
string label
Inlet label
Definition: Inlet.idl:26
pdumodel::Inlet_2_0_6::MetaData::rating
Rating_2_0_0 rating
Numerical usage ratings.
Definition: Inlet.idl:29
pdumodel::Inlet_2_0_6::getSensors
Sensors getSensors()
Get the inlet sensors.
pdumodel::Inlet_2_0_6::Sensors::crestFactor
sensors::NumericSensor_4_0_4 crestFactor
Crest factor sensor.
Definition: Inlet.idl:52
pdumodel::Inlet_2_0_6::Sensors::displacementPowerFactor
sensors::NumericSensor_4_0_4 displacementPowerFactor
Displacement power factor sensor.
Definition: Inlet.idl:46
pdumodel::Inlet_2_0_6::Sensors::activeEnergy
sensors::NumericSensor_4_0_4 activeEnergy
Active energy sensor.
Definition: Inlet.idl:47
pdumodel::Inlet_2_0_6::Sensors::voltage
sensors::NumericSensor_4_0_4 voltage
RMS voltage sensor.
Definition: Inlet.idl:34
pdumodel::Inlet_2_0_6::MetaData::plugType
string plugType
Plug type.
Definition: Inlet.idl:27
pdumodel::Inlet_2_0_6::Sensors::residualCurrent
sensors::NumericSensor_4_0_4 residualCurrent
Residual current sensor.
Definition: Inlet.idl:37
pdumodel::Inlet_2_0_6::setSettings
int setSettings(in Settings settings)
Change the inlet settings.
pdumodel::Inlet_2_0_6::Sensors::peakCurrent
sensors::NumericSensor_4_0_4 peakCurrent
Peak current sensor.
Definition: Inlet.idl:36
pdumodel::Inlet_2_0_6::Sensors::residualCurrentStatus
ResidualCurrentStateSensor_2_0_4 residualCurrentStatus
Residual current monitor state sensor.
Definition: Inlet.idl:55
sensors::NumericSensor_4_0_4
A sensor with numeric readings.
Definition: NumericSensor.idl:17
pdumodel::Inlet_2_0_6
Inlet interface
Definition: Inlet.idl:22
pdumodel::Inlet_2_0_6::Sensors::apparentPower
sensors::NumericSensor_4_0_4 apparentPower
Apparent power sensor.
Definition: Inlet.idl:44
pdumodel::Inlet_2_0_6::MetaData
Inlet metadata
Definition: Inlet.idl:25
pdumodel::Inlet_2_0_6::Sensors::apparentEnergy
sensors::NumericSensor_4_0_4 apparentEnergy
Apparent energy sensor.
Definition: Inlet.idl:48
pdumodel::EDevice
Common base interface for any kind of electrical device that is used in the PDU model,...
Definition: EDevice.idl:24
pdumodel::Inlet_2_0_6::Settings
Inlet settings
Definition: Inlet.idl:59
pdumodel::Inlet_2_0_6::newSettings
Settings newSettings
Settings after change.
Definition: Inlet.idl:66