Google is committed to advancing racial equity for Black communities. See how.

fuchsia.wlan.stats

STRUCTS

AntennaId

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Identifier for antenna.

NameTypeDescriptionDefault
freq AntennaFreq No default
index uint8

0 indexed antenna number of freq.

No default

ApMlmeStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
not_used PacketCounter No default

ClientMlmeStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
svc_msg PacketCounter No default
data_frame PacketCounter No default
mgmt_frame PacketCounter No default
tx_frame PacketCounter No default
rx_frame PacketCounter No default
assoc_data_rssi RssiStats No default
beacon_rssi RssiStats No default
noise_floor_histograms vector<NoiseFloorHistogram>[8]

Noise floor histogram(s).

No default
rssi_histograms vector<RssiHistogram>[8]

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

No default
rx_rate_index_histograms vector<RxRateIndexHistogram>[8]

Received rate index histogram(s).

No default
snr_histograms vector<SnrHistogram>[8]

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

No default

Counter

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
count uint64 No default
name string No default

DispatcherStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
any_packet PacketCounter No default
mgmt_frame PacketCounter No default
ctrl_frame PacketCounter No default
data_frame PacketCounter No default

HistBucket

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram bucket.

NameTypeDescriptionDefault
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

IfaceStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
dispatcher_stats DispatcherStats No default
mlme_stats MlmeStats? No default

NoiseFloorHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for noise floor samples.

NameTypeDescriptionDefault
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.

0

PacketCounter

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescriptionDefault
in Counter No default
out Counter No default
drop Counter No default
in_bytes Counter No default
out_bytes Counter No default
drop_bytes Counter No default

RssiHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for received signal strength indicator (RSSI).

NameTypeDescriptionDefault
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.

0

RssiStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

RssiStats count the occurrence of the RSSIs. RSSI value r's occurrence is counted in the bin[-r], where r is defined in [-128, 0] in dBm.

NameTypeDescriptionDefault
hist vector<uint64>[129] No default

RxRateIndexHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for received data rate.

NameTypeDescriptionDefault
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.

0

SnrHistogram

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Histogram for signal to noise ratio (SNR).

NameTypeDescriptionDefault
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

Type: uint8

Defined in fuchsia.wlan.stats/wlan_stats.fidl

Antenna frequency.

NameValueDescription
ANTENNA_2_G 1

2.4 GHz.

ANTENNA_5_G 2

5 GHz.

HistScope

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
STATION 1
PER_ANTENNA 2

UNIONS

MlmeStats

Defined in fuchsia.wlan.stats/wlan_stats.fidl

NameTypeDescription
client_mlme_stats ClientMlmeStats
ap_mlme_stats ApMlmeStats

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.

RSSI_BINS 129 uint8