fuchsia.wlan.common

對指定頻帶中 BSS 的觀測 RSSI 值進行調整。

新增：HEAD

欄位	類型	說明	預設
`band`	`fuchsia.wlan.ieee80211/WlanBand`		無預設值
`rssi_adjustment`	`int8`		無預設值

ScheduledScanPlan

掃描計畫會定義掃描疊代次數和掃描間隔。第一次掃描的時間 (例如 t=0、t=間隔等) 由韌體決定。

新增：HEAD

欄位	類型	說明	預設
`interval`	`uint32`	掃描間隔時間 (以秒為單位)。	無預設值
`iterations`	`uint32`	要掃描的疊代次數。如果設為 0，掃描計畫會無限期執行。	無預設值

WlanChannel

已移除：28

欄位	類型	預設
`primary`	`uint8`	無預設值
`cbw`	`ChannelBandwidth`	無預設值
`secondary80`	`uint8`	無預設值

WlanTxResult

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

移除：HEAD 新增：13

欄位	類型	說明	預設
`tx_result_entry`	`array<WlanTxResultEntry, 8>`	一個 PPDU 影格最多可有 8 個不同的 tx_result_entry。WLAN_TX_VECTOR_IDX_INVALID 表示沒有更多項目。	無預設值
`peer_addr`	`fuchsia.wlan.ieee80211/MacAddr`	目標 MAC 位址，或封包標頭中的 addr1。	無預設值
`result_code`	`WlanTxResultCode`		無預設值

WlanTxResultEntry

WlanTxResult 報表中的一個項目。表示在特定傳輸向量上嘗試傳輸的次數，但不代表傳輸成功。

移除：HEAD 新增：13

欄位	類型	說明	預設
`tx_vector_idx`	`uint16`		無預設值
`attempts`	`uint8`	使用這個特定 tx 向量的總嘗試次數，包括成功嘗試。DDK 假設每個封包的嘗試次數不會超過 255 次。(通常 <= 8)	無預設值

WlanWmmAccessCategoryParameters

WFA WMM v1.2、2.2.2

移除：HEAD 新增：13

欄位	類型	預設
`ecw_min`	`uint8`	無預設值
`ecw_max`	`uint8`	無預設值
`aifsn`	`uint8`	無預設值
`txop_limit`	`uint16`	無預設值
`acm`	`bool`	無預設值

WlanWmmParameters

移除：HEAD 新增：13

欄位	類型	預設
`apsd`	`bool`	無預設值
`ac_be_params`	`WlanWmmAccessCategoryParameters`	無預設值
`ac_bk_params`	`WlanWmmAccessCategoryParameters`	無預設值
`ac_vi_params`	`WlanWmmAccessCategoryParameters`	無預設值
`ac_vo_params`	`WlanWmmAccessCategoryParameters`	無預設值

列舉

BssType flexible

類型：uint32

移除：HEAD 新增：13

名稱	值	說明
不明	`0`
基礎架構	`1`
獨立	`2`
MESH	`3`
個人	`4`

ChannelBandwidth flexible

類型：uint32

移除：28 新增：13

名稱	值	說明
CBW20	`1`
CBW40	`2`
CBW40BELOW	`3`
CBW80	`4`
CBW160	`5`
CBW80P80	`6`

DataPlaneType flexible

類型：uint8

指出資料層的實作位置。

名稱	值	說明
ETHERNET_DEVICE	`1`
GENERIC_NETWORK_DEVICE	`2`

GuardInterval strict

類型：uint8

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

已移除：HEAD

名稱	值	說明
LONG_GI	`1`
SHORT_GI	`2`

MacImplementationType flexible

類型：uint8

指出 MAC 層的實作位置。

名稱	值	說明
SOFTMAC	`1`
FULLMAC	`2`

PowerSaveType strict

類型：uint32

名稱	值	說明
PS_MODE_ULTRA_LOW_POWER	`0`
PS_MODE_LOW_POWER	`1`
PS_MODE_BALANCED	`2`
PS_MODE_PERFORMANCE	`3`

ScanType strict

類型：uint32

名稱	值	說明
有效	`1`
被動	`2`

WlanKeyType 彈性

類型：uint8

移除：HEAD 新增：13

名稱	值	說明
PAIRWISE	`1`
GROUP	`2`
IGTK	`3`
同類頻道	`4`

WlanMacRole 彈性

類型：uint32

名稱	值	說明
用戶端	`1`
AP	`2`
MESH	`3`

WlanPhyType 彈性

類型：uint32

已移除：HEAD

名稱	值	說明
DSSS	`1`
HR	`2`
OFDM	`3`
企業資源規劃 (ERP)	`4`
HT	`5`
DMG	`6`
VHT	`7`
TVHT	`8`
S1G	`9`
CDMG	`10`
CMMG	`11`
HE	`12`

WlanSoftmacHardwareCapabilityBit strict

類型：uint32

已移除：HEAD

名稱	值	說明
SHORT_PREAMBLE	`32`
SPECTRUM_MGMT	`256`
QoS	`512`
SHORT_SLOT_TIME	`1024`
RADIO_MSMT	`4096`
SIMULTANEOUS_CLIENT_AP	`65536`

WlanTxResultCode 彈性

類型：uint8

封包傳輸結果。

移除：HEAD 新增：13

名稱	值	說明
失敗	`0`	未收到 ACK 或傳輸失敗。
成功	`1`	已收到對等互連的 ACK。

TABLES

ApfPacketFilterSupport

Android 封包篩選器 (APF) 支援。

新增：31

序數	欄位	類型	說明
1	`supported`	`bool`
2	`version`	`int32`	只有在「supported」為 true 時才有效。
3	`max_filter_length`	`int32`	只有在「supported」為 true 時才有效。

DataPlaneExtension

指出資料層的實作位置。這是 MAC 子層擴充功能，適用於 fullmac 或 softmac。這項擴充功能不屬於 802.11-2016 規格。

序數	欄位	類型	說明
1	`data_plane_type`	`DataPlaneType`

DeviceExtension

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

序數	欄位	類型	說明
1	`is_synthetic`	`bool`	表示裝置並非實體硬體裝置。這個擴充功能僅用於支援 fuchsia.hardware.ethernet/EthernetFeature 中的 SYNTH 值。
2	`mac_implementation_type`	`MacImplementationType`	指出 MAC 層的實作位置。
3	`tx_status_report_supported`	`bool`	指出裝置是否支援傳輸報告。

DfsFeature

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

序數	欄位	類型	說明
1	`supported`	`bool`	如果為 true，驅動程式庫會實作 DFS 程序 (例如偵測到雷達時清空管道)。根據驅動程式庫是否實作 DFS 程序，較高層可能會調整其邏輯 (例如納入/排除需要 DFS 的頻道)。

DiscoverySupport

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

已移除：HEAD

序數	欄位	類型	說明
1	`scan_offload`	`ScanOffloadExtension`
2	`probe_response_offload`	`ProbeResponseOffloadExtension`

JoinBssRequest

加入要求的輸入參數。softmac.fidl 和 wlantap.fidl 會共用這個定義。

移除：HEAD 新增：13

序數	欄位	類型
1	`bssid`	`fuchsia.wlan.ieee80211/MacAddr`
2	`bss_type`	`BssType`
3	`remote`	`bool`
4	`beacon_period`	`uint16`

MacSublayerSupport

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

序數	欄位	類型
1	`rate_selection_offload`	`RateSelectionOffloadExtension`
2	`data_plane`	`DataPlaneExtension`
3	`device`	`DeviceExtension`

MfpFeature

管理框架保護。請參閱 IEEE 802.11-2016 4.5.4.9。這是一項安全防護功能，適用於 fullmac 或 softmac。

序數	欄位	類型	說明
1	`supported`	`bool`

OweFeature

Opportunistic Wireless Encryption。請參閱 RFC 8110。這是一項安全防護功能，適用於 fullmac 或 softmac。

新增：31

序數	欄位	類型	說明
1	`supported`	`bool`

ProbeResponseOffloadExtension

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

已移除：HEAD

序數	欄位	類型	說明
1	`supported`	`bool`	如果為 true，驅動程式庫會回應探測要求；否則 MLME 必須回應。

RateSelectionOffloadExtension

指出費率選擇邏輯的協調位置和方式。請參閱 IEEE 802.11-2016 10.7。這是 MAC 子層擴充功能，預期僅用於 softmac。

序數	欄位	類型	說明
1	`supported`	`bool`	如果為 true，驅動程式庫會協調速率選擇；否則 MLME 必須執行這項操作。

RssiMonitorSupport

韌體 RSSI 門檻監控卸載支援。

新增：NEXT

序數	欄位	類型	說明
1	`supported`	`bool`

SaeFeature

Simultaneous Authentication of Equals。請參閱 IEEE 802.11-2016 12.4。這是一項安全防護功能，適用於 fullmac 或 softmac。

序數	欄位	類型	說明
1	`driver_handler_supported`	`bool`	SAE 可由驅動程式庫處理。
2	`sme_handler_supported`	`bool`	SAE 可由 SME 處理。
3	`hash_to_element_supported`	`bool`	指出驅動程式庫是否與 SAE 雜湊至元素相容。在 SME 處理常式案例中，這只是指傳遞具有 SAE_HASH_TO_ELEMENT 狀態碼的 SAE 框架。新增：30
4	`pmksa_caching_supported`	`bool`	指出驅動程式庫是否在 SAE 期間啟用 PMKSA 快取，如果是，則會在關聯要求的 RSNE 中附加新的 PMKID。新增：NEXT

ScanOffloadExtension

指出掃描邏輯的協調位置和方式。請參閱 IEEE 802.11-2016 11.1.4.2 和 11.1.4.3。這是探索擴充功能，預期僅用於 Softmac。

已移除：HEAD

序數	欄位	類型	說明
1	`supported`	`bool`	如果為 true，驅動程式庫會協調掃描作業；否則必須由 MLME 執行。
2	`scan_cancel_supported`	`bool`	新增：10

ScheduledScanMatchSet

排定掃描期間要比對的一組巢狀屬性。BSS 必須符合比對組合中的所有現有條件，才算相符。

由於並非所有硬體都支援比對所有類型的屬性，因此無法保證回報的 BSS 完全符合比對組合。如果驅動程式不支援比對組合，可能會傳回 EINVAL，或忽略比對條件。

新增：HEAD

序數	欄位	類型	說明
1	`ssid`	`fuchsia.wlan.ieee80211/Ssid`	(選用)
2	`bssid`	`fuchsia.wlan.ieee80211/MacAddr`	(選用)
3	`min_rssi_threshold`	`int8`	選用。要套用至所有 BSS 的 RSSI 門檻下限。
4	`relative_rssi_threshold`	`int8`	選用。RSSI 值差異，相對於目前連線 BSS 的 RSSI，以符合比對組合。可以為負值 (例如 -5 dB 表示觀測到的 BSS RSSI 不得低於目前的 RSSI - 5 dB)。如果目前未連線，系統會忽略這個欄位。
5	`band_rssi_adjustments`	`vector<BandRssiAdjustment>`	選用。在與最低和相對 RSSI 門檻比較前，對觀測到的 RSSI 值進行 RSSI 頻帶調整。

ScheduledScanRequest

要求排定掃描作業。

新增：HEAD

序數	欄位	類型	說明
1	`scan_plans`	`vector<ScheduledScanPlan>`	必要：一或多個掃描計畫，會連續執行。在某些韌體實作中，無論疊代欄位值為何，最後一個掃描計畫都可能無限期執行。
2	`ssids`	`vector<fuchsia.wlan.ieee80211/Ssid>`	選用。要掃描的 SSID (零或多個)。如有 SSID，應包含在探測要求中。如果出現空字串，則應在探測要求中傳送廣播 SSID。如果向量為空白或不存在，則只應執行被動掃描。
3	`frequencies`	`vector<uint32>`	選用。應掃描的管道頻率 (零或多個)。如果留空或不存在，系統會掃描法規網域的所有頻道。
4	`min_rssi_threshold`	`int8`	選用。要套用至所有 BSS 的 RSSI 門檻下限。
5	`relative_rssi_threshold`	`int8`	選用。RSSI 值差異，相對於目前連線 BSS 的 RSSI，以符合比對組合。可以為負值 (例如 -5 dB 表示觀測到的 BSS RSSI 不得低於目前的 RSSI - 5 dB)。如果目前未連線，系統會忽略這個欄位。
6	`band_rssi_adjustments`	`vector<BandRssiAdjustment>`	選用。在與最低和相對 RSSI 門檻比較前，對觀測到的 RSSI 值進行 RSSI 頻帶調整。
7	`match_sets`	`vector<ScheduledScanMatchSet>`	零或多組比對條件。如有提供，系統只會回報通過頂層 RSSI 門檻篩選器，且符合任一比對組合的 BSS。

SecuritySupport

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

序數	欄位	類型	說明
1	`sae`	`SaeFeature`
2	`mfp`	`MfpFeature`
3	`owe`	`OweFeature`	新增：31

SpectrumManagementSupport