fuchsia.wlan.stats

Added: HEAD

STRUCTS

AntennaId

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Identifier for antenna.

FieldTypeDescriptionDefault
freq AntennaFreq No default
index uint8

0 indexed antenna number of freq.

No default

HistBucket

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram bucket.

FieldTypeDescriptionDefault
bucket_index uint16

Index into a lookup table for each histogram type. The lookup table for each type is described below in the comments for each type.

No default
num_samples uint64

The count of samples in the bucket.

No default

NoiseFloorHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for noise floor samples.

FieldTypeDescriptionDefault
hist_scope HistScope No default
antenna_id AntennaId?

If hist_scope is PER_ANTENNA, antenna_id must be provided.

No default
noise_floor_samples vector<HistBucket>:255

Sparse histogram of noise floor of current channel in dBm. Each sample's bucket_index is an index into this list of dBm values: [-255, -254, ... -1]. For example, if noise_floor_samples contains a HistBucket with bucket_index = 165 and num_samples = 50, that means there were 50 frames counted that had a noise floor of -90 dBm.

No default
invalid_samples uint64

Count of invalid samples encountered, if any.

No default

RssiHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for received signal strength indicator (RSSI).

FieldTypeDescriptionDefault
hist_scope HistScope No default
antenna_id AntennaId?

If hist_scope is PER_ANTENNA, antenna_id must be provided.

No default
rssi_samples vector<HistBucket>:255

Sparse histogram of RSSI of AP in dBm. Each sample's bucket_index is an index into this list of dBm values: [-255, -254, ... -1]. For example, if rssi_samples contains a HistBucket with bucket_index = 225 and num_samples = 50, that means there were 50 frames counted that had a signal level of -30 dBm.

No default
invalid_samples uint64

Count of invalid samples encountered, if any.

No default

RxRateIndexHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for received data rate.

FieldTypeDescriptionDefault
hist_scope HistScope No default
antenna_id AntennaId?

If hist_scope is PER_ANTENNA, antenna_id must be provided.

No default
rx_rate_index_samples vector<HistBucket>:196

Sparse histogram of count of received frames for each rate. Each sample's bucket_index is an index into this lookup table: 0-3: B-MCS 0-3 4-11: G-MCS 0-7 12-27: N-MCS 0-15 (BW20) 28-43: N-MCS 0-15 (BW40) 44-59: N-MCS 0-15 (BW20:SGI) 60-75: N-MCS 0-15 (BW40:SGI) 76-85: AC-MCS 0-9 (VHT:BW20:NSS1) 86-95: AC-MCS 0-9 (VHT:BW20:NSS2) 96-105: AC-MCS 0-9 (VHT:BW40:NSS1) 106-115: AC-MCS 0-9 (VHT:BW40:NSS2) 116-125: AC-MCS 0-9 (VHT:BW80:NSS1) 126-135: AC-MCS 0-9 (VHT:BW80:NSS2) 136-145: AC-MCS 0-9 (VHT:BW20:NSS1:SGI) 146-155: AC-MCS 0-9 (VHT:BW20:NSS2:SGI) 156-165: AC-MCS 0-9 (VHT:BW40:NSS1:SGI) 166-175: AC-MCS 0-9 (VHT:BW40:NSS2:SGI) 176-185: AC-MCS 0-9 (VHT:BW80:NSS1:SGI) 186-195: AC-MCS 0-9 (VHT:BW80:NSS2:SGI)

For example, if rx_rate_index_samples contains a HistBucket with bucket_index = 75 and num_samples = 50, that means there were 50 frames counted that had a rate corresponding to N-MCS 15 (BW40:SGI).

No default
invalid_samples uint64

Count of invalid samples encountered, if any.

No default

SnrHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for signal to noise ratio (SNR).

FieldTypeDescriptionDefault
hist_scope HistScope No default
antenna_id AntennaId?

If hist_scope is PER_ANTENNA, antenna_id must be provided.

No default
snr_samples vector<HistBucket>:256

Sparse histogram of signal to noise ratio in dB. Each sample's bucket_index is an index into this list of dB values: [0, 1, ... 255]. For example, if snr_samples contains a HistBucket with value = 60 and num_samples = 50, that means there were 50 frames counted that had a SNR of 60 dB.

No default
invalid_samples uint64

Count of invalid samples encountered, if any.

No default

ENUMS

AntennaFreq strict

Type: uint8

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Antenna frequency.

NameValueDescription
1

2.4 GHz.

2

5 GHz.

HistScope strict

Type: uint8

Defined in fuchsia.wlan.stats/wlan_stats.fidl

The scope of the histogram, e.g. if the histogram contains data for the entire station, or has data for just a single antenna.

NameValueDescription
1
2

TABLES

ConnectionCounters

Defined in fuchsia.wlan.stats/wlan_stats.fidl

OrdinalFieldTypeDescription
connection_id uint8

ID of the current connection. Used by WLAN telemetry to determine whether the current counters and the previous counters belong to the same connection. If the counters belong to two different connections, telemetry will not diff between them as it assumes that the driver/firmware has reset the counter in between.

The driver should set a new connection ID after a successful connection, reconnection, or roaming attempt, as it's expected that the connection- related counters would reset on a new connection.

rx_unicast_total uint64
rx_unicast_drop uint64
rx_multicast uint64
tx_total uint64
tx_drop uint64

IfaceCounterStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

OrdinalFieldTypeDescription
connection_counters ConnectionCounters

Counters related to the current connection. May not be set if the client is not connected.

IfaceHistogramStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

OrdinalFieldTypeDescription
noise_floor_histograms vector<NoiseFloorHistogram>:8

Noise floor histogram(s).

rssi_histograms vector<RssiHistogram>:8

Received signal strength indicator (RSSI) histogram(s).

rx_rate_index_histograms vector<RxRateIndexHistogram>:8

Received rate index histogram(s).

snr_histograms vector<SnrHistogram>:8

Signal to noise ratio (SNR) histogram(s).

CONSTANTS

NameValueTypeDescription
MAX_HISTOGRAMS_PER_TYPE 8 uint8

For each histogram type (e.g. RSSI), there can be multiple histograms up to this limit. For example, an interface might have 1 histogram for station-wide RSSI, but also 1 for each of the antennas used by the interface.

MAX_NOISE_FLOOR_SAMPLES 255 uint8

All histograms have a fixed number of buckets. To save space, each histogram type uses a vector to hold only non-empty buckets (a sparse histogram), with these constants as the max size of each vector. Noise floor values range from -255 to -1 dBm.

MAX_RSSI_SAMPLES 255 uint8

RSSI values range from -255 to -1 dBm.

MAX_RX_RATE_INDEX_SAMPLES 196 uint8

Size of RxRateIndexHistogram lookup table (see comments in RxRateIndexHistogram).

MAX_SNR_SAMPLES 256 uint16

SNR values range from 0 to 255 dB.