fuchsia.wlan.common

新增：7

結構

DataPlaneExtension

定義於 fuchsia.wlan.common/driver_features.fidl

用於表示資料層的實作位置。 這是 MAC 子層擴充功能，適用於 fullmac 或 softmac。這個 並未包含在 802.11-2016 規格中。

欄位類型說明預設
data_plane_type DataPlaneType 無預設

DeviceExtension

定義於 fuchsia.wlan.common/driver_features.fidl

裝置專屬的功能資訊。 這是 MAC 子層擴充功能。這項額外資訊不屬於 802.11-2016 規格

欄位類型說明預設
is_synthetic bool

表示裝置不是實體的硬體裝置。僅限這個額外資訊 以支援 SYNTH 值 fuchsia.hardware.ethernet/EthernetFeature。

 無預設
mac_implementation_type MacImplementationType

用於指出 MAC 層的實作位置。

 無預設
tx_status_report_supported bool

指出裝置是否支援傳輸報告。

 無預設

DfsFeature

定義於 fuchsia.wlan.common/driver_features.fidl

動態頻率選擇。 請參閱 IEEE 802.11-2016 11.9。 這是頻譜管理功能，適用於 Fullmac 或 softmac。

欄位類型說明預設
supported bool

如果為 true，驅動程式庫會執行 DFS 程序 (例如在 偵測 RADAR)。視驅動程式庫是否實作 DFS 程序而定 或上層的層級可能會調整邏輯 (例如納入/排除管道) 需要 DFS 的應用程式)。

 無預設

DiscoverySupport

定義於 fuchsia.wlan.common/driver_features.fidl

與發現潛在 BSS 相關的功能。 請參閱 IEEE 802.11-2016 11.1.4.2 和 11.1.4.3。

欄位類型說明預設
scan_offload ScanOffloadExtension 無預設
probe_response_offload ProbeResponseOffloadExtension 無預設

MacSublayerSupport

定義於 fuchsia.wlan.common/driver_features.fidl

與 MAC 子層相關的功能 (MLME 下方)。 請參閱 IEEE 802.11-2016 10。

欄位類型說明預設
rate_selection_offload RateSelectionOffloadExtension 無預設
data_plane DataPlaneExtension 無預設
device DeviceExtension 無預設

MfpFeature

定義於 fuchsia.wlan.common/driver_features.fidl

。 請參閱 IEEE 802.11-2016 4.5.4.9。 這是安全性功能，適用於 Fullmac 或 softmac 一次。

欄位類型說明預設
supported bool 無預設

ProbeResponseOffloadExtension

定義於 fuchsia.wlan.common/driver_features.fidl

用於指出探測回應的位置和方式。 請參閱 IEEE 802.11-2016 11.1.4.3。 這是探索擴充功能，應僅適用於 softmac 專用。

欄位類型說明預設
supported bool

如果為 true，驅動程式庫會回應探測要求；否則 MLME 必須回應。

 無預設

RateSelectionOffloadExtension

定義於 fuchsia.wlan.common/driver_features.fidl

指出費率選擇邏輯的自動化調度管理位置和方式。 請參閱 IEEE 802.11-2016 10.7。 這是 MAC 子層擴充功能，應僅用於 softmac。

欄位類型說明預設
supported bool

如果為 true，驅動程式庫會協調費率選項。不然 MLME 也要如此。

 無預設

SaeFeature

定義於 fuchsia.wlan.common/driver_features.fidl

「等於」的同步驗證。 請參閱 IEEE 802.11-2016 12.4。 這是安全性功能，適用於 Fullmac 或 softmac 一次。

欄位類型說明預設
driver_handler_supported bool

可由驅動程式庫處理 SAE。

 無預設
sme_handler_supported bool

可由 SME 處理 SAE。

 無預設

ScanOffloadExtension

定義於 fuchsia.wlan.common/driver_features.fidl

指出掃描邏輯的自動化調度管理位置和方式。 請參閱 IEEE 802.11-2016 11.1.4.2 和 11.1.4.3。 這是探索擴充功能，應僅適用於 softmac 專用。

欄位類型說明預設
supported bool

如果為 true，驅動程式庫會自動化調度管理掃描作業。不然 MLME 也要如此。

 無預設
scan_cancel_supported bool
新增：10
 無預設

SecuritySupport

定義於 fuchsia.wlan.common/driver_features.fidl

與安全性 / 存取權控管和資料機密相關的功能。 請參閱 IEEE 802.11-2016 4.5.4 和 802.11-2016 12。

欄位類型說明預設
sae SaeFeature 無預設
mfp MfpFeature 無預設

SpectrumManagementSupport

定義於 fuchsia.wlan.common/driver_features.fidl

與頻譜管理相關的功能。 請參閱 IEEE 802.11-2016 4.5.5、11.8 和 11.9。

欄位類型說明預設
dfs DfsFeature 無預設

WlanChannel

定義於 fuchsia.wlan.common/wlan_common.fidl

欄位類型說明預設
primary uint8 無預設
cbw ChannelBandwidth 無預設
secondary80 uint8 無預設

WlanTxResult

定義於 fuchsia.wlan.common/wlan_common.fidl

最低心率選擇演算法會使用 TX 狀態報表 測試應使用 //src/connectivity/wlan/testing/hw-sim/src/lib.rs 中的預設值

新增：13

欄位類型說明預設
tx_result_entry [8]

單一 PPDU 影格最多 8 個不同的 tx_vector。 WLAN_TX_VECTOR_IDX_INVALID 表示已無任何項目。

 無預設
peer_addr fuchsia.wlan.ieee80211/MacAddr

目的地 mac 位址，或封包標頭中的 addr1。

 無預設
result_code WlanTxResultCode 無預設

WlanTxResultEntry

定義於 fuchsia.wlan.common/wlan_common.fidl

WlanTxResult 報告中的項目。表示在 特定 tx 向量，但並不表示傳輸成功。

新增：13

欄位類型說明預設
tx_vector_idx uint16 無預設
attempts uint8

此特定 tx 向量的總嘗試次數，包括成功的嘗試次數。 DDK 會假設每個封包的嘗試次數不超過 255 次。(通常小於 8)

 無預設

WlanWmmAccessCategoryParameters

定義於 fuchsia.wlan.common/associnfo.fidl

WFA WMM v1.2、2.2.2

新增：13

欄位類型說明預設
ecw_min uint8

指數形式的爭用期下限 cw_min = 2^(ecw_min) - 1。競爭視窗的單位為「運算單元時間」， (例如 9 微秒、13 微秒等)

 無預設
ecw_max uint8

指數形式的爭用期上限 cw_max = 2^(ecw_max) - 1。競爭視窗的單位為「運算單元時間」， (例如 9 微秒、13 微秒等)

 無預設
aifsn uint8

仲裁間間距編號 (傳送每個影格之間的等待時間)

 無預設
txop_limit uint16

以 32 微秒為單位的 TXOP 上限

 無預設
acm bool

是否強制要求入場

 無預設

WlanWmmParameters

定義於 fuchsia.wlan.common/associnfo.fidl

新增：13

欄位類型說明預設
apsd bool 無預設
ac_be_params WlanWmmAccessCategoryParameters 無預設
ac_bk_params WlanWmmAccessCategoryParameters 無預設
ac_vi_params WlanWmmAccessCategoryParameters 無預設
ac_vo_params WlanWmmAccessCategoryParameters 無預設

ENUMS

BssType 彈性

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

新增：13

名稱值說明
0
1
2
3
4

ChannelBandwidth 彈性

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

新增：13

名稱值說明
1
2
3
4
5
6

DataPlaneType 嚴格

類型：uint8

定義於 fuchsia.wlan.common/driver_features.fidl

用於表示資料層的實作位置。

名稱值說明
1
2

GuardInterval 嚴格

類型：uint8

定義於 fuchsia.wlan.common/wlan_common.fidl

HT 和 VHT 守衛間隔。 請參閱 IEEE 802.11-2016 表 19-1 和表 21-1。

名稱值說明
1
2

MacImplementationType 嚴格

類型：uint8

定義於 fuchsia.wlan.common/driver_features.fidl

用於指出 MAC 層的實作位置。

名稱值說明
1
2

PowerSaveType 嚴格

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
0
1
2
3

RequestStatus 嚴格

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
0
1
2
3
4

ScanType 嚴格

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
1
2

WlanBand 彈性

類型：uint8

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
0
1

WlanKeyType 彈性

類型：uint8

定義於 fuchsia.wlan.common/associnfo.fidl

新增：13

名稱值說明
1
2
3
4

WlanMacRole 彈性

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
1
2
3

WlanPhyType 彈性

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

支援不同 MCS 和酬載資料速率的 PHY 類型。 以 IEEE 802.11-2016/2020 附錄 C + 修訂條款中的 dot11PHYType 為基礎

名稱值說明
1

IEEE 802.11-2016 第 15 條： 直接序列散播頻譜 支援 1、2 Mbps。
2

IEEE 802.11-2016 第 16 條： 高費率 DSSS 支援 5.5、11 Mbps。 也稱為 ERP-CCK
3

IEEE 802.11a/g 或 IEEE 802.11-2016 第 17 條： 正對頻率劃分多工處理 支援 6、9、12、18、24、36、48 和 54 Mbps。
4

IEEE 802.11g 或 IEEE 802.11-2016 第 18 條： 延長率：PHY 支援 1、2、5.5、11、12、24 Mbps + 6、54 Mbps。 包含 DSSS/HR/OFDM 費率和調節。
5

IEEE 802.11n 或 IEEE 802.11-2016 第 19 條： 高處理量 PHY 最高支援 495 Mbps 的速率。
6

802.11ad 或 IEEE 802.11-2016 第 20 條： 定向多千兆位元 (PHY)
7

IEEE 802.11ac 或 IEEE 802.11-2016 第 21 條： 處理量極高 (PHY) 最高支援 6.9 Gbps。
8

IEEE 802.11af 或 IEEE 802.11-2016 第 22 條： 電視處理量極高 (PHY) 支援電視訊號最高 568.9 Mbps 的速率
9

IEEE 802.11ah 或 IEEE 802.11-2020 第 23 條： Sub 1 GHz (PHY)
10

IEEE 802.11aj 或 IEEE 802.11-2020 第 24 條： 中國定向多十億位元 PHY
11

IEEE 802.11aj 或 IEEE 802.11-2020 第 25 條： 中國毫米波多十億位元 PHY
12

IEEE 802.11ax：高效率 PHY 支援高達 9.6 Gbps (太棒了！) 的速率

WlanProtection 嚴格

類型：uint8

定義於 fuchsia.wlan.common/wlan_common.fidl

新增時間：HEAD

名稱值說明
0
1
2
3

WlanSoftmacHardwareCapabilityBit 嚴格

類型：uint32

定義於 fuchsia.wlan.common/wlan_common.fidl

名稱值說明
32

短封包前置碼。
256

頻譜管理。
512
1024

封包衝突後短運算單元時間。
4096

無線電測量。
65536

WlanTxResultCode 彈性

類型：uint8

定義於 fuchsia.wlan.common/wlan_common.fidl

封包傳輸結果。

新增：13

名稱值說明
0

未接收 ACK，或以其他方式傳送失敗。
1

已收到對等連線的 ACK。

資料表

JoinBssRequest

定義於 fuchsia.wlan.common/wlan_common.fidl

新增：13

Ordinal欄位類型說明
bssid fuchsia.wlan.ieee80211/MacAddr
bss_type BssType
remote bool
beacon_period uint16

WlanKeyConfig

定義於 fuchsia.wlan.common/wlan_common.fidl

新增時間：HEAD

Ordinal欄位類型說明
protection WlanProtection

要保護的路徑：None、TX、RX，或 TX 和 RX。
cipher_oui uint8[3]

IEEE 加密套件選取器。 請參閱 IEEE Std 802.11-2016, 9.4.2.25.2，表 9-131 選用。若未指定，系統會假設這是 IEEE OUI。
cipher_type fuchsia.wlan.ieee80211/CipherSuiteType

加密類型。 必填。
key_type WlanKeyType

這組金鑰是否為配對金鑰、群組金鑰或對等互連金鑰。 必填。
peer_addr fuchsia.wlan.ieee80211/MacAddr

配對金鑰和對等金鑰的對等互連 MAC 位址。 如果是群組鍵，這個值一律會是廣播位址。 必填。
key_idx uint8

輪替鍵的索引，例如。 對於不會輪替的金鑰類型，這個值一律為 0，例如。 必填。

TODO(https://fxbug.dev/301104836)：這是 uint8，但在 MLME FIDL 中則是 SetKeyDescriptor Fullmac FIDL 中的 DeleteKeysDescriptor 針對 key_id/key_idx 使用 uint16。我們應該考慮 因為這些元素都使用相同的類型
key vector<uint8>[32]

索引鍵的實際位元組。 必填。
rsc uint64

僅接收群組金鑰的序列計數器。 在所有其他情況下，RSC 都會是 0。 選用。

觀測站

名稱值類型說明
MAX_BANDS 16 uint8

這個常數定義了含有功能的陣列固定長度 裝置驅動程式庫支援的各款錶帶。
MAX_SUPPORTED_MAC_ROLES 16 uint8

此常數定義陣列的固定長度，對於包含 既有實體。
MAX_SUPPORTED_PHY_TYPES 64 uint8

此常數定義包含 PHY 類型之陣列的固定長度，為 既有實體。
WLAN_MAC_MAX_EXT_RATES 255 uint32
新增：13
WLAN_MAC_MAX_SUPP_RATES 8 uint32

只在關聯時定義的資訊 請注意每個欄位的細微解釋： 反映關聯中安全使用的參數 許多參數不會區分 Rx 能力與 Tx 能力。 在這些情況下，能力通常會同時套用至 Rx 和 Tx。 有些參數僅適用於 Rx，有些則是 Tx。

新增：13
WLAN_TX_RESULT_MAX_ENTRY 8 uint32
新增：13
WLAN_TX_VECTOR_IDX_INVALID 0 uint16

別名

名稱值說明
WlanSoftmacHardwareCapability uint32