NAME

       SNMP::Info::PowerEthernet - SNMP Interface to data stored in POWER-ETHERNET-MIB.

AUTHOR

       Bill Fenner

SYNOPSIS

        # Let SNMP::Info determine the correct subclass for you.
        my $poe = new SNMP::Info(
                                 AutoSpecify => 1,
                                 Debug       => 1,
                                 DestHost    => 'myswitch',
                                 Community   => 'public',
                                 Version     => 2
                               )
           or die "Can't connect to DestHost.\n";

        my $class      = $poe->class();
        print "SNMP::Info determined this device to fall under subclass : $class\n";

DESCRIPTION

       POWER-ETHERNET-MIB is used to describe PoE (IEEE 802.3af)

       Create or use a device subclass that inherit this class.  Do not use directly.

       For debugging purposes you can call this class directly as you would SNMP::Info

        my $poe = new SNMP::Info::PowerEthernet (...);

   Inherited Classes
       none.

   Required MIBs
       POWER-ETHERNET-MIB

GLOBALS

       none.

TABLE METHODS

       These are methods that return tables of information in the form of a reference to a hash.

   Power Port Table
       Selected values from the "pethPsePortTable"

       $poe->peth_port_admin()
           Administrative status: is this port permitted to deliver power?

           "pethPsePortAdminEnable"

       $poe->peth_port_status()
           Current status: is this port delivering power, searching, disabled, etc?

           "pethPsePortDetectionStatus"

       $poe->peth_port_class()
           Device class: if status is delivering power, this represents the 802.3af class of the
           device being powered.

           "pethPsePortPowerClassifications"

       $poe->peth_port_ifindex()
           A mapping function from the "pethPsePortTable" INDEX of module.port to an "ifIndex".
           The default mapping ignores the module (returning undef if there are any module values
           greater than 1) and returns the port number, assuming that there is a 1:1 mapping.

           This mapping is more or less left up to the device vendor to implement; the MIB gives
           only very weak guidance.  A given device class may implement its own version of this
           function (e.g., see Info::CiscoPower).

       $poe->peth_port_neg_power()
           The power, in milliwatts, that has been committed to this port.  This value is derived
           from the 802.3af class of the device being powered, but may be overridden by a
           subclass that has information from another source (e.g., if a different protocol, such
           as CDP, was used to negotiate the power level.)

   Power Supply Table
       $poe->peth_power_watts()
           The power supply's capacity, in watts.

           "pethMainPsePower"

       $poe->peth_power_status()
           The power supply's operational status.

           "pethMainPseOperStatus"

       $poe->peth_power_consumption()
           How much power, in watts, this power supply has been committed to deliver.  (Note:
           certain devices seem to supply this value in milliwatts, so be cautious interpreting
           it.)

           "pethMainPseConsumptionPower"

       $poe->peth_power_threshold()
           The threshold (in percent) of consumption required to raise an alarm.

           "pethMainPseUsageThreshold"