Struct WlanSoftmacBaseProxy

pub struct WlanSoftmacBaseProxy { /* private fields */ }

Implementations

impl WlanSoftmacBaseProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.wlan.softmac/WlanSoftmacBase.

pub fn take_event_stream(&self) -> WlanSoftmacBaseEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn query( &self, ) -> QueryResponseFut<WlanSoftmacBaseQueryResult, DefaultFuchsiaResourceDialect>

Gets general information about the device and its supported features. This method is safe to call even when the SoftMAC has not yet started.

Note: The implementation of this method must not depend on a response from an ethernet driver, otherwise there is a risk of deadlock. The wlansoftmac driver calls this method synchronously while serving the fuchsia.hardware.ethernet/EthernetImpl.Query method.

pub fn query_discovery_support( &self, ) -> QueryResponseFut<WlanSoftmacBaseQueryDiscoverySupportResult, DefaultFuchsiaResourceDialect>

Gets information about the station discovery (e.g., scanning and probing) features supported by the device. This method is safe to call even when the SoftMAC has not yet started.

pub fn query_mac_sublayer_support( &self, ) -> QueryResponseFut<WlanSoftmacBaseQueryMacSublayerSupportResult, DefaultFuchsiaResourceDialect>

Gets information about the MAC features supported by the device. This method is safe to call even when the SoftMAC has not yet started.

Note: The implementation of this method must not depend on a response from an ethernet driver, otherwise there is a risk of deadlock. The wlansoftmac driver calls this method synchronously while serving the fuchsia.hardware.ethernet/EthernetImpl.Query method.

pub fn query_security_support( &self, ) -> QueryResponseFut<WlanSoftmacBaseQuerySecuritySupportResult, DefaultFuchsiaResourceDialect>

Gets information about the security features supported by the device. This method is safe to call even when the SoftMAC has not yet started.

pub fn query_spectrum_management_support( &self, ) -> QueryResponseFut<WlanSoftmacBaseQuerySpectrumManagementSupportResult, DefaultFuchsiaResourceDialect>

Gets information about the spectrum usage (e.g., DFS) features supported by the device. This method is safe to call even when the SoftMAC has not yet started.

pub fn set_channel( &self, payload: &WlanSoftmacBaseSetChannelRequest, ) -> QueryResponseFut<WlanSoftmacBaseSetChannelResult, DefaultFuchsiaResourceDialect>

Set the primary radio channel, e.g. in response to a channel switch event. If successful, this will trigger the channel switch immediately. This may impact the transmission of any frames that are in-flight, and might also interfere with an ongoing scan request.

Common errors include:
ZX_ERR_NOT_SUPPORTED: The device cannot switch to the requested channel.

pub fn join_bss( &self, join_request: &JoinBssRequest, ) -> QueryResponseFut<WlanSoftmacBaseJoinBssResult, DefaultFuchsiaResourceDialect>

Join a specific BSS in which we will participate. This applies regardless of if we are hosting the BSS or joining it (indicated by the remote flag in JoinBssRequest). If successful, the device will switch to the correct channel and perform any internal filtering/timing operations required to join the BSS. For client STAs, this is the first step before authenticating.

Common errors include:
ZX_ERR_NOT_SUPPORTED: The device does not support the given bss config.

pub fn enable_beaconing( &self, payload: &WlanSoftmacBaseEnableBeaconingRequest, ) -> QueryResponseFut<WlanSoftmacBaseEnableBeaconingResult, DefaultFuchsiaResourceDialect>

Enables hardware Beaconing.

This method cannot be called while beaconing is enabled and so DisableBeaconing must be called prior to this method if beaconing is enabled.

All request fields are required.

Common errors include:

• ZX_ERR_NOT_SUPPORTED: The device does not support hardware beacons.
• ZX_ERR_INVALID_ARGS: The device cannot transmit the requested beacon.
• ZX_ERR_BAD_STATE: The device is already beaconing.

pub fn disable_beaconing( &self, ) -> QueryResponseFut<WlanSoftmacBaseDisableBeaconingResult, DefaultFuchsiaResourceDialect>

Disables hardware beaconing.

pub fn install_key( &self, payload: &WlanKeyConfiguration, ) -> QueryResponseFut<WlanSoftmacBaseInstallKeyResult, DefaultFuchsiaResourceDialect>

Install a key for encryption when transmitting or receiving protected frames.

Common errors include: ZX_ERR_INVALID_ARGS: The given config does not specify a valid key. ZX_ERR_NOT_SUPPORTED: The device does not support the given cipher.

pub fn notify_association_complete( &self, assoc_cfg: &WlanAssociationConfig, ) -> QueryResponseFut<WlanSoftmacBaseNotifyAssociationCompleteResult, DefaultFuchsiaResourceDialect>

Notifies the device of a successful association and configures additional parameters necessary to participate in that association.

Errors

Common errors include:

• ZX_ERR_BAD_STATE: The device was not previously informed of this BSS via WlanSoftmac.JoinBss.

pub fn clear_association( &self, payload: &WlanSoftmacBaseClearAssociationRequest, ) -> QueryResponseFut<WlanSoftmacBaseClearAssociationResult, DefaultFuchsiaResourceDialect>

Notifies MAC and PHY that the peer has been de-associated.

pub fn start_passive_scan( &self, payload: &WlanSoftmacBaseStartPassiveScanRequest, ) -> QueryResponseFut<WlanSoftmacBaseStartPassiveScanResult, DefaultFuchsiaResourceDialect>

Starts a passive scan. The server will deliver scan results as Beacon frames using WlanSoftmacIfc.Recv(). When complete, the server will call WlanSoftmacIfc.ScanComplete() with the same scan_id returned by StartPassiveScan().

The server indicates support for StartPassiveScan() using fuchsia.wlan.common/ScanOffloadExtension.supported.

Common errors include: ZX_ERR_INVALID_ARGS: The device is not capable of performing the requested scan, e.g. because an incompatible channel was requested. ZX_ERR_UNAVAILABLE: The device cannot currently perform scans. ZX_ERR_SHOULD_WAIT: Another scan is already in-progress.

pub fn start_active_scan( &self, payload: &WlanSoftmacStartActiveScanRequest, ) -> QueryResponseFut<WlanSoftmacBaseStartActiveScanResult, DefaultFuchsiaResourceDialect>

Starts an active scan. The server will deliver scan results as Beacon or Probe Response frames using WlanSoftmacIfc.Recv(). When complete, the server will call WlanSoftmacIfc.ScanComplete() with the same scan_id returned by StartActiveScan().

A device driver indicates support for StartActiveScan() using fuchsia.wlan.common/ProbeRequestOffloadExtension.supported.

Common errors include: ZX_ERR_INVALID_ARGS: The device is not capable of performing the requested scan, e.g. because an incompatible channel was requested. ZX_ERR_UNAVAILABLE: The device cannot currently perform scans. ZX_ERR_SHOULD_WAIT: Another scan is already in-progress.

pub fn cancel_scan( &self, payload: &WlanSoftmacBaseCancelScanRequest, ) -> QueryResponseFut<WlanSoftmacBaseCancelScanResult, DefaultFuchsiaResourceDialect>

Cancels the ongoing scan corresponding to scan_id, where scan_id is an identifier returned by StartPassiveScan() or StartActiveScan(). If cancellation succeeds, the server will soon call WlanSoftmacIfc.ScanComplete() with the same scan_id.

A device driver indicates support for CancelScan() using fuchsia.wlan.common/ScanOffloadExtension.scan_cancel_supported.

Common errors include:

• ZX_ERR_NOT_FOUND: scan_id does not match an ongoing scan.
• ZX_ERR_NOT_SUPPORTED: Server does not support scan cancellation.

pub fn update_wmm_parameters( &self, payload: &WlanSoftmacBaseUpdateWmmParametersRequest, ) -> QueryResponseFut<WlanSoftmacBaseUpdateWmmParametersResult, DefaultFuchsiaResourceDialect>

Indicate the device of modified WiFi Multimedia (WMM) parameters for a particular access category (AC).

Trait Implementations

impl Clone for WlanSoftmacBaseProxy

fn clone(&self) -> WlanSoftmacBaseProxy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WlanSoftmacBaseProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Proxy for WlanSoftmacBaseProxy

type Protocol = WlanSoftmacBaseMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.

impl WlanSoftmacBaseProxyInterface for WlanSoftmacBaseProxy

type QueryResponseFut = QueryResponseFut<Result<WlanSoftmacQueryResponse, i32>>

type QueryDiscoverySupportResponseFut = QueryResponseFut<Result<DiscoverySupport, i32>>

type QueryMacSublayerSupportResponseFut = QueryResponseFut<Result<MacSublayerSupport, i32>>

type QuerySecuritySupportResponseFut = QueryResponseFut<Result<SecuritySupport, i32>>

type QuerySpectrumManagementSupportResponseFut = QueryResponseFut<Result<SpectrumManagementSupport, i32>>

type SetChannelResponseFut = QueryResponseFut<Result<(), i32>>

type JoinBssResponseFut = QueryResponseFut<Result<(), i32>>

type EnableBeaconingResponseFut = QueryResponseFut<Result<(), i32>>

type DisableBeaconingResponseFut = QueryResponseFut<Result<(), i32>>

type InstallKeyResponseFut = QueryResponseFut<Result<(), i32>>

type NotifyAssociationCompleteResponseFut = QueryResponseFut<Result<(), i32>>

type ClearAssociationResponseFut = QueryResponseFut<Result<(), i32>>

type StartPassiveScanResponseFut = QueryResponseFut<Result<WlanSoftmacBaseStartPassiveScanResponse, i32>>

type StartActiveScanResponseFut = QueryResponseFut<Result<WlanSoftmacBaseStartActiveScanResponse, i32>>

type CancelScanResponseFut = QueryResponseFut<Result<(), i32>>

type UpdateWmmParametersResponseFut = QueryResponseFut<Result<(), i32>>

fn query(&self) -> Self::QueryResponseFut

fn query_discovery_support(&self) -> Self::QueryDiscoverySupportResponseFut

fn query_mac_sublayer_support(&self) -> Self::QueryMacSublayerSupportResponseFut

fn query_security_support(&self) -> Self::QuerySecuritySupportResponseFut

fn query_spectrum_management_support( &self, ) -> Self::QuerySpectrumManagementSupportResponseFut

fn set_channel( &self, payload: &WlanSoftmacBaseSetChannelRequest, ) -> Self::SetChannelResponseFut

fn join_bss(&self, join_request: &JoinBssRequest) -> Self::JoinBssResponseFut

fn enable_beaconing( &self, payload: &WlanSoftmacBaseEnableBeaconingRequest, ) -> Self::EnableBeaconingResponseFut

fn disable_beaconing(&self) -> Self::DisableBeaconingResponseFut

fn install_key( &self, payload: &WlanKeyConfiguration, ) -> Self::InstallKeyResponseFut

fn notify_association_complete( &self, assoc_cfg: &WlanAssociationConfig, ) -> Self::NotifyAssociationCompleteResponseFut

fn clear_association( &self, payload: &WlanSoftmacBaseClearAssociationRequest, ) -> Self::ClearAssociationResponseFut

fn start_passive_scan( &self, payload: &WlanSoftmacBaseStartPassiveScanRequest, ) -> Self::StartPassiveScanResponseFut

fn start_active_scan( &self, payload: &WlanSoftmacStartActiveScanRequest, ) -> Self::StartActiveScanResponseFut

fn cancel_scan( &self, payload: &WlanSoftmacBaseCancelScanRequest, ) -> Self::CancelScanResponseFut

fn update_wmm_parameters( &self, payload: &WlanSoftmacBaseUpdateWmmParametersRequest, ) -> Self::UpdateWmmParametersResponseFut