newdevice: Added support for Racom RAy devices (#7466)

LibreNMS/OS/Ray.php

@@ -0,0 +1,97 @@
+<?php
+/**
+ * Ray.php
+ *
+ * Racom.eu
+ *
+ * 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\WirelessPowerDiscovery;
+use LibreNMS\Interfaces\Discovery\Sensors\WirelessRssiDiscovery;
+use LibreNMS\Interfaces\Discovery\Sensors\WirelessSnrDiscovery;
+use LibreNMS\OS;
+
+class Ray extends OS implements
+    WirelessFrequencyDiscovery,
+    WirelessPowerDiscovery,
+    WirelessRssiDiscovery,
+    WirelessSnrDiscovery
+{
+
+    /**
+     * Discover wireless frequency.  This is in GHz. Type is frequency.
+     * Returns an array of LibreNMS\Device\Sensor objects that have been discovered
+     *
+     * @return array Sensors
+     */
+    public function discoverWirelessFrequency()
+    {
+        $oid = '.1.3.6.1.4.1.33555.1.2.1.4'; // RAY-MIB::txFreq.0
+        return array(
+            new WirelessSensor('frequency', $this->getDeviceId(), $oid, 'racom', 1, 'Frequency', null, 1, 1000),
+        );
+    }
+
+    /**
+     * 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()
+    {
+        $oid = '.1.3.6.1.4.1.33555.1.2.1.12'; // RAY-MIB::rfPowerConfigured.0
+        return array(
+            new WirelessSensor('power', $this->getDeviceId(), $oid, 'racom', 1, 'Tx Power'),
+        );
+    }
+
+    /**
+     * 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()
+    {
+        $oid = '.1.3.6.1.4.1.33555.1.3.2.1'; // RAY-MIB::rss.0
+        return array(
+            new WirelessSensor('rssi', $this->getDeviceId(), $oid, 'racom', 1, 'RSSI', null, 1, 10),
+        );
+    }
+
+    /**
+     * Discover wireless SNR.  This is in dB. Type is snr.
+     * Returns an array of LibreNMS\Device\Sensor objects that have been discovered
+     *
+     * @return array Sensors
+     */
+    public function discoverWirelessSnr()
+    {
+        $oid = '.1.3.6.1.4.1.33555.1.3.2.2'; // RAY-MIB::snr.0
+        return array(
+            new WirelessSensor('snr', $this->getDeviceId(), $oid, 'racom', 1, 'CINR', null, 1, 10),
+        );
+    }
+}

includes/definitions/ray.yaml

@@ -0,0 +1,12 @@
+os: ray
+text: 'RAy'
+type: wireless
+icon: ray
+over:
+    - { graph: device_bits, text: 'Device Traffic' }
+    - { graph: device_processor, text: 'CPU Usage' }
+    - { graph: device_mempool, text: 'Memory Usage' }
+discovery:
+    - sysObjectId: .1.3.6.1.4.1.33555.1.1
+mib_dir:
+    - ray

includes/discovery/processors/ray.inc.php

@@ -0,0 +1,23 @@
+<?php
+/*
+ * LibreNMS
+ *
+ * Copyright (c) 2017 Martin Zatloukal <slezi2@pvfree.net> 
+ * 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.  Please see LICENSE.txt at the top level of
+ * the source code distribution for details.
+ */
+
+if ($device['os'] == 'ray') {
+    echo 'ray : ';
+
+    $oid = '.1.3.6.1.4.1.33555.1.1.5.1';
+    $descr = 'Processor';
+    $usage = snmp_get($device, $oid, '-Ovqn');
+
+    if (is_numeric($usage)) {
+        discover_processor($valid['processor'], $device, $oid, '0', 'ray', $descr, '1', $usage);
+    }
+}

includes/discovery/sensors/temperature/ray.inc.php

@@ -0,0 +1,22 @@
+<?php
+/*
+ * LibreNMS
+ *
+ * Copyright (c) 2017 Martin Zatloukal <slezi2@pvfree.net>
+ * 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.  Please see LICENSE.txt at the top level of
+ * the source code distribution for details.
+ */
+
+d_echo('RAY');
+$oid = ".1.3.6.1.4.1.33555.1.1.4.2";
+$index = 0;
+$sensor_type = ' temperatureRadio';
+$descr = 'Internal Temp';
+$divisor = 100;
+$temperature = (snmp_get($device, $oid, '-Oqv', 'RAY-MIB') / $divisor);
+if (is_numeric($temperature)) {
+    discover_sensor($valid['sensor'], 'temperature', $device, $oid, $index, $sensor_type, $descr, $divisor, null, null, null, null, null, $temperature);
+}

includes/discovery/sensors/voltage/ray.inc.php

@@ -0,0 +1,23 @@
+<?php
+/*
+ * LibreNMS
+ *
+ * Copyright (c) 2017 Martin Zatloukal <slezi2@pvfree.net>
+ * 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.  Please see LICENSE.txt at the top level of
+ * the source code distribution for details.
+ */
+
+
+d_echo('RAY');
+$oid = ".1.3.6.1.4.1.33555.1.1.4.3";
+$index = 0;
+$sensor_type = 'voltageUnit';
+$descr = 'Voltage';
+$divisor = 10;
+$voltage = (snmp_get($device, $oid, '-Oqv', 'RAY-MIB') / $divisor);
+if (is_numeric($voltage)) {
+    discover_sensor($valid['sensor'], 'voltage', $device, $oid, $index, $sensor_type, $descr, $divisor, null, null, null, null, null, $voltage);
+}

includes/polling/os/ray.inc.php

@@ -0,0 +1,8 @@
+<?php
+
+
+$ray_tmp = snmp_get_multi_oid($device, 'deviceName swVer serialNumber', '-OQs', 'RAY-MIB');
+$hardware      = $ray_tmp['deviceName'];
+$version       = $ray_tmp['swVer'];
+$serial        = $ray_tmp['serialNumber'];
+unset($ray_tmp);

tests/snmpsim/ray.snmprec

@@ -0,0 +1,2 @@
+1.3.6.1.2.1.1.1.0|4|RAy - Microwave Link
+1.3.6.1.2.1.1.2.0|6|.1.3.6.1.4.1.33555.1.1

tests/snmpsim/ray_24GHz.snmprec

@@ -0,0 +1,2 @@
+1.3.6.1.2.1.1.1.0|4|Microwave Link
+1.3.6.1.2.1.1.2.0|6|.1.3.6.1.4.1.33555.1.1