mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Add Lancom OAP-321 Wireless AP (#10982)

Browse Source 
* update lancom mib

* add Lancom OAP-321

* refactoring

* switch to available function
This commit is contained in:
Vitali Kari
2020-01-12 20:03:26 +01:00
committed by PipoCanaja
parent 25b5c64bff
commit dc3fe103ad
5 changed files with 54921 additions and 495 deletions
Download Patch File Download Diff File Expand all files Collapse all files

294
LibreNMS/OS/Lcos.php Normal file
View File

@@ -0,0 +1,294 @@
<?php
/**
* Lcos.php
*
* Lancom LCOS
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @package LibreNMS
* @link http://librenms.org
* @copyright 2019 Vitali Kari
* @author Vitali Kari <vitali.kari@gmail.com>
*/
namespace LibreNMS\OS;
use LibreNMS\Device\WirelessSensor;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessFrequencyDiscovery;
use LibreNMS\Interfaces\Polling\Sensors\WirelessFrequencyPolling;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessCapacityDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessNoiseFloorDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessPowerDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessCcqDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessRateDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessRssiDiscovery;
use LibreNMS\OS;
use LibreNMS\Util\Rewrite;
class Lcos extends OS implements
WirelessFrequencyDiscovery,
WirelessFrequencyPolling,
WirelessCapacityDiscovery,
WirelessNoiseFloorDiscovery,
WirelessPowerDiscovery,
WirelessCcqDiscovery,
WirelessRateDiscovery,
WirelessRssiDiscovery
{
/**
* Convert String to decimal encoded string notation
*
* @param string
* @return decimal encoded OID string
*/
private function strToDecOid($index)
{
for ($i = 0, $j = strlen($index); $i < $j; $i++) {
$dec_index[] = ord($index{$i});
}
return implode('.', $dec_index);
}
/**
* Discover wireless frequency. This is in Hz. Type is frequency.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessFrequency()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanRadiosEntryRadioChannel', [], 'LCOS-MIB');
$radios = $this->getCacheByIndex('lcsStatusWlanRadiosEntryIfc', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$radio = $radios[$index];
if (isset($sensors[$radio])) {
continue;
}
$sensors[$radio] = new WirelessSensor(
'frequency',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.57.1.3.' . '6.' . $this->strToDecOid($index),
'lcos',
$radio,
"Frequency ($radio)",
WirelessSensor::channelToFrequency($entry['lcsStatusWlanRadiosEntryRadioChannel'])
);
}
return $sensors;
}
/**
* Poll wireless frequency as MHz
* The returned array should be sensor_id => value pairs
*
* @param array $sensors Array of sensors needed to be polled
* @return array of polled data
*/
public function pollWirelessFrequency(array $sensors)
{
return $this->pollWirelessChannelAsFrequency($sensors);
}
/**
* Discover wireless capacity. This is a percent. Type is capacity.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessCapacity()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanRadiosEntryModemLoad', [], 'LCOS-MIB');
$radios = $this->getCacheByIndex('lcsStatusWlanRadiosEntryIfc', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$radio = $radios[$index];
if (isset($sensors[$radio])) {
continue;
}
$sensors[$radio] = new WirelessSensor(
'capacity',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.57.1.6.' . '6.' . $this->strToDecOid($index),
'lcos',
$radio,
"Modem Load ($radio)",
$entry['lcsStatusWlanRadiosEntryModemLoad']
);
}
return $sensors;
}
/**
* Discover wireless noise floor. This is in dBm/Hz. Type is noise-floor.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array
*/
public function discoverWirelessNoiseFloor()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanRadiosEntryNoiseLevel', [], 'LCOS-MIB');
$radios = $this->getCacheByIndex('lcsStatusWlanRadiosEntryIfc', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$radio = $radios[$index];
if (isset($sensors[$radio])) {
continue;
}
$sensors[$radio] = new WirelessSensor(
'noise-floor',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.57.1.5.' . '6.' . $this->strToDecOid($index),
'lcos',
$radio,
"Noise Floor ($radio)",
$entry['lcsStatusWlanRadiosEntryNoiseLevel']
);
}
return $sensors;
}
/**
* Discover wireless tx or rx power. This is in dBm. Type is power.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array
*/
public function discoverWirelessPower()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanRadiosEntryTransmitPower', [], 'LCOS-MIB');
$radios = $this->getCacheByIndex('lcsStatusWlanRadiosEntryIfc', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$radio = $radios[$index];
if (isset($sensors[$radio])) {
continue;
}
$sensors[$radio] = new WirelessSensor(
'power',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.57.1.7.' . '6.' . $this->strToDecOid($index),
'lcos-tx',
$radio,
"Tx Power ($radio)",
$entry['lcsStatusWlanRadiosEntryTransmitPower']
);
}
return $sensors;
}
/**
* Discover wireless client connection quality. This is a percent. Type is ccq.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessCcq()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntryPhySignal', [], 'LCOS-MIB');
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntryInterpointPeerName', $data, 'LCOS-MIB');
$bssids = $this->getCacheByIndex('lcsStatusWlanCompetingNetworksEntryBssid', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$bssid = $bssids[$index];
if (isset($sensors[$bssid])) {
continue;
}
$sensors[$bssid] = new WirelessSensor(
'ccq',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.44.1.10.' . Rewrite::oidMac($bssid) . '.0',
'lcos',
$bssid,
"CCQ " . $entry['lcsStatusWlanCompetingNetworksEntryInterpointPeerName'] . " $bssid",
$entry['lcsStatusWlanCompetingNetworksEntryPhySigal']
);
}
return $sensors;
}
/**
* Discover wireless rate. This is in bps. Type is rate.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array
*/
public function discoverWirelessRate()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntryEffRate', [], 'LCOS-MIB');
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntryInterpointPeerName', $data, 'LCOS-MIB');
$bssids = $this->getCacheByIndex('lcsStatusWlanCompetingNetworksEntryBssid', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$bssid = $bssids[$index];
if (isset($sensors[$bssid])) {
continue;
}
$sensors[$bssid] = new WirelessSensor(
'rate',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.44.1.35.' . Rewrite::oidMac($bssid) . '.0',
'lcos-tx',
$bssid,
"TX Rate " . $entry['lcsStatusWlanCompetingNetworksEntryInterpointPeerName'] . " $bssid",
$entry['lcsStatusWlanCompetingNetworksEntryEffRate'],
1000000
);
}
return $sensors;
}
/**
* Discover wireless RSSI (Received Signal Strength Indicator). This is in dBm. Type is rssi.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array
*/
public function discoverWirelessRssi()
{
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntrySignalLevel', [], 'LCOS-MIB');
$data = snmpwalk_cache_oid($this->getDevice(), 'lcsStatusWlanCompetingNetworksEntryInterpointPeerName', $data, 'LCOS-MIB');
$bssids = $this->getCacheByIndex('lcsStatusWlanCompetingNetworksEntryBssid', 'LCOS-MIB');
$sensors = [];
foreach ($data as $index => $entry) {
$bssid = $bssids[$index];
if (isset($sensors[$bssid])) {
continue;
}
$sensors[$bssid] = new WirelessSensor(
'rssi',
$this->getDeviceId(),
'.1.3.6.1.4.1.2356.11.1.3.44.1.26.' . Rewrite::oidMac($bssid) . '.0',
'lcos',
$bssid,
"RSSI " . $entry['lcsStatusWlanCompetingNetworksEntryInterpointPeerName'] . " $bssid",
$entry['lcsStatusWlanCompetingNetworksEntrySignalLevel']
);
}
return $sensors;
}
}

64
includes/definitions/discovery/lcos.yaml Normal file
View File

@@ -0,0 +1,64 @@
mib: LCOS-MIB
modules:
sensors:
pre-cache:
data:
-
oid:
- lcsStatusWlanInterpointsAccesspointListEntryInterpointPeerName
snmp_flags: '-OQUsb'
temperature:
data:
-
oid: lcsStatusHardwareInfoTemperatureDegrees
num_oid: '.1.3.6.1.4.1.2356.11.1.47.20.{{ $index }}'
descr: Temperature
low_limit: -33
high_limit: 70
state:
data:
-
oid: lcsStatusWlanInterpointsAccesspointListTable
value: lcsStatusWlanInterpointsAccesspointListEntryKeyingState
num_oid: '.1.3.6.1.4.1.2356.11.1.3.36.1.1.12.{{ $index }}'
descr: 'Keying {{ $lcsStatusWlanInterpointsAccesspointListEntryInterpointPeerName }}'
snmp_flags: '-OQUsbe'
state_name: KeyingState
states:
- { graph: 0, value: 0, generic: 0, descr: Idle }
- { graph: 0, value: 1, generic: 1, descr: Pending }
- { graph: 0, value: 2, generic: 0, descr: Done }
- { graph: 0, value: 3, generic: 1, descr: SaePending }
-
oid: lcsStatusWlanInterpointsAccesspointListTable
value: lcsStatusWlanInterpointsAccesspointListEntryWpaVersion
num_oid: '.1.3.6.1.4.1.2356.11.1.3.36.1.1.21.{{ $index }}'
descr: 'WPA Version {{ $lcsStatusWlanInterpointsAccesspointListEntryInterpointPeerName }}'
snmp_flags: '-OQUsbe'
state_name: WpaVersion
states:
- { graph: 0, value: 0, generic: 1, descr: None }
- { graph: 0, value: 1, generic: 0, descr: Wpa1 }
- { graph: 0, value: 2, generic: 0, descr: Wpa2 }
- { graph: 0, value: 3, generic: 0, descr: Wpa3 }
-
oid: lcsStatusWlanInterpointsAccesspointListTable
value: lcsStatusWlanInterpointsAccesspointListEntryLinkActive
num_oid: '.1.3.6.1.4.1.2356.11.1.3.36.1.1.40.{{ $index }}'
descr: 'Link Active {{ $lcsStatusWlanInterpointsAccesspointListEntryInterpointPeerName }}'
snmp_flags: '-OQUsbe'
state_name: LinkActive
states:
- { graph: 0, value: 0, generic: 2, descr: No }
- { graph: 0, value: 1, generic: 0, descr: Yes }
-
oid: lcsStatusWlanInterpointsAccesspointListTable
value: lcsStatusWlanInterpointsAccesspointListEntryRemoteStatus
num_oid: '.1.3.6.1.4.1.2356.11.1.3.36.1.1.43.{{ $index }}'
descr: 'Remote Status {{ $lcsStatusWlanInterpointsAccesspointListEntryInterpointPeerName }}'
snmp_flags: '-OQUsbe'
state_name: RemoteStatus
states:
- { graph: 0, value: 0, generic: 3, descr: Unknown }
- { graph: 0, value: 1, generic: 2, descr: NotOK }
- { graph: 0, value: 2, generic: 0, descr: OK }

32163
mibs/lancom/LCOS-MIB
View File

File diff suppressed because it is too large Load Diff

18484
tests/data/lcos_oap-321.json Normal file
View File

File diff suppressed because it is too large Load Diff

4411
tests/snmpsim/lcos_oap-321.snmprec Normal file
View File

File diff suppressed because it is too large Load Diff