NAME

       SNMP::Info::Layer3::Scalance - SNMP Interface to Siemens Scalance Switches

AUTHOR

       Christoph Handel

SYNOPSIS

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

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

DESCRIPTION

       Provides abstraction to the configuration information obtainable from a Siemens Scalance
       Switch via SNMP.

       Tested only with scalance xr524

   Inherited Classes
       SNMP::Info::Layer3
       SNMP::Info::MAU

   Required MIBs
       AUTOMATION-SMI
       AUTOMATION-SYSTEM-MIB
       AUTOMATION-TC
       SIEMENS-SMI
       SN-MSPS-SCX-MIB

       <https://support.industry.siemens.com/cs/document/22015045/private-mibs%3A-scalance-x-scalance-w-and-snmp-opc-profile?dti=0&lc=en-DE>

       <https://support.industry.siemens.com/cs/document/67637278/automationmib-now-available-for-download-in-version-v02-00-00-02-?dti=0&lc=en-TN>

Change Log

GLOBALS

       These are methods that return scalar value from SNMP

       $scalance->layers()
           Overwrite snmp value, we support 1-3

       $scalance->os()
           Returns scalance

       $scalance->vendor()
           Returns siemens

       $scalance->model()
           extract a meaningful name from description

       $scalance->mac()
           use the dot1dBaseBridgeAddress

       $scalance->os_ver()
           clean up os_version string

       $scalance->i_description()
           siemens returns a description including firmware, switch serial, etc clean it up. Try
           to use anything past VLAN or Port. And if this fails past the last comma

       $scalance->lldp_ip()
           simatic does not implement lldpRemManAddrIfSubtype but remote system names are
           available try to resolve them via DNS and use that

   Globals imported from SNMP::Info::Layer3
       See documentation in "GLOBALS" in SNMP::Info::Layer3 for details.

   Globals imported from SNMP::Info::MAU
       See documentation in "GLOBALS" in SNMP::Info::MAU for details.

TABLE METHODS

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

   Overrides
       $scalance->lldp_ip()
           Returns reference to hash of ports to remote ips.

           simatic does not implement lldpRemManAddrIfSubtype but remote system names are
           available try to resolve them via DNS and use that.

   Table Methods imported from SNMP::Info::Layer3
       See documentation in "TABLE METHODS" in SNMP::Info::Layer3 for details.

   Table Methods imported from SNMP::Info::MAU
       See documentation in "TABLE METHODS" in SNMP::Info::MAU for details.