librenms/librenms

View on GitHub
LibreNMS/OS/Engenius.php

Summary

Maintainability
A
3 hrs
Test Coverage
<?php
/*
 * Engenius.php
 *
 * -Description-
 *
 * 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  2021 Tony Murray
 * @author     Tony Murray <murraytony@gmail.com>
 */

namespace LibreNMS\OS;

use App\Models\Device;
use LibreNMS\OS;

class Engenius extends OS
{
    public function discoverOS(Device $device): void
    {
        parent::discoverOS($device); // yaml

        // SENAO-ENTERPRISE-INDOOR-AP-CB-MIB::entSysMode.0
        $data = \SnmpQuery::numeric()->get([
            '.1.3.6.1.4.1.14125.2.1.1.5.0',
            '.1.3.6.1.4.1.14125.3.1.1.5.0',
            '.1.3.6.1.4.1.14125.100.1.4.0',
            '.1.3.6.1.4.1.14125.100.1.6.0',
            '.1.3.6.1.4.1.14125.100.1.7.0',
            '.1.3.6.1.4.1.14125.100.1.8.0',
            '.1.3.6.1.4.1.14125.100.1.9.0',
        ])->values();

        // Sorry about the OIDs but there doesn't seem to be a matching MIB available... :-/
        if (! empty($data['.1.3.6.1.4.1.14125.100.1.8.0']) && ! empty($data['.1.3.6.1.4.1.14125.100.1.9.0'])) {
            $device->version = 'Kernel ' . $data['.1.3.6.1.4.1.14125.100.1.8.0'] . ' / Apps ' . $data['.1.3.6.1.4.1.14125.100.1.9.0'];
        } else {
            $device->version = isset($data['.1.3.6.1.4.1.14125.2.1.1.5.0']) ? 'Firmware ' . $data['.1.3.6.1.4.1.14125.2.1.1.5.0'] : null;
        }
        $device->serial = $data['.1.3.6.1.4.1.14125.100.1.7.0'] ?? null;

        // There doesn't seem to be a real hardware identification.. sysName will have to do?
        if (! empty($data['.1.3.6.1.4.1.14125.100.1.6.0'])) {
            $device->hardware = str_replace('EnGenius ', '', $device->sysName) . ' v' . $data['.1.3.6.1.4.1.14125.100.1.6.0'];
        } else {
            $device->hardware = $device->sysName . ($data['.1.3.6.1.4.1.14125.3.1.1.5.0'] ?? '');
        }

        switch ($data['.1.3.6.1.4.1.14125.100.1.4.0'] ?? null) {
            case 0:
                $device->features = 'Router mode';
                break;
            case 1:
                $device->features = 'Universal repeater mode';
                break;
            case 2:
                $device->features = 'Access Point mode';
                break;
            case 3:
                $device->features = 'Client Bridge mode';
                break;
            case 4:
                $device->features = 'Client router mode';
                break;
            case 5:
                $device->features = 'WDS Bridge mode';
                break;
        }
    }
}