EATON-PCD-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32 FROM SNMPv2-SMI DisplayString FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF powerChain, PositiveInteger, NonNegativeInteger FROM EATON-OIDS; pcdMIB MODULE-IDENTITY LAST-UPDATED "200804290000Z" ORGANIZATION "Eaton Corporation" CONTACT-INFO "Eaton Power Quality Technical Support (PQTS) group www.eaton.com/powerxpert Technical Resource Center phone numbers United States: 1.800.843.9433 or 919.870.3028 Canada: 1.800.461.9166 ext. 260 All other countries: Call your local service representative." DESCRIPTION "The MIB module for objects for common measures that most Eaton Power Chain Devices can support. Some portion of this MIB would be supported by most Eaton equipment, including Meters. This MIB covers three areas: - Voltage, Current, Frequency, and %Load measures. - Digital (binary) Inputs and Outputs. - Generic (non-specific) sensor readings. All objects are indexed by a device number, since some agents will present data from more than one Power Chain Device. This powerChainDeviceIndex is normally the same as entPhysicalIndex. Copyright (C) Eaton Corporation (2007-)." REVISION "200804290000Z" DESCRIPTION "Revised to improve the voltage measures presentation. Changed pcdMeasuresVoltage into pcdMeasuresMain- and -SecondVoltage, and pcdVoltageUnits into pcdMain- and -SecondVoltageType. Changed pcdPhaseMeasuresVoltage into pcdPhaseMeasuresVoltageLL and -LN. Changed pcdDigitalInput- and -OutputLastChange from TimeStamp to DisplayString types." REVISION "200712030000Z" DESCRIPTION "Initial Version of pcdMIB." ::= { powerChain 2 } -- ::= { enterprises 534 8 2 } -- pcdMib { iso org(3) dod(6) internet(1) private(4) -- enterprises(1) eaton(534) powerChain(8) (2) } pcdMIBObjects OBJECT IDENTIFIER ::= { pcdMIB 1 } -- pcdMIB contains these groups pcdMeasures OBJECT IDENTIFIER ::= { pcdMIBObjects 1 } pcdDigitalIO OBJECT IDENTIFIER ::= { pcdMIBObjects 2 } pcdSensors OBJECT IDENTIFIER ::= { pcdMIBObjects 3 } -- -- pcdMeasures group -- -- Two tables for common Voltage, Current, % Load, and Frequency -- readings. The first table, pcdMeasuresTable, provides overall values for -- all phases of each device, and the second table, pcdPhaseMeasuresTable, -- breaks down readingpcdMainVoltageTypes by phase. pcdMeasuresTable OBJECT-TYPE SYNTAX SEQUENCE OF PcdMeasuresEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of measures for each device. Since these measures are not broken out by phase, they apply to all phases of the device." ::= { pcdMeasures 1 } pcdMeasuresEntry OBJECT-TYPE SYNTAX PcdMeasuresEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing information applicable to a particular Power Chain Device." INDEX { powerChainDeviceIndex } ::= { pcdMeasuresTable 1 } PcdMeasuresEntry ::= SEQUENCE { powerChainDeviceIndex PositiveInteger, pcdMeasuresMainVoltage NonNegativeInteger, pcdMainVoltageType DisplayString, pcdMeasuresSecondVoltage NonNegativeInteger, pcdSecondVoltageType DisplayString, pcdMeasuresCurrent NonNegativeInteger, pcdMeasuresPercentLoad Integer32, pcdMeasuresFrequency NonNegativeInteger } powerChainDeviceIndex OBJECT-TYPE SYNTAX PositiveInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Power Chain Device identifier (device number). Used to index all tables in this MIB. Normally equal to the device's entPhysicalIndex." ::= { pcdMeasuresEntry 1 } pcdMeasuresMainVoltage OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "Volts" MAX-ACCESS read-only STATUS current DESCRIPTION "The present 'main' voltage for this device. The measure will be device-specific, eg, 3-phase average. The type of this measures is indicated by pcdMainVoltageType." ::= { pcdMeasuresEntry 2 } pcdMainVoltageType OBJECT-TYPE SYNTAX DisplayString (SIZE (0..31)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates what type of reading pcdMeasuresMainVoltage is. This may be units like 'Vrms Line-Line' or 'Vrms Line-Neutral', or the name of the source of this reading in the device's terms." ::= { pcdMeasuresEntry 3 } pcdMeasuresSecondVoltage OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "Volts" MAX-ACCESS read-only STATUS current DESCRIPTION "The present 'second' voltage for this device. The measure will be device-specific, eg, 3-phase average. The type of this measures is indicated by pcdSecondVoltageType." ::= { pcdMeasuresEntry 4 } pcdSecondVoltageType OBJECT-TYPE SYNTAX DisplayString (SIZE (0..31)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates what type of reading pcdMeasuresSecondVoltage is. This may be units like 'Vrms Line-Line' or 'Vrms Line-Neutral', or the name of the source of this reading in the device's terms." ::= { pcdMeasuresEntry 5 } pcdMeasuresCurrent OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "0.1 Amps RMS" MAX-ACCESS read-only STATUS current DESCRIPTION "The present summary current for this device. This may be the 3-phase average." ::= { pcdMeasuresEntry 6 } pcdMeasuresPercentLoad OBJECT-TYPE SYNTAX Integer32 (0..200) UNITS "percent" MAX-ACCESS read-only STATUS current DESCRIPTION "The percentage of the Power Chain Device's rated capacity presently being used." ::= { pcdMeasuresEntry 7 } pcdMeasuresFrequency OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "0.01 Hertz" MAX-ACCESS read-only STATUS current DESCRIPTION "The present frequency reading for this Power Chain Device." ::= { pcdMeasuresEntry 8 } -- -- Table of Measures by Phase -- pcdPhaseMeasuresTable OBJECT-TYPE SYNTAX SEQUENCE OF PcdPhaseMeasuresEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of per-phase measures for each device." ::= { pcdMeasures 2 } pcdPhaseMeasuresEntry OBJECT-TYPE SYNTAX PcdPhaseMeasuresEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing information applicable to one line of a particular Power Chain Device. Indexed by device number and phase number." INDEX { powerChainDeviceIndex, pcdPhaseIndex } ::= { pcdPhaseMeasuresTable 1 } PcdPhaseMeasuresEntry ::= SEQUENCE { pcdPhaseIndex PositiveInteger, pcdPhaseMeasuresVoltageLL NonNegativeInteger, pcdPhaseMeasuresVoltageLN NonNegativeInteger, pcdPhaseMeasuresCurrent NonNegativeInteger, pcdPhaseMeasuresPercentLoad Integer32 } pcdPhaseIndex OBJECT-TYPE SYNTAX PositiveInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "The line (phase) identifier." ::= { pcdPhaseMeasuresEntry 1 } pcdPhaseMeasuresVoltageLL OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "Volts" MAX-ACCESS read-only STATUS current DESCRIPTION "The present Line-to-Line voltage for this phase of this device." ::= { pcdPhaseMeasuresEntry 2 } pcdPhaseMeasuresVoltageLN OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "Volts" MAX-ACCESS read-only STATUS current DESCRIPTION "The present Line-to-Neutral voltage for this phase of this device." ::= { pcdPhaseMeasuresEntry 3 } pcdPhaseMeasuresCurrent OBJECT-TYPE SYNTAX NonNegativeInteger UNITS "0.1 Amps RMS" MAX-ACCESS read-only STATUS current DESCRIPTION "The present current for this phase of this device." ::= { pcdPhaseMeasuresEntry 4 } pcdPhaseMeasuresPercentLoad OBJECT-TYPE SYNTAX Integer32 (0..200) UNITS "percent" MAX-ACCESS read-only STATUS current DESCRIPTION "The percentage of this phase's rated capacity presently being used." ::= { pcdPhaseMeasuresEntry 5 } -- -- pcdDigitalIO group -- -- Two tables for digital (ie, binary state) Inputs and Outputs. -- Rather than provide the two states as True and False boolean values, -- these tables use the more informative labels for these states that the -- devices themselves use (Open/Closed, NormallyOpen/ActiveClosed, -- High/Low, etc). pcdDigitalInputsTable OBJECT-TYPE SYNTAX SEQUENCE OF PcdDigitalInputsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of digital inputs for the indicated device. Devices will have varying numbers of digital inputs, from 1 to 64, but most commonly 1-4. The table will not be implemented for a device if there are no digital inputs." ::= { pcdDigitalIO 1 } pcdDigitalInputsEntry OBJECT-TYPE SYNTAX PcdDigitalInputsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing information applicable to a particular digital input of a Power Chain Device." INDEX { powerChainDeviceIndex, pcdDigitalInputIndex } ::= { pcdDigitalInputsTable 1 } PcdDigitalInputsEntry ::= SEQUENCE { pcdDigitalInputIndex PositiveInteger, pcdDigitalInputName DisplayString, pcdDigitalInputPresentValue DisplayString, pcdDigitalInputPossibleValues DisplayString, pcdDigitalInputLastChange DisplayString } pcdDigitalInputIndex OBJECT-TYPE SYNTAX PositiveInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index of this digital input." ::= { pcdDigitalInputsEntry 1 } pcdDigitalInputName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The name of this digital input as a human-readable text string." ::= { pcdDigitalInputsEntry 2 } pcdDigitalInputPresentValue OBJECT-TYPE SYNTAX DisplayString (SIZE (0..31)) MAX-ACCESS read-only STATUS current DESCRIPTION "The present value of this digital input, presented as a human-readable text string. This value should be one of the states listed in pcdDigitalInputPossibleValues." ::= { pcdDigitalInputsEntry 3 } pcdDigitalInputPossibleValues OBJECT-TYPE SYNTAX DisplayString (SIZE (0..63)) MAX-ACCESS read-only STATUS current DESCRIPTION "The possible states of this digital input, listed as a semicolon separated string of values. A simple default is True;False, but most devices should provide more informative text, such as Open;Closed, Stopped;Started, or High;Low. The pcdDigitalInputPresentValue should always be one of the states listed in pcdDigitalInputPossibleValues. This design does not specifically exclude the use of additional states for the input, such as Unknown or Unavailable, as long as they are included in pcdDigitalInputPossibleValues." ::= { pcdDigitalInputsEntry 4 } pcdDigitalInputLastChange OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates (in text) the date and time when pcdDigitalInputPresentValue last changed its state." ::= { pcdDigitalInputsEntry 5 } -- -- Digital Outputs Table -- pcdDigitalOutputsTable OBJECT-TYPE SYNTAX SEQUENCE OF PcdDigitalOutputsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of digital outputs for the indicated device. Devices will have varying numbers of digital outputs, from 1 to 64, but most commonly 1-4. The table will not be implemented for a device if there are no digital outputs." ::= { pcdDigitalIO 2 } pcdDigitalOutputsEntry OBJECT-TYPE SYNTAX PcdDigitalOutputsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing information applicable to a particular digital output of a Power Chain Device." INDEX { powerChainDeviceIndex, pcdDigitalOutputIndex } ::= { pcdDigitalOutputsTable 1 } PcdDigitalOutputsEntry ::= SEQUENCE { pcdDigitalOutputIndex PositiveInteger, pcdDigitalOutputName DisplayString, pcdDigitalOutputPresentValue DisplayString, pcdDigitalOutputPossibleValues DisplayString, pcdDigitalOutputLastChange DisplayString } pcdDigitalOutputIndex OBJECT-TYPE SYNTAX PositiveInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index of this digital output." ::= { pcdDigitalOutputsEntry 1 } pcdDigitalOutputName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The name of this digital output as a human-readable text string." ::= { pcdDigitalOutputsEntry 2 } pcdDigitalOutputPresentValue OBJECT-TYPE SYNTAX DisplayString (SIZE (0..31)) MAX-ACCESS read-write STATUS current DESCRIPTION "When read, gives the present value of this digital output, presented as a human-readable text string. When written, sets the digital output to the indicated state. Whether read or written, this value should be one of the states listed in pcdDigitalOutputPossibleValues." ::= { pcdDigitalOutputsEntry 3 } pcdDigitalOutputPossibleValues OBJECT-TYPE SYNTAX DisplayString (SIZE (0..63)) MAX-ACCESS read-only STATUS current DESCRIPTION "The possible states of this digital output, listed as a semicolon separated string of values. A simple default is True;False, but most devices should provide more informative text, such as Open;Closed, Stopped;Started, or High;Low. The pcdDigitalOutputPresentValue should always be one of the states listed in pcdDigitalOutputPossibleValues. This design does not specifically exclude the use of additional states for the output, such as Unknown or Unavailable, as long as they are included in pcdDigitalOutputPossibleValues. However, the agent may refuse an attempt to set the value to one of these states." ::= { pcdDigitalOutputsEntry 4 } pcdDigitalOutputLastChange OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates (in text) the date and time when pcdDigitalOutputPresentValue last changed its state." ::= { pcdDigitalOutputsEntry 5 } -- -- pcdSensors group -- -- A simple table of additional readouts that are considered important -- enough to present in MIB data but that are not covered by a specific -- RFC or Eaton MIB object. Each entry is indexed by its device number -- and a "sensor index", and consists of 3 accessible objects that name -- the reading, give its value, and provide the units for it. -- Thus, a sample reading of the fifth "sensor" from device 2 might be: -- pcdSensorEntry.2.5: "Winding Temperature 3" 525 "degrees Centigrade x10" pcdSensorTable OBJECT-TYPE SYNTAX SEQUENCE OF PcdSensorEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of additional non-specific sensor measures for each device." ::= { pcdSensors 1 } pcdSensorEntry OBJECT-TYPE SYNTAX PcdSensorEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing information for one sensor reading in a Power Chain Device. Indexed by device number and a sensor index." INDEX { powerChainDeviceIndex, pcdSensorIndex } ::= { pcdSensorTable 1 } PcdSensorEntry ::= SEQUENCE { pcdSensorIndex PositiveInteger, pcdSensorName DisplayString, pcdSensorReading Integer32, pcdSensorUnits DisplayString } pcdSensorIndex OBJECT-TYPE SYNTAX PositiveInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "A simple index to separate pcdSensorEntry rows. This index has no specific meaning; it is normally just a consecutive numbering of sensor reading rows for a given device." ::= { pcdSensorEntry 1 } pcdSensorName OBJECT-TYPE SYNTAX DisplayString MAX-ACCESS read-only STATUS current DESCRIPTION "The name of this sensor readings as a human-readable text string." ::= { pcdSensorEntry 2 } pcdSensorReading OBJECT-TYPE SYNTAX Integer32 -- UNITS - given by pcdSensorUnits MAX-ACCESS read-only STATUS current DESCRIPTION "The present reading of this sensor." ::= { pcdSensorEntry 3 } pcdSensorUnits OBJECT-TYPE SYNTAX DisplayString (SIZE (0..31)) MAX-ACCESS read-only STATUS current DESCRIPTION "Text string which indicates the units for this pcdSensorEntry, including any scaling factor to convert pcdSensorReading to an Integer32 value." ::= { pcdSensorEntry 4 } -- Notifications -- pcdNotifications OBJECT IDENTIFIER ::= { pcdMIB 0 } -- (Assignment reserved in case used in the future) -- IMPORTS (add these above) -- NOTIFICATION-TYPE FROM SNMPv2-SMI -- NOTIFICATION-GROUP FROM SNMPv2-CONF -- -- Conformance-related definitions -- pcdConformance OBJECT IDENTIFIER ::= { pcdMIB 2 } pcdMeasuresRow OBJECT-GROUP OBJECTS { pcdMeasuresMainVoltage, pcdMainVoltageType, pcdMeasuresSecondVoltage, pcdSecondVoltageType, pcdMeasuresCurrent, pcdMeasuresPercentLoad, pcdMeasuresFrequency } STATUS current DESCRIPTION "The pcdMeasuresEntry objects that are accessible to MIB browsers." ::= { pcdConformance 1 } pcdPhaseMeasuresRow OBJECT-GROUP OBJECTS { pcdPhaseMeasuresVoltageLL, pcdPhaseMeasuresVoltageLN, pcdPhaseMeasuresCurrent, pcdPhaseMeasuresPercentLoad } STATUS current DESCRIPTION "The pcdPhaseMeasuresEntry objects that are accessible to MIB browsers." ::= { pcdConformance 2 } pcdDigitalInputRow OBJECT-GROUP OBJECTS { pcdDigitalInputName, pcdDigitalInputPresentValue, pcdDigitalInputPossibleValues, pcdDigitalInputLastChange } STATUS current DESCRIPTION "The pcdDigitalInputsEntry objects that are accessible to MIB browsers." ::= { pcdConformance 3 } pcdDigitalOutputRow OBJECT-GROUP OBJECTS { pcdDigitalOutputName, pcdDigitalOutputPresentValue, pcdDigitalOutputPossibleValues, pcdDigitalOutputLastChange } STATUS current DESCRIPTION "The pcdDigitalOutputsEntry objects that are accessible to MIB browsers." ::= { pcdConformance 4 } pcdSensorRow OBJECT-GROUP OBJECTS { pcdSensorName, pcdSensorReading, pcdSensorUnits } STATUS current DESCRIPTION "The pcdSensorEntry objects that are accessible to MIB browsers." ::= { pcdConformance 5 } pcdMeasuresCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for Power Chain Device implementations that support pcdMeasures." MODULE -- this module MANDATORY-GROUPS { pcdMeasuresRow, pcdPhaseMeasuresRow } ::= { pcdConformance 11 } pcdDigitalIOCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for Power Chain Device implementations that support the pcdDigitalIO tables." MODULE -- this module MANDATORY-GROUPS { pcdDigitalInputRow, pcdDigitalOutputRow } ::= { pcdConformance 12 } pcdSensorsCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for Power Chain Device implementations that support the pcdSensorTable." MODULE -- this module MANDATORY-GROUPS { pcdSensorRow } ::= { pcdConformance 13 } END