STRUCTS
AntennaId
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
天线的标识符。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
freq |
AntennaFreq
|
无默认应用 | |
index |
uint8
|
频率的从 0 开始编号的天线编号。 |
无默认应用 |
HistBucket
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
直方图存储桶。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
bucket_index |
uint16
|
每个直方图类型的对照表中的索引。每种类型的对照表在每种类型的注释中进行了说明。 |
无默认应用 |
num_samples |
uint64
|
存储桶中的样本数。 |
无默认应用 |
NoiseFloorHistogram
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
本底噪声样本的直方图。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
hist_scope |
HistScope
|
无默认应用 | |
antenna_id |
AntennaId?
|
如果 hist_scope 为 PER_ANTENNA，则必须提供 antenna_id。 |
无默认应用 |
noise_floor_samples |
vector<HistBucket>:255
|
当前信道本底噪声的稀疏直方图（以 dBm 为单位）。每个样本的 bucket_index 都是此 dBm 值列表中的索引：[-255, -254, … -1]。例如，如果 noise_floor_samples 包含一个 HistBucket，其中 bucket_index = 165 且 num_samples = 50，则表示有 50 个帧的本底噪声为 -90 dBm。 |
无默认应用 |
invalid_samples |
uint64
|
遇到的无效样本数量（如有）。 |
无默认应用 |
RssiHistogram
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
接收信号强度指示器 (RSSI) 的直方图。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
hist_scope |
HistScope
|
无默认应用 | |
antenna_id |
AntennaId?
|
如果 hist_scope 为 PER_ANTENNA，则必须提供 antenna_id。 |
无默认应用 |
rssi_samples |
vector<HistBucket>:255
|
AP 的 RSSI 稀疏直方图（以 dBm 为单位）。每个样本的 bucket_index 都是此 dBm 值列表中的索引：[-255, -254, … -1]。例如，如果 rssi_samples 包含一个 HistBucket，其中 bucket_index = 225 且 num_samples = 50，则表示有 50 帧的信号电平为 -30 dBm。 |
无默认应用 |
invalid_samples |
uint64
|
遇到的无效样本数量（如有）。 |
无默认应用 |
RxRateIndexHistogram
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
接收数据速率的直方图。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
hist_scope |
HistScope
|
无默认应用 | |
antenna_id |
AntennaId?
|
如果 hist_scope 为 PER_ANTENNA，则必须提供 antenna_id。 |
无默认应用 |
rx_rate_index_samples |
vector<HistBucket>:196
|
每个速率下接收到的帧数的稀疏直方图。每个样本的 bucket_index 都是此对照表中的索引： 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) 例如，如果 rx_rate_index_samples 包含一个 HistBucket，其中 bucket_index = 75 且 num_samples = 50，则表示有 50 个帧的速率对应于 N-MCS 15 (BW40:SGI)。 |
无默认应用 |
invalid_samples |
uint64
|
遇到的无效样本数量（如有）。 |
无默认应用 |
SnrHistogram
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
信噪比 (SNR) 直方图。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
hist_scope |
HistScope
|
无默认应用 | |
antenna_id |
AntennaId?
|
如果 hist_scope 为 PER_ANTENNA，则必须提供 antenna_id。 |
无默认应用 |
snr_samples |
vector<HistBucket>:256
|
以 dB 为单位的信噪比稀疏直方图。每个样本的 bucket_index 都是此 dB 值列表中的索引：[0, 1, … 255]。例如，如果 snr_samples 包含一个 HistBucket，其 value = 60 且 num_samples = 50，则表示有 50 帧的信噪比为 60 dB。 |
无默认应用 |
invalid_samples |
uint64
|
遇到的无效样本数量（如有）。 |
无默认应用 |
UnnamedCounter
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
id |
uint16
|
无默认应用 | |
count |
uint64
|
无默认应用 |
UnnamedGauge
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
id |
uint16
|
无默认应用 | |
value |
int64
|
无默认应用 |
枚举
AntennaFreq strict
类型：uint8
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
天线频率。
| 名称 | 值 | 说明 |
|---|---|---|
ANTENNA_2_G |
1 |
2.4 GHz。 |
ANTENNA_5_G |
2 |
5 GHz。 |
GaugeStatistic flexible
类型：uint8
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
Gauge 类型支持的统计信息。
| 名称 | 值 | 说明 |
|---|---|---|
下限 |
1 |
|
上限 |
2 |
|
SUM |
3 |
|
LAST |
4 |
|
MEAN |
5 |
HistScope strict
类型：uint8
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
直方图的范围，例如直方图是包含整个基站的数据，还是仅包含单个天线的数据。
| 名称 | 值 | 说明 |
|---|---|---|
电台 |
1 |
|
PER_ANTENNA |
2 |
TABLES
ConnectionSignalReport
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
primary |
fuchsia.wlan.ieee80211/ChannelNumber
|
|
2 |
tx_rate_500kbps |
uint32
|
|
3 |
rssi_dbm |
int8
|
|
4 |
snr_db |
int8
|
|
5 |
bandwidth |
fuchsia.wlan.ieee80211/ChannelBandwidth
|
|
6 |
vht_secondary_80_channel |
fuchsia.wlan.ieee80211/ChannelNumber
|
|
7 |
rx_rate_500kbps |
uint32
|
Rx 速率，单位为 500 kbit/s，这是 IEEE Std 802.11-2024 9.4.2.3 中支持的速率所用的单位。 可选。如果未设置，则 Rx 速率未知（例如，空闲或不受支持）。 |
ConnectionStats
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
connection_id |
uint8
|
当前连接的 ID。WLAN 遥测使用此值来确定当前计数器和之前的计数器是否属于同一连接。如果计数器属于两个不同的连接，遥测不会对它们进行差分，因为它会假设驱动程序/固件在此期间重置了计数器。 驱动程序应在成功连接、重新连接或漫游尝试后设置新的连接 ID，因为与连接相关的计数器应在建立新连接时重置。 |
2 |
driver_specific_counters |
vector<UnnamedCounter>:127
|
|
3 |
driver_specific_gauges |
vector<UnnamedGauge>:127
|
|
4 |
rx_unicast_total |
uint64
|
|
5 |
rx_unicast_drop |
uint64
|
|
6 |
rx_multicast |
uint64
|
|
7 |
tx_total |
uint64
|
|
8 |
tx_drop |
uint64
|
|
9 |
wme |
WmePacketStats
|
IfaceHistogramStats
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
noise_floor_histograms |
vector<NoiseFloorHistogram>:8
|
本底噪声直方图。 |
2 |
rssi_histograms |
vector<RssiHistogram>:8
|
接收信号强度指示器 (RSSI) 直方图。 |
3 |
rx_rate_index_histograms |
vector<RxRateIndexHistogram>:8
|
收到的速率指数直方图。 |
4 |
snr_histograms |
vector<SnrHistogram>:8
|
信噪比 (SNR) 直方图。 |
IfaceStats
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
connection_stats |
ConnectionStats
|
与当前连接相关的统计信息。如果客户端未连接，则可能无法设置。 |
2 |
driver_specific_counters |
vector<UnnamedCounter>:127
|
|
3 |
driver_specific_gauges |
vector<UnnamedGauge>:127
|
InspectCounterConfig
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
用于将特定于驱动程序的计数器 ID 与要在 Inspect 中使用的计数器名称相关联的配置。
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
counter_id |
uint16
|
|
2 |
counter_name |
string:127
|
InspectGaugeConfig
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
用于将特定于驱动程序的计量器 ID 与要在 Inspect 中使用的计量器名称相关联的配置。
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
gauge_id |
uint16
|
|
2 |
gauge_name |
string:127
|
|
3 |
statistics |
vector<GaugeStatistic>:5
|
系统会为每个统计信息创建一个 Inspect 时序。 |
PacketStats
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
rx |
uint64
|
|
2 |
tx |
uint64
|
|
3 |
tx_drop |
uint64
|
|
4 |
tx_retries |
uint64
|
SignalReport
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
connection_signal_report |
ConnectionSignalReport
|
与当前连接相关的信号报告。 如果客户端未连接，则可能无法设置。 |
TelemetrySupport
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
inspect_counter_configs |
vector<InspectCounterConfig>:127
|
指定应记录到 Inspect 时序中的计数器 |
2 |
inspect_gauge_configs |
vector<InspectGaugeConfig>:127
|
指定应记录到 Inspect 时序中的计量器 |
WmePacketStats
在 fuchsia.wlan.stats/wlan_stats.fidl 中定义
| 序数 | 字段 | 类型 | 说明 |
|---|---|---|---|
1 |
be |
PacketStats
|
|
2 |
bk |
PacketStats
|
|
3 |
vi |
PacketStats
|
|
4 |
vo |
PacketStats
|
常量
| 名称 | 值 | 类型 | 说明 |
|---|---|---|---|
| GAUGE_STATISTIC_MAX_LENGTH |
5
|
uint8 |
|
| MAX_DRIVER_SPECIFIC_COUNTERS |
127
|
uint32 |
|
| MAX_DRIVER_SPECIFIC_GAUGES |
127
|
uint32 |
|
| MAX_HISTOGRAMS_PER_TYPE |
8
|
uint8 |
对于每种直方图类型（例如 RSSI），最多可以有此数量的直方图。例如，一个接口可能有一个用于整个基站 RSSI 的直方图，但该接口使用的每个天线也可能有一个直方图。 |
| MAX_NOISE_FLOOR_SAMPLES |
255
|
uint8 |
所有直方图都具有固定数量的存储桶。为节省空间，每种直方图类型都使用一个向量来仅保存非空存储桶（稀疏直方图），并将这些常量作为每个向量的大小上限。本底噪声值范围为 -255 到 -1 dBm。 |
| MAX_RSSI_SAMPLES |
255
|
uint8 |
RSSI 值的范围为 -255 到 -1 dBm。 |
| MAX_RX_RATE_INDEX_SAMPLES |
196
|
uint8 |
RxRateIndexHistogram 查找表的大小（请参阅 RxRateIndexHistogram 中的注释）。 |
| MAX_SNR_SAMPLES |
256
|
uint16 |
SNR 值的范围为 0 到 255 dB。 |
| STAT_NAME_MAX_LENGTH |
127
|
uint8 |