. * * @package LibreNMS * @link http://librenms.org * @copyright 2017 Tony Murray * @author Tony Murray */ namespace LibreNMS\OS; use LibreNMS\Device\WirelessSensor; use LibreNMS\Interfaces\Discovery\Sensors\WirelessErrorRatioDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessFrequencyDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessNoiseFloorDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessPowerDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessRateDiscovery; use LibreNMS\Interfaces\Discovery\Sensors\WirelessSnrDiscovery; use LibreNMS\OS; class Mimosa extends OS implements WirelessErrorRatioDiscovery, WirelessFrequencyDiscovery, WirelessNoiseFloorDiscovery, WirelessPowerDiscovery, WirelessRateDiscovery, WirelessSnrDiscovery { /** * Discover wireless bit/packet error ratio. This is in percent. Type is error-ratio. * Returns an array of LibreNMS\Device\Sensor objects that have been discovered * * @return array Sensors */ public function discoverWirelessErrorRatio() { $tx_oid = '.1.3.6.1.4.1.43356.2.1.2.7.3.0'; // MIMOSA-NETWORKS-BFIVE-MIB::mimosaPerTxRate $rx_oid = '.1.3.6.1.4.1.43356.2.1.2.7.4.0'; // MIMOSA-NETWORKS-BFIVE-MIB::mimosaPerRxRate return array( new WirelessSensor( 'error-ratio', $this->getDeviceId(), $tx_oid, 'mimosa-tx', 0, 'Tx Packet Error Ratio', null, 1, 100 ), new WirelessSensor( 'error-ratio', $this->getDeviceId(), $rx_oid, 'mimosa-rx', 0, 'Rx Packet Error Ratio', null, 1, 100 ), ); } /** * 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() { $sensors = array(); // ptp radios $polar = $this->getCacheByIndex('mimosaPolarization', 'MIMOSA-NETWORKS-BFIVE-MIB'); $freq = $this->getCacheByIndex('mimosaCenterFreq', 'MIMOSA-NETWORKS-BFIVE-MIB'); // both chains should be the same frequency, make sure $freq = array_flip($freq); if (count($freq) == 1) { $descr = 'Frequency'; } else { $descr = 'Frequency: $s Chain'; } foreach ($freq as $index => $frequency) { $sensors[] = new WirelessSensor( 'frequency', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.1.1.6.' . $index, 'mimosa', $index, sprintf($descr, $this->getPolarization($polar[$index])), $frequency ); } // ptmp radios $ptmpRadioName = $this->getCacheByIndex('mimosaPtmpChPwrRadioName', 'MIMOSA-NETWORKS-PTMP-MIB'); $ptmpFreq = snmpwalk_group($this->getDevice(), 'mimosaPtmpChPwrCntrFreqCur', 'MIMOSA-NETWORKS-PTMP-MIB'); foreach ($ptmpFreq as $index => $frequency) { $sensors[] = new WirelessSensor( 'frequency', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.9.3.3.1.7.' . $index, 'mimosa', $index, $ptmpRadioName[$index], $frequency['mimosaPtmpChPwrCntrFreqCur'] ); } return $sensors; } private function getPolarization($polarization) { return $polarization == 'horizontal' ? 'Horiz.' : 'Vert.'; } /** * Discover wireless noise floor. This is in dBm. Type is noise-floor. * Returns an array of LibreNMS\Device\Sensor objects that have been discovered * * @return array Sensors */ public function discoverWirelessNoiseFloor() { // FIXME: is Noise different from Noise Floor? $polar = $this->getCacheByIndex('mimosaPolarization', 'MIMOSA-NETWORKS-BFIVE-MIB'); $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaRxNoise', array(), 'MIMOSA-NETWORKS-BFIVE-MIB'); $sensors = array(); foreach ($oids as $index => $entry) { $sensors[] = new WirelessSensor( 'noise-floor', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.1.1.4.' . $index, 'mimosa', $index, sprintf('Rx Noise: %s Chain', $this->getPolarization($polar[$index])), $entry['mimosaRxNoise'] ); } 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() { $sensors = array(); // ptp radios $polar = $this->getCacheByIndex('mimosaPolarization', 'MIMOSA-NETWORKS-BFIVE-MIB'); $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaTxPower', array(), 'MIMOSA-NETWORKS-BFIVE-MIB'); $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaRxPower', $oids, 'MIMOSA-NETWORKS-BFIVE-MIB'); foreach ($oids as $index => $entry) { $sensors[] = new WirelessSensor( 'power', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.1.1.2.' . $index, 'mimosa-tx', $index, sprintf('Tx Power: %s Chain', $this->getPolarization($polar[$index])), $entry['mimosaTxPower'] ); $sensors[] = new WirelessSensor( 'power', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.1.1.3.' . $index, 'mimosa-rx', $index, sprintf('Rx Power: %s Chain', $this->getPolarization($polar[$index])), $entry['mimosaRxPower'] ); } // ptmp radios $ptmpRadioName = $this->getCacheByIndex('mimosaPtmpChPwrRadioName', 'MIMOSA-NETWORKS-PTMP-MIB'); $ptmpTxPow = snmpwalk_group($this->getDevice(), 'mimosaPtmpChPwrTxPowerCur', 'MIMOSA-NETWORKS-PTMP-MIB'); foreach ($ptmpTxPow as $index => $entry) { $sensors[] = new WirelessSensor( 'power', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.9.3.3.1.10.' . $index, 'mimosa-tx', $index, 'Tx Power: ' . $ptmpRadioName[$index], $entry['mimosaPtmpChPwrTxPowerCur'] ); } $ptmpRxPow = snmpwalk_group($this->getDevice(), 'mimosaPtmpChPwrMinRxPower', 'MIMOSA-NETWORKS-PTMP-MIB'); foreach ($ptmpRxPow as $index => $entry) { $sensors[] = new WirelessSensor( 'power', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.9.3.3.1.12.' . $index, 'mimosa-rx', $index, 'Min Rx Power: ' . $ptmpRadioName[$index], $entry['mimosaPtmpChPwrMinRxPower'] ); } 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() { $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaTxPhy', array(), 'MIMOSA-NETWORKS-BFIVE-MIB'); $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaRxPhy', $oids, 'MIMOSA-NETWORKS-BFIVE-MIB'); $sensors = array(); foreach ($oids as $index => $entry) { $sensors[] = new WirelessSensor( 'rate', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.2.1.2.' . $index, 'mimosa-tx', $index, "Stream $index Tx Rate", $entry['mimosaTxPhy'], 1000000 ); $sensors[] = new WirelessSensor( 'rate', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.2.1.5.' . $index, 'mimosa-rx', $index, "Stream $index Rx Rate", $entry['mimosaRxPhy'], 1000000 ); } return $sensors; } /** * 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() { $polar = $this->getCacheByIndex('mimosaPolarization', 'MIMOSA-NETWORKS-BFIVE-MIB'); $oids = snmpwalk_cache_oid($this->getDevice(), 'mimosaSNR', array(), 'MIMOSA-NETWORKS-BFIVE-MIB'); $sensors = array(); foreach ($oids as $index => $entry) { $sensors[] = new WirelessSensor( 'snr', $this->getDeviceId(), '.1.3.6.1.4.1.43356.2.1.2.6.1.1.5.' . $index, 'mimosa', $index, sprintf('SNR: %s Chain', $this->getPolarization($polar[$index])), $entry['mimosaSNR'] ); } return $sensors; } }