fuchsia.wlan.common

Added: 7

STRUCTS

DataPlaneExtension

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where the data plane is implemented. This is a MAC sublayer extension, usable for fullmac or softmac. This extension is not part of the 802.11-2016 spec.

FieldTypeDescriptionDefault
data_plane_type DataPlaneType No default

DeviceExtension

Defined in fuchsia.wlan.common/driver_features.fidl

Feature-like information specific to the device. This is a MAC sublayer extension. This extension is not part of the 802.11-2016 spec.

FieldTypeDescriptionDefault
is_synthetic bool

Indicates that device is not a real hardware device. This extension only exists to support the SYNTH value in fuchsia.hardware.ethernet/EthernetFeature.

No default
mac_implementation_type MacImplementationType

Indicates where MAC layer is implemented.

No default
tx_status_report_supported bool

Indicates whether device supports transmission reports.

No default

DfsFeature

Defined in fuchsia.wlan.common/driver_features.fidl

Dynamic Frequency Selection. See IEEE 802.11-2016 11.9. This is a spectrum management feature, usable for fullmac or softmac.

FieldTypeDescriptionDefault
supported bool

If true, driver implements DFS procedures (e.g. vacate channel upon detecting RADAR). Based on whether the driver implements DFS procedures, higher layers may adjust their logic (e.g. to include/exclude channels that require DFS).

No default

DiscoverySupport

Defined in fuchsia.wlan.common/driver_features.fidl

Features related to discovery of potential BSSs. See IEEE 802.11-2016 11.1.4.2 and 11.1.4.3.

FieldTypeDescriptionDefault
scan_offload ScanOffloadExtension No default
probe_response_offload ProbeResponseOffloadExtension No default

MacSublayerSupport

Defined in fuchsia.wlan.common/driver_features.fidl

Features related to the MAC sublayer (below MLME). See IEEE 802.11-2016 10.

FieldTypeDescriptionDefault
rate_selection_offload RateSelectionOffloadExtension No default
data_plane DataPlaneExtension No default
device DeviceExtension No default

MfpFeature

Defined in fuchsia.wlan.common/driver_features.fidl

Management Frame Protection. See IEEE 802.11-2016 4.5.4.9. This is a security feature, usable for fullmac or softmac.

FieldTypeDescriptionDefault
supported bool No default

ProbeResponseOffloadExtension

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where and how probe responses are to be handled. See IEEE 802.11-2016 11.1.4.3. This is a discovery extension, expected to be used for softmac only.

FieldTypeDescriptionDefault
supported bool

If true, driver responds to probe requests; otherwise MLME must respond.

No default

RateSelectionOffloadExtension

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where and how rate selection logic is orchestrated. See IEEE 802.11-2016 10.7. This is a MAC sublayer extension, expected to be used for softmac only.

FieldTypeDescriptionDefault
supported bool

If true, driver orchestrates rate selection; otherwise MLME must do so.

No default

SaeFeature

Defined in fuchsia.wlan.common/driver_features.fidl

Simultaneous Authentication of Equals. See IEEE 802.11-2016 12.4. This is a security feature, usable for fullmac or softmac.

FieldTypeDescriptionDefault
driver_handler_supported bool

SAE can be handled by the driver.

No default
sme_handler_supported bool

SAE can be handled by SME.

No default

ScanOffloadExtension

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where and how scan logic is orchestrated. See IEEE 802.11-2016 11.1.4.2 and 11.1.4.3. This is a discovery extension, expected to be used for softmac only.

FieldTypeDescriptionDefault
supported bool

If true, driver orchestrates scans; otherwise MLME must do so.

No default
scan_cancel_supported bool
Added: 10
No default

SecuritySupport

Defined in fuchsia.wlan.common/driver_features.fidl

Features related to security / access control and data confidentiality. See IEEE 802.11-2016 4.5.4 and 802.11-2016 12.

FieldTypeDescriptionDefault
sae SaeFeature No default
mfp MfpFeature No default

SpectrumManagementSupport

Defined in fuchsia.wlan.common/driver_features.fidl

Features related to spectrum management. See IEEE 802.11-2016 4.5.5, 11.8, and 11.9.

FieldTypeDescriptionDefault
dfs DfsFeature No default

WlanChannel

Defined in fuchsia.wlan.common/wlan_common.fidl

FieldTypeDescriptionDefault
primary uint8 No default
cbw ChannelBandwidth No default
secondary80 uint8 No default

WlanTxStatus

Defined in fuchsia.wlan.common/wlan_common.fidl

TX status reports are used by the Minstrel rate selection algorithm Tests should use the default value in //src/connectivity/wlan/testing/hw-sim/src/lib.rs

FieldTypeDescriptionDefault
tx_status_entry [8]

up to 8 different tx_vector for one PPDU frame. WLAN_TX_VECTOR_IDX_INVALID indicates no more entries.

No default
peer_addr fuchsia.wlan.ieee80211/MacAddr

Destination mac address, or addr1 in packet header.

No default
result WlanTxResult No default

WlanTxStatusEntry

Defined in fuchsia.wlan.common/wlan_common.fidl

One entry in a WlanTxStatus report. Indicates a number of attempted transmissions on a particular tx vector, but does not imply successful transmission.

FieldTypeDescriptionDefault
tx_vector_idx uint16 No default
attempts uint8

Number of total attempts with this specific tx vector, including successful attempts. DDK assumes the number of attempts per packet will not exceed 255. (typically <= 8)

No default

ENUMS

ChannelBandwidth strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
0
1
2
3
4
5

DataPlaneType strict

Type: uint8

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where data plane is implemented.

NameValueDescription
1
2

GuardInterval strict

Type: uint8

Defined in fuchsia.wlan.common/wlan_common.fidl

HT and VHT guard interval. See IEEE 802.11-2016 Table 19-1 and Table 21-1.

NameValueDescription
1
2

MacImplementationType strict

Type: uint8

Defined in fuchsia.wlan.common/driver_features.fidl

Indicates where MAC layer is implemented.

NameValueDescription
1
2

PowerSaveType strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
0
1
2
3

RequestStatus strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
0
1
2
3
4

ScanType strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
1
2

WlanBand flexible

Type: uint8

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
0
1

WlanMacRole strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
1
2
3

WlanPhyType strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

PHY types supporting different MCS and payload data rates. Based off of dot11PHYType from IEEE 802.11-2016/2020 Annex C + Amendments

NameValueDescription
1

IEEE 802.11-2016 Clause 15: Direct Sequence Spread Spectrum Supports 1, 2 Mbps.

2

IEEE 802.11-2016 Clause 16: High Rate DSSS Supports 5.5, 11 Mbps. Also referred to as ERP-CCK

3

IEEE 802.11a/g or IEEE 802.11-2016 Clause 17: Orthogonal Frequency Division Multiplexing Supports 6, 9, 12, 18, 24, 36, 48, and 54 Mbps.

4

IEEE 802.11g or IEEE 802.11-2016 Clause 18: Extended Rate PHY Supports 1, 2, 5.5, 11, 12, 24 Mbps + optionally 6, 54 Mbps. Encompasses DSSS/HR/OFDM rates and modulation.

5

IEEE 802.11n or IEEE 802.11-2016 Clause 19: High Throughput PHY Supports rates up to 495 Mbps.

6

802.11ad or IEEE 802.11-2016 Clause 20: Directional Multi-Gigabit PHY

7

IEEE 802.11ac or IEEE 802.11-2016 Clause 21: Very High Throughput PHY Supports rates up to 6.9 Gbps.

8

IEEE 802.11af or IEEE 802.11-2016 Clause 22: Television Very High Throughput PHY Supports rates of up to 568.9 Mbps in TV spectrum

9

IEEE 802.11ah or IEEE 802.11-2020 Clause 23: Sub 1-GHz PHY

10

IEEE 802.11aj or IEEE 802.11-2020 Clause 24: China Directional Multi-Gigabit PHY

11

IEEE 802.11aj or IEEE 802.11-2020 Clause 25: China Millimeter-wave Multi-Gigabit PHY

12

IEEE 802.11ax: High Efficiency PHY Supports rates of up to 9.6 Gbps (whew!)

WlanSoftmacHardwareCapabilityBit strict

Type: uint32

Defined in fuchsia.wlan.common/wlan_common.fidl

NameValueDescription
32

Short packet preamble.

256

Spectrum management.

512
1024

Short slot times after packet collision.

4096

Radio measurement.

65536

WlanTxResult strict

Type: uint8

Defined in fuchsia.wlan.common/wlan_common.fidl

Outcome of a packet transmission.

NameValueDescription
0

ACK was not received or transmission otherwise failed.

1

ACK was received from peer.

CONSTANTS

NameValueTypeDescription
MAX_BANDS 16 uint8

This constant defined the fixed length for arrays containing the capabilities for each band supported by a device driver.

MAX_SUPPORTED_MAC_ROLES 16 uint8

This constant defines fixed length for arrays containing MAC roles supported by PHY entities.

MAX_SUPPORTED_PHY_TYPES 64 uint8

This constant defines fixed length for arrays containing PHY types supported by PHY entities.

WLAN_TX_STATUS_MAX_ENTRY 8 uint32
WLAN_TX_VECTOR_IDX_INVALID 0 uint16

ALIASES

NameValueDescription
WlanSoftmacHardwareCapability uint32