fuchsia.wlan.softmac

新增：15

PROTOCOLS

EthernetRx

在 fuchsia.wlan.softmac/softmac.fidl 定義

從橋接的 Wlansoftmac 傳送乙太網路訊框的通訊協定 安裝 wlansoftmac 驅動程式庫的元件。

實驗性

這個通訊協定是以外國函式介面 (FFI) 的形式實作 wlansoftmac 驅動程式庫和橋接器驅動程式庫之間的連線 透過 wlan-mlme 程式庫處理資料影格的效能。

新增時間：HEAD

轉移

要求

名稱類型
payload EthernetRxTransferRequest

回應

名稱類型
payload EthernetRx_Transfer_Result

EthernetTx

在 fuchsia.wlan.softmac/softmac.fidl 定義

將乙太網路框架從 wlansoftmac 驅動程式傳送至橋接器的通訊協定 wlansoftmac 驅動程式庫。

實驗性

這個通訊協定是以外國函式介面 (FFI) 的形式實作 wlansoftmac 驅動程式庫和橋接器驅動程式庫之間的連線 透過 wlan-mlme 程式庫處理資料影格的效能。

安全性

complete_borrowed_operation 欄位必須是該類型的函式指標 void ()(eth::BorrowedOperation<>, zx_status_t)，其中第一個引數 是 borrowed_operation 欄位的值

撥打 complete_borrowed_operation 將會撥號 eth::BorrowedOperation<>::Complete()，藉此釋放封包擁有權。這個 只能呼叫一次無法呼叫 complete_borrowed_operation 會流失記憶體，而重複呼叫則會導致使用釋放後記憶體。

新增時間：HEAD

轉移

要求

名稱類型
payload EthernetTxTransferRequest

回應

名稱類型
payload EthernetTx_Transfer_Result

WlanRx

在 fuchsia.wlan.softmac/softmac.fidl 定義

將 WLAN 影格從 wlansoftmac 驅動程式傳送至橋接器的通訊協定 wlansoftmac 驅動程式庫。

實驗性

這個通訊協定是以外國函式介面 (FFI) 的形式實作 wlansoftmac 驅動程式庫和橋接器驅動程式庫之間的連線 透過 wlan-mlme 程式庫處理資料影格的效能。

新增時間：HEAD

轉移

要求

名稱類型
payload WlanRxTransferRequest

回應

<空白>

WlanSoftmac

在 fuchsia.wlan.softmac/softmac.fidl 定義

WlanSoftmac 是由第三方驅動程式實作的 SDK 版本通訊協定。

新增：15

CancelScan

取消與 scan_id 對應的進行中的掃描作業。 其中 scan_id 是 StartPassiveScan() 或 StartActiveScan()。如果取消成功 伺服器很快就會呼叫 WlanSoftmacIfc.ScanComplete() scan_id。

裝置驅動程式庫表示支援使用 CancelScan() fuchsia.wlan.common/ScanOffloadExtension.scan_cancel_supported。

常見錯誤包括：

  • ZX_ERR_NOT_FOUND：scan_id 與進行中的掃描作業不相符。
  • ZX_ERR_NOT_SUPPORTED：伺服器不支援掃描取消功能。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseCancelScanRequest

回應

名稱類型
payload WlanSoftmacBase_CancelScan_Result

ClearAssociation

通知 MAC 和 PHY，說明對等互連已解除關聯。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseClearAssociationRequest

回應

名稱類型
payload WlanSoftmacBase_ClearAssociation_Result

DisableBeaconing

停用硬體信標。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_DisableBeaconing_Result

EnableBeaconing

啟用硬體信標。

信號功能已啟用，因此無法呼叫這個方法，因此 DisableBeaconing如果信標是

所有要求欄位皆為必填。

常見錯誤包括：

  • ZX_ERR_NOT_SUPPORTED：裝置不支援硬體信標。
  • ZX_ERR_INVALID_ARGS：裝置無法傳輸要求的 信標。
  • ZX_ERR_BAD_STATE：裝置已在發出信標。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseEnableBeaconingRequest

回應

名稱類型
payload WlanSoftmacBase_EnableBeaconing_Result

InstallKey

在傳輸或接收受保護的資料時安裝加密金鑰 相輔相成。

常見錯誤包括： ZX_ERR_INVALID_ARGS：提供的設定未指定有效的金鑰。 ZX_ERR_NOT_SUPPORTED：此裝置不支援指定的加密方式。

新增時間：HEAD

要求

名稱類型
payload WlanKeyConfiguration

回應

名稱類型
payload WlanSoftmacBase_InstallKey_Result

JoinBss

加入我們將參與的特定 BSS 活動。 無論我們是否代管或彙整 BSS，都適用這項規定 (以 JoinBssRequest 中的 remote 旗標表示)。 如果成功，裝置會切換到正確的管道，並執行 加入 BSS 時所需的任何內部篩選/時間作業。 對於用戶端 STA，這是驗證前的第一步。

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置不支援指定的 bss 設定。

新增時間：HEAD

要求

名稱類型
join_request fuchsia.wlan.common/JoinBssRequest

回應

名稱類型
payload WlanSoftmacBase_JoinBss_Result

NotifyAssociationComplete

通知裝置成功建立關聯並完成設定 參與該關聯所需的額外參數。

錯誤

常見錯誤包括：

  • ZX_ERR_BAD_STATE：裝置先前未收到這個 BSS 透過 WlanSoftmac.JoinBss。
新增時間：HEAD

要求

名稱類型
assoc_cfg WlanAssociationConfig

回應

名稱類型
payload WlanSoftmacBase_NotifyAssociationComplete_Result

查詢

取得裝置及其支援功能的一般資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_Query_Result

QueryDiscoverySupport

取得車站探索資訊 (例如掃描和 裝置支援的功能。您可以放心呼叫 即使 SoftMAC 尚未啟動

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryDiscoverySupport_Result

QueryMacSublayerSupport

取得裝置支援的 MAC 功能的相關資訊。這個 方法仍安全，即使 SoftMAC 尚未啟動也一樣。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryMacSublayerSupport_Result

QuerySecuritySupport

取得裝置支援安全性功能的相關資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySecuritySupport_Result

QuerySpectrumManagementSupport

取得頻譜使用方式的相關資訊 (例如DFS) 支援的功能 資料。即使 SoftMAC 沒有

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySpectrumManagementSupport_Result

QueueTx

將封包傳輸排入佇列。封包可能在 之間的錯誤。這項呼叫不會取得傳入的緩衝區擁有權 WlanTxPacket。

因無法將封包排入佇列等待傳送而產生的錯誤。 因此，OK 結果只表示封包已在佇列中，而「不是」 但延遲時間很長

新增：15

要求

名稱類型
packet WlanTxPacket

回應

名稱類型
payload WlanSoftmac_QueueTx_Result

SetChannel

設定主要電台管道，例如：回應管道切換事件 確認成功後，就會立即啟動管道切換程序。這可能會 影響傳輸中任何影格的傳輸率，也可能影響 幹擾進行中的掃描請求

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置無法切換到要求的管道。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseSetChannelRequest

回應

名稱類型
payload WlanSoftmacBase_SetChannel_Result

開始

向伺服器發出信號，說明 iface 已準備好傳送及接收 相輔相成。

用戶端提供下列引數：

  • ifc：WlanSoftmaIfc 伺服器的用戶端結束， 伺服器會使用這項資訊將事件傳送至用戶端。

伺服器會傳回 fuchsia.wlan.mlme/MLME 通訊協定的伺服器端。SME 。因此，這個管道適用於中小企業<->MLME 非常適用於內部微服務通訊

除非另有註明，否則只有在事後呼叫 WlanSoftmac 方法 成功呼叫 WlanSoftmac.Start

常見錯誤包括：

  • ZX_ERR_ALREADY_BOUND：已在此 softmac 上呼叫 Start。
新增：15

要求

名稱類型
ifc WlanSoftmacIfc

回應

名稱類型
payload WlanSoftmac_Start_Result

StartActiveScan

開始執行中的掃描作業。伺服器將提供掃描結果 做為 Beacon 或 Probe Response 頁框，則採用 WlanSoftmacIfc.Recv()。 完成後，伺服器會呼叫 WlanSoftmacIfc.ScanComplete() 與 StartActiveScan() 傳回的 scan_id 相同。

裝置驅動程式庫表示支援使用 StartActiveScan() fuchsia.wlan.common/ProbeRequestOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacStartActiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartActiveScan_Result

StartPassiveScan

開始被動掃描。伺服器將提供掃描結果 做為信標影格，並採用 WlanSoftmacIfc.Recv()。完成後 伺服器會呼叫 WlanSoftmacIfc.ScanComplete() StartPassiveScan() 傳回的相同 scan_id。

伺服器使用以下方式指出支援 StartPassiveScan() fuchsia.wlan.common/ScanOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseStartPassiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartPassiveScan_Result

停止

關閉正在執行的 softmac。 在 softmac 未執行時可以安全呼叫。

新增：15

要求

<空白>

回應

<空白>

UpdateWmmParameters

指出經修改的 Wi-Fi 多媒體 (WMM) 參數裝置 以及特定存取類別 (AC)

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseUpdateWmmParametersRequest

回應

名稱類型
payload WlanSoftmacBase_UpdateWmmParameters_Result

WlanSoftmacBase

在 fuchsia.wlan.softmac/softmac.fidl 定義

WlanSoftmacBase 是要組合成 WlanSoftmacBridge和WlanSoftmac。WlanSoftmacBase 包含所有方法 WlanSoftmacBridge 和 WlanSoftmac 具有共通點。 請勿直接實作 WlanSoftmacBase。

注意：所有方法都會使用 selector 屬性來保留序數 ，並且從 WlanSoftmac 遷移至此通訊協定。此為必要步驟 以維持 API 相容性

新增時間：HEAD

CancelScan

取消與 scan_id 對應的進行中的掃描作業。 其中 scan_id 是 StartPassiveScan() 或 StartActiveScan()。如果取消成功 伺服器很快就會呼叫 WlanSoftmacIfc.ScanComplete() scan_id。

裝置驅動程式庫表示支援使用 CancelScan() fuchsia.wlan.common/ScanOffloadExtension.scan_cancel_supported。

常見錯誤包括：

  • ZX_ERR_NOT_FOUND：scan_id 與進行中的掃描作業不相符。
  • ZX_ERR_NOT_SUPPORTED：伺服器不支援掃描取消功能。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseCancelScanRequest

回應

名稱類型
payload WlanSoftmacBase_CancelScan_Result

ClearAssociation

通知 MAC 和 PHY，說明對等互連已解除關聯。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseClearAssociationRequest

回應

名稱類型
payload WlanSoftmacBase_ClearAssociation_Result

DisableBeaconing

停用硬體信標。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_DisableBeaconing_Result

EnableBeaconing

啟用硬體信標。

信號功能已啟用，因此無法呼叫這個方法，因此 DisableBeaconing如果信標是

所有要求欄位皆為必填。

常見錯誤包括：

  • ZX_ERR_NOT_SUPPORTED：裝置不支援硬體信標。
  • ZX_ERR_INVALID_ARGS：裝置無法傳輸要求的 信標。
  • ZX_ERR_BAD_STATE：裝置已在發出信標。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseEnableBeaconingRequest

回應

名稱類型
payload WlanSoftmacBase_EnableBeaconing_Result

InstallKey

在傳輸或接收受保護的資料時安裝加密金鑰 相輔相成。

常見錯誤包括： ZX_ERR_INVALID_ARGS：提供的設定未指定有效的金鑰。 ZX_ERR_NOT_SUPPORTED：此裝置不支援指定的加密方式。

新增時間：HEAD

要求

名稱類型
payload WlanKeyConfiguration

回應

名稱類型
payload WlanSoftmacBase_InstallKey_Result

JoinBss

加入我們將參與的特定 BSS 活動。 無論我們是否代管或彙整 BSS，都適用這項規定 (以 JoinBssRequest 中的 remote 旗標表示)。 如果成功，裝置會切換到正確的管道，並執行 加入 BSS 時所需的任何內部篩選/時間作業。 對於用戶端 STA，這是驗證前的第一步。

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置不支援指定的 bss 設定。

新增時間：HEAD

要求

名稱類型
join_request fuchsia.wlan.common/JoinBssRequest

回應

名稱類型
payload WlanSoftmacBase_JoinBss_Result

NotifyAssociationComplete

通知裝置成功建立關聯並完成設定 參與該關聯所需的額外參數。

錯誤

常見錯誤包括：

  • ZX_ERR_BAD_STATE：裝置先前未收到這個 BSS 透過 WlanSoftmac.JoinBss。
新增時間：HEAD

要求

名稱類型
assoc_cfg WlanAssociationConfig

回應

名稱類型
payload WlanSoftmacBase_NotifyAssociationComplete_Result

查詢

取得裝置及其支援功能的一般資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_Query_Result

QueryDiscoverySupport

取得車站探索資訊 (例如掃描和 裝置支援的功能。您可以放心呼叫 即使 SoftMAC 尚未啟動

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryDiscoverySupport_Result

QueryMacSublayerSupport

取得裝置支援的 MAC 功能的相關資訊。這個 方法仍安全，即使 SoftMAC 尚未啟動也一樣。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryMacSublayerSupport_Result

QuerySecuritySupport

取得裝置支援安全性功能的相關資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySecuritySupport_Result

QuerySpectrumManagementSupport

取得頻譜使用方式的相關資訊 (例如DFS) 支援的功能 資料。即使 SoftMAC 沒有

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySpectrumManagementSupport_Result

SetChannel

設定主要電台管道，例如：回應管道切換事件 確認成功後，就會立即啟動管道切換程序。這可能會 影響傳輸中任何影格的傳輸率，也可能影響 幹擾進行中的掃描請求

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置無法切換到要求的管道。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseSetChannelRequest

回應

名稱類型
payload WlanSoftmacBase_SetChannel_Result

StartActiveScan

開始執行中的掃描作業。伺服器將提供掃描結果 做為 Beacon 或 Probe Response 頁框，則採用 WlanSoftmacIfc.Recv()。 完成後，伺服器會呼叫 WlanSoftmacIfc.ScanComplete() 與 StartActiveScan() 傳回的 scan_id 相同。

裝置驅動程式庫表示支援使用 StartActiveScan() fuchsia.wlan.common/ProbeRequestOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacStartActiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartActiveScan_Result

StartPassiveScan

開始被動掃描。伺服器將提供掃描結果 做為信標影格，並採用 WlanSoftmacIfc.Recv()。完成後 伺服器會呼叫 WlanSoftmacIfc.ScanComplete() StartPassiveScan() 傳回的相同 scan_id。

伺服器使用以下方式指出支援 StartPassiveScan() fuchsia.wlan.common/ScanOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseStartPassiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartPassiveScan_Result

UpdateWmmParameters

指出經修改的 Wi-Fi 多媒體 (WMM) 參數裝置 以及特定存取類別 (AC)

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseUpdateWmmParametersRequest

回應

名稱類型
payload WlanSoftmacBase_UpdateWmmParameters_Result

WlanSoftmacBridge

在 fuchsia.wlan.softmac/softmac.fidl 定義

WlanSoftmacBridge 是 wlansoftmac 驅動程式庫提供的通訊協定 加入橋接驅動程式庫。請勿導入這個通訊協定 由供應商驅動程式庫提供

新增：15

CancelScan

取消與 scan_id 對應的進行中的掃描作業。 其中 scan_id 是 StartPassiveScan() 或 StartActiveScan()。如果取消成功 伺服器很快就會呼叫 WlanSoftmacIfc.ScanComplete() scan_id。

裝置驅動程式庫表示支援使用 CancelScan() fuchsia.wlan.common/ScanOffloadExtension.scan_cancel_supported。

常見錯誤包括：

  • ZX_ERR_NOT_FOUND：scan_id 與進行中的掃描作業不相符。
  • ZX_ERR_NOT_SUPPORTED：伺服器不支援掃描取消功能。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseCancelScanRequest

回應

名稱類型
payload WlanSoftmacBase_CancelScan_Result

ClearAssociation

通知 MAC 和 PHY，說明對等互連已解除關聯。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseClearAssociationRequest

回應

名稱類型
payload WlanSoftmacBase_ClearAssociation_Result

DisableBeaconing

停用硬體信標。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_DisableBeaconing_Result

EnableBeaconing

啟用硬體信標。

信號功能已啟用，因此無法呼叫這個方法，因此 DisableBeaconing如果信標是

所有要求欄位皆為必填。

常見錯誤包括：

  • ZX_ERR_NOT_SUPPORTED：裝置不支援硬體信標。
  • ZX_ERR_INVALID_ARGS：裝置無法傳輸要求的 信標。
  • ZX_ERR_BAD_STATE：裝置已在發出信標。
新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseEnableBeaconingRequest

回應

名稱類型
payload WlanSoftmacBase_EnableBeaconing_Result

InstallKey

在傳輸或接收受保護的資料時安裝加密金鑰 相輔相成。

常見錯誤包括： ZX_ERR_INVALID_ARGS：提供的設定未指定有效的金鑰。 ZX_ERR_NOT_SUPPORTED：此裝置不支援指定的加密方式。

新增時間：HEAD

要求

名稱類型
payload WlanKeyConfiguration

回應

名稱類型
payload WlanSoftmacBase_InstallKey_Result

JoinBss

加入我們將參與的特定 BSS 活動。 無論我們是否代管或彙整 BSS，都適用這項規定 (以 JoinBssRequest 中的 remote 旗標表示)。 如果成功，裝置會切換到正確的管道，並執行 加入 BSS 時所需的任何內部篩選/時間作業。 對於用戶端 STA，這是驗證前的第一步。

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置不支援指定的 bss 設定。

新增時間：HEAD

要求

名稱類型
join_request fuchsia.wlan.common/JoinBssRequest

回應

名稱類型
payload WlanSoftmacBase_JoinBss_Result

NotifyAssociationComplete

通知裝置成功建立關聯並完成設定 參與該關聯所需的額外參數。

錯誤

常見錯誤包括：

  • ZX_ERR_BAD_STATE：裝置先前未收到這個 BSS 透過 WlanSoftmac.JoinBss。
新增時間：HEAD

要求

名稱類型
assoc_cfg WlanAssociationConfig

回應

名稱類型
payload WlanSoftmacBase_NotifyAssociationComplete_Result

查詢

取得裝置及其支援功能的一般資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_Query_Result

QueryDiscoverySupport

取得車站探索資訊 (例如掃描和 裝置支援的功能。您可以放心呼叫 即使 SoftMAC 尚未啟動

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryDiscoverySupport_Result

QueryMacSublayerSupport

取得裝置支援的 MAC 功能的相關資訊。這個 方法仍安全，即使 SoftMAC 尚未啟動也一樣。

注意：此方法的實作不得依附於回應 否則會有死結的風險。 wlansoftmac 驅動程式庫同步呼叫此方法 提供 fuchsia.hardware.ethernet/EthernetImpl.Query 方法。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QueryMacSublayerSupport_Result

QuerySecuritySupport

取得裝置支援安全性功能的相關資訊。 即使 SoftMAC 尚未啟動，此方法仍可安全呼叫。

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySecuritySupport_Result

QuerySpectrumManagementSupport

取得頻譜使用方式的相關資訊 (例如DFS) 支援的功能 資料。即使 SoftMAC 沒有

新增時間：HEAD

要求

<空白>

回應

名稱類型
payload WlanSoftmacBase_QuerySpectrumManagementSupport_Result

SetChannel

設定主要電台管道，例如：回應管道切換事件 確認成功後，就會立即啟動管道切換程序。這可能會 影響傳輸中任何影格的傳輸率，也可能影響 幹擾進行中的掃描請求

常見錯誤包括：
ZX_ERR_NOT_SUPPORTED：裝置無法切換到要求的管道。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseSetChannelRequest

回應

名稱類型
payload WlanSoftmacBase_SetChannel_Result

SetEthernetStatus

將包含 ETHERNET_STATUS_* 標記的狀態轉送至 擁有 fuchsia.hardware.ethernet/EthernetImplIfc 個 Proxy wlansoftmac 的 C++ 部分執行即可

如上所述，status 的值是由 ETHERNET_STATUS_* 旗標。不過，實際上 ETHERNET_STATUS_ONLINE，且沒有定義 不要指定任何旗標在實務上，0x1 表示狀態有所提升。 0x0 則代表狀態下降。

雖然這個方法應屬於 「EthernetImplIfcBridge 通訊協定」包含在 WlanSoftmacBridge 通訊協定。wlansoftmac 驅動程式庫 最終會透過 fuchsia.hardware.ethernet/EthernetImplIfc 並使用 fuchsia.hardware.network.driver/NetworkDeviceIfc Proxy。屆時，此方法應當 重構為獨立的橋接器

新增時間：HEAD

要求

名稱類型
status uint32

回應

<空白>

開始

向伺服器發出信號，說明 iface 已準備好傳送及接收 相輔相成。

用戶端提供下列引數：

  • ifc_bridge：WlanSoftmacIfcBridge 伺服器的用戶端結束， wlansoftmac驅動程式庫會使用將 WlanSoftmacIfc 事件轉送至 橋接驅動程式庫
  • ethernet_tx：ethernet_tx_t* 已投放到 uint64。 ethernet_tx_t 定義於 //src/connectivity/wlan/drivers/wlansoftmac/rust_driver/c-binding/bindings.h。
  • wlan_rx：wlan_rx_t* 已投放到 uint64。 wlan_rx_t 定義於 //src/connectivity/wlan/drivers/wlansoftmac/rust_driver/c-binding/bindings.h。

伺服器必須在下列時間之前複製 ethernet_tx_t 和 wlan_rx_t 的內容： 使用這個方法ethernet_tx_t* 和 wlan_rx_t* 的生命週期只是 就會呼叫此方法，但 ethernet_tx_t 和 wlan_rx_t 的內容 持續運作，直到伺服器停止 MLME 為止

伺服器會傳回 fuchsia.wlan.mlme/MLME 通訊協定的伺服器端。SME 。因此，這個管道適用於中小企業<->MLME 非常適用於內部微服務通訊

WlanSoftmacBridge.Start 方法與 WlanSoftmac.Start 不同 有兩個原因首先，傳輸的驅動程式不存在 Rust 繫結 因此 WlanSoftmacIfcBridge 通訊協定必須事先傳輸至 Zircon 可透過橋接驅動程式庫使用。其次，Zircon 傳輸元件 延遲時間非常長因此， ethernet_tx 和 wlan_rx 引數可提供 wlansoftmac 驅動程式庫的 FFI 傳送 WLAN 封包，並接收 WLAN 封包 延遲時間不等於或優於驅動程式傳輸通訊協定。

除非另有註明，否則只有在事後呼叫 WlanSoftmacBridge 方法 成功呼叫 WlanSoftmacBridge.Start

常見錯誤包括：

  • ZX_ERR_ALREADY_BOUND：已在此 softmac 上呼叫 Start。
新增時間：HEAD

要求

名稱類型
ifc_bridge WlanSoftmacIfcBridge
ethernet_tx uint64
wlan_rx uint64

回應

名稱類型
payload WlanSoftmacBridge_Start_Result

StartActiveScan

開始執行中的掃描作業。伺服器將提供掃描結果 做為 Beacon 或 Probe Response 頁框，則採用 WlanSoftmacIfc.Recv()。 完成後，伺服器會呼叫 WlanSoftmacIfc.ScanComplete() 與 StartActiveScan() 傳回的 scan_id 相同。

裝置驅動程式庫表示支援使用 StartActiveScan() fuchsia.wlan.common/ProbeRequestOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacStartActiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartActiveScan_Result

StartPassiveScan

開始被動掃描。伺服器將提供掃描結果 做為信標影格，並採用 WlanSoftmacIfc.Recv()。完成後 伺服器會呼叫 WlanSoftmacIfc.ScanComplete() StartPassiveScan() 傳回的相同 scan_id。

伺服器使用以下方式指出支援 StartPassiveScan() fuchsia.wlan.common/ScanOffloadExtension.supported。

常見錯誤包括： ZX_ERR_INVALID_ARGS：裝置無法執行 要求掃描作業，例如因為所要求的管道不相容。 ZX_ERR_UNAVAILABLE：裝置目前無法執行掃描。 ZX_ERR_SHOULD_WAIT：還有其他掃描作業正在進行中。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseStartPassiveScanRequest

回應

名稱類型
payload WlanSoftmacBase_StartPassiveScan_Result

UpdateWmmParameters

指出經修改的 Wi-Fi 多媒體 (WMM) 參數裝置 以及特定存取類別 (AC)

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacBaseUpdateWmmParametersRequest

回應

名稱類型
payload WlanSoftmacBase_UpdateWmmParameters_Result

WlanSoftmacIfc

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

NotifyScanComplete

與專屬「scan_id」相關聯的掃描作業完成執行完畢。status 會指出掃描是否順利完成、因錯誤失敗而失敗 或是已取消

傳回狀態表示掃描完成的原因： ZX_OK：已成功掃描所有頻道。 ZX_ERR_CANCELLED：使用者要求終止掃描作業， 明確的 WlanSoftmac.CancelScan() 或 不相容的要求 (例如連線)。 ZX_ERR_OUT_OF_RANGE：掃描請求包含禁止的管道。 這可能是因為目前的國家/地區設定所致。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacIfcBaseNotifyScanCompleteRequest

回應

<空白>

接球

轉送透過無線媒介接收的封包。

要求

名稱類型
packet WlanRxPacket

回應

<空白>

ReportTxResult

回報嘗試傳輸作業的結果。

裝置驅動程式庫表示支援使用 ReportTxResult() fuchsia.wlan.common/DeviceExtension.report_tx_result_supported。

新增時間：HEAD

要求

名稱類型
tx_result fuchsia.wlan.common/WlanTxResult

回應

<空白>

WlanSoftmacIfcBase

在 fuchsia.wlan.softmac/softmac.fidl 定義

此通訊協定包含 WlanSoftmacIfc 和 WlanSoftmacIfcBridge 通用方法。

WlanSoftmacIfc 和 WlanSoftmacIfcBridge 通訊協定具有通用方法，如後者 一般會轉送 wlansoftmac 驅動程式庫收到的 WlanSoftmacIfc 要求 橋接驅動程式庫中的 WlanSoftmacIfcBridge 要求。撰寫此項目 將通訊協定轉換為 WlanSoftmacIfc 和 WlanSoftmacIfcBridge，以盡量減少方法的重複情形 定義 (以及因重複造成的相關要求轉換)。

這個通訊協定不會由任何元件直接實作，組成範圍為 WlanSoftmacIfc 和 WlanSoftmacIfcBridge。

新增時間：HEAD

NotifyScanComplete

與專屬「scan_id」相關聯的掃描作業完成執行完畢。status 會指出掃描是否順利完成、因錯誤失敗而失敗 或是已取消

傳回狀態表示掃描完成的原因： ZX_OK：已成功掃描所有頻道。 ZX_ERR_CANCELLED：使用者要求終止掃描作業， 明確的 WlanSoftmac.CancelScan() 或 不相容的要求 (例如連線)。 ZX_ERR_OUT_OF_RANGE：掃描請求包含禁止的管道。 這可能是因為目前的國家/地區設定所致。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacIfcBaseNotifyScanCompleteRequest

回應

<空白>

ReportTxResult

回報嘗試傳輸作業的結果。

裝置驅動程式庫表示支援使用 ReportTxResult() fuchsia.wlan.common/DeviceExtension.report_tx_result_supported。

新增時間：HEAD

要求

名稱類型
tx_result fuchsia.wlan.common/WlanTxResult

回應

<空白>

WlanSoftmacIfcBridge

在 fuchsia.wlan.softmac/softmac.fidl 定義

將 WlanSoftmacIfc 要求從 wlansoftmac 驅動程式庫傳輸至的通訊協定 橋接驅動程式庫

這個通訊協定應一律在 HEAD 中使用，因為該通訊協定是僅限樹狀結構內的通訊協定。 只有這個通訊協定無法在 Rust 中實作，且必須與 wlansoftmac-c、wlansoftmac-rust 和 wlan-mlme Rust Crate。

新增時間：HEAD

NotifyScanComplete

與專屬「scan_id」相關聯的掃描作業完成執行完畢。status 會指出掃描是否順利完成、因錯誤失敗而失敗 或是已取消

傳回狀態表示掃描完成的原因： ZX_OK：已成功掃描所有頻道。 ZX_ERR_CANCELLED：使用者要求終止掃描作業， 明確的 WlanSoftmac.CancelScan() 或 不相容的要求 (例如連線)。 ZX_ERR_OUT_OF_RANGE：掃描請求包含禁止的管道。 這可能是因為目前的國家/地區設定所致。

新增時間：HEAD

要求

名稱類型
payload WlanSoftmacIfcBaseNotifyScanCompleteRequest

回應

<空白>

ReportTxResult

回報嘗試傳輸作業的結果。

裝置驅動程式庫表示支援使用 ReportTxResult() fuchsia.wlan.common/DeviceExtension.report_tx_result_supported。

新增時間：HEAD

要求

名稱類型
tx_result fuchsia.wlan.common/WlanTxResult

回應

<空白>

StopBridgedDriver

關閉橋接器。

呼叫這個方法會同時造成此通訊協定的伺服器端 (WlanSoftmacIfcBridge) 關閉，且用戶端 WlanSoftmacBridge 可關閉。伺服器不會傳回 此方法的回應，直到處理所有排入佇列的事件之後。

實際操作時，wlansoftmac 驅動程式庫會在解除繫結時呼叫此方法。

新增時間：HEAD

要求

<空白>

回應

<空白>

WlanTx

在 fuchsia.wlan.softmac/softmac.fidl 定義

從橋接的 WLANmac 傳送 WLAN 影格的通訊協定 安裝 wlansoftmac 驅動程式庫的元件。

實驗性

這個通訊協定是以外國函式介面 (FFI) 的形式實作 wlansoftmac 驅動程式庫和橋接器驅動程式庫之間的連線 透過 wlan-mlme 程式庫處理資料影格的效能。

新增時間：HEAD

轉移

要求

名稱類型
payload WlanTxTransferRequest

回應

名稱類型
payload WlanTx_Transfer_Result

結構

EthernetRx_Transfer_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

EthernetTx_Transfer_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanRxInfo

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

欄位類型說明預設
rx_flags WlanRxInfoFlags

接收標記。這些屬性代表布林標記，而不是列舉或價值型資訊， 如下所示。值應從 WLAN_RX_INFO_FLAGS_* 列舉中取得。

 無預設
valid_fields WlanRxInfoValid

指出以下哪些欄位是這個結構體的有效位元遮罩。保留的旗標 必須為零。

 無預設
phy fuchsia.wlan.common/WlanPhyType

裝置作業進行時的 PHY 格式。

 無預設
data_rate uint32

裝置的資料速率，以每秒 0.5 Mb 為單位。

 無預設
channel fuchsia.wlan.common/WlanChannel

裝置作業執行時的版本，必須加入此欄位。

 無預設
mcs uint8

作業執行時的裝置模組和編碼配置索引。視情況而定 並採用 PHY 格式和管道寬度

 無預設
rssi_dbm int8

已收到訊號強度指標。

 無預設
snr_dbh int16

訊號至雜訊比率，以 0.5 dB 為單位。

 無預設

WlanRxPacket

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

欄位類型說明預設
mac_frame vector<uint8> 無預設
info WlanRxInfo 無預設

WlanSoftmacBase_CancelScan_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_ClearAssociation_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_DisableBeaconing_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_EnableBeaconing_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_InstallKey_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_JoinBss_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_NotifyAssociationComplete_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_QueryDiscoverySupport_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
resp fuchsia.wlan.common/DiscoverySupport 無預設

WlanSoftmacBase_QueryMacSublayerSupport_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
resp fuchsia.wlan.common/MacSublayerSupport 無預設

WlanSoftmacBase_QuerySecuritySupport_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
resp fuchsia.wlan.common/SecuritySupport 無預設

WlanSoftmacBase_QuerySpectrumManagementSupport_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
resp fuchsia.wlan.common/SpectrumManagementSupport 無預設

WlanSoftmacBase_SetChannel_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBase_UpdateWmmParameters_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmacBridge_Start_Response 資源

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
sme_channel handle<channel> 無預設

WlanSoftmac_QueueTx_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

WlanSoftmac_Start_Response 資源

在 fuchsia.wlan.softmac/softmac.fidl 定義

欄位類型說明預設
sme_channel handle<channel> 無預設

WlanTxInfo

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

欄位類型說明預設
tx_flags uint32

傳送標記。這些代表布林值選項，而非列舉或其他以價值為準 相關資訊，詳見下方說明。值應從 WLAN_TX_INFO_FLAGS_* 列舉中取得。

 無預設
valid_fields uint32

指出以下哪些欄位是這個結構體的有效位元遮罩。保留的旗標 必須為零。對於未以標記標示的欄位，您可以自行決定 開啟 softmac 驅動程式庫

 無預設
tx_vector_idx uint16 無預設
phy fuchsia.wlan.common/WlanPhyType 無預設
channel_bandwidth fuchsia.wlan.common/ChannelBandwidth 無預設
mcs uint8

這個封包的調節和編碼配置索引。視 PHY 格式和 管道寬度。

 無預設

WlanTxPacket

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

欄位類型說明預設
mac_frame vector<uint8> 無預設
info WlanTxInfo

傳送封包所需的額外資料。 TODO(https://fxbug.dev/42056823)：iwlwifi 忽略此欄位。

 無預設

WlanTx_Transfer_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

<空白>

ENUMS

WlanProtection 嚴格

類型：uint8

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

名稱值說明
0
1
2
3

資料表

EthernetRxTransferRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
packet_address uint64
packet_size uint64

EthernetTxTransferRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
packet_address uint64
packet_size uint64
async_id uint64
borrowed_operation uint64
complete_borrowed_operation uint64

WlanAssociationConfig

在 fuchsia.wlan.softmac/softmac.fidl 定義

要做為單一引數傳遞的引數資料表 WlanSoftmac.NotifyAssociationComplete. 這裡所有的資訊僅供 指定的 peer_addr 即可 除非另有說明，否則這個表中的所有欄位皆為必填。

新增：15

Ordinal欄位類型說明
bssid fuchsia.wlan.ieee80211/MacAddr

我們現在與對等點相關聯的 MAC 位址。
aid uint16

此特定關聯的專屬 ID。這個名稱與 有效連結，不一定是歷史資料。
listen_interval uint16
channel fuchsia.wlan.common/WlanChannel

我們與此同儕相關聯的頻道。
qos bool

QoS 功能與參數
wmm_params fuchsia.wlan.common/WlanWmmParameters

WFA WMM v1.2、2.2.2
rates vector<uint8>[263]

SupportRates 和 ExtendedSupportedRates 的串連 IEEE Std 802.11-2016, 9.4.2.3 &9.4.2.13
capability_info uint16

IEEE Std 802.11-2016, 9.4.1.4
ht_cap fuchsia.wlan.ieee80211/HtCapabilities

IEEE Std 802.11-2016, 9.4.2.56, 57 支援的 MCS 組合欄位中的 Rx MCS 位元遮罩代表 MCS 的一組 視這部裝置的 Tx 能力而定，對等互連可從這部裝置接收。
ht_op fuchsia.wlan.ieee80211/HtOperation
vht_cap fuchsia.wlan.ieee80211/VhtCapabilities

IEEE Std 802.11-2016, 9.4.2.158, 159
vht_op fuchsia.wlan.ieee80211/VhtOperation

WlanKeyConfiguration

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

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
cipher_type uint8
key_type fuchsia.wlan.common/WlanKeyType

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

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

輪替鍵的索引，例如。 對於不會輪替的金鑰類型，這個值一律為 0，例如。
key vector<uint8>[32]
rsc uint64

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

WlanRxTransferRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
packet_address uint64
packet_size uint64
packet_info WlanRxInfo
async_id uint64
arena uint64

WlanSoftmacBandCapability

在 fuchsia.wlan.softmac/softmac.fidl 定義

說明特定錶帶上的 SoftMAC 功能。

新增：15

Ordinal欄位類型說明
band fuchsia.wlan.common/WlanBand

本資料圖描述的功能適用的錶帶。
basic_rate_count uint8

支援的基本費率數量，如果 basic_rate_list 欄位是 則必須包含此欄位，且必須 與 basic_rate_list 欄位一致

淘汰

這個欄位已由 basic_rates 取代。伺服器 (即驅動程式) 指定平台版本，但 basic_rate_count 已淘汰 應省略此值，並將基本費率寫入 basic_rates 欄位。 用戶端嘗試在 basic_rate_count 之前讀取 basic_rates。

已淘汰：15
basic_rate_list uint8[12]

支援的基本費率，以 500 Kbit/秒為單位 (如 IEEE 所定義)。 Std 802.11-2016, 9.4.2.3)，例如0x02 代表 1 Mbps。這組 代表裝置同時支援的所有非 HT 費率 傳輸與接收。

這個欄位中顯示的費率數量必須與 basic_rate_count 欄位 (如有)。

淘汰

這個欄位已由 basic_rates 取代。伺服器 (即驅動程式) 指定平台版本，但 basic_rate_list 已淘汰 應省略此值，並將基本費率寫入 basic_rates 欄位。 用戶端嘗試在 basic_rate_list 之前讀取 basic_rates。

已淘汰：15
ht_supported bool

決定用戶端是否應讀取 ht_caps 欄位。如果 裝置支援 HT PHY 模式，因此 ht_supported 必須為 true， 「必須」設定 ht_caps 欄位並提供說明 HT 的資料 即便沒有技術背景，也能因這些工具的功能而受益這些欄位的任何其他設定 裝置「不」支援 HT PHY 模式。詳情請參閱 HtCapabilities。

淘汰

這個欄位會決定 ht_caps 欄位是否讀取 用戶端，但並非絕對必要，例如 ht_caps 等表格欄位 。目標平台的伺服器 (即驅動程式) ht_supported 已淘汰的版本應一律設定 欄位設為 true，ht_caps如果裝置支援 HT PHY 模式或 未設定 ht_caps。

已淘汰：15
ht_caps fuchsia.wlan.ieee80211/HtCapabilities
vht_supported bool

決定用戶端是否應讀取 vht_caps 欄位。如果 裝置支援 VHT PHY 模式，因此 vht_supported 必須為 true， 「必須」設定 vht_caps 欄位並提供說明 VHT 的資料 即便沒有技術背景，也能因這些工具的功能而受益這些欄位的任何其他設定 裝置「不」支援 VHT PHY 模式。詳情請參閱 VhtCapabilities。

淘汰

這個欄位會決定 vht_caps 欄位是否讀取 用戶端，但並非絕對必要，例如 vht_caps 等表格欄位 。目標平台的伺服器 (即驅動程式) vht_supported 已淘汰的版本應一律設定 欄位設為 true，vht_caps如果裝置支援 VHT PHY 模式或 未設定 vht_caps。

已淘汰：15
vht_caps fuchsia.wlan.ieee80211/VhtCapabilities
operating_channel_count uint16

營運管道的數量，如果 operating_channel_list 欄位是 則必須包含此欄位，且必須 與 operating_channel_list 欄位一致

淘汰

這個欄位已由 operating_channels 取代。伺服器 (即 驅動程式版本) 的特定平台版本，其中 operating_channel_count 已不適用，請將操作管道寫入 operating_channels 欄位。用戶端嘗試讀取 operating_channel_count前 operating_channels。

已淘汰：15
operating_channel_list uint8[256]

按照法規資訊確定的有效營運管道組合 由裝置驅動程式產生。營運管道指的是 一個 AP 可能傳輸信標影格的管道。

這個欄位中顯示的管道數量必須與 operating_channel_count 欄位 (如有)。

淘汰

這個欄位已由 operating_channels 取代。伺服器 (即 驅動程式版本) 的特定平台版本，其中 operating_channel_list 已不適用，請將操作管道寫入 operating_channels 欄位。用戶端嘗試讀取 operating_channel_list前 operating_channels。

已淘汰：15
basic_rates vector<uint8>[12]

支援的基本費率，以 500 Kbit/秒為單位 (如 IEEE 所定義)。 Std 802.11-2016, 9.4.2.3)，例如0x02 代表 1 Mbps。這組 代表裝置同時支援的所有非 HT 費率 傳輸與接收。

新增：15
operating_channels vector<uint8>[256]

按照法規資訊確定的有效營運管道組合 由裝置驅動程式產生。營運管道指的是 一個 AP 可能傳輸信標影格的管道。

用戶端必須使用這個組合來判斷 使用 iface 或確定 啟動 AP 時使用的運作管道

新增：15

WlanSoftmacBaseCancelScanRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
scan_id uint64

WlanSoftmacBaseClearAssociationRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
peer_addr fuchsia.wlan.ieee80211/MacAddr

WlanSoftmacBaseEnableBeaconingRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
packet_template WlanTxPacket

信標範本。由於這是範本，因此某些封包內容 僅包含少量有效資訊，因為內容稍後提供 遭到硬體、韌體或軟體修改。
tim_ele_offset uint64

設定與 packet_template 欄位開頭的 TIM 偏移量 (以位元組為單位)。 您必須為 TIM IE 的第一個位元組 (也就是代碼 ID) 建立索引。
beacon_interval uint16

TU 中的信標間隔週期。

WlanSoftmacBaseSetChannelRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
channel fuchsia.wlan.common/WlanChannel

WlanSoftmacBaseStartPassiveScanRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
channels vector<uint8>[256]

要掃描的頻道清單。如果管道清單空白， 掃描要求，立即傳回 ZX_ERR_INVALID_ARGS。

系統會忽略無效的管道號碼，且不顯示任何通知訊息。管道效力 號碼取決於目前的監管區域，而且 SoftMAC 驅動程式庫無法 請一律決定區域設定。尤其是在下列情況中 韌體會動態變更區域設定。

這是必要參數。
min_channel_time zx/Duration

掃描期間，每個管道花費最少的時間長度。
max_channel_time zx/Duration

掃描期間對每個管道花費的時間上限。
min_home_time zx/Duration

停留時間介於停留時間的最短期間 每個首頁管道與裝置所應該頻道對應的頻道 或位於不掃描時

WlanSoftmacBaseUpdateWmmParametersRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
ac fuchsia.wlan.ieee80211/WlanAccessCategory
params fuchsia.wlan.common/WlanWmmParameters

WlanSoftmacBase_StartActiveScan_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
scan_id uint64

WlanSoftmacBase_StartPassiveScan_Response

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
scan_id uint64

WlanSoftmacIfcBaseNotifyScanCompleteRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
status zx/Status
scan_id uint64

WlanSoftmacQueryResponse

在 fuchsia.wlan.softmac/softmac.fidl 定義

說明執行中 softmac 狀態的高階資訊。 這則回應中的所有欄位皆為必填。

新增：15

Ordinal欄位類型說明
sta_addr fuchsia.wlan.ieee80211/MacAddr

車站位址。
mac_role fuchsia.wlan.common/WlanMacRole

MAC 角色
supported_phys vector<fuchsia.wlan.common/WlanPhyType>[64]

表示硬體支援的 WlanInfoPhyType 值。
hardware_capability fuchsia.wlan.common/WlanSoftmacHardwareCapability

表示已啟用的 WlanInfoHardwareCapability 值。定義為 fuchsia.wlan.common.WlanSoftmacHardwareCapability 的值
band_caps vector<WlanSoftmacBandCapability>[16]

支援的錶帶。

WlanSoftmacStartActiveScanRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

要做為 WlanSoftmac.StartActiveScan 做為單一引數的引數結構體

新增：15

Ordinal欄位類型說明
channels vector<uint8>[256]

要掃描的頻道清單。如果管道清單空白， 掃描要求，立即傳回 ZX_ERR_INVALID_ARGS。

系統會忽略無效的管道號碼，且不顯示任何通知訊息。管道效力 號碼取決於目前的監管區域，而且 SoftMAC 驅動程式庫無法 請一律決定區域設定。尤其是在下列情況中 韌體會動態變更區域設定。
ssids vector<fuchsia.wlan.ieee80211/CSsid>[84]

要掃描的 SSID 清單。如果清單只有一個 SSID，這個 SSID 在 Probe Request 框的 SSID 元素中，如果清單包含多個 SSID， 所有 SSID 都會放在 Probe Request 框的 SSID List 元素中， 所需 SSID 元素的第一個 SSID。空白清單與 並指定只包含萬用字元 SSID 的清單。
mac_header vector<uint8>[28]

含有 MAC 標頭 (如 IEEE 規章 802.11-2016 與 9.3.3.2 所定義) 的緩衝區，至 都包含在內
ies vector<uint8>[11454]

包含要納入每個 Probe Request 框架的 IE 位元組的緩衝區。

您所指定的 IE 不得導致探測要求的 MMPDU 數量 限制由 IEEE Std 802.11-2016, 9.2.4.7 定義。MMPDU 限制常數 網址是 fuchsia.wlan.ieee80211。這些限制相當龐大 指定最常出現在哪些 IE 中 探測要求頁框。
min_channel_time zx/Duration

掃描期間，每個管道花費最少的時間長度。
max_channel_time zx/Duration

掃描期間對每個管道花費的時間上限。
min_home_time zx/Duration

每個管道的停留時間之間，在主畫面管道花費的最短時間長度 其中，主畫面管道應與裝置對應的頻道相同 已開啟，但不掃描。
min_probes_per_channel uint8

在掃描作業期間，每次管道造訪時要傳輸的探測要求影格數量下限。 不同裝置驅動程式對於管道造訪的定義可能有所不同，但大致上 掃描期間，查看特定頻道停留在某頻道的時間時間間隔。

如果在一個管道上傳送多個 Probe Request 框架，將可提高 但在嘈雜的環境中接收。
max_probes_per_channel uint8

掃描作業期間，每次管道造訪時傳輸的探測要求影格數量上限。 不同裝置驅動程式對於管道造訪的定義可能有所不同，但大致上 掃描期間，查看特定頻道停留在某頻道的時間時間間隔。指定 0 無效 因為必須至少傳送一個 Probe Request 框架，才能執行執行中的掃描作業。

限制管道傳送的 Probe Request 框架數，可以縮短作業時間 傳送影格，進而增加接收影格的時間。

WlanTxTransferRequest

在 fuchsia.wlan.softmac/softmac.fidl 定義

Ordinal欄位類型說明
packet_address uint64
packet_size uint64
packet_info WlanTxInfo
async_id uint64
arena uint64

聯合國

EthernetRx_Transfer_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response EthernetRx_Transfer_Response
err zx/Status

EthernetTx_Transfer_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response EthernetTx_Transfer_Response
err zx/Status

WlanSoftmacBase_CancelScan_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_CancelScan_Response
err zx/Status

WlanSoftmacBase_ClearAssociation_Result strict

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_ClearAssociation_Response
err zx/Status

WlanSoftmacBase_DisableBeaconing_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_DisableBeaconing_Response
err zx/Status

WlanSoftmacBase_EnableBeaconing_Result strict

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_EnableBeaconing_Response
err zx/Status

WlanSoftmacBase_InstallKey_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_InstallKey_Response
err zx/Status

WlanSoftmacBase_JoinBss_Result strict

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_JoinBss_Response
err zx/Status

WlanSoftmacBase_NotifyAssociationComplete_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_NotifyAssociationComplete_Response
err zx/Status

WlanSoftmacBase_QueryDiscoverySupport_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_QueryDiscoverySupport_Response
err zx/Status

WlanSoftmacBase_QueryMacSublayerSupport_Result strict

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_QueryMacSublayerSupport_Response
err zx/Status

WlanSoftmacBase_QuerySecuritySupport_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_QuerySecuritySupport_Response
err zx/Status

WlanSoftmacBase_QuerySpectrumManagementSupport_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_QuerySpectrumManagementSupport_Response
err zx/Status

WlanSoftmacBase_Query_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacQueryResponse
err zx/Status

WlanSoftmacBase_SetChannel_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_SetChannel_Response
err zx/Status

WlanSoftmacBase_StartActiveScan_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_StartActiveScan_Response
err zx/Status

WlanSoftmacBase_StartPassiveScan_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_StartPassiveScan_Response
err zx/Status

WlanSoftmacBase_UpdateWmmParameters_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBase_UpdateWmmParameters_Response
err zx/Status

WlanSoftmacBridge_Start_Result 嚴格 資源

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmacBridge_Start_Response
err zx/Status

WlanSoftmac_QueueTx_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmac_QueueTx_Response
err zx/Status

WlanSoftmac_Start_Result 嚴格 資源

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanSoftmac_Start_Response
err zx/Status

WlanTx_Transfer_Result 嚴格

在 fuchsia.wlan.softmac/softmac.fidl 定義

OrdinalVariant類型說明
response WlanTx_Transfer_Response
err zx/Status

商業智慧

WlanRxInfoFlags 彈性

類型：uint32

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

名稱值說明
1

接收影格的 FCS 無效。

FRAME_BODY_PADDING_4

 2

在 MAC 標頭後方加上邊框間距，以便將影格主體對齊 4 個位元組。

WlanRxInfoValid 彈性

類型：uint32

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

名稱值說明
1
2
4
8
16
32

WlanTxInfoFlags 彈性

類型：uint32

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

名稱值說明
1

表明應保護這個封包。
2

速率控制：指出應傳送的重要資料訊框 (例如 EAPOL) 可靠，而非快速，且免除頻率探測
4

指出這個封包應盡可能透過 QoS 標頭傳送 (11n+)。

WlanTxInfoValid 彈性

類型：uint32

在 fuchsia.wlan.softmac/softmac.fidl 定義

新增：15

名稱值說明
1
2
4
8
16

觀測站

名稱值類型說明
WLAN_MAC_MAX_RATES 263 uint32
新增：15

服務

服務

在 fuchsia.wlan.softmac/softmac.fidl 定義

名稱類型傳輸
wlan_softmac fuchsia.wlan.softmac/WlanSoftmac 駕駛座