NAME

SNMP::Info::Layer2::LigoWave - SNMP interface to LigoWave DLB radios

AUTHOR

SNMP::Info Developers

SYNOPSIS

use SNMP::Info;

my $info = SNMP::Info->new(
    AutoSpecify => 1,
    DestHost    => 'mydevice',
    Community   => 'public',
    Version     => 2,
);

DESCRIPTION

Identifies LigoDLB radios, and reports model and firmware from sysDescr. Reports the SSID and channel on the radio interface, and logical VLAN interfaces. The tested devices do not serve IP-MIB addresses, BRIDGE-MIB or Q-BRIDGE-MIB.

Inherited Classes

SNMP::Info::IEEE802dot11
SNMP::Info::Layer2

Required MIBs

None. The LIGO-WIRELESS-MIB and LIGO-GENERIC-MIB objects are read by numeric OID until those MIBs are in a netdisco-mibs release.

Inherited MIBs

See "Required MIBs" in SNMP::Info::IEEE802dot11 and "Required MIBs" in SNMP::Info::Layer2 for their MIB requirements.

GLOBALS

These are methods that return scalar values.

$ligo->ligo_unit_id()

Returns a unit identifier from the LIGO-GENERIC-MIB subtree, beyond the published objects. It differs between devices, but the MIB does not call it a serial number, so serial() does not use it.

Overrides

$ligo->vendor()

Returns ligowave.

$ligo->model()

Returns the model name from sysDescr, without the firmware version.

$ligo->os()

Returns ligowave os.

$ligo->os_ver()

Returns the firmware version from sysDescr.

Global Methods imported from SNMP::Info::IEEE802dot11

See "GLOBALS" in SNMP::Info::IEEE802dot11 for details.

Global Methods imported from SNMP::Info::Layer2

See "GLOBALS" in SNMP::Info::Layer2 for details.

TABLE METHODS

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

Overrides

The firmware represents a VLAN as logical interfaces, such as br99, eth0.99 and ath0.99. These methods report those interfaces, not switch-port membership.

$ligo->v_name()

Returns reference to hash. Key: VLAN ID, Value: VLAN and the ID.

$ligo->v_index()

Returns reference to hash. Key: VLAN ID, Value: VLAN ID.

$ligo->i_vlan_membership()

Returns reference to hash. Key: ifIndex of a logical VLAN interface, Value: array reference holding its VLAN ID.

$ligo->i_vlan_membership_untagged()

Returns reference to an empty hash: untagged membership is not reported.

LigoWave Wireless Interface Table (ligoWiIfConfTable)

Keys are the agent's row number, which does not equal the ifIndex.

$ligo->ligo_wifi_mac()

Returns reference to hash. Key: row, Value: radio MAC address.

(ligoWiIfMacAddress)

$ligo->ligo_wifi_protocol()

Returns reference to hash. Key: row, Value: wireless protocol name.

(ligoWiIfProtocol)

$ligo->ligo_wifi_mode()

Returns reference to hash. Key: row, Value: operating mode.

(ligoWiIfMode)

$ligo->ligo_wifi_essid()

Returns reference to hash. Key: row, Value: SSID.

(ligoWiIfESSID)

$ligo->ligo_wifi_country()

Returns reference to hash. Key: row, Value: regulatory country code.

(ligoWiIfCountryCode)

$ligo->ligo_wifi_frequency()

Returns reference to hash. Key: row, Value: frequency in MHz.

(ligoWiIfFrequency)

$ligo->ligo_wifi_channel()

Returns reference to hash. Key: row, Value: channel.

(ligoWiIfChannel)

$ligo->ligo_wifi_width()

Returns reference to hash. Key: row, Value: channel width.

(ligoWiIfChannelBandwidth)

$ligo->ligo_wifi_encryption()

Returns reference to hash. Key: row, Value: encryption mode.

(ligoWiIfEncryption)

$ligo->ligo_wifi_tx_power()

Returns reference to hash. Key: row, Value: transmit power.

(ligoWiIfTxPower)

$ligo->ligo_wifi_bitrate()

Returns reference to hash. Key: row, Value: bit rate.

(ligoWiIfBitRate)

$ligo->ligo_wifi_snr()

Returns reference to hash. Key: row, Value: signal-to-noise ratio.

(ligoWiIfSNR)

$ligo->ligo_wifi_max_snr()

Returns reference to hash. Key: row, Value: maximum signal-to-noise ratio.

(ligoWiIfMaxSNR)

$ligo->ligo_wifi_signal()

Returns reference to hash. Key: row, Value: signal level in dBm.

(ligoWiIfSignalLevel)

$ligo->ligo_wifi_noise()

Returns reference to hash. Key: row, Value: noise level in dBm.

(ligoWiIfNoiseLevel)

$ligo->ligo_wifi_assoc_count()

Returns reference to hash. Key: row, Value: number of associated remote nodes.

(ligoWiIfAssocNodeCount)

$ligo->ligo_wifi_state()

Returns reference to hash. Key: row, Value: interface state. Column 17, beyond the published table.

LigoWave Remote Node Table (ligoWiRemoteNodeStatsTable)

Keys are 0, the address length and the remote node's MAC address, as the agent serves them.

$ligo->ligo_peer_mac()

Returns reference to hash. Key: node, Value: remote node MAC address.

(ligoWiRmtNodeMacAddress)

$ligo->ligo_peer_associated()

Returns reference to hash. Key: node, Value: association status.

(ligoWiRmtNodeAssociated)

$ligo->ligo_peer_tx_bytes()

Returns reference to hash. Key: node, Value: bytes transmitted to the node.

(ligoWiRmtNodeTxBytes)

$ligo->ligo_peer_rx_bytes()

Returns reference to hash. Key: node, Value: bytes received from the node.

(ligoWiRmtNodeRxBytes)

$ligo->ligo_peer_signal()

Returns reference to hash. Key: node, Value: signal level in dBm.

(ligoWiRmtNodeSignalLevel)

$ligo->ligo_peer_noise()

Returns reference to hash. Key: node, Value: noise level in dBm.

(ligoWiRmtNodeNoiseLevel)

$ligo->ligo_peer_ip()

Returns reference to hash. Key: node, Value: remote node management address. Column 7, beyond the published table.

$ligo->ligo_peer_remote_port()

Returns reference to hash. Key: node, Value: remote port value. Column 8, beyond the published table.

$ligo->ligo_peer_name()

Returns reference to hash. Key: node, Value: remote node name. Column 9, beyond the published table.

$ligo->ligo_peer_rx_rate()

Returns reference to hash. Key: node, Value: receive rate. Column 10, beyond the published table.

$ligo->ligo_peer_tx_rate()

Returns reference to hash. Key: node, Value: transmit rate. Column 11, beyond the published table.

802.11 Interface Table Emulation

These methods emulate the IEEE802dot11-MIB SSID and channel methods using the LIGO-WIRELESS-MIB ligoWiIfConfTable. Each row is matched to the athN interface whose ifPhysAddress equals the row's MAC address. A row that matches no interface, or several, is left out.

$ligo->i_ssidlist()

Returns reference to hash. Key: ifIndex, Value: SSID.

(ligoWiIfESSID)

$ligo->i_ssidmac()

Returns reference to hash. Key: ifIndex, Value: BSSID.

(ligoWiIfMacAddress)

$ligo->i_80211channel()

Returns reference to hash. Key: ifIndex, Value: channel.

(ligoWiIfChannel)

Table Methods imported from SNMP::Info::IEEE802dot11

See "TABLE METHODS" in SNMP::Info::IEEE802dot11 for details.

Table Methods imported from SNMP::Info::Layer2

See "TABLE METHODS" in SNMP::Info::Layer2 for details.