PROTOCOLS

WlanSoftmac

Defined in fuchsia.wlan.softmac/softmac.fidl

CancelScan

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.

Request

Name	Type
payload	WlanSoftmacBridgeCancelScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_CancelScan_Result

ClearAssociation

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

Request

Name	Type
payload	WlanSoftmacBridgeClearAssociationRequest

Response

Name	Type
payload	WlanSoftmacBridge_ClearAssociation_Result

DisableBeaconing

Disables hardware beaconing.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmacBridge_DisableBeaconing_Result

EnableBeaconing

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.

Request

Name	Type
payload	WlanSoftmacBridgeEnableBeaconingRequest

Response

Name	Type
payload	WlanSoftmacBridge_EnableBeaconing_Result

InstallKey

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.

Request

Name	Type
payload	WlanKeyConfiguration

Response

Name	Type
payload	WlanSoftmac_InstallKey_Result

JoinBss

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.

Request

Name	Type
join_request	fuchsia.wlan.common/JoinBssRequest

Response

Name	Type
payload	WlanSoftmac_JoinBss_Result

NotifyAssociationComplete

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.

Request

Name	Type
assoc_cfg	WlanAssociationConfig

Response

Name	Type
payload	WlanSoftmacBridge_NotifyAssociationComplete_Result

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.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmacBridge_Query_Result

QueryDiscoverySupport

Query the underlying device for feature support related to station discovery (e.g. scans and probes). Safe to call when the softmac is not started.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmac_QueryDiscoverySupport_Result

QueryMacSublayerSupport

Query the underlying device for information related to how it implements MAC-level functionality. Safe to call when the softmac is not started.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmac_QueryMacSublayerSupport_Result

QuerySecuritySupport

Query the underlying device for features related to specific security modes. Safe to call when the softmac is not started.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmac_QuerySecuritySupport_Result

QuerySpectrumManagementSupport

Query the underlying device for features related to spectrum usage, e.g. DFS. Safe to call when the softmac is not started.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmac_QuerySpectrumManagementSupport_Result

QueueTx

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.

Request

Name	Type
packet	WlanTxPacket

Response

Name	Type
payload	WlanSoftmac_QueueTx_Result

SetChannel

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.

Request

Name	Type
payload	WlanSoftmacBridgeSetChannelRequest

Response

Name	Type
payload	WlanSoftmacBridge_SetChannel_Result

Start

Start a softmac on the underlying device, using the given ifc to pass events upwards. Callbacks on ifc may be invoked from now until Stop() is called.

The returned sme_channel is the server endpoint of a wlan_mlme.fidl:MLME protocol, the client end of which is held by SME. This channel is used for SME <-> MLME communication.

Except where noted, WlanSoftmac APIs may only be called while the softmac is running after a successful call to Start().

Common errors include:
ZX_ERR_ALREADY_BOUND: Start was already called on this softmac.

Request

Name	Type
ifc	WlanSoftmacIfc

Response

Name	Type
payload	WlanSoftmac_Start_Result

StartActiveScan

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.

Request

Name	Type
payload	WlanSoftmacStartActiveScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_StartActiveScan_Result

StartPassiveScan

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.

Request

Name	Type
payload	WlanSoftmacBridgeStartPassiveScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_StartPassiveScan_Result

Stop

Shut down the softmac if it is running. Safe to call when the softmac is not running.

Request

<EMPTY>

Response

<EMPTY>

UpdateWmmParameters

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

Request

Name	Type
payload	WlanSoftmacUpdateWmmParametersRequest

Response

Name	Type
payload	WlanSoftmac_UpdateWmmParameters_Result

WlanSoftmacBridge

Defined in fuchsia.wlan.softmac/softmac.fidl

The wlansoftmac C++ driver establishes a FIDL channel serving the WlanSoftmacBridge protocol to the wlan-mlme Rust library. The WlanSoftmacBridge protocol is similar to WlanSoftmac, but may not contain methods where the additional FIDL channel hinders performance.

WlanSoftmac composes a subset of its methods from WlanSoftmacBridge so that the wlansoftmac driver can trivially convert between WlanSoftmacBridge messages transported via the Zircon channel and WlanSoftmac messages transported via the driver framework channel.

CancelScan

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.

Request

Name	Type
payload	WlanSoftmacBridgeCancelScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_CancelScan_Result

ClearAssociation

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

Request

Name	Type
payload	WlanSoftmacBridgeClearAssociationRequest

Response

Name	Type
payload	WlanSoftmacBridge_ClearAssociation_Result

DisableBeaconing

Disables hardware beaconing.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmacBridge_DisableBeaconing_Result

EnableBeaconing

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.

Request

Name	Type
payload	WlanSoftmacBridgeEnableBeaconingRequest

Response

Name	Type
payload	WlanSoftmacBridge_EnableBeaconing_Result

NotifyAssociationComplete

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.

Request

Name	Type
assoc_cfg	WlanAssociationConfig

Response

Name	Type
payload	WlanSoftmacBridge_NotifyAssociationComplete_Result

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.

Request

<EMPTY>

Response

Name	Type
payload	WlanSoftmacBridge_Query_Result

SetChannel

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.

Request

Name	Type
payload	WlanSoftmacBridgeSetChannelRequest

Response

Name	Type
payload	WlanSoftmacBridge_SetChannel_Result

StartActiveScan

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.

Request

Name	Type
payload	WlanSoftmacStartActiveScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_StartActiveScan_Result

StartPassiveScan

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.

Request

Name	Type
payload	WlanSoftmacBridgeStartPassiveScanRequest

Response

Name	Type
payload	WlanSoftmacBridge_StartPassiveScan_Result

WlanSoftmacIfc

Defined in fuchsia.wlan.softmac/softmac.fidl

NotifyScanComplete

Reports completion of a scan associated with the unique scan_id. status indicates whether the scan completed successfully, failed due to an error, or was cancelled.

Return status indicates the reason for scan completion: ZX_OK: All channels were scanned successfully. ZX_ERR_CANCELLED: The scan was terminated by a user request, either an explicit WlanSoftmac.CancelScan() or the initiation of an incompatible request (e.g. connect). ZX_ERR_OUT_OF_RANGE: The scan request included a prohibited channel. This may be due to the current country setting.

Request

Name	Type
payload	WlanSoftmacIfcNotifyScanCompleteRequest

Response

<EMPTY>

Recv

Forward up a packet received over the wireless medium.

Request

Name	Type
packet	WlanRxPacket

Response

<EMPTY>

ReportTxResult

Reports the result of an attempted transmission.

A device driver indicates support for ReportTxResult() using fuchsia.wlan.common/DeviceExtension.report_tx_result_supported.

Request

Name	Type
tx_result	fuchsia.wlan.common/WlanTxResult

Response

<EMPTY>

STRUCTS

WlanRxInfo

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
rx_flags	WlanRxInfoFlags	Receive flags. These represent boolean flags as opposed to enums or value-based info which are represented below. Values should be taken from the WLAN_RX_INFO_FLAGS_* enum.	No default
valid_fields	WlanRxInfoValid	Bitmask indicating which of the following fields are valid in this struct. Reserved flags must be zero.	No default
phy	fuchsia.wlan.common/WlanPhyType	The PHY format of the device at the time of the operation.	No default
data_rate	uint32	The data rate of the device, measured in units of 0.5 Mb/s.	No default
channel	fuchsia.wlan.common/WlanChannel	The channel of the device at the time of the operation. This field must be included.	No default
mcs	uint8	The modulation and coding scheme index of the device at the time of the operation. Depends on the PHY format and channel width.	No default
rssi_dbm	int8	Received Signal Strength Indicator.	No default
snr_dbh	int16	Signal-to-Noise Ratio, in 0.5 dB.	No default

WlanRxPacket

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
mac_frame	vector<uint8>		No default
info	WlanRxInfo		No default

WlanSoftmacBridge_CancelScan_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmacBridge_ClearAssociation_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmacBridge_DisableBeaconing_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmacBridge_EnableBeaconing_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmacBridge_NotifyAssociationComplete_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmacBridge_SetChannel_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmac_InstallKey_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmac_JoinBss_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmac_QueryDiscoverySupport_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
resp	fuchsia.wlan.common/DiscoverySupport		No default

WlanSoftmac_QueryMacSublayerSupport_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
resp	fuchsia.wlan.common/MacSublayerSupport		No default

WlanSoftmac_QuerySecuritySupport_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
resp	fuchsia.wlan.common/SecuritySupport		No default

WlanSoftmac_QuerySpectrumManagementSupport_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
resp	fuchsia.wlan.common/SpectrumManagementSupport		No default

WlanSoftmac_QueueTx_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanSoftmac_Start_Response resource

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
sme_channel	handle<channel>		No default

WlanSoftmac_UpdateWmmParameters_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

<EMPTY>

WlanTxInfo

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
tx_flags	uint32	Transmit flags. These represent boolean options as opposed to enums or other value-based info which are represented below. Values should be taken from the WLAN_TX_INFO_FLAGS_* enum.	No default
valid_fields	uint32	Bitmask indicating which of the following fields are valid in this struct. Reserved flags must be zero. Values for fields not indicated by a flag may be chosen at the discretion of the softmac driver.	No default
tx_vector_idx	uint16		No default
phy	fuchsia.wlan.common/WlanPhyType		No default
channel_bandwidth	fuchsia.wlan.common/ChannelBandwidth		No default
mcs	uint8	The modulation and coding scheme index for this packet. Depends on the PHY format and channel width.	No default

WlanTxPacket

Defined in fuchsia.wlan.softmac/softmac.fidl

Field	Type	Description	Default
mac_frame	vector<uint8>		No default
info	WlanTxInfo	Additional data needed to transmit the packet. TODO(fxbug.dev/105579): This field is ignored by iwlwifi.	No default

ENUMS

WlanProtection strict

Type: uint8

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Value	Description
NONE	0
RX	1
TX	2
RX_TX	3

TABLES

WlanAssociationConfig

Defined in fuchsia.wlan.softmac/softmac.fidl

Argument table to be passed as the single argument to WlanSoftmac.NotifyAssociationComplete. All information here is relevant only in the context of the association with the given peer_addr. All fields in this table are required unless stated otherwise.

Ordinal	Field	Type	Description
1	bssid	fuchsia.wlan.ieee80211/MacAddr	The MAC address of the peer with which we are now associated.
2	aid	uint16	A unique identifier for this specific association. This is unique among active associations, not necessarily historical ones.
3	listen_interval	uint16
4	channel	fuchsia.wlan.common/WlanChannel	The channel on which we have associated with this peer.
5	qos	bool	QoS capable and parameters
6	wmm_params	fuchsia.wlan.common/WlanWmmParameters	WFA WMM v1.2, 2.2.2
7	rates	vector<uint8>[263]	Concatenation of SupportedRates and ExtendedSupportedRates IEEE Std 802.11-2016, 9.4.2.3 & 9.4.2.13
8	capability_info	uint16	IEEE Std 802.11-2016, 9.4.1.4
9	ht_cap	fuchsia.wlan.ieee80211/HtCapabilities	IEEE Std 802.11-2016, 9.4.2.56, 57 Rx MCS Bitmask in Supported MCS Set field represents the set of MCS the peer can receive at from this device, considering this device's Tx capability.
10	ht_op	fuchsia.wlan.ieee80211/HtOperation
11	vht_cap	fuchsia.wlan.ieee80211/VhtCapabilities	IEEE Std 802.11-2016, 9.4.2.158, 159
12	vht_op	fuchsia.wlan.ieee80211/VhtOperation

WlanKeyConfiguration

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	protection	WlanProtection	Which path to protect: None, TX, RX, or TX and RX.
2	cipher_oui	uint8[3]	IEEE Cipher suite selector. See IEEE Std 802.11-2016, 9.4.2.25.2, Table 9-131
3	cipher_type	uint8
4	key_type	fuchsia.wlan.common/WlanKeyType	Whether this key is a pairwise, group or peer key.
5	peer_addr	fuchsia.wlan.ieee80211/MacAddr	The peer MAC address for pairwise and peer keys. For group keys this value is always the broadcast address.
6	key_idx	uint8	Index for rotating keys, e.g. group keys. This value is always 0 for key types which aren't rotating, e.g. pairwise keys.
7	key	vector<uint8>[32]
8	rsc	uint64	Receive Sequence Counter for group keys only. In all other cases the RSC will be 0.

WlanSoftmacBandCapability

Defined in fuchsia.wlan.softmac/softmac.fidl

Describes the capabilities of a SoftMAC on a particular band.

Ordinal	Field	Type	Description
1	band	fuchsia.wlan.common/WlanBand	Band to which the capabilities described by this datagram apply.
2	basic_rate_count	uint8	Count of supported basic rates. If the basic_rate_list field is present, then this field must also be present and must be consistent with the basic_rate_list field. Deprecation This field has been replaced by basic_rates. Servers (i.e., drivers) that target platform versions wherein basic_rate_count is deprecated should omit it and write basic rates to the basic_rates field instead. Clients attempt to read basic_rates before basic_rate_count. Deprecated: 15
3	basic_rate_list	uint8[12]	Set of supported basic rates in units of 500 Kbit/s (as defined in IEEE Std 802.11-2016, 9.4.2.3), e.g., 0x02 represents 1 Mbps. This set represents all of the non-HT rates that the device supports for both transmitting and receiving. The count of rates present in this field must be consistent with the basic_rate_count field when present. Deprecation This field has been replaced by basic_rates. Servers (i.e., drivers) that target platform versions wherein basic_rate_list is deprecated should omit it and write basic rates to the basic_rates field instead. Clients attempt to read basic_rates before basic_rate_list. Deprecated: 15
4	ht_supported	bool	Determines if the ht_caps fields should be read by clients. If the device supports HT PHY mode, then ht_supported must be true and the ht_caps field must be set and provide data that describes HT capabilities. Any other configuration of these fields means that the device does not support HT PHY mode. See HtCapabilities. Deprecation This field determines whether or not the ht_caps field is read by clients, but is not strictly necessary as table fields like ht_caps may be set or unset. Servers (i.e., drivers) that target platform versions wherein ht_supported is deprecated should always set the field to true and set ht_caps if the device supports HT PHY mode or unset ht_caps if the device does not. Deprecated: 15
5	ht_caps	fuchsia.wlan.ieee80211/HtCapabilities
6	vht_supported	bool	Determines if the vht_caps fields should be read by clients. If the device supports VHT PHY mode, then vht_supported must be true and the vht_caps field must be set and provide data that describes VHT capabilities. Any other configuration of these fields means that the device does not support VHT PHY mode. See VhtCapabilities. Deprecation This field determines whether or not the vht_caps field is read by clients, but is not strictly necessary as table fields like vht_caps may be set or unset. Servers (i.e., drivers) that target platform versions wherein vht_supported is deprecated should always set the field to true and set vht_caps if the device supports VHT PHY mode or unset vht_caps if the device does not. Deprecated: 15
7	vht_caps	fuchsia.wlan.ieee80211/VhtCapabilities
8	operating_channel_count	uint16	Count of operating channels. If the operating_channel_list field is present, then this field must also be present and must be consistent with the operating_channel_list field. Deprecation This field has been replaced by operating_channels. Servers (i.e., drivers) that target platform versions wherein operating_channel_count is deprecated should omit it and write operating channels to the operating_channels field instead. Clients attempt to read operating_channels before operating_channel_count. Deprecated: 15
9	operating_channel_list	uint8[256]	Set of valid operating channels per regulatory information as determined by the device driver during iface creation. An operating channel refers to a channel on which APs may transmit beacon frames. The count of channels present in this field must be consistent with the operating_channel_count field when present. Deprecation This field has been replaced by operating_channels. Servers (i.e., drivers) that target platform versions wherein operating_channel_list is deprecated should omit it and write operating channels to the operating_channels field instead. Clients attempt to read operating_channels before operating_channel_list. Deprecated: 15
10	basic_rates	vector<uint8>[12]	Set of supported basic rates in units of 500 Kbit/s (as defined in IEEE Std 802.11-2016, 9.4.2.3), e.g., 0x02 represents 1 Mbps. This set represents all of the non-HT rates that the device supports for both transmitting and receiving. Added: 15
11	operating_channels	vector<uint8>[256]	Set of valid operating channels per regulatory information as determined by the device driver during iface creation. An operating channel refers to a channel on which APs may transmit beacon frames. The client must use this set to determine the efficacy of subsequent requests to scan a subset of channels using the iface or to determine which operating channel to use when starting an AP. Added: 15

WlanSoftmacBridgeCancelScanRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	scan_id	uint64

WlanSoftmacBridgeClearAssociationRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	peer_addr	fuchsia.wlan.ieee80211/MacAddr

WlanSoftmacBridgeEnableBeaconingRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	packet_template	WlanTxPacket	Beacon template. Since this is a template, some packet content can only contain minimal valid information, because the content is later modified by hardware, firmware, or software.
2	tim_ele_offset	uint64	TIM offset to the start of the packet_template field in bytes. This must index the first byte of the TIM IE, which is the tag ID.
3	beacon_interval	uint16	Beacon interval period in TU.

WlanSoftmacBridgeSetChannelRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	channel	fuchsia.wlan.common/WlanChannel

WlanSoftmacBridgeStartPassiveScanRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	channels	vector<uint8>[256]	List of channels to scan on. An empty list of channels will cause a scan request to immediately return ZX_ERR_INVALID_ARGS. Invalid channel numbers will be silently ignored. The validity of a channel number depends on the current regulatory region, and a SoftMAC driver cannot always determine the region setting. This is especially the case when firmware changes the region setting dynamically. This is a required parameter.
2	min_channel_time	zx/Duration	Minimum duration to spend on each channel during the scan.
3	max_channel_time	zx/Duration	Maximum duration to spend on each channel during the scan.
4	min_home_time	zx/Duration	Minimum duration to spend on the home channel(s) between the dwell time on each channel where a home channel corresponds to channels the device should otherwise be present on while not scanning.

WlanSoftmacBridge_StartActiveScan_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	scan_id	uint64

WlanSoftmacBridge_StartPassiveScan_Response

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	scan_id	uint64

WlanSoftmacIfcNotifyScanCompleteRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	status	zx/Status
2	scan_id	uint64

WlanSoftmacQueryResponse

Defined in fuchsia.wlan.softmac/softmac.fidl

High-level information describing the state of a running softmac. All fields in this response are required.

Ordinal	Field	Type	Description
1	sta_addr	fuchsia.wlan.ieee80211/MacAddr	Station address.
2	mac_role	fuchsia.wlan.common/WlanMacRole	MAC role
3	supported_phys	vector<fuchsia.wlan.common/WlanPhyType>[64]	Bitmask indicating WlanInfoPhyType values supported by the hardware.
4	hardware_capability	fuchsia.wlan.common/WlanSoftmacHardwareCapability	Bitmask indicating enabled WlanInfoHardwareCapability values. Values defined as fuchsia.wlan.common.WlanSoftmacHardwareCapability
5	band_caps	vector<WlanSoftmacBandCapability>[16]	Supported bands.

WlanSoftmacStartActiveScanRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Argument struct to be passed as the single argument to WlanSoftmac.StartActiveScan

Ordinal	Field	Type	Description
1	channels	vector<uint8>[256]	List of channels to scan on. An empty list of channels will cause a scan request to immediately return ZX_ERR_INVALID_ARGS. Invalid channel numbers will be silently ignored. The validity of a channel number depends on the current regulatory region, and a SoftMAC driver cannot always determine the region setting. This is especially the case when firmware changes the region setting dynamically.
2	ssids	vector<fuchsia.wlan.ieee80211/CSsid>[84]	List of SSIDs to scan for. For a list with a single SSID, the SSID will be placed in the SSID element in the Probe Request frame. For a list with more than one SSID, all SSIDs will be placed in an SSID List element in the Probe Request frame with the first SSID in the list in the required SSID element. An empty list is the same as specifying a list containing only the wildcard SSID.
3	mac_header	vector<uint8>[28]	Buffer containing a MAC header (as defined in IEEE Std 802.11-2016, 9.3.3.2) to include in each Probe Request frame.
4	ies	vector<uint8>[11454]	Buffer containing IE bytes to include in each Probe Request frame. The IEs specified must not result in a Probe Request MMPDU that exceed the limits defined by IEEE Std 802.11-2016, 9.2.4.7. MMPDU limit constants can be found in fuchsia.wlan.ieee80211. These limits are very large and will likely not be exceeded by specifying the most common IEs found in Probe Request frames.
5	min_channel_time	zx/Duration	Minimum duration to spend on each channel during the scan.
6	max_channel_time	zx/Duration	Maximum duration to spend on each channel during the scan.
7	min_home_time	zx/Duration	Minimum duration to spend on the home channel(s) between the dwell time on each channel where a home channel corresponds to channels the device should otherwise be present on while not scanning.
8	min_probes_per_channel	uint8	Minimum number of Probe Request frames to transmit per channel visit during a scan. The definition of a channel visit may differ between device drivers, but it is roughly the interval of time spent on a specific channel during a scan. Sending more than one Probe Request frame on a channel may increase the probability that it is received in a noisy environment.
9	max_probes_per_channel	uint8	Maximum number of Probe Request frames to transmit per channel visit during a scan. The definition of a channel visit may differ between device drivers, but it is roughly the interval of time spent on a specific channel during a scan. Specifying 0 is invalid since at least one Probe Request frame must be transmitted for an active scan. Limiting the number of Probe Request frames sent on a channel reduces the time spent transmitting frames, and thus increase the time spent receiving frames, while scanning.

WlanSoftmacUpdateWmmParametersRequest

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Field	Type	Description
1	ac	fuchsia.wlan.ieee80211/WlanAccessCategory
2	params	fuchsia.wlan.common/WlanWmmParameters

UNIONS

WlanSoftmacBridge_CancelScan_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_CancelScan_Response
2	err	zx/Status

WlanSoftmacBridge_ClearAssociation_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_ClearAssociation_Response
2	err	zx/Status

WlanSoftmacBridge_DisableBeaconing_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_DisableBeaconing_Response
2	err	zx/Status

WlanSoftmacBridge_EnableBeaconing_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_EnableBeaconing_Response
2	err	zx/Status

WlanSoftmacBridge_NotifyAssociationComplete_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_NotifyAssociationComplete_Response
2	err	zx/Status

WlanSoftmacBridge_Query_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacQueryResponse
2	err	zx/Status

WlanSoftmacBridge_SetChannel_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_SetChannel_Response
2	err	zx/Status

WlanSoftmacBridge_StartActiveScan_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_StartActiveScan_Response
2	err	zx/Status

WlanSoftmacBridge_StartPassiveScan_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmacBridge_StartPassiveScan_Response
2	err	zx/Status

WlanSoftmac_InstallKey_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_InstallKey_Response
2	err	zx/Status

WlanSoftmac_JoinBss_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_JoinBss_Response
2	err	zx/Status

WlanSoftmac_QueryDiscoverySupport_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_QueryDiscoverySupport_Response
2	err	zx/Status

WlanSoftmac_QueryMacSublayerSupport_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_QueryMacSublayerSupport_Response
2	err	zx/Status

WlanSoftmac_QuerySecuritySupport_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_QuerySecuritySupport_Response
2	err	zx/Status

WlanSoftmac_QuerySpectrumManagementSupport_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_QuerySpectrumManagementSupport_Response
2	err	zx/Status

WlanSoftmac_QueueTx_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_QueueTx_Response
2	err	zx/Status

WlanSoftmac_Start_Result strict resource

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_Start_Response
2	err	zx/Status

WlanSoftmac_UpdateWmmParameters_Result strict

Defined in fuchsia.wlan.softmac/softmac.fidl

Ordinal	Variant	Type	Description
1	response	WlanSoftmac_UpdateWmmParameters_Response
2	err	zx/Status

BITS

WlanRxInfoFlags flexible

Type: uint32

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Value	Description
FCS_INVALID	1	The FCS for the received frame was invalid.
FRAME_BODY_PADDING_4	2	Padding was added after the MAC header to align the frame body to 4 bytes.

WlanRxInfoValid flexible

Type: uint32

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Value	Description
PHY	1
DATA_RATE	2
CHAN_WIDTH	4
MCS	8
RSSI	16
SNR	32

WlanTxInfoFlags flexible

Type: uint32

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Value	Description
PROTECTED	1	Indicate this packet should be protected.
FAVOR_RELIABILITY	2	For rate control: indicate an important data frame, such as EAPOL, which should be sent reliably rather than fast, and is exempt from rate probing
QOS	4	Indicate that this packet should be sent out with QoS header when possible (11n+).

WlanTxInfoValid flexible

Type: uint32

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Value	Description
DATA_RATE	1
TX_VECTOR_IDX	2
PHY	4
CHANNEL_BANDWIDTH	8
MCS	16

CONSTANTS

Name	Value	Type	Description
WLAN_MAC_MAX_RATES	263	uint32	Added: 15

SERVICES

Service

Defined in fuchsia.wlan.softmac/softmac.fidl

Name	Type	Transport
wlan_softmac	fuchsia.wlan.softmac/WlanSoftmac	Driver