template <>

class WireSyncBufferClientImpl

Defined at line 3967 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

Public Methods

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::Query> Query ()

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 3980 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::QueryDiscoverySupport> QueryDiscoverySupport ()

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 3990 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::QueryMacSublayerSupport> QueryMacSublayerSupport ()

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4004 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::QuerySecuritySupport> QuerySecuritySupport ()

Gets information about the security features supported by the device.

This method is safe to call even when the SoftMAC has not yet started.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4013 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::QuerySpectrumManagementSupport> QuerySpectrumManagementSupport ()

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4023 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::SetChannel> SetChannel (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseSetChannelRequest WlanSoftmacBaseSetChannelRequest)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4037 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::JoinBss> JoinBss (::fuchsia_wlan_common::wire::JoinBssRequest join_request)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4053 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::EnableBeaconing> EnableBeaconing (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseEnableBeaconingRequest WlanSoftmacBaseEnableBeaconingRequest)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4074 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::DisableBeaconing> DisableBeaconing ()

Disables hardware beaconing.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4082 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::InstallKey> InstallKey (::fuchsia_wlan_softmac::wire::WlanKeyConfiguration WlanKeyConfiguration)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4095 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::NotifyAssociationComplete> NotifyAssociationComplete (::fuchsia_wlan_softmac::wire::WlanAssociationConfig assoc_cfg)

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`.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4111 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::ClearAssociation> ClearAssociation (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseClearAssociationRequest WlanSoftmacBaseClearAssociationRequest)

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

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4119 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::StartPassiveScan> StartPassiveScan (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseStartPassiveScanRequest WlanSoftmacBaseStartPassiveScanRequest)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4139 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::StartActiveScan> StartActiveScan (::fuchsia_wlan_softmac::wire::WlanSoftmacStartActiveScanRequest WlanSoftmacStartActiveScanRequest)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4159 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::CancelScan> CancelScan (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseCancelScanRequest WlanSoftmacBaseCancelScanRequest)

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.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4179 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::UpdateWmmParameters> UpdateWmmParameters (::fuchsia_wlan_softmac::wire::WlanSoftmacBaseUpdateWmmParametersRequest WlanSoftmacBaseUpdateWmmParametersRequest)

Indicate the device of modified WiFi Multimedia (WMM) parameters for a

particular access category (AC).

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4188 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::Start> Start (::fdf::ClientEnd< ::fuchsia_wlan_softmac::WlanSoftmacIfc> && ifc)

Signal to the server that the MLME for the iface is ready to send and receive

frames.

The client provides the following arguments:

- `ifc`: The client end of a `WlanSoftmaIfc` server which the

server will use to send events to the client.

The server returns a server end of a `fuchsia.wlan.mlme/MLME` protocol. The SME

for the iface owns the client end. Thus, this channel is used for SME

<

-> MLME

communication.

Except where noted, `WlanSoftmac` methods must only be called after

a successful call to `WlanSoftmac.Start`.

Common errors include:

- `ZX_ERR_ALREADY_BOUND`: `Start` was already called on this softmac.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4213 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::Stop> Stop ()

Shut down the softmac if it is running.

Safe to call when the softmac is not running.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4222 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h

::fdf::WireUnownedResult< ::fuchsia_wlan_softmac::WlanSoftmac::QueueTx> QueueTx (const ::fuchsia_wlan_softmac::wire::WlanTxPacket & packet)

Queue a packet for transmission. May return before a packet has actually

been transmitted. This call does not take ownership of the buffer passed in

the WlanTxPacket.

Errors result from a failure to queue the packet for transmission.

An OK result thus only indicates that the packet was queued, *not* that

it was successfully transmitted.

Caller provides the backing storage for FIDL message via an argument to `.buffer()`.

Defined at line 4236 of file fidling/gen/sdk/fidl/fuchsia.wlan.softmac/fuchsia.wlan.softmac/cpp/fidl/fuchsia.wlan.softmac/cpp/driver/wire_messaging.h