STRUCTS
AntennaId
定義於 fuchsia.wlan.stats/wlan_stats.fidl
天線 ID。
| 欄位 | 類型 | 說明 | 預設 |
|---|---|---|---|
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 包含 bucket_index = 225 且 num_samples = 50 的 HistBucket，表示有 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 個影格的 SNR 為 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 彈性
類型：uint8
定義於 fuchsia.wlan.stats/wlan_stats.fidl
量表類型支援的統計資料。
| 名稱 | 值 | 說明 |
|---|---|---|
MIN |
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
|
接收速率，單位為 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，判斷目前的計數器和先前的計數器是否屬於同一個連線。如果計數器屬於兩個不同的連線，遙測不會區分兩者，因為系統會假設驅動程式庫/韌體已重設計數器。 驅動程式應在成功連線、重新連線或漫遊嘗試後設定新的連線 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
|
系統會為每項統計資料建立檢查時間序列。 |
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
|
指定應記錄到檢查時間序列的計數器 |
2 |
inspect_gauge_configs |
vector<InspectGaugeConfig>:127
|
指定應記錄到「檢查時間序列」的測量儀 |
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) 最多可有多個直方圖，舉例來說，介面可能會有 1 個直方圖用於全站 RSSI，但也會有 1 個直方圖用於介面使用的每個天線。 |
| 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 |