fuchsia.wlan.common

添加时间：7

结构体

DataPlaneExtension

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示数据平面的实现位置。 这是一个 MAC 子层扩展，可用于 Fullmac 或 softmac。这个 扩展程序不属于 802.11-2016 规范。

字段类型说明默认
data_plane_type DataPlaneType 无默认设置

DeviceExtension

在 fuchsia.wlan.common/driver_features.fidl 中定义

特定于设备的类似功能信息。 这是 MAC 子层扩展。此扩展程序不属于 802.11-2016 规范。

字段类型说明默认
is_synthetic bool

表示设备不是真实的硬件设备。仅限此附加信息 以支持 SYNTH 值 fuchsia.hardware.ethernet/EthernetFeature。

 无默认设置
mac_implementation_type MacImplementationType

指示 MAC 层的实现位置。

 无默认设置
tx_status_report_supported bool

指明设备是否支持传输报告。

 无默认设置

DfsFeature

在 fuchsia.wlan.common/driver_features.fidl 中定义

动态频率选择。 请参阅 IEEE 802.11-2016 11.9。 这是一项频谱管理功能，适用于 Fullmac 或 softmac。

字段类型说明默认
supported bool

如果为 true，驱动程序将实现 DFS 过程（例如，在 ）。根据驱动程序是否实现 DFS 过程， 较高层可以调整其逻辑（例如，包含/排除频道） （需要 DFS）。

 无默认设置

DiscoverySupport

在 fuchsia.wlan.common/driver_features.fidl 中定义

与发现潜在 BSS 相关的功能。 请参阅 IEEE 802.11-2016 11.1.4.2 和 11.1.4.3。

字段类型说明默认
scan_offload ScanOffloadExtension 无默认设置
probe_response_offload ProbeResponseOffloadExtension 无默认设置

MacSublayerSupport

在 fuchsia.wlan.common/driver_features.fidl 中定义

与 MAC 子层（在 MLME 下）相关的功能。 请参阅 IEEE 802.11-2016 10。

字段类型说明默认
rate_selection_offload RateSelectionOffloadExtension 无默认设置
data_plane DataPlaneExtension 无默认设置
device DeviceExtension 无默认设置

MfpFeature

在 fuchsia.wlan.common/driver_features.fidl 中定义

Management Frame Protection。 请参阅 IEEE 802.11-2016 4.5.4.9。 这是一项安全功能，适用于 Fullmac 或 softmac。

字段类型说明默认
supported bool 无默认设置

ProbeResponseOffloadExtension

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示处理探测响应的位置和方式。 请参阅 IEEE 802.11-2016 11.1.4.3。 这是一个 Discovery 扩展程序，预计会仅用于 softmac。

字段类型说明默认
supported bool

如果为 true，驱动程序将响应探测请求；否则 MLME 必须响应。

 无默认设置

RateSelectionOffloadExtension

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示速率选择逻辑的编排位置和方式。 请参阅 IEEE 802.11-2016 10.7。 这是 MAC 子层扩展，应仅用于 softmac。

字段类型说明默认
supported bool

如果为 true，则驱动程序会编排速率选择；否则 MLME 必须这样做。

 无默认设置

SaeFeature

在 fuchsia.wlan.common/driver_features.fidl 中定义

同时验证等于。 请参阅 IEEE 802.11-2016 12.4。 这是一项安全功能，适用于 Fullmac 或 softmac。

字段类型说明默认
driver_handler_supported bool

SAE 可以由驱动程序处理。

 无默认设置
sme_handler_supported bool

SAE 可以由 SME 处理。

 无默认设置

ScanOffloadExtension

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示扫描逻辑的编排位置和方式。 请参阅 IEEE 802.11-2016 11.1.4.2 和 11.1.4.3。 这是一个 Discovery 扩展程序，预计会仅用于 softmac。

字段类型说明默认
supported bool

如果为 true，驱动程序将编排扫描；否则 MLME 必须这样做。

 无默认设置
scan_cancel_supported bool
添加时间：10
 无默认设置

SecuritySupport

在 fuchsia.wlan.common/driver_features.fidl 中定义

与安全性 / 访问权限控制和数据机密性相关的功能。 请参阅 IEEE 802.11-2016 4.5.4 和 802.11-2016 12。

字段类型说明默认
sae SaeFeature 无默认设置
mfp MfpFeature 无默认设置

SpectrumManagementSupport

在 fuchsia.wlan.common/driver_features.fidl 中定义

与频谱管理相关的功能。 请参阅 IEEE 802.11-2016 4.5.5、11.8 和 11.9。

字段类型说明默认
dfs DfsFeature 无默认设置

WlanChannel

在 fuchsia.wlan.common/wlan_common.fidl 中定义

字段类型说明默认
primary uint8 无默认设置
cbw ChannelBandwidth 无默认设置
secondary80 uint8 无默认设置

WlanTxResult

在 fuchsia.wlan.common/wlan_common.fidl 中定义

TX 状态报告由 Minstrel 速率选择算法使用 测试应使用 //src/connectivity/wlan/testing/hw-sim/src/lib.rs 中的默认值

添加时间：13

字段类型说明默认
tx_result_entry [8]

一个 PPDU 帧最多支持 8 个不同的 tx_vector。 WLAN_TX_VECTOR_IDX_INVALID 表示没有更多条目。

 无默认设置
peer_addr fuchsia.wlan.ieee80211/MacAddr

目标 MAC 地址或数据包标头中的 addr1。

 无默认设置
result_code WlanTxResultCode 无默认设置

WlanTxResultEntry

在 fuchsia.wlan.common/wlan_common.fidl 中定义

WlanTxResult 报告中的 1 个条目。表示在 上尝试传输的次数 但并不表示传输成功。

添加时间：13

字段类型说明默认
tx_vector_idx uint16 无默认设置
attempts uint8

使用此特定事务向量的总尝试次数，包括成功尝试次数。 DDK 假定每个数据包的尝试次数不超过 255 次。（通常 <= 8）

 无默认设置

WlanWmmAccessCategoryParameters

在 fuchsia.wlan.common/associnfo.fidl 中定义

WFA WMM v1.2、2.2.2

添加时间：13

字段类型说明默认
ecw_min uint8

以指数形式表示的争用窗口下限 cw_min = 2^(ecw_min) - 1。争用时段的单位是“槽时间”， 因每个标准而异（例如 9 微秒、13 微秒等）

 无默认设置
ecw_max uint8

以指数形式表示的争用窗口上限 cw_max = 2^(ecw_max) - 1。争用时段的单位是“槽时间”， 因每个标准而异（例如 9 微秒、13 微秒等）

 无默认设置
aifsn uint8

仲裁间隔数（控制发送每一帧之间的等待时间）

 无默认设置
txop_limit uint16

以 32 微秒为单位的 TXOP 限制

 无默认设置
acm bool

准入控制是否是强制性的

 无默认设置

WlanWmmParameters

在 fuchsia.wlan.common/associnfo.fidl 中定义

添加时间：13

字段类型说明默认
apsd bool 无默认设置
ac_be_params WlanWmmAccessCategoryParameters 无默认设置
ac_bk_params WlanWmmAccessCategoryParameters 无默认设置
ac_vi_params WlanWmmAccessCategoryParameters 无默认设置
ac_vo_params WlanWmmAccessCategoryParameters 无默认设置

精英

BssType 灵活

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

添加时间：13

名称值说明
0
1
2
3
4

ChannelBandwidth 柔性

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

添加时间：13

名称值说明
1
2
3
4
5
6

DataPlaneType 严格

类型：uint8

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示数据平面的实现位置。

名称值说明
1
2

GuardInterval 严格

类型：uint8

在 fuchsia.wlan.common/wlan_common.fidl 中定义

HT 和 VHT 保护间隔。 请参阅 IEEE 802.11-2016 表 19-1 和表 21-1。

名称值说明
1
2

MacImplementationType 严格

类型：uint8

在 fuchsia.wlan.common/driver_features.fidl 中定义

指示 MAC 层的实现位置。

名称值说明
1
2

PowerSaveType 严格

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
0
1
2
3

RequestStatus 严格

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
0
1
2
3
4

ScanType 严格

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
1
2

WlanBand 柔性环境

类型：uint8

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
0
1

WlanKeyType 柔性

类型：uint8

在 fuchsia.wlan.common/associnfo.fidl 中定义

添加时间：13

名称值说明
1
2
3
4

WlanMacRole 柔性

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
1
2
3

WlanPhyType 柔性

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

支持不同 MCS 和载荷数据速率的 PHY 类型。 基于 IEEE 802.11-2016/2020 附录 C + 修正条款中的 dot11PHYType

名称值说明
1

IEEE 802.11-2016 第 15 条： 直接序列扩散频谱 支持 1 Mbps 和 2 Mbps。
2

IEEE 802.11-2016 第 16 条： 高速率 DSSS 支持 5.5 Mbps 和 11 Mbps。 也称为 ERP-CCK
3

IEEE 802.11a/g 或 IEEE 802.11-2016 第 17 条： 正交分频多路复用 支持 6、9、12、18、24、36、48 和 54 Mbps。
4

IEEE 802.11g 或 IEEE 802.11-2016 第 18 条： 扩展速率 PHY 支持 1、2、5.5、11、12、24 Mbps 以及可选的 6 到 54 Mbps。 包括 DSSS/HR/OFDM 费率和调制。
5

IEEE 802.11n 或 IEEE 802.11-2016 第 19 条： 高吞吐量 PHY 支持的速率最高为 495 Mbps。
6

802.11ad 或 IEEE 802.11-2016 条款 20： 定向多千兆位 PHY
7

IEEE 802.11ac 或 IEEE 802.11-2016 条款 21： 超高吞吐量 PHY 支持的速率最高可达 6.9 Gbps。
8

IEEE 802.11af 或 IEEE 802.11-2016 第 22 条： 电视超高吞吐量 PHY 支持高达 568.9 Mbps 的电视频谱速率
9

IEEE 802.11ah 或 IEEE 802.11-2020 第 23 条： Sub 1 GHz PHY
10

IEEE 802.11aj 或 IEEE 802.11-2020 条款 24： 中国定向多千兆位 PHY
11

IEEE 802.11aj 或 IEEE 802.11-2020 第 25 条： 中国毫米波多千兆位 PHY
12

IEEE 802.11ax：高效率 PHY 支持的速率最高可达 9.6 Gbps（哇！）

WlanProtection 严格

类型：uint8

在 fuchsia.wlan.common/wlan_common.fidl 中定义

添加时间：HEAD

名称值说明
0
1
2
3

WlanSoftmacHardwareCapabilityBit strict

类型：uint32

在 fuchsia.wlan.common/wlan_common.fidl 中定义

名称值说明
32

短数据包前导。
256

频谱管理。
512
1024

数据包冲突后的槽时间较短。
4096

无线电测量。
65536

WlanTxResultCode 柔性

类型：uint8

在 fuchsia.wlan.common/wlan_common.fidl 中定义

数据包传输的结果。

添加时间：13

名称值说明
0

未接收 ACK 或传输失败。
1

从对等方收到 ACK。

表

JoinBssRequest

在 fuchsia.wlan.common/wlan_common.fidl 中定义

添加时间：13

Ordinal字段类型说明
bssid fuchsia.wlan.ieee80211/MacAddr
bss_type BssType
remote bool
beacon_period uint16

WlanKeyConfig

在 fuchsia.wlan.common/wlan_common.fidl 中定义

添加时间：HEAD

Ordinal字段类型说明
protection WlanProtection

要保护的路径：“无”“TX”“RX”或“TX 和 RX”。
cipher_oui uint8[3]

IEEE 加密套件选择器。 请参阅 IEEE 标准 802.11-2016、9.4.2.25.2、表 9-131 选填。如果未指定，则假定这是 IEEE OUI。
cipher_type fuchsia.wlan.ieee80211/CipherSuiteType

加密类型。 必填。
key_type WlanKeyType

此密钥是成对密钥、组密钥还是对等密钥。 必填。
peer_addr fuchsia.wlan.ieee80211/MacAddr

成对密钥和对等密钥的对等 MAC 地址。 对于群组密钥，此值始终是广播地址。 必填。
key_idx uint8

轮替密钥的索引，例如群组密钥。 对于不轮替的密钥类型，此值始终为 0（例如成对密钥。 必填。

TODO(https://fxbug.dev/301104836)：这是一个 uint8，但使用的是 MLME FIDL 中的 SetKeyDescriptor，并且 Fullmac FIDL 中的 DeleteKeysDescriptor 针对 key_id/key_idx 使用 uint16。我们应该考虑 确保所有这些元素都使用相同的类型
key vector<uint8>[32]

它们键的实际字节数。 必填。
rsc uint64

仅针对组键接收序列计数器。 在所有其他情况下，RSC 将为 0。 可选。

常量

名称值类型说明
MAX_BANDS 16 uint8

此常量定义了包含功能的数组的固定长度 。
MAX_SUPPORTED_MAC_ROLES 16 uint8

此常量定义包含受 支持 MAC 角色的数组的固定长度。 PHY 实体。
MAX_SUPPORTED_PHY_TYPES 64 uint8

此常量定义了包含受系统支持的 PHY 类型的数组的固定长度。 PHY 实体。
WLAN_MAC_MAX_EXT_RATES 255 uint32
添加时间：13
WLAN_MAC_MAX_SUPP_RATES 8 uint32

仅在关联上下文中定义的信息 请注意对每个字段的微妙解读：它们旨在 反映可在关联中安全使用的参数 许多参数无法区分 Rx 功能与 Tx 功能。 在这些情况下，功能通常同时应用于 Rx 和 Tx。 有些参数仅与 Rx 区分开来，而有些参数仅用于 Tx。

添加时间：13
WLAN_TX_RESULT_MAX_ENTRY 8 uint32
添加时间：13
WLAN_TX_VECTOR_IDX_INVALID 0 uint16

别名

名称值说明
WlanSoftmacHardwareCapability uint32