Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

fuchsia.wlan.fullmac

新增：HEAD

通訊協定

WlanFullmacImpl

從平台到 fullmac 供應商驅動程式庫的通訊協定定義。

AssocResp

要求

名稱	類型
`payload`	`WlanFullmacImplAssocRespRequest`

回應

<EMPTY>

AuthResp

要求

名稱	類型
`payload`	`WlanFullmacImplAuthRespRequest`

回應

<EMPTY>

連線

要求

名稱	類型
`payload`	`WlanFullmacImplConnectRequest`

回應

<EMPTY>

Deauth

要求

名稱	類型
`payload`	`WlanFullmacImplDeauthRequest`

回應

<EMPTY>

Disassoc

要求

名稱	類型
`payload`	`WlanFullmacImplDisassocRequest`

回應

<EMPTY>

EapolTx

要求

名稱	類型
`payload`	`WlanFullmacImplEapolTxRequest`

回應

<EMPTY>

GetApfPacketFilterEnabled

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_GetApfPacketFilterEnabled_Result`

GetIfaceHistogramStats

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_GetIfaceHistogramStats_Result`

GetIfaceStats

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_GetIfaceStats_Result`

GetScheduledScanEnabled

傳回目前進行中排定掃描作業的交易 ID。

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_GetScheduledScanEnabled_Result`

GetSignalReport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_GetSignalReport_Result`

Init

初始化 FullMAC 驅動程式庫。這是平台向 FullMAC 驅動程式庫提出的第一個要求。

初始化時，MLME 會將用戶端端點提供給 WlanFullmacImplIfc 通訊協定。驅動程式必須傳回 SME 伺服器端管道，供平台內部使用。一般來說，SME 伺服器端管道會由 fuchsia.wlan.phy/WlanPhy.CreateIface 提供給 FullMAC 驅動程式庫程式。

如果 Init 成功完成，平台就會開始向 FullMAC 驅動程式庫發出其他 WlanFullmacImpl 要求，而 FullMAC 驅動程式庫則可向平台發出 WlanFullmacImplIfc 要求。平台可能會繼續提出 WlanFullmacImpl 要求，直到 WlanFullmacImpl 伺服器解除繫結為止。

常見錯誤包括：

ZX_ERR_ALREADY_BOUND：已在這個 FullMAC 驅動程式庫上呼叫 Init。

要求

名稱	類型
`payload`	`WlanFullmacImplInitRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_Init_Result`

InstallApfPacketFilter

安裝 APF 程式，並取代現有程式 (如有)。這個方法不會啟用計畫。

要求

名稱	類型
`payload`	`WlanFullmacImplInstallApfPacketFilterRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_InstallApfPacketFilter_Result`

OnLinkStateChanged

要求

名稱	類型
`payload`	`WlanFullmacImplOnLinkStateChangedRequest`

回應

<EMPTY>

查詢

傳回說明 FullMAC 驅動程式庫狀態的高階資訊。即使在呼叫 WlanFullmacImpl::Start 之前，也能安全呼叫。

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_Query_Result`

QueryApfPacketFilterSupport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_QueryApfPacketFilterSupport_Result`

QueryRssiMonitorSupport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_QueryRssiMonitorSupport_Result`

QuerySecuritySupport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_QuerySecuritySupport_Result`

QuerySpectrumManagementSupport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_QuerySpectrumManagementSupport_Result`

QueryTelemetrySupport

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_QueryTelemetrySupport_Result`

ReadApfPacketFilterData

擷取整個 APF 程式和工作記憶體緩衝區的一致快照，並傳回給主機。傳回的緩衝區包含程式碼和資料。長度必須與最近傳回的 QueryPacketFilterSupport().max_filter_length 相符。

擷取快照時，APF 解譯器不得執行，且所有傳入封包都必須傳遞至主機，就像未安裝 APF 程式一樣。

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_ReadApfPacketFilterData_Result`

重新連線

要求

名稱	類型
`payload`	`WlanFullmacImplReconnectRequest`

回應

<EMPTY>

Roam

嘗試漫遊，將關聯移至 ESS 內的其他 BSS。

要求

名稱	類型
`payload`	`WlanFullmacImplRoamRequest`

回應

<EMPTY>

SaeFrameTx

傳輸 SAE 驗證框架。

要求

名稱	類型
`frame`	`SaeFrame`

回應

<EMPTY>

SaeHandshakeResp

通知驅動程式庫 SAE 握手結果。

要求

名稱	類型
`payload`	`WlanFullmacImplSaeHandshakeRespRequest`

回應

<EMPTY>

SetApfPacketFilterEnabled

要求

名稱	類型
`payload`	`WlanFullmacImplSetApfPacketFilterEnabledRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_SetApfPacketFilterEnabled_Result`

SetKeys

設定連線的安全金鑰。通常會在成功交換金鑰後呼叫。

請注意，平台會假設驅動程式庫會在連線中斷或金鑰輪替時自動刪除金鑰。

要求

名稱	類型
`payload`	`WlanFullmacImplSetKeysRequest`

回應

名稱	類型
`resp`	`WlanFullmacSetKeysResp`

SetMacAddress

設定介面的 MAC 位址，可透過 Query() 方法擷取。如要重設為預設/原廠 MAC 位址，請使用 Query() 方法擷取 factory_addr，並將該值傳遞至這個方法。

要求

名稱	類型
`mac_addr`	`fuchsia.wlan.ieee80211/MacAddr`

回應

名稱	類型
`payload`	`WlanFullmacImpl_SetMacAddress_Result`

StartBss

要求

名稱	類型
`payload`	`WlanFullmacImplStartBssRequest`

回應

<EMPTY>

StartRssiMonitor

設定連線 RSSI 的監控門檻。

偵測到 RSSI 低於 min_rssi_dbm 或高於 max_rssi_dbm 時，WlanFullmacImplIfc::OnRssiThresholdBreached 會回報。

多次呼叫 StartRssiMonitor 會將監控門檻替換為最新提供的值。

呼叫 StopRssiMonitor 或連線中斷時，RSSI 監控會自動停止。

要求

名稱	類型
`payload`	`WlanFullmacImplStartRssiMonitorRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_StartRssiMonitor_Result`

StartScan

要求

名稱	類型
`payload`	`WlanFullmacImplStartScanRequest`

回應

<EMPTY>

StartScheduledScan

開始排定掃描。

要求

名稱	類型
`payload`	`WlanFullmacImplStartScheduledScanRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_StartScheduledScan_Result`

StopBss

要求

名稱	類型
`payload`	`WlanFullmacImplStopBssRequest`

回應

<EMPTY>

StopRssiMonitor

要求

<EMPTY>

回應

名稱	類型
`payload`	`WlanFullmacImpl_StopRssiMonitor_Result`

StopScheduledScan

停止排定的掃描作業。

如果傳回值表示成功，代表掃描作業已停止。驅動程式「不會」傳送 OnScheduledScanStoppedByFirmware 事件來回應這項呼叫。OnScheduledScanStoppedByFirmware 則保留給韌體啟動的停止或錯誤。

要求

名稱	類型
`payload`	`WlanFullmacImplStopScheduledScanRequest`

回應

名稱	類型
`payload`	`WlanFullmacImpl_StopScheduledScan_Result`

WmmStatusReq

要求

<EMPTY>

回應

<EMPTY>

名稱	類型
`status`	`zx/Result`
`wmm_params`	`fuchsia.wlan.driver/WlanWmmParameters`

欄位	類型	預設
`new_primary_channel`	`fuchsia.wlan.ieee80211/ChannelNumber`	無預設值
`bandwidth`	`fuchsia.wlan.ieee80211/ChannelBandwidth`	無預設值
`vht_secondary_80_channel`	`fuchsia.wlan.ieee80211/ChannelNumber`	無預設值

名稱	值	說明
成功	`0`
BSS_ALREADY_STARTED_OR_JOINED	`1`
RESET_REQUIRED_BEFORE_START	`2`
NOT_SUPPORTED	`3`

名稱	值	說明
成功	`0`
REFUSED_REASON_UNSPECIFIED	`1`
REFUSED_NOT_AUTHENTICATED	`2`
REFUSED_CAPABILITIES_MISMATCH	`3`
REFUSED_EXTERNAL_REASON	`4`
REFUSED_AP_OUT_OF_MEMORY	`5`
REFUSED_BASIC_RATES_MISMATCH	`6`
REJECTED_EMERGENCY_SERVICES_NOT_SUPPORTED	`7`
REFUSED_TEMPORARILY	`8`

名稱	值	說明
成功	`0`
REFUSED	`1`
ANTI_CLOGGING_TOKEN_REQUIRED	`2`
FINITE_CYCLIC_GROUP_NOT_SUPPORTED	`3`
已拒絕	`4`
FAILURE_TIMEOUT	`5`

名稱	值	說明
成功	`0`
NOT_SUPPORTED	`1`
INVALID_ARGS	`2`
INTERNAL_ERROR	`3`
SHOULD_WAIT	`4`
CANCELED_BY_DRIVER_OR_FIRMWARE	`5`

序數	欄位	類型	說明
1	`band`	`fuchsia.wlan.ieee80211/WlanBand`	這個表格的值適用於這個欄位中指定的頻帶。必填。
2	`basic_rates`	`vector<uint8>:12`	支援的基本速率，單位為 500 kbit/s (如 IEEE Std 802.11-2016, 9.4.2.3 所定義)，例如 0x02 代表 1 Mbps。這種類型傳回的值表示裝置支援傳輸和接收的所有非 HT 速率。必填。
3	`ht_caps`	`fuchsia.wlan.ieee80211/HtCapabilities`	HT PHY 模式功能。選用。如果沒有這個欄位，表示裝置不支援這個頻帶的 HT PHY 模式。
4	`vht_caps`	`fuchsia.wlan.ieee80211/VhtCapabilities`	VHT PHY 模式功能。選用。如果沒有這個欄位，表示裝置不支援這個頻帶的 VHT PHY 模式。
5	`primary_channels`	`vector<fuchsia.wlan.ieee80211/ChannelNumber>:256`	在建立 iface 時，根據裝置驅動程式庫程式已知的法規資訊，硬體認為有效的主要頻道清單。在這種情況下，主要管道是指 AP 可在目前法規網域中傳輸信標框架的管道。這份清單可用於判斷後續要求是否有效，以便使用 iface 掃描部分頻道，或判斷啟動 AP 時要使用哪個主要管道。必填。

序數	欄位	類型	說明
1	`peer_sta_address`	`fuchsia.wlan.ieee80211/MacAddr`	對等互連的 MAC 位址。必填。
2	`status_code`	`fuchsia.wlan.ieee80211/StatusCode`	這個 SAE 框架的狀態碼。必填。
3	`seq_num`	`uint16`	序號。必填。
4	`sae_fields`	`vector<uint8>`	包含影格主體中與 SAE 相關的欄位。詳情請參閱 IEEE Std 802.11-2016 表 9-35 和表 9-36。必填。

序數	欄位	類型
1	`peer_sta_address`	`fuchsia.wlan.ieee80211/MacAddr`
2	`result_code`	`WlanAssocResult`
3	`association_id`	`uint16`

序數	欄位	類型	說明
1	`selected_bss`	`fuchsia.wlan.ieee80211/BssDescription`
2	`connect_failure_timeout`	`uint32`	信標間隔中指定的逾時時間。
3	`auth_type`	`WlanAuthType`	驗證交換作業專用的其他參數。
4	`sae_password`	`vector<uint8>`	除非啟用 SAE_DRIVER_AUTH 且 auth_type 為 SAE，否則系統會忽略 sae_password。
5	`wep_key`	`fuchsia.wlan.driver/WlanKeyConfig`	驗證交換中使用的 WEP 金鑰。只有 WEP 安全性類型會填入這個欄位，否則這個欄位會留空。
6	`security_ie`	`vector<uint8>:257`	關聯廣告交易平台專用的其他參數。
7	`wep_key_desc`	`fuchsia.wlan.ieee80211/SetKeyDescriptor`	驗證交換中使用的 WEP 金鑰。只有 WEP 安全性類型會填入這個欄位，否則這個欄位會留空。
8	`owe_public_key`	`WlanFullmacOwePublicKey`	關聯期間用於 Diffie Hellman 交換的 OWE 公開金鑰。只有 OWE 安全性類型會填入這個欄位，否則這個欄位會留空。

序數	欄位	類型	說明
1	`peer_sta_address`	`fuchsia.wlan.ieee80211/MacAddr`
2	`reason_code`	`fuchsia.wlan.ieee80211/ReasonCode`

序數	欄位	類型
1	`src_addr`	`fuchsia.wlan.ieee80211/MacAddr`
2	`dst_addr`	`fuchsia.wlan.ieee80211/MacAddr`
3	`data`	`vector<uint8>`

序數	欄位	類型
1	`peer_sta_address`	`fuchsia.wlan.ieee80211/MacAddr`
2	`listen_interval`	`uint16`
3	`ssid`	`fuchsia.wlan.ieee80211/Ssid`
4	`rsne`	`vector<uint8>:257`
5	`vendor_ie`	`vector<uint8>:514`

序數	欄位	類型	說明
1	`peer_sta_address`	`fuchsia.wlan.ieee80211/MacAddr`	已取消關聯的對等互連位址。必填。
2	`reason_code`	`fuchsia.wlan.ieee80211/ReasonCode`	取消關聯的原因。必填。
3	`locally_initiated`	`bool`	解除關聯是否由裝置發起。必填。如果解除關聯是由裝置啟動 (例如韌體或供應商驅動程式庫啟動解除關聯)，則 locally_initiated 為 true；如果解除關聯是由外部啟動 (例如收到 AP 的解除關聯框架)，則為 false。

序數	欄位	類型	說明
1	`result_code`	`EapolTxResult`	傳輸結果。必填。
2	`dst_addr`	`fuchsia.wlan.ieee80211/MacAddr`	這個值對應到我們確認的 EapolTxRequest 中的 dst_addr。IEEE 802.11-2020 不含這個欄位，但如果有多個 EAPoL 握手正在進行，我們需要這個欄位來消除歧義。必填。

序數	欄位	類型	說明
1	`src_addr`	`fuchsia.wlan.ieee80211/MacAddr`	寄件者的地址。必填。
2	`dst_addr`	`fuchsia.wlan.ieee80211/MacAddr`	指定目的地的位址。必填。
3	`data`	`vector<uint8>`	EAPoL 框架資料的位元組。必填。

序數	欄位	類型	說明
1	`pmk`	`vector<uint8>`	成對主金鑰位元組。必填。
2	`pmkid`	`vector<uint8>`	PMK ID。必填。

序數	欄位	類型
1	`txn_id`	`uint64`
2	`timestamp_nanos`	`zx/Time`
3	`bss`	`fuchsia.wlan.ieee80211/BssDescription`

序數	欄位	類型	說明
1	`selected_bssid`	`fuchsia.wlan.ieee80211/MacAddr`	目標 BSS 的 BSSID。必填。
2	`status_code`	`fuchsia.wlan.ieee80211/StatusCode`	漫遊嘗試結果。必填。
3	`original_association_maintained`	`bool`	漫遊嘗試期間是否維持原始 BSS 關聯。必要。成功的漫遊一律會與原始 BSS 取消關聯，因此如果 `status_code` 成功，則必須將這個欄位設為 false；漫遊失敗通常會與原始 BSS 取消關聯，但在某些情況下可能不會 (例如在某些快速 BSS 轉換情境中)。
4	`target_bss_authenticated`	`bool`	用戶端是否已通過目標 BSS 驗證。如果 `status_code` 成功，則這個欄位必須設為 true；如果漫遊嘗試失敗，這個欄位可能為 true 或 false。這樣一來，較高層級就能決定如何在漫遊嘗試失敗後清除連線狀態。
5	`association_id`	`uint16`	與 AP 建立關聯的關聯 ID。如果 `status_code` 為 success，則為必要欄位。
6	`association_ies`	`vector<uint8>`	與 AP 建立關聯的 IE。如果 `status_code` 為 success，則為必要欄位。

序數	欄位	類型	說明
1	`keylist`	`vector<fuchsia.wlan.driver/WlanKeyConfig>:4`
2	`key_descriptors`	`vector<fuchsia.wlan.ieee80211/SetKeyDescriptor>:4`

序數	欄位	類型
1	`ssid`	`fuchsia.wlan.ieee80211/Ssid`
2	`bss_type`	`fuchsia.wlan.ieee80211/BssType`
3	`beacon_period`	`uint32`
4	`dtim_period`	`uint32`
5	`primary`	`fuchsia.wlan.ieee80211/ChannelNumber`
6	`rsne`	`vector<uint8>:257`
7	`vendor_ie`	`vector<uint8>:514`

序數	欄位	類型	說明
1	`txn_id`	`uint64`	專屬交易 ID (會顯示在對應的掃描結果中)。
2	`scan_type`	`WlanScanType`
3	`channels`	`vector<fuchsia.wlan.ieee80211/ChannelNumber>:256`	要掃描的頻道清單。如果頻道清單空白，掃描要求會立即傳回 OnScanEnd，並附上 INVALID_ARGS 程式碼。系統會忽略無效的管道號碼，管道號碼是否有效取決於目前的法規區域，而 FullMAC 驅動程式不一定能判斷區域設定。如果韌體會動態變更區域設定，就更可能發生這種情況。
4	`ssids`	`vector<fuchsia.wlan.ieee80211/Ssid>`	要掃描的 SSID 清單。空白的 SSID 清單等同於僅包含萬用字元 SSID 的清單。指定的 SSID 數量沒有上限。SSID 數量過多可能會導致掃描時間延長，因為硬體限制了每次掃描要求允許的 SSID 數量，且 IEEE 802.11-2016 的技術限制也將單一探測要求框架中的 SSID 數量限制為 ieee80211.SSID_LIST_MAX SSID。
5	`min_channel_time`	`uint32`	掃描期間在管道上花費的最短時間 (以毫秒為單位)。
6	`max_channel_time`	`uint32`	掃描期間在管道上花費的時間上限 (以毫秒為單位)。

序數	欄位	類型	說明
1	`txn_id`	`uint64`
2	`req`	`fuchsia.wlan.common/ScheduledScanRequest`

序數	欄位	類型	說明
1	`sta_addr`	`fuchsia.wlan.ieee80211/MacAddr`	目前的充電站地址。必填。
2	`role`	`fuchsia.wlan.common/WlanMacRole`	MAC 角色。必填。
3	`band_caps`	`vector<BandCapability>:16`	支援的頻帶。必填。
4	`factory_addr`	`fuchsia.wlan.ieee80211/MacAddr`	原廠 MAC 位址。必填。

序數	欄位	類型	說明
1	`rssi_dbm`	`int8`
2	`snr_db`	`int8`
3	`tx_rate_500kbps`	`uint32`	傳輸速率，單位為 500 kbit/s，這是 IEEE Std 802.11-2024 9.4.2.3 中支援速率的單位。
4	`rx_rate_500kbps`	`uint32`	接收速率，以 500 kbit/s 為單位。

序數	Variant	類型
1	`response`	`WlanFullmacImpl_GetApfPacketFilterEnabled_Response`
2	`err`	`zx/Status`
3	`framework_err`	`internal`

序數	Variant	類型	說明
1	`response`	`WlanFullmacImpl_GetIfaceStats_Response`
2	`err`	`zx/Status`

序數	Variant	類型	說明
1	`response`	`fuchsia.wlan.stats/SignalReport`
2	`err`	`zx/Status`

序數	Variant	類型	說明
1	`response`	`WlanFullmacImpl_Query_Response`
2	`err`	`zx/Status`

序數	Variant	類型	說明
1	`response`	`WlanFullmacImpl_SetMacAddress_Response`
2	`err`	`zx/Status`