extend documentation with primary source

Includes references to the IEEE 802.11 Chapter that defines the Information Element

Signed-off-by: Lukas Raffelt <[email protected]>

client_linux.go

@@ -554,10 +554,13 @@ func decodeSSID(b []byte) string {
 
 // decodeBSSLoad Decodes the BSSLoad IE. Supports Version 1 and Version 2
 // values according to https://raw.githubusercontent.com/wireshark/wireshark/master/epan/dissectors/packet-ieee80211.c
+// See also source code of iw (v5.19) scan.c Line 1634ff
+// BSS Load ELement (with length 5) is defined by chapter 9.4.2.27 (page 1066) of the current IEEE 802.11-2020
 func decodeBSSLoad(b []byte) (*BSSLoad, error) {
 	var load BSSLoad
 	if len(b) == 5 {
 		// Wireshark calls this "802.11e CCA Version"
+		// This is the version defined in IEEE 802.11 (Versions 2007, 2012, 2016 and 2020)
 		load.Version = 2
 		load.StationCount = binary.LittleEndian.Uint16(b[0:2])               // first 2 bytes
 		load.ChannelUtilization = b[2]                                       // next 1 byte

wifi.go

@@ -174,13 +174,13 @@ type BSSLoad struct {
 	// Version of the BSS Load Element. Can be 1 or 2.
 	Version int
 
-	// Station Count on this BSS.
+	// Station Count: total number of STA currently associated with this BSS.
 	StationCount uint16
 
-	// Channel Utilization from 0 to 255
+	// Channel Utilization: Percentage of time (linearly scaled 0 to 255) that the AP sensed the medium was busy. Calculated only for the primary channel.
 	ChannelUtilization uint8
 
-	// Available Admission Capacity in unit [32 us/s]
+	// Available Admission Capacity: remaining amount of medium time availible via explicit admission controll in units of 32 us/s.
 	AvailableAdmissionCapacity uint16
 }