STRUCTS
AntennaId
Defined in fuchsia.wlan.stats/wlan_stats.fidl
Identifier for antenna.
Field | Type | Description | Default |
---|---|---|---|
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.
Field | Type | Description | Default |
---|---|---|---|
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.
Field | Type | Description | Default |
---|---|---|---|
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).
Field | Type | Description | Default |
---|---|---|---|
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.
Field | Type | Description | Default |
---|---|---|---|
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).
Field | Type | Description | Default |
---|---|---|---|
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.
Name | Value | Description |
---|---|---|
ANTENNA_2_G |
1 |
2.4 GHz. |
ANTENNA_5_G |
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.
Name | Value | Description |
---|---|---|
STATION |
1 |
|
PER_ANTENNA |
2 |
TABLES
ConnectionCounters
Defined in fuchsia.wlan.stats/wlan_stats.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
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. |
2 |
rx_unicast_total |
uint64
|
|
3 |
rx_unicast_drop |
uint64
|
|
4 |
rx_multicast |
uint64
|
|
5 |
tx_total |
uint64
|
|
6 |
tx_drop |
uint64
|
IfaceCounterStats
Defined in fuchsia.wlan.stats/wlan_stats.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
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
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
noise_floor_histograms |
vector<NoiseFloorHistogram>:8
|
Noise floor histogram(s). |
2 |
rssi_histograms |
vector<RssiHistogram>:8
|
Received signal strength indicator (RSSI) histogram(s). |
3 |
rx_rate_index_histograms |
vector<RxRateIndexHistogram>:8
|
Received rate index histogram(s). |
4 |
snr_histograms |
vector<SnrHistogram>:8
|
Signal to noise ratio (SNR) histogram(s). |
CONSTANTS
Name | Value | Type | Description |
---|---|---|---|
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. |