[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: (draft-romascanu-hubmib-power-ethernet-mib) 00 01 02 03 04 05 06 07 08 RFC 3621

Internet Draft                                                Avi Berger
                                                         PowerDsine Inc.
                                                           Dan Romascanu
                                                              Avaya Inc.
                                                            30 June 2002


                 Power Ethernet (DTE Power via MDI) MIB


              <draft-ietf-hubmib-power-ethernet-mib-02.txt>

Status of this Memo

   This document is an Internet-Draft and is in full conformance with
   all provisions of Section 10 of RFC2026.  Internet-Drafts are working
   documents of the Internet Engineering Task Force (IETF), its areas,
   and its working groups.  Note that other groups may also distribute
   working documents as Internet-Drafts.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet- Drafts as reference
   material or to cite them other than as "work in progress."

   To view the list Internet-Draft Shadow Directories, see
   http://www.ietf.org/shadow.html.

   Copyright Notice

   Copyright (C) The Internet Society (2002).  All Rights Reserved.

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   The document proposes an extension to the Ethernet-like Interfaces
   MIB [RFC2665] with a set of objects for managing a power Ethernet
   Powered Device (PD) and/or Power Source Equipment (PSE).

   Distribution of this memo is unlimited.

Table of Contents

   Status of this Memo                                             1
   Abstract                                                        1
    1 Introduction                                                 2
    2 The SNMP Management Framework                                2



Ethernet MIB WG           Expires November 2002                 [Page 1]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


    3 Overview                                                     3
    4 MIB Structure                                                4
    5 Evolution of the Document, Limitations and Future Work       4
    6 Changes log                                                  4
    7 Definitions                                                  7
    8 References                                                  24
    9 Intellectual Property                                       26
    10 Security Considerations                                    26
    11 Authors Addresses                                          27
    A Full Copyright Statement                                    27

1.  Introduction

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in the Internet community.
   In particular, it defines a set of MIB objects to manage a Power
   Ethernet (DTE Power via MDI)Powered Device (PD) and/or power Source
   Equipment (PSE).

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [RFC2863].

2.  The SNMP Management Framework

   The SNMP Management Framework presently consists of five major
   components:

   o   An overall architecture, described in RFC 2571 [RFC2571].

   o   Mechanisms for describing and naming objects and events for the
       purpose of management.  The first version of this Structure of
       Management Information (SMI) is called SMIv1 and described in
       STD 16, RFC 1155 [RFC1155], STD 16, RFC 1212 [RFC1212] and RFC
       1215 [RFC1215].  The second version, called SMIv2, is described
       in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and
       STD 58, RFC 2580 [RFC2580].

   o   Message protocols for transferring management information.  The
       first version of the SNMP message protocol is called SNMPv1 and
       described in STD 15, RFC 1157 [RFC1157].  A second version of
       the SNMP message protocol, which is not an Internet standards
       track protocol, is called SNMPv2c and described in RFC 1901
       [RFC1901] and RFC 1906 [RFC1906].  The third version of the
       message protocol is called SNMPv3 and described in RFC 1906
       [RFC1906], RFC 2572 [RFC2572] and RFC 2574 [RFC2574].

   o   Protocol operations for accessing management information.  The



Ethernet MIB WG           Expires November 2002                 [Page 2]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       first set of protocol operations and associated PDU formats is
       described in STD 15, RFC 1157 [RFC1157].  A second set of
       protocol operations and associated PDU formats is described in
       RFC 1905 [RFC1905].

   o   A set of fundamental applications described in RFC 2573
       [RFC2573] and the view-based access control mechanism described
       in RFC 2575 [RFC2575].

   A more detailed introduction to the current SNMP Management Framework
   can be found in RFC 2570 [RFC2570].

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  Objects in the MIB are
   defined using the mechanisms defined in the SMI.

   This memo specifies a MIB module that is compliant to the SMIv2.  A
   MIB conforming to the SMIv1 can be produced through the appropriate
   translations.  The resulting translated MIB must be semantically
   equivalent, except where objects or events are omitted because no
   translation is possible (use of Counter64).  Some machine readable
   information in SMIv2 will be converted into textual descriptions in
   SMIv1 during the translation process.  However, this loss of machine
   readable information is not considered to change the semantics of the
   MIB.

3. Overview

   The emergence of IP telephony as an application that allows for voice
   applications to be run over the same infrastructure as data
   applications led to the emergence of Ethernet IP phones, with similar
   functions and characteristics as the traditional phones. Powering a
   phone is one of these functions that are being taken as granted. The
   IEEE 802.3 Working Group initiated a standard work on this subject,
   currently known as the IEEE 802.3af work [IEEE-802.3af].

   The IEEE 802.3af WG will not define a full management interface, but
   only the hardware registers that will allow for a management
   interfaces to be built for a powered Ethernet device. The MIB module
   defined in this document extends the Ethernet-like Interfaces MIB
   [RFC2665] with the management objects required for the management of
   the powered Ethernet devices and ports.

   The following abbreviations are defined in [IEEE-802.3af] and will be
   used with the same significance in this document: PSE - Power
   Sourcing Equipment; PD - Powered Device





Ethernet MIB WG           Expires November 2002                 [Page 3]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


4. MIB Structure

   This MIB objects are included in four MIB groups - three of them
   include MIB tables, and the fourth scalar objects

   The pethPsePortTable defines the objects used for the configuration
   and describing the status of ports on a PSE device. Examples of PSE
   devices are Ethernet switches that support power Ethernet and mid-
   span boxes.

   The pethPdPortTable defines the objects used for the configuration
   and describing the status of ports on a PD device. Examples of PD
   devices are Ethernet phones.

   The pethMainPseObjects MIB group defines the management objects for a
   managed main power source in a PSE device. Ethernet switches are one
   example of boxes that would support these objects.

   The pethTrapsControlTable includes objects that control the
   transmission of traps by the agent to a management application.

5. Evolution of the Document, Limitations and Future Work

   The IEEE 802.3af is at this stage work in progress. The scope of this
   document is to do the standards work in the IETF in parallel with the
   IEEE standardization activity, in order to allow  for the publication
   of a standard track document containing an SNMP  MIB simultaneously
   or close to the date of the publication of the IEEE revised standard.
   It is possible that changes may be brought to the IEEE proposal, and
   the Ethernet MIB Working Group will work in order to ensure
   consistency between the two standards proposals.

6. Changes Log

   The following changes were introduced relative to the first proposal
   for a Power Ethernet MIB [PWR-MIB]

   a. pethPsePortTable has to index pethPsePortGroupIndex &
   pethPsePortIndex

   b. pethPsePortIndex INTEGER instead of InterfaceIndex

   c. Name change pethPsePortStatus insted of pethPsePortFaultError

   d. Name change pethPsePortStatusClear instead of
   pethPsePortFaultErrorClear

   e. DESCRIPTION update for pethPsePortPowerDetectionStatus test(3)



Ethernet MIB WG           Expires November 2002                 [Page 4]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   f. DESCRIPTION update pethPsePortDetectionOperStatus off(2)

   g. Adding to pethPsePortStatus one more item both(4)

   h. Adding pethMainPseTable with a pethMainPseGroupIndex

   i. Deletting to objects pethMainPseMaxVoltage & pethMainPseMinVoltage

   j. Change SYNTAX of pethMainPseUsagePower form INTEGER to Gauge32

   k. Change SYNTAX of pethMainPseUsageCurrent form INTEGER to Gauge32

   l. Adding pethMainPseBackupActivated & pethMainPseBackupPresent

   m. Adding Traps  Control  Objects

   n. Adding Notifications Section (5 notifications )

   o. Adding pethTrapsControlGroup to Conformance Section

   p. Adding pethPsePortPowerClassifications to pethPsePortTable Class
   1-5

   q. Adding pethPsePortPowerClassifications to pethPsePortGroup

   r. Change in pethPsePortStatus none(1) to ok(1)

   s. Change in DESCRIPTION of pethMainPseUsagePower from mW to Watt

   t. Change pethMainPseUsagePower to pethMainPseConsumptionPower

   u. Delete of pethMainPseUsageCurrent

   The following changes were introduced between draft-ietf-hubmib-
   power-ethernet-mib-00.txt and draft-ietf-hubmib-power-ethernet-
   mib-01.txt:

   1. change pethMainPowerUsageTrap to pethMainPowerUsageOnTrap

   2. add pethMainPowerUsageOffTrap

   3. change pethMainPowerTrapGroup

   4. change pethPsePorPowerEnable to pethPsePortAdminEnable

   5. pethPsePortPowerIdPairsControl to
   pethPsePortPowerPairsControlAbility




Ethernet MIB WG           Expires November 2002                 [Page 5]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   6. pethPsePortPowerIdPairs to pethPsePortPowerPairs

   7. delete both from pethPsePortPowerPairs object

   8.  change pethPsePortPowerDetectionStatus to
   pethPsePortPowerDetectionControl

   9. delete from pethPsePortPowerDetectionControl off , and change test
   to 2

   10. change pethPsePortDetectionOperStatus to
   pethPsePortDetectionStatus

   11. change pethPsePortDetectionStatus to:
                  disabled(1),
                  searching(2),
                  detected(3),
                  deliveringPower(4),
                  fault(5),
                  invalidPD(6),
                  test(7),
                  denyLowPriority(8)

   12. change description for pethPsePortPowerClassifications

   13. change pethPsePortStatus to pethPsePortCurrentStatus

   14. Update description for pethPsePortCurrentStatus

   15. change pethPsePortStatusClear to pethPsePortCurrentStatusClear

   16. change pethPdPortDetectionOperStatus to pethPdPortDetectionStatus

   17. change in description of pethPdPortPowerPairs

   18. change in pethPdPortDetectionStatus description

   19. delete pethPdPortPowerClassifications object

   20. change in pethPsePortGroup

   21. change in pethPdPortGroup

   22. change pethPsePortOnOffTrap with pethPsePortDetectionStatus
   object

   23. change pethPsePortStatusTrap to pethPsePortCurrentStatusTrap




Ethernet MIB WG           Expires November 2002                 [Page 6]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   24. change pethPsePortTrapGroup

   The following changes were introduced between draft-ietf-hubmib-
   power-ethernet-mib-01.txt and draft-ietf-hubmib-power-ethernet-
   mib-02.txt:

   1. change pethMainPsePower SYNTAX Integer32 (0..65535) to (1..65535)

   2. change pethTrapsControlGroupIndex SYNTAX Integer32 (0..65535) to
   (1..65535)

   3. change int pethMainPseBackUpActivatedTrap pethPsePortGroupIndex to
   pethMainPseGroupIndex

   4. change int pethMainPowerUsageOnTrap pethPsePortGroupIndex to
   pethMainPseGroupIndex

   5. change int pethMainPowerUsageOffTrap pethPsePortGroupIndex to
   pethMainPseGroupIndex

   6. change pethMainPseGroupIndex MAX-ACCESS to  read-only

   updates from IEEE Draft P802.3af/D3.1, June 5, 2002

   7. remove from pethPsePortPowerClassifications class5

   8. remove from pethPsePortCurrentStatus both(4) and description

   9. add pethPsePortUnderCurrentCounter object

   10. add pethPsePortOverCurrentCounter object

   11. remove pethPsePortCurrentStatusClear object

   12. change pethPsePortType OID to end with 13

   13. change pethPsePortPowerClassifications OID to end with 14

   14. update pethPsePortGroup OBJECT-GROUP

   15. chage reference to new IEEE Draft

   16. change pethPdCompliance description.


7. Definitions





Ethernet MIB WG           Expires November 2002                 [Page 7]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   POWER-ETHERNET-MIB DEFINITIONS ::= BEGIN

      IMPORTS
           MODULE-IDENTITY, OBJECT-TYPE, Integer32 , Gauge32,Counter32 ,NOTIFICATION-TYPE
                   FROM SNMPv2-SMI
           dot3
                   FROM EtherLike-MIB
           TruthValue
                   FROM SNMPv2-TC
           MODULE-COMPLIANCE, OBJECT-GROUP ,NOTIFICATION-GROUP
                   FROM SNMPv2-CONF;

      powerEthernetMIB MODULE-IDENTITY
           LAST-UPDATED "200206260000Z"  -- June 26, 2002
           ORGANIZATION "IETF Ethernet Interfaces and Hub MIB
                         Working Group"
           CONTACT-INFO
           "

                       Chair: Dan Romascanu
                                  Avaya Inc.
                                  Tel:  +972-3-645-8414
                                  Email: dromasca@avaya.com


                      Editor: Avi Berger
                                 PowerDsine Inc.
                                    Tel:    972-9-7755100 Ext 307
                                    Fax:    972-9-7755120
                                    E-mail: avib@PowerDsine.com
           "

          DESCRIPTION
                   "The MIB module for for managing Powered Devices (PD) or
                   Power Source Equipment (PSE) working according to the IEEE
                   802.af Powere Ethernet (DTE Power via MDI) standard.

                  The following terms are used throughout this
                  MIB module.  For complete formal definitions,
                  the IEEE 802.3 standards should be consulted
                  wherever possible:


                  Group - A recommended, but optional, entity
                  defined by the IEEE 802.3 management standard,
                  in order to support a modular numbering scheme.
                  The classical example allows an implementor to
                  represent field-replaceable units as groups of



Ethernet MIB WG           Expires November 2002                 [Page 8]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


                  ports, with the port numbering matching the
                  modular hardware implementation.


                 Port - This entity identifies the port within the group
                 for which this entry contains information.The numbering
                 scheme for ports is implementation specific.
              "
           ::= { dot3 20 }

   pethObjects       OBJECT IDENTIFIER ::= { powerEthernetMIB 1 }
   pethNotifications OBJECT IDENTIFIER ::= { powerEthernetMIB 2 }
   pethConformance   OBJECT IDENTIFIER ::= { powerEthernetMIB 3 }

   -- PSE Objects

     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 power Ethernet ports on a Power Source
               Entity (PSE) device. This group will be implemented in
               managed power Ethernet switches and mid-span devices."
          ::= { 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 Ethernet PSE port."
          INDEX    { pethPsePortGroupIndex , pethPsePortIndex  }
          ::= { pethPsePortTable 1 }


      PethPsePortEntry ::= SEQUENCE {
          pethPsePortGroupIndex
             INTEGER,
          pethPsePortIndex
             INTEGER,
          pethPsePortAdminEnable
              INTEGER,
          pethPsePortPowerPairsControlAbility
              TruthValue,
          pethPsePortPowerPairs



Ethernet MIB WG           Expires November 2002                 [Page 9]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


              INTEGER,
          pethPsePortPowerDetectionControl
              INTEGER,
          pethPsePortDetectionStatus
              INTEGER,
          pethPsePortPowerPriority
              INTEGER,
          pethPsePortCurrentStatus
              INTEGER,
          pethPsePortUnderCurrentCounter
                Counter32,
          pethPsePortOverCurrentCounter
                Counter32,
          pethPsePortType
              INTEGER,
          pethPsePortPowerClassifications
                INTEGER
      }

        pethPsePortGroupIndex OBJECT-TYPE
          SYNTAX      INTEGER (1..2147483647)
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              "This variable uniquely identifies the group
               containing the port to which power Ethernet PSE is connected.
               Group means (box in the stack, module in a rack) and the value 1
               MUST be  used for non-modular devices."
          ::= { pethPsePortEntry 1 }

        pethPsePortIndex OBJECT-TYPE
          SYNTAX      INTEGER(1..2147483647)
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              "This variable uniquely identifies the power Ethernet PSE
               port within group pethPseGroupIndex to which the
               power Ethernet PSE entry is connected."
          ::= { pethPsePortEntry 2 }


        pethPsePortAdminEnable OBJECT-TYPE
       SYNTAX INTEGER   {
                  enable(1),
                  disable(2)
        }
       MAX-ACCESS read-write
       STATUS current



Ethernet MIB WG           Expires November 2002                [Page 10]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       DESCRIPTION
           "Enables power supply on this port.
            Setting this object at a value enable(1) enables power
            and detection mechanism for this port.
            Setting this object at a value disable(2) disables power
            for this port."
       ::= { 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 indicate that the  device has the capability
            to control the power pairs"
       ::= { pethPsePortEntry 4 }

        pethPsePortPowerPairs OBJECT-TYPE
       SYNTAX INTEGER   {
                  signal(1),
                  spare(2)
        }
       MAX-ACCESS read-write
       STATUS current
       DESCRIPTION
           "Describes or controls the pairs in use. If the value of
            pethPsePortPowerPairsControl is true, this object is
            writable.
            A value of signal(1) menas that the signal pairs
            only are in use.
            A value of spare(2) means that the spare pairs
            only are in use."
       ::= { pethPsePortEntry 5 }

        pethPsePortPowerDetectionControl OBJECT-TYPE
       SYNTAX INTEGER   {
                  auto(1),
                  test(2)
        }
       MAX-ACCESS read-write
       STATUS current
       DESCRIPTION
           "Controls the power detection mechanism of the port.
            Setting the value auto(1) enables the power detection
            mechanism of the port.
           Setting the value test(2) puts the port in a



Ethernet MIB WG           Expires November 2002                [Page 11]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


            testmode: force continuous discovery without applying
            power regardless of whether PD detected."
       ::= { pethPsePortEntry 6 }


        pethPsePortDetectionStatus OBJECT-TYPE
       SYNTAX INTEGER   {
                disabled(1),
                searching(2),
                detected(3),
                  deliveringPower(4),
                  fault(5),
                  invalidPD(6),
                  test(7),
                  denyLowPriority(8)
        }
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Describes the operational status of the port PD detection.
            A value of disabled(1) indicates that the PD Detection function
            has been disabled.
            A value of searching(2) indicates that the PD Detection function
            is enabled and is searching for a valid PD.
            A value of detected(3)indicates that the PD Detection function
            has detected a valid PD but the PSE is not supplying power.
            A value of deliveringPower(4) indicates that the port
            executed the detection algorithm, found a PD connection
            and is currently delivering power.
            A value of fault(5) indicates that a fault was detected
            on the port , faults detected are vendor-specific.
            A value of invalidPD(6)indicates that the PD Detection function
            has detected an invalid PD.
            A value of test(7)indicates that the PD Detection function has
            been placed in test mode.
            A value of denyLowPriority(8) indicates that the port was
            disabled by the power management system, in order to keep
            active higher priority ports.
             "
       ::= { pethPsePortEntry 7 }

        pethPsePortPowerPriority OBJECT-TYPE
       SYNTAX INTEGER   {
                  critical(1),
                  high(2),
                  low(3)
        }
       MAX-ACCESS read-write



Ethernet MIB WG           Expires November 2002                [Page 12]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       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 over current 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."
       ::= { pethPsePortEntry 8 }

        pethPsePortCurrentStatus OBJECT-TYPE
       SYNTAX INTEGER   {
                  ok(1),
                  underCurrent(2),
                  overCurrent(3)
        }
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Describes a current port status related to the power generation
           The value ok(1) indicates neither an undercurrent or an
            overcurrent condition has been
            detected since the attribute was last cleared.
            The value underCurrent(2) indicates that the port current
            is below the minimal value since the attribute was last cleared.
            The value overCurrent(3) indicates that the port current
            exceeds the maximal value since the attribute was last cleared. "


       REFERENCE   "[IEEE Draft P802.3af/D3.1, June 5, 2002 object 30.9.1.1.8 aPSEPowerCurrentStatus]"
       ::= { pethPsePortEntry 10 }

        pethPsePortUnderCurrentCounter OBJECT-TYPE
       SYNTAX Counter32
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Counts the number of times that the pethPsePortCurrentStatus
            attribute changes from any
           enumeration to the enumeration underCurrent ."

       REFERENCE   "[IEEE Draft P802.3af/D3.1, June 5, 2002 object 30.9.1.1.9 aPSEUnderCurrentCounter]"
       ::= { pethPsePortEntry 11 }

        pethPsePortOverCurrentCounter OBJECT-TYPE
       SYNTAX Counter32
       MAX-ACCESS read-only



Ethernet MIB WG           Expires November 2002                [Page 13]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       STATUS current
       DESCRIPTION
          "Counts the number of times that the aPSEPowerCurrentStatus
           attribute changes from any
           enumeration to the enumeration overCurrent ."
       REFERENCE   "[IEEE Draft P802.3af/D3.1, June 5, 2002 object 30.9.1.1.10 aPSEOverCurrentCounter]"
       ::= { pethPsePortEntry 12 }


        pethPsePortType OBJECT-TYPE
       SYNTAX INTEGER   {
                  other(1),
                  telephone(2),
                  webcam(3),
                  wireless(4)
        }
       MAX-ACCESS read-write
       STATUS current
       DESCRIPTION
           "A manager will set the value of this variable to a value
            that indicates the type of the device that is connected
            to theport. This value can be the result of the mapping
            the address of the station connected to the port and of
            the value of the pethPdPortType of the respective PD port."
       ::= { pethPsePortEntry 13 }

       pethPsePortPowerClassifications OBJECT-TYPE
        SYNTAX INTEGER   {
                  class0(1),
                  class1(2),
                  class2(3),
                  class3(4),
                  class4(5)
        }
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Classification is a way to tag different terminals on the
           Power over LAN network according to their power consumption.
           Devices such as IP telephones, WLAN access points and others,
           will be classified according to their power requirements.

             The value is only valid while a valid PD is being detected
               as indicated by the attribute
             pethPsePortDetectionStatus reporting the enumeration
               (detected) or (deliveringPower).
              "
       REFERENCE   "[IEEE Draft P802.3af/D3.1, June 5, 2002 object 30.9.1.1.7 aPSEPowerClassification]"



Ethernet MIB WG           Expires November 2002                [Page 14]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


      ::= { pethPsePortEntry 14 }


   -- PD Port table

   pethPdPortTable OBJECT-TYPE
          SYNTAX      SEQUENCE OF PethPdPortEntry
          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
              "A table of objects that display and control the power
               characteristics power Ethernet ports on a Powered
               Device(PD) device. This group will be implemented in
               managed powered and mid-span devices."
          ::= { pethObjects 2 }

      pethPdPortEntry OBJECT-TYPE
          SYNTAX      PethPdPortEntry
          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
                  "A set of objects that display and control the power
               characteristics of a Powered Device port."
          INDEX    { pethPdPortIndex }
          ::= { pethPdPortTable 1 }

      PethPdPortEntry ::= SEQUENCE {
          pethPdPortIndex
              INTEGER,
          pethPdPortPowerPairs
              INTEGER,
          pethPdPortDetectionStatus
              INTEGER,
          pethPdPortType
              INTEGER
      }

        pethPdPortIndex OBJECT-TYPE
          SYNTAX      INTEGER (0..65535)
          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
                  "An index value that uniquely identifies an
               interface to a PD device.  The
               interface identified by a particular value of
               this index is the same interface as identified
               by the same value of ifIndex. The mapping
               between the ifIndex values and the numbering of



Ethernet MIB WG           Expires November 2002                [Page 15]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


               the port on the device is an implementation
               issue."
          ::= { pethPdPortEntry 1 }

        pethPdPortPowerPairs OBJECT-TYPE
       SYNTAX INTEGER   {
                  signal(1),
                  spare(2),
                  both(3)
        }
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Describes the pairs in use by the PD to derive power.
            A value of signal(1) indicates that only PD Pinout Mode A is
            supported by the PD.
            A value of spare(2) indicates that only PD Pinout Mode B is
            supported by the PD.
            A value of both(3) means indicates that both PD Pinout Mode A
            and PD Pinout Mode B are supported by the PD."
       ::= { pethPdPortEntry 2 }

        pethPdPortDetectionStatus OBJECT-TYPE
       SYNTAX INTEGER   {
                  off(1),
                  receivingPower(2)
        }
       MAX-ACCESS read-only
       STATUS current
       DESCRIPTION
           "Describes the operational status of the port detection.
            The value off(1) indicates that the PD is drawing a current less
            than I Port as specified in [IEEE-802.3af]
            The value receivingPower(2) indicates that the PD is drawing a
            current greater I Port as specified in [IEEE-802.3af]
             "
       REFERENCE   "[IEEE Draft P802.3af/D3.1, June 5, 2002 object 30.9.2.1.2 aPDPowerStatus]"
       ::= { pethPdPortEntry 3 }

        pethPdPortType OBJECT-TYPE
       SYNTAX INTEGER   {
                  other(1),
                  telephone(2),
                  webcam(3),
                  wireless(4)
        }
       MAX-ACCESS read-only
       STATUS current



Ethernet MIB WG           Expires November 2002                [Page 16]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       DESCRIPTION
           "The type of the device. A management application may read
             the value of this variable and use it for setting the
             corresponding value of pethPsePortType of the port that
             connects the device."
       ::= { pethPdPortEntry 4 }


   -- Main PSE Objects

   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 the Main power
             on a PSE  device. Example internet switch midspan
               device can control an
             Ethernet port and the Main Power supply unit's."
          ::= { 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
              INTEGER,
          pethMainPsePower
              Integer32,
          pethMainPseOperStatus
              INTEGER,
          pethMainPseConsumptionPower
              Gauge32,
          pethMainPseBackupPresent
                INTEGER,
           pethMainPseBackupActivated
                TruthValue,
          pethMainPseUsageThreshold
              INTEGER,



Ethernet MIB WG           Expires November 2002                [Page 17]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


          pethMainPseMaximumDcPower
                INTEGER
      }
        pethMainPseGroupIndex OBJECT-TYPE
          SYNTAX      INTEGER (0..65535)
          MAX-ACCESS  read-only
          STATUS      current
          DESCRIPTION
              "This variable uniquely identifies the group to which
              power Ethernet PSE is connected.Group means (box in the stack,
              module in a rack) and  the value 1 MUST be  used for
              non-modular devices "
          ::= { pethMainPseEntry 1 }

        pethMainPsePower OBJECT-TYPE
          SYNTAX      Integer32 (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 }


        pethMainPseBackupPresent  OBJECT-TYPE
          SYNTAX  INTEGER    {



Ethernet MIB WG           Expires November 2002                [Page 18]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


                                 present(1),
                                 notPresent(2),
                                 faulty(3)
          }
          MAX-ACCESS         read-only
          STATUS             current
          DESCRIPTION
                       "reflects the presence of a backup PSE ."
          ::= { pethMainPseEntry 5 }

        pethMainPseBackupActivated  OBJECT-TYPE
                  SYNTAX         TruthValue
                  MAX-ACCESS      read-only
                  STATUS          current
                  DESCRIPTION
                       "Reflects the activation status of the backup PSE .
                       The value true Backup is activated."
                  ::= { pethMainPseEntry 6 }

        pethMainPseUsageThreshold OBJECT-TYPE
          SYNTAX      INTEGER (1..99)
          UNITS      "%"
          MAX-ACCESS  read-write
          STATUS      current
          DESCRIPTION
                  "The usage threshold expressed in percens for
                   comparing the measured power and initiating
                   an alarm if the threshold is exceeded."
          ::= { pethMainPseEntry 7 }

      pethMainPseMaximumDcPower  OBJECT-TYPE
         SYNTAX             INTEGER
         UNITS               "Watts"
         MAX-ACCESS         read-write
         STATUS             current
         DESCRIPTION
                       "describes the maximum available power  in
                       Watt to be supplied by the DC backup source to this
                       device."
         ::= { pethMainPseEntry 8 }


   -- Traps  Control  Objects

   pethTrapsControl        OBJECT IDENTIFIER ::= { pethObjects 4 }

   pethTrapsControlTable OBJECT-TYPE
          SYNTAX      SEQUENCE OF PethTrapsControlEntry



Ethernet MIB WG           Expires November 2002                [Page 19]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
              "A table of objects that display and control the Traps
                  on a PSE  device."
          ::= { pethTrapsControl 1 }

      pethTrapsControlEntry OBJECT-TYPE
          SYNTAX      PethTrapsControlEntry
          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
               "A set of objects that control the Trap events."
          INDEX    { pethTrapsControlGroupIndex }
          ::= { pethTrapsControlTable 1 }

      PethTrapsControlEntry ::= SEQUENCE {
          pethTrapsControlGroupIndex
              INTEGER,
          pethTrapsControlEnable
                INTEGER
      }
        pethTrapsControlGroupIndex OBJECT-TYPE
          SYNTAX      INTEGER (1..65535)
          MAX-ACCESS  not-accessible
          STATUS      current
          DESCRIPTION
              "This variable uniquely identifies the group.Group means
              (box in the stack, module in a rack) and recommend
              that the value 1 MUST be used for non-modular devices "
          ::= { pethTrapsControlEntry 1 }


         pethTrapsControlEnable  OBJECT-TYPE
             SYNTAX             INTEGER
                  {
                       enable(1),
                       disable(2)
                  }
             MAX-ACCESS         read-write
             STATUS             current
             DESCRIPTION
                  "Enable Traps from Agent"
          ::= { pethTrapsControlEntry 2 }


   --
   -- Notifications Section



Ethernet MIB WG           Expires November 2002                [Page 20]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   --
   --

        pethPsePortOnOffTrap NOTIFICATION-TYPE
            OBJECTS     { pethPsePortGroupIndex,pethPsePortIndex,pethPsePortDetectionStatus }
            STATUS      current
            DESCRIPTION " This trap indicate if Pse Port is delivering
                          or not power to the PD."
             ::= { pethNotifications 1 }



        pethPsePortCurrentStatusTrap NOTIFICATION-TYPE
            OBJECTS     { pethPsePortGroupIndex,pethPsePortIndex,pethPsePortCurrentStatus }
            STATUS      current
            DESCRIPTION
                  " This trap indicate Port Change Status and
                       it will be sent on every status change."
            ::= { pethNotifications 2 }

        pethMainPseBackUpActivatedTrap NOTIFICATION-TYPE
            OBJECTS     { pethMainPseGroupIndex,pethMainPseBackupActivated }
            STATUS      current
            DESCRIPTION
                  " This trap indicate BackUp is Activated or
                       BackUp is released."
            ::= { pethNotifications 3 }

        pethMainPowerUsageOnTrap NOTIFICATION-TYPE
            OBJECTS     { pethMainPseGroupIndex }
            STATUS      current
            DESCRIPTION
                  " This trap indicate PSE Threshold  usage indication is on,
                       the usage power is above the threshold."
            ::= { pethNotifications 4 }

         pethMainPowerUsageOffTrap NOTIFICATION-TYPE
            OBJECTS     { pethMainPseGroupIndex }
            STATUS      current
            DESCRIPTION
                  " This trap indicate PSE Threshold usage indication off,
                       the usage power is below the threshold.."
            ::= { pethNotifications 5 }


     pethPsePortTrapGroup NOTIFICATION-GROUP
             NOTIFICATIONS { pethPsePortOnOffTrap, pethPsePortCurrentStatusTrap}
             STATUS          current



Ethernet MIB WG           Expires November 2002                [Page 21]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


             DESCRIPTION  "Pse trap indications"
           ::= { pethNotifications 6 }

       pethMainPowerTrapGroup NOTIFICATION-GROUP
             NOTIFICATIONS { pethMainPseBackUpActivatedTrap, pethMainPowerUsageOnTrap,pethMainPowerUsageOffTrap}
             STATUS          current
             DESCRIPTION  "Pse trap indications"
           ::= { pethNotifications 7 }


   --
   -- Conformance Section
   --
   pethCompliances OBJECT IDENTIFIER ::= { pethConformance 1 }
   pethGroups      OBJECT IDENTIFIER ::= { pethConformance 2 }

   pethCompliance MODULE-COMPLIANCE
       STATUS  current
       DESCRIPTION
               "Describes the requirements for conformance to the
               Power Ethernet MIB."
       MODULE  -- this module
           GROUP   pethPsePortGroup
           DESCRIPTION
               "The pethPsePortGroup is mandatory for systems which
               implement PSE ports."
          GROUP   pethPdPortGroup
           DESCRIPTION
               "The pethPdPortGroup is mandatory for systems which
               implement PD Ports."
           GROUP   pethMainPseGroup
           DESCRIPTION
               "The pethMainPseGroup is mandatory for systems which
               implement main power supply within a PSE Device."
           GROUP   pethTrapsControlGroup
           DESCRIPTION
               "The pethTrapsControlGroup is mandatory for systems which
               implement PSE ports."
       ::= { pethCompliances 1 }

   pethPseCompliance MODULE-COMPLIANCE
       STATUS  current
       DESCRIPTION
               "Describes the requirements for conformance to the PSE
                and MID-Span."
       MODULE  -- this module
       MANDATORY-GROUPS {pethPsePortGroup, pethMainPseGroup,pethTrapsControlGroup}
        ::= { pethCompliances 2 }



Ethernet MIB WG           Expires November 2002                [Page 22]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   pethPdCompliance MODULE-COMPLIANCE
       STATUS  current
       DESCRIPTION
               "Describes the requirements for conformance to the PD."
       MODULE  -- this module
       MANDATORY-GROUPS {pethPdPortGroup}
        ::= { pethCompliances 3}

   pethPsePortGroup OBJECT-GROUP
       OBJECTS {
          pethPsePortGroupIndex,
          pethPsePortIndex,
          pethPsePortAdminEnable,
          pethPsePortPowerPairsControlAbility,
          pethPsePortPowerPairs,
          pethPsePortDetectionStatus,
          pethPsePortPowerPriority,
          pethPsePortCurrentStatus,
          pethPsePortUnderCurrentCounter,
          pethPsePortOverCurrentCounter,
          pethPsePortType,
          pethPsePortPowerClassifications
       }
       STATUS  current
       DESCRIPTION
               "PSE Port Objects."
       ::= { pethGroups 1 }

   pethPdPortGroup OBJECT-GROUP
       OBJECTS {
          pethPdPortPowerPairs,
          pethPdPortDetectionStatus,
          pethPdPortType
       }
       STATUS  current
       DESCRIPTION
               "PD Port Objects."
       ::= { pethGroups 2 }

   pethMainPseGroup OBJECT-GROUP
       OBJECTS {
          pethMainPsePower,
          pethMainPseOperStatus,
          pethMainPseConsumptionPower,
          pethMainPseBackupPresent,
          pethMainPseBackupActivated,
          pethMainPseUsageThreshold,
          pethMainPseMaximumDcPower



Ethernet MIB WG           Expires November 2002                [Page 23]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


       }
       STATUS  current
       DESCRIPTION
               "Main PSE Objects. "
       ::= { pethGroups 3 }

   pethTrapsControlGroup OBJECT-GROUP
       OBJECTS {
          pethTrapsControlEnable
       }
       STATUS  current
       DESCRIPTION
               "Trap Control  Objects. "
       ::= { pethGroups 4 }


   END



8. References

    [RFC2571]   Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture
               for Describing SNMP Management Frameworks", RFC 2571, April
               1999.

   [RFC1155]   Rose, M., and K. McCloghrie, "Structure and Identification
               of Management Information for TCP/IP-based Internets", STD
               16, RFC 1155, May 1990.

   [RFC1212]   Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD
               16, RFC 1212, March 1991.

   [RFC1215]   M. Rose, "A Convention for Defining Traps for use with the
               SNMP", RFC 1215, March 1991.

   [RFC2578]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
               Rose, M., and S. Waldbusser, "Structure of Management
               Information Version 2 (SMIv2)", STD 58, RFC 2578, April
               1999.

   [RFC2579]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
               Rose, M., and S. Waldbusser, "Textual Conventions for
               SMIv2", STD 58, RFC 2579, April 1999.

   [RFC2580]   McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
               Rose, M., and S. Waldbusser, "Conformance Statements for
               SMIv2", STD 58, RFC 2580, April 1999.



Ethernet MIB WG           Expires November 2002                [Page 24]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   [RFC1157]   Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
               Network Management Protocol", STD 15, RFC 1157, May 1990.

   [RFC1901]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
               "Introduction to Community-based SNMPv2", RFC 1901, January
               1996.

   [RFC1906]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
               "Transport Mappings for Version 2 of the Simple Network
               Management Protocol (SNMPv2)", RFC 1906, January 1996.

   [RFC2572]   Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message
               Processing and Dispatching for the Simple Network Management
               Protocol (SNMP)", RFC 2572, April 1999.

   [RFC2574]   Blumenthal, U., and B. Wijnen, "User-based Security Model
               (USM) for version 3 of the Simple Network Management
               Protocol (SNMPv3)", RFC 2574, April 1999.

   [RFC1905]   Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
               "Protocol Operations for Version 2 of the Simple Network
               Management Protocol (SNMPv2)", RFC 1905, January 1996.

   [RFC2573]   Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications",
               RFC 2573, April 1999.

   [RFC2575]   Wijnen, B., Presuhn, R., and K. McCloghrie, "View-based
               Access Control Model (VACM) for the Simple Network
               Management Protocol (SNMP)", RFC 2575, April 1999.

   [RFC2570]   Case, J., Mundy, R., Partain, D., and B. Stewart,
               "Introduction to Version 3 of the Internet-standard Network
               Management Framework", RFC 2570, April 1999.

   [RFC2119]   Bradner, S., "Key words for use in RFCs to Indicate
               Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC2665]   Flick, J., and J. Johnson,  "Definitions of Managed Objects
               for the Ethernet-like Interface Types", RFC 2665, August 1999.

   [IEEE-802.3af]   IEEE 802.3af Working Group,  "Data Terminal Equipment (DTE)
               Power via Media Dependent Interface (MDI)", Draft D3.1,
               November 2001.

   [PWR-MIB]   Romascanu, D., " Power Ethernet (DTE Power via MDI) MIB",
               Internet-Draft, draft-romascanu-hubmib-power-ethernet-mib-00.txt,
               June 2002.




Ethernet MIB WG           Expires November 2002                [Page 25]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


9.Intellectual Property

   The IETF takes no position regarding the validity or scope of any
   intellectual property or other rights that might be claimed to
   pertain to the implementation or use of the technology described in
   this document or the extent to which any license under such rights
   might or might not be available; neither does it represent that it
   has made any effort to identify any such rights.  Information on the
   IETF's procedures with respect to rights in standards-track and
   standards-related documentation can be found in BCP-11.  Copies of
   claims of rights made available for publication and any assurances of
   licenses to be made available, or the result of an attempt made to
   obtain a general license or permission for the use of such
   proprietary rights by implementors or users of this specification can
   be obtained from the IETF Secretariat.

   The IETF invites any interested party to bring to its attention any
   copyrights, patents or patent applications, or other proprietary
   rights which may cover technology that may be required to practice
   this standard.  Please address the information to the IETF Executive
   Director.


10.  Security Considerations

   There are a number of management objects defined in this MIB
   that have a MAX-ACCESS clause of read-write and/or read-create.
   Such objects may be considered sensitive or vulnerable in some
   network environments.  The support for SET operations in a
   non-secure environment without proper protection can have a
   negative effect on network operations.

   There are a number of managed objects in this MIB that may
   contain sensitive information. These are:


   It is thus important to control even GET access to these objects
   and possibly to even encrypt the values of these object when
   sending them over the network via SNMP.  Not all versions of
   SNMP provide features for such a secure environment.

   SNMPv1 by itself is not a secure environment.  Even if the
   network itself is secure (for example by using IPSec), even then,
   there is no control as to who on the secure network is allowed
   to access and GET/SET (read/change/create/delete) the objects in
   this MIB.

   It is RECOMMENDED that the implementers consider the security



Ethernet MIB WG           Expires November 2002                [Page 26]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   features as provided by the SNMPv3 framework.  Specifically, the
   use of the User-based Security Model [RFC2274] and the
   View-based Access Control Model [RFC2275] is RECOMMENDED.

   It is then a customer/user responsibility to ensure that the SNMP
   entity giving access to an instance of this MIB, is properly
   configured to give access to the objects only to those
   principals (users) that have legitimate rights to indeed GET or
   SET (change/create/delete) them.

11.  Authors Addresses

        Avi Berger
        PowerDsine Inc.
        1, Hanagar St., P.O. Box 7220
        Hod Hasharon 45421,
        Israel
        Tel:    +972-9-7755100 Ext 307
        Fax:    +972-9-7755120
        E-mail: avib@PowerDsine.com


        Dan Romascanu
        Avaya Inc.
        Atidim Technology Park, Bldg. #3
        Tel Aviv, 61131
        Israel
        Tel: +972-3-645-8414
        Email: dromasca@avaya.com


   A.  Full Copyright Statement

   This document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph are
   included on all such copies and derivative works.  However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organizations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into languages other than
   English.

   The limited permissions granted above are perpetual and will not be



Ethernet MIB WG           Expires November 2002                [Page 27]


INTERNET DRAFT             Power Ethernet MIB                  June 2002


   revoked by the Internet Society or its successors or assigns.

   This document and the information contained herein is provided on an
   "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
   TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
   BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
   HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
   MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.











































Ethernet MIB WG           Expires November 2002                [Page 28]


Html markup produced by rfcmarkup 1.129b, available from https://tools.ietf.org/tools/rfcmarkup/