IEEE8023-POWER-ETHERNET-MIB DEFINITIONS ::= BEGIN IMPORTS SnmpAdminString FROM SNMP-FRAMEWORK-MIB MODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP FROM SNMPv2-CONF Counter32, Gauge32, Integer32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE, org FROM SNMPv2-SMI TruthValue FROM SNMPv2-TC; ieee8023powerEthernetMIB MODULE-IDENTITY LAST-UPDATED "202412110000Z" ORGANIZATION "IEEE 802.3 Working Group" CONTACT-INFO " WG-URL: http://www.ieee802.org/3/index.html WG-EMail: mailto:stds-802-3-dialog@ieee.org Contact: IEEE 802.3 Working Group Chair Postal: C/O IEEE 802.3 Working Group IEEE Standards Association 445 Hoes Lane Piscataway, NJ 08854 USA E-mail: mailto:stds-802-3-dialog@ieee.org" DESCRIPTION "The MIB module for managing Power Source Equipment (PSE) specified in IEEE Std 802.3 Clause 33." REVISION "202412110000Z" DESCRIPTION "Revision, based on an earlier version in IEEE Std 802.3.1-2013 addressing changes from IEEE Std 802.3 revisions 2012, 2015, 2018, and 2022." REVISION "201304110000Z" DESCRIPTION "Revision, based on an earlier version in IEEE Std 802.3.1-2011." REVISION "201102020000Z" DESCRIPTION "Initial version, based on an earlier version published as RFC 3621." ::= { org ieee(111) standards-association-numbers-series-standards(2) lan-man-stds(802) ieee802dot3(3) ieee802dot3dot1mibs(1) 8 } pethNotifications OBJECT IDENTIFIER ::= { ieee8023powerEthernetMIB 0 } pethObjects OBJECT IDENTIFIER ::= { ieee8023powerEthernetMIB 1 } pethPsePortTable OBJECT-TYPE SYNTAX SEQUENCE OF PethPsePortEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of objects that display and control the power characteristics of Power over Ethernet ports on a Power Source Equipment (PSE) device. This group will be implemented in managed Power over Ethernet switches and mid-span devices. Values of all read-write objects in this table are persistent at restart/reboot." ::= { pethObjects 1 } pethPsePortEntry OBJECT-TYPE SYNTAX PethPsePortEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A set of objects that display and control the power characteristics of a Power over Ethernet PSE port." INDEX { pethPsePortGroupIndex, pethPsePortIndex } ::= { pethPsePortTable 1 } PethPsePortEntry ::= SEQUENCE { pethPsePortGroupIndex Integer32, pethPsePortIndex Integer32, pethPsePortAdminEnable TruthValue, pethPsePortPowerPairsControlAbility TruthValue, pethPsePortPowerPairs INTEGER, pethPsePortDetectionStatus INTEGER, pethPsePortPowerPriority INTEGER, pethPsePortMPSAbsentCounter Counter32, pethPsePortType SnmpAdminString, pethPsePortPowerClassifications INTEGER, pethPsePortInvalidSignatureCounter Counter32, pethPsePortPowerDeniedCounter Counter32, pethPsePortOverLoadCounter Counter32, pethPsePortShortCounter Counter32, pethPsePortActualPower Integer32, pethPsePortPowerAccuracy Integer32, pethPsePortCumulativeEnergy Counter32, pethPsePortAdminState TruthValue } pethPsePortGroupIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This variable uniquely identifies the group containing the port to which a Power over Ethernet PSE is connected. Group means box in the stack, module in a rack and the value 1 shall be used for non-modular devices. Furthermore, the same value shall be used in this variable, pethMainPseGroupIndex, and pethNotificationControlGroupIndex to refer to a given box in a stack or module in a rack." ::= { pethPsePortEntry 1 } pethPsePortIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This variable uniquely identifies the Power over Ethernet PSE port within group pethPsePortGroupIndex to which the Power over Ethernet PSE entry is connected." ::= { pethPsePortEntry 2 } pethPsePortAdminEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "true (1) Enable PSE functions. false(2) Disable PSE functions." REFERENCE "IEEE Std 802.3, 30.9.1.2.1" ::= { pethPsePortEntry 3 } pethPsePortPowerPairsControlAbility OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "Describes the capability of controlling the power pairs functionality to switch pins for sourcing power. The value true indicates that the device has the capability to control the power pairs. When false the PSE Pinout Alternative used cannot be controlled through the PethPsePortAdminEnable attribute." REFERENCE "IEEE Std 802.3, 30.9.1.1.3" ::= { pethPsePortEntry 4 } pethPsePortPowerPairs OBJECT-TYPE SYNTAX INTEGER { signal(1), spare(2), both(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "Describes or controls the pairs in use. If the value of pethPsePortPowerPairsControl is true, this object is writeable. A value of signal(1) means that the signal pairs only are in use. A value of spare(2) means that the spare pairs only are in use. A value of both(3) means that both signal and spare pairs are in use" REFERENCE "IEEE Std 802.3, 30.9.1.1.4" ::= { pethPsePortEntry 5 } pethPsePortDetectionStatus OBJECT-TYPE SYNTAX INTEGER { disabled(1), searching(2), deliveringPower(3), fault(4), test(5), otherFault(6) } MAX-ACCESS read-only STATUS current DESCRIPTION "Describes the operational status of the port PD detection. A value of disabled(1)- indicates that the PSE State diagram is in the state DISABLED. A value of searching(2)- indicates the PSE State diagram is in a state other than one of the states listed here. A value of deliveringPower(3) - indicates that the PSE State diagram is in the state POWER_ON for a duration greater than tlim max (see IEEE Std 802.3, Table 33-11). A value of fault(4) - indicates that the PSE State diagram is in the state TEST_ERROR. A value of test(5) - indicates that the PSE State diagram is in the state TEST_MODE. A value of otherFault(6) - indicates that the PSE State diagram is in the state IDLE due to the variable error_conditions." REFERENCE "IEEE Std 802.3, 30.9.1.1.5" ::= { pethPsePortEntry 6 } pethPsePortPowerPriority OBJECT-TYPE SYNTAX INTEGER { critical(1), high(2), low(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object controls the priority of the port from the point of view of a power management algorithm. The priority that is set by this variable could be used by a control mechanism that prevents overcurrent situations by disconnecting first ports with lower power priority. Ports that connect devices critical to the operation of the network - like the E911 telephones ports - should be set to higher priority." REFERENCE "IEEE Std 802.3, 79.3.2.4" ::= { pethPsePortEntry 7 } pethPsePortMPSAbsentCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This counter is incremented when the PSE doesn't detect a PD when powering up." REFERENCE "IEEE Std 802.3, 30.9.1.1.20" ::= { pethPsePortEntry 8 } pethPsePortType OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-write STATUS current DESCRIPTION "A manager will set the value of this variable to indicate the type of powered device that is connected to the port. The default value supplied by the agent if no value has ever been set should be a zero-length octet string." REFERENCE "IEEE Std 802.3, 79.3.2.4" ::= { pethPsePortEntry 9 } pethPsePortPowerClassifications OBJECT-TYPE SYNTAX INTEGER { class0(1), class1(2), class2(3), class3(4), class4(5), class5(6), class6(7), class7(8), class8(9) } MAX-ACCESS read-only STATUS current DESCRIPTION "Classification is a way to tag different terminals on the Power over Ethernet network according to their power consumption. The meaning of the classification labels is defined in IEEE Std 802.3 Clause 145. This variable is valid only while a PD is being powered, that is, while the attribute pethPsePortDetectionStatus is reporting the enumeration deliveringPower." REFERENCE "IEEE Std 802.3, 30.9.1.1.8" ::= { pethPsePortEntry 10 } pethPsePortInvalidSignatureCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This counter is incremented when a Type 1 or Type 2 PSE detects an invalid signature from the port." REFERENCE "IEEE Std 802.3, 30.9.1.1.11" ::= { pethPsePortEntry 11 } pethPsePortPowerDeniedCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This counter is incremented when the PSE denies power to the PD." REFERENCE "IEEE Std 802.3, 30.9.1.1.14" ::= { pethPsePortEntry 12 } pethPsePortOverLoadCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This counter is incremented when the PSE ouput current has gone into overload." REFERENCE "IEEE Std 802.3, 30.9.1.1.17" ::= { pethPsePortEntry 13 } pethPsePortShortCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS obsolete DESCRIPTION "Obsolete." ::= { pethPsePortEntry 14 } pethPsePortActualPower OBJECT-TYPE SYNTAX Integer32 UNITS "Milliwatts" MAX-ACCESS read-only STATUS current DESCRIPTION "The power being supplied by the PSE to the PD measured at the MDI." REFERENCE "IEEE Std 802.3, 30.9.1.1.23" ::= { pethPsePortEntry 15 } pethPsePortPowerAccuracy OBJECT-TYPE SYNTAX Integer32 UNITS "Milliwatts" MAX-ACCESS read-only STATUS current DESCRIPTION "The accuracy of the power measurement at MDI." REFERENCE "IEEE Std 802.3, 30.9.1.1.24" ::= { pethPsePortEntry 16 } pethPsePortCumulativeEnergy OBJECT-TYPE SYNTAX Counter32 UNITS "Millijoules" MAX-ACCESS read-only STATUS current DESCRIPTION "The cumulative energy supplied by the PSE ." REFERENCE "IEEE Std 802.3, 30.9.1.1.25" ::= { pethPsePortEntry 17 } pethPsePortAdminState OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "true (1) PSE functions are enabled. false(2) PSE functions are disabled." REFERENCE "IEEE Std 802.3, 30.9.1.1.2" ::= { pethPsePortEntry 18 } pethMainPseObjects OBJECT IDENTIFIER ::= { pethObjects 3 } pethMainPseTable OBJECT-TYPE SYNTAX SEQUENCE OF PethMainPseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of objects that display and control attributes of the main power source in a PSE device. Ethernet switches are one example of devices that would support these objects. Values of all read-write objects in this table are persistent at restart/reboot." ::= { pethMainPseObjects 1 } pethMainPseEntry OBJECT-TYPE SYNTAX PethMainPseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A set of objects that display and control the Main power of a PSE." INDEX { pethMainPseGroupIndex } ::= { pethMainPseTable 1 } PethMainPseEntry ::= SEQUENCE { pethMainPseGroupIndex Integer32, pethMainPsePower Gauge32, pethMainPseOperStatus INTEGER, pethMainPseConsumptionPower Gauge32, pethMainPseUsageThreshold Integer32 } pethMainPseGroupIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This variable uniquely identifies the group to which the Power over Ethernet PSE is connected. Group means (box in the stack, module in a rack) and the value 1 shall be used for non-modular devices. Furthermore, the same value shall be used in this variable, pethPsePortGroupIndex, and pethNotificationControlGroupIndex to refer to a given box in a stack or module in a rack." ::= { pethMainPseEntry 1 } pethMainPsePower OBJECT-TYPE SYNTAX Gauge32 (1..65535) UNITS "Watts" MAX-ACCESS read-only STATUS current DESCRIPTION "The nominal power of the PSE expressed in Watts." ::= { pethMainPseEntry 2 } pethMainPseOperStatus OBJECT-TYPE SYNTAX INTEGER { on(1), off(2), faulty(3) } MAX-ACCESS read-only STATUS current DESCRIPTION "The operational status of the main PSE." ::= { pethMainPseEntry 3 } pethMainPseConsumptionPower OBJECT-TYPE SYNTAX Gauge32 UNITS "Watts" MAX-ACCESS read-only STATUS current DESCRIPTION "Measured usage power expressed in Watts." ::= { pethMainPseEntry 4 } pethMainPseUsageThreshold OBJECT-TYPE SYNTAX Integer32 (1..99) UNITS "%" MAX-ACCESS read-write STATUS current DESCRIPTION "The usage threshold expressed in percents for comparing the measured power and initiating an alarm if the threshold is exceeded." ::= { pethMainPseEntry 5 } pethNotificationControl OBJECT IDENTIFIER ::= { pethObjects 4 } pethNotificationControlTable OBJECT-TYPE SYNTAX SEQUENCE OF PethNotificationControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of objects that display and control the Notification on a PSE device. Values of all read-write objects in this table are persistent at restart/reboot." ::= { pethNotificationControl 1 } pethNotificationControlEntry OBJECT-TYPE SYNTAX PethNotificationControlEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A set of objects that control the Notification events." INDEX { pethNotificationControlGroupIndex } ::= { pethNotificationControlTable 1 } PethNotificationControlEntry ::= SEQUENCE { pethNotificationControlGroupIndex Integer32, pethNotificationControlEnable TruthValue } pethNotificationControlGroupIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This variable uniquely identifies the group. Group means box in the stack, module in a rack and the value 1 shall be used for non-modular devices. Furthermore, the same value shall be used in this variable, pethPsePortGroupIndex, and pethMainPseGroupIndex to refer to a given box in a stack or module in a rack." ::= { pethNotificationControlEntry 1 } pethNotificationControlEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "This object controls, on a per-group basis, whether or not notifications from the agent are enabled. The value true(1) means that notifications are enabled; the value false(2) means that they are not." ::= { pethNotificationControlEntry 2 } pethConformance OBJECT IDENTIFIER ::= { ieee8023powerEthernetMIB 2 } pethCompliances OBJECT IDENTIFIER ::= { pethConformance 1 } pethGroups OBJECT IDENTIFIER ::= { pethConformance 2 } pethPsePortOnOffNotification NOTIFICATION-TYPE OBJECTS { pethPsePortDetectionStatus } STATUS current DESCRIPTION "This Notification indicates if Pse Port is delivering power to the PD or not. This Notification should be sent on every status change except in the searching mode. At least 500 msec shall elapse between notifications being emitted by the same object instance." ::= { pethNotifications 1 } pethMainPowerUsageOnNotification NOTIFICATION-TYPE OBJECTS { pethMainPseConsumptionPower } STATUS current DESCRIPTION "This Notification indicates PSE Threshold usage indication is on, the usage power is above the threshold. At least 500 msec shall elapse between notifications being emitted by the same object instance." ::= { pethNotifications 2 } pethMainPowerUsageOffNotification NOTIFICATION-TYPE OBJECTS { pethMainPseConsumptionPower } STATUS current DESCRIPTION "This Notification indicates PSE Threshold usage indication off, the usage power is below the threshold. At least 500 msec shall elapse between notifications being emitted by the same object instance." ::= { pethNotifications 3 } pethPsePortGroup OBJECT-GROUP OBJECTS { pethPsePortAdminEnable, pethPsePortPowerPairsControlAbility, pethPsePortPowerPairs, pethPsePortDetectionStatus, pethPsePortPowerPriority, pethPsePortMPSAbsentCounter, pethPsePortInvalidSignatureCounter, pethPsePortPowerDeniedCounter, pethPsePortOverLoadCounter, pethPsePortType, pethPsePortPowerClassifications, pethPsePortActualPower, pethPsePortPowerAccuracy, pethPsePortCumulativeEnergy, pethPsePortAdminState } STATUS current DESCRIPTION "PSE Port objects." ::= { pethGroups 1 } pethMainPseGroup OBJECT-GROUP OBJECTS { pethMainPsePower, pethMainPseOperStatus, pethMainPseConsumptionPower, pethMainPseUsageThreshold } STATUS current DESCRIPTION "Main PSE Objects." ::= { pethGroups 2 } pethNotificationControlGroup OBJECT-GROUP OBJECTS { pethNotificationControlEnable } STATUS current DESCRIPTION "Notification Control Objects." ::= { pethGroups 3 } pethPsePortNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { pethPsePortOnOffNotification } STATUS current DESCRIPTION "Pse Port Notifications." ::= { pethGroups 4 } pethMainPowerNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { pethMainPowerUsageOnNotification, pethMainPowerUsageOffNotification } STATUS current DESCRIPTION "Main PSE Notifications." ::= { pethGroups 5 } pethCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "Describes the requirements for conformance to the Power Ethernet MIB." MODULE -- this module MANDATORY-GROUPS { pethPsePortGroup, pethPsePortNotificationGroup, pethNotificationControlGroup } GROUP pethMainPseGroup DESCRIPTION "The pethMainPseGroup is mandatory for PSE systems that implement a main power supply." GROUP pethMainPowerNotificationGroup DESCRIPTION "The pethMainPowerNotificationGroup is mandatory for PSE systems that implement a main power supply." ::= { pethCompliances 1 } END -- end of module IEEE8023-POWER-ETHERNET-MIB.