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

newdevice: Added wireless sensors for SAF Tehnika (#6975)

Browse Source 
Add new sensor type MSE (Mean Squared Error) which is similar to SNR
This commit is contained in:
Tony Murray
2017-07-07 10:05:55 -05:00
committed by Neil Lathwood
parent aeedf515c5
commit 527a989b4c
6 changed files with 262 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
LibreNMS/Device/WirelessSensor.php
View File

@@ -175,6 +175,12 @@ class WirelessSensor extends Sensor
'unit' => 'dB',
'icon' => 'signal',
),
'mse' => array(
'short' => 'MSE',
'long' => 'Mean Square Error',
'unit' => 'dB',
'icon' => 'signal',
),
'rssi' => array(
'short' => 'RSSI',
'long' => 'Received Signal Strength Indicator',

37
LibreNMS/Interfaces/Discovery/Sensors/WirelessMseDiscovery.php Normal file
View File

@@ -0,0 +1,37 @@
<?php
/**
* WirelessMseDiscovery.php
*
* Discover wireless MSE. Mean square error value in dB.
*
* 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 2017 Tony Murray
* @author Tony Murray <murraytony@gmail.com>
*/
namespace LibreNMS\Interfaces\Discovery\Sensors;
interface WirelessMseDiscovery
{
/**
* Discover wireless MSE. Mean square error value in dB.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessMse();
}

38
LibreNMS/Interfaces/Polling/Sensors/WirelessMsePolling.php Normal file
View File

@@ -0,0 +1,38 @@
<?php
/**
* WirelessMsePolling.php
*
* Poll wireless MSE. Mean square error value in dB.
*
* 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 2017 Tony Murray
* @author Tony Murray <murraytony@gmail.com>
*/
namespace LibreNMS\Interfaces\Polling\Sensors;
interface WirelessMsePolling
{
/**
* Poll wireless MSE in dB
* 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 pollWirelessMse(array $sensors);
}

164
LibreNMS/OS/Saf.php Normal file
View File

@@ -0,0 +1,164 @@
<?php
/**
* Saf.php
*
* Saf Tehnika wireless radios
*
* 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 2017 Tony Murray
* @author Tony Murray <murraytony@gmail.com>
*/
namespace LibreNMS\OS;
use LibreNMS\Device\WirelessSensor;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessFrequencyDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessMseDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessPowerDiscovery;
use LibreNMS\Interfaces\Discovery\Sensors\WirelessRateDiscovery;
use LibreNMS\OS;
class Saf extends OS implements
WirelessFrequencyDiscovery,
WirelessMseDiscovery,
WirelessPowerDiscovery,
WirelessRateDiscovery
{
/**
* Discover wireless frequency. This is in MHz. Type is frequency.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessFrequency()
{
return array(
// SAF-IPRADIO::radioTxFrequency.local
new WirelessSensor(
'frequency',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.10.1.9.1',
'saf-tx',
1,
'Tx Frequency',
null,
1,
1000
),
// SAF-IPRADIO::radioRxFrequency.local
new WirelessSensor(
'frequency',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.10.1.10.1',
'saf-rx',
1,
'Rx Frequency',
null,
1,
1000
),
);
}
/**
* Discover wireless MSE. Mean square error value *10 in dB.
* Returns an array of LibreNMS\Device\Sensor objects that have been discovered
*
* @return array Sensors
*/
public function discoverWirelessMse()
{
return array(
// SAF-IPRADIO::modemRadialMSE.local
new WirelessSensor(
'mse',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.12.1.10.1',
'saf-radial',
1,
'Radial MSE',
null,
1,
10
),
);
}
/**
* 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()
{
return array(
// SAF-IPRADIO::radioRxLevel.local
new WirelessSensor(
'power',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.10.1.5.1',
'saf-rx',
1,
'Rx Power'
),
// SAF-IPRADIO::radioTxPower.local
new WirelessSensor(
'power',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.10.1.4.1',
'saf-tx',
1,
'Tx Power'
),
);
}
/**
* 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()
{
return array(
// SAF-IPRADIO::modemACMtotalCapacity.local
new WirelessSensor(
'rate',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.12.1.18.1',
'saf-acm',
1,
'ACM Capacity',
null,
1000
),
// SAF-IPRADIO::modemTotalCapacity.local
new WirelessSensor(
'rate',
$this->getDeviceId(),
'.1.3.6.1.4.1.7571.100.1.1.5.1.1.1.12.1.6.1',
'saf-total',
1,
'Total Capacity',
null,
1000
),
);
}
}

9
html/includes/graphs/device/wireless_mse.inc.php Normal file
View File

@@ -0,0 +1,9 @@
<?php
$scale_max = '0';
$class = 'mse';
$unit = '';
$unit_long = 'dB';
require 'includes/graphs/device/wireless-sensor.inc.php';

8
html/includes/graphs/wireless/mse.inc.php Normal file
View File

@@ -0,0 +1,8 @@
<?php
$scale_max = '0';
$unit_long = 'MSE (dB)';
$unit = 'dB';
include 'wireless-sensor.inc.php';