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

表示裝置並非實際的硬體裝置。這項擴充功能只能用於支援 fuchsia.hardware.ethernet/EthernetFeature 的 SYNTH 值。

 無預設
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

SAE 可由 SME 處理。

 無預設

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

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

新增日期：13 張

廣闊類型說明預設
tx_result_entry [8]

最多 8 個 tx_vector 格式，用於一個 PPDU 影格。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 1.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

TXOP 限制 (單位為 32 微秒)

 無預設
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

防護間隔嚴格

類型：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 strict

類型：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

新增日期：13 張

名稱值說明
1
2
3

WlanPhyType 彈性

類型：uint32

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

支援不同 MCS 和酬載資料速率的 PHY 類型。根據 IEEE 802.11-2016/2020 Annex C + 修訂條款中的 dot11PHYType

新增日期：13 張

名稱值說明
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 條：中國方向性 Multi-Gigabit 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 張

序數廣闊類型說明
bssid fuchsia.wlan.ieee80211/MacAddr
bss_type BssType
remote bool
beacon_period uint16

WlanKeyConfig

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

已新增：HEAD

序數廣闊類型說明
protection WlanProtection

要保護的路徑：無、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。必填。
key vector<uint8>[32]

金鑰金鑰的實際位元組數。必填。
rsc uint64

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

業者

名稱值類型說明
MAX_BANDS 16 uint8

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

這個常數定義了陣列的固定長度，當中包含 PHY 實體支援的 MAC 角色。
MAX_SUPPORTED_PHY_TYPES 64 uint8

這個常數定義了含有 PHY 實體支援的 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