Add plugin 'wireless_channel_active_'

plugins/wifi/wireless_channel_active_

@@ -0,0 +1,139 @@
+#!/bin/sh
+
+: << =cut
+
+=head1 NAME
+
+wireless_channel_active - Show currently used channel of wifi enabled devices
+
+=head1 APPLICABLE SYSTEMS
+
+Information is parsed from the output of the tool "iwinfo" (OpenWrt) or "iw" (most systems).
+
+
+=head1 CONFIGURATION
+
+Symlink this plugin with the name of the wifi device added (e.g. "phy0").
+
+Root permissions are probably required for accessing "iw".
+
+  [wireless_channel_active*]
+  user root
+
+
+=head1 VERSION
+
+  1.1
+
+
+=head1 AUTHOR
+
+Lars Kruse <devel@sumpfralle.de>
+
+
+=head1 LICENSE
+
+GPLv3 or above
+
+
+=head1 MAGIC MARKERS
+
+  #%# family=auto
+  #%# capabilities=autoconf suggest
+
+=cut
+
+
+set -eu
+
+if which iwinfo >/dev/null; then
+	# "iwinfo" has a stable output format but is only available on OpenWrt
+	get_physical_interfaces() { iwinfo | sed -n 's/^.*PHY name: \+\(.*\)$/\1/p'; }
+	get_physical_interface_current_channel() { iwinfo "$1" info \
+		| grep Channel | sed 's/^.*Channel: \+\([0-9]\+\) .*$/\1/'; }
+	get_physical_interfaces_channel_descriptions() {
+		# return: CHANNEL CHANNEL_DESCRIPTION
+		# e.g.: "104 5.520 GHz (Channel 104)"
+		iwinfo "$1" freqlist | sed 's/^[^0-9]*//' \
+			| sed 's/^.*Channel \+\([0-9]\+\).*$/\1 \0/'; }
+else
+	# "iw" is available everywhere - but its output format is not recommended for non-humans
+	get_physical_interfaces() { iw list | awk '/^\w/ {print $2}'; }
+	get_physical_interface_current_channel() { iw dev | awk '
+		/^\w+#/ { phy_name=gensub("#", "", 1, $1); }
+		/channel/ { if (phy_name == "phy0") print($2); }'; }
+	get_physical_interfaces_channel_descriptions() {
+		# example input: "* 5680 MHz [136]"
+		# return: CHANNEL CHANNEL_DESCRIPTION
+		# e.g.: "136 5680 MHz [136]"
+		iw phy phy0 channels | awk '
+			/\*/ { chan_num=gensub("^.*\\[", "", 1, gensub("\\].*$", "", 1, $0));
+				print(chan_num, $2, $3, $4); }'; }
+fi
+
+
+get_selected_physical_interface() {
+	# The physical interface name should be safe (phyX) and needs no cleanup.
+	# pick the last segment after the final "_"
+	echo "$0" | sed 's/.*_//'
+}
+
+
+do_config() {
+	local phy
+	phy=$(get_selected_physical_interface)
+	[ -z "$phy" ] && echo >&2 "Missing wireless PHY" && return 1
+	echo "graph_title Wireless channel usage - $phy"
+	echo "graph_args --base 1000 -r --lower-limit 0 --upper-limit 100"
+	echo "graph_vlabel Channel usage by time in percent"
+	echo "graph_category network"
+	echo "graph_info This graph shows the currently used channel of your WiFi device(s)"
+	get_physical_interfaces_channel_descriptions "$phy" | while read -r channel description; do
+		fieldname="channel_${channel}"
+		echo "${fieldname}.label $description"
+		echo "${fieldname}.draw AREASTACK"
+		# percent scaling
+		echo "${fieldname}.cdef 100,${fieldname},*"
+	done
+}
+
+
+do_fetch() {
+	local phy
+	local current_channel
+	phy=$(get_selected_physical_interface)
+	[ -z "$phy" ] && echo >&2 "Missing wireless PHY" && return 1
+	current_channel=$(get_physical_interface_current_channel "$phy")
+	get_physical_interfaces_channel_descriptions "$phy" | while read -r channel description; do
+		[ "$current_channel" = "$channel" ] && value=1 || value=0
+		echo "channel_${channel}.value $value"
+	done
+}
+
+
+ACTION="${1:-}"
+
+case "$ACTION" in
+	config)
+		do_config || exit 1
+		if [ "${MUNIN_CAP_DIRTYCONFIG:-0}" = 1 ]; then do_fetch; fi
+		;;
+	autoconf)
+		if [ -z "$(get_physical_interfaces)" ]; then
+			echo "no (no wifi interfaces found)"
+		else
+			echo "yes"
+		fi
+		;;
+	suggest)
+		get_physical_interfaces
+		;;
+	"")
+		do_fetch
+		;;
+	*)
+		echo >&2 "Invalid action (valid: config / autoconf / suggest / <empty>)"
+		echo >&2
+		exit 2
+		;;
+esac