Network ports status LuCI application

Description

This package allows you to monitor current state of the network interfaces specified in configuration file (/etc/config/luci_netports).

Dependencies

This LuCI application developed for LuCI master branch. Application requires luabitop package to be installed.

Master branch of this repository requires index status page client side view implementation in the LuCI (see commit https://github.com/openwrt/luci/commit/c85af3d7618b55c499ce4bf58e3896068bd413ae). Support for older LuCI releases (e.g. for version 18.06.x) is left in the v1.x branch of this repository.

Supported languages

• English
• Russian

UCI configuration

UCI configuration for this application is stored in /etc/config/luci_netports file.

This file contain one global section with global application settings and one or more port sections with network ports settings.

Global settings

The global section contains global application settings. Default global section configuration:

config global 'global'
	option default_additional_info 'false'
	option default_h_mode          'false'
	option hv_mode_switch_button   'false'

These options can be set in the global section:

Name	Type	Required	Default	Description
default_additional_info	boolean	no	false	Display additional information in horizontal view mode by default.
default_h_mode	boolean	no	false	Use horizontal view mode by default.
hv_mode_switch_button	boolean	no	false	Show button for manual switching between horizontal and vertical view modes.

Horizontal display mode can be used maximum for 6 interfaces. If there are more interfaces, the vertical display mode will be automatically activated without the possibility of switching to the horizontal mode.

Ports settings

Sections of the type port declare network port settings for displaying in application.

A minimal port declaration consists of the following lines:

config port
	option ifname 'eth0'

These options can be set in the port sections:

Name	Type	Required	Default	Description
ifname	string	yes	(none)	Network interface name.
name	string	no	value of ifname	Custom port name for displaying in application.
type	string	no	auto	Custom port type. Available port types listed in the table below.
disable	boolean	no	false	Do not display specified interface.

Available port types (type setting):

Type(s)	Disabled icon	Linkdown icon	Linkup icon	Description
auto	-	-	-	Automatically detect type by interface name (see next table).
copper				Wired (RJ45) connection.
sfp				SFP connection.
fixed				Intercircuit fixed link connection.
wifi, usb_wifi				Wireless connection.
usb_rndis				USB RNDIS connection.
usb_stick, usb_2g, usb_3g, usb_4g				USB 2G/3G/4G modem connection.
gprs				GPRS connection.
vpn, tunnel				Tunnel connection.
ppp				PPP connection.

Automatic network port type detection (auto type):

Interface name regular expression(s)	Example(s)	Detected type
^eth\d+, ^sw\d+p\d+, ^en[a-z]\d+[a-z]\d+	eth0, eth32, sw1p4, enp0s4, ens9f0	copper
^wlan\d+, ^wl[a-z]\d+[a-z]\d+	wlan0, wlp0s4, wls1f4	wifi
^usb\d+	usb0	usb_rndis
^wwan\d+, ^ww[a-z]\d+[a-z]\d+	wwan0, wwp0s4, wws1f4	usb_stick
^ppp\d+	ppp0	ppp
^tun\d+, ^tap\d+, ^wg\d+	tun0, tap0, wg0	tunnel

Screenshots

Vertical mode

Horizontal mode

Without additional information:

With additional information: