fuchsia.wlan.common

新增：7

STRUCTS

BandRssiAdjustment

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

对指定频段中 BSS 的观测 RSSI 值进行的调整。

Added: HEAD

字段类型说明默认
band fuchsia.wlan.ieee80211/WlanBand 无默认应用
rssi_adjustment int8 无默认应用

ScheduledScanPlan

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

扫描计划定义了扫描迭代次数和扫描间隔。首次扫描的时间（例如 t=0、t=间隔等）由固件决定。

Added: HEAD

字段类型说明默认
interval uint32

扫描间隔时间（以秒为单位）。

 无默认应用
iterations uint32

要扫描的迭代次数。如果为 0，则扫描方案将无限期运行。

 无默认应用

WlanChannel

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

已移除：28

字段类型说明默认
primary uint8 无默认应用
cbw ChannelBandwidth 无默认应用
secondary80 uint8 无默认应用

WlanTxResult

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

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

已移除：HEAD 已添加：13

字段类型说明默认
tx_result_entry array<WlanTxResultEntry, 8>

一个 PPDU 帧最多可有 8 个不同的 tx_result_entry。 WLAN_TX_VECTOR_IDX_INVALID 表示没有更多条目。

 无默认应用
peer_addr fuchsia.wlan.ieee80211/MacAddr

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

 无默认应用
result_code WlanTxResultCode 无默认应用

WlanTxResultEntry

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

WlanTxResult 报告中的一个条目。表示在特定 tx 向量上尝试传输的次数，但不表示传输成功。

已移除：HEAD 已添加：13

字段类型说明默认
tx_vector_idx uint16 无默认应用
attempts uint8

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

 无默认应用

WlanWmmAccessCategoryParameters

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

WFA WMM v1.2、2.2.2

已移除：HEAD 已添加：13

字段类型说明默认
ecw_min uint8 无默认应用
ecw_max uint8 无默认应用
aifsn uint8 无默认应用
txop_limit uint16 无默认应用
acm bool 无默认应用

WlanWmmParameters

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

已移除：HEAD 已添加：13

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

枚举

BssType flexible

类型：uint32

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

已移除：HEAD 已添加：13

名称值说明
0
1
2
3
4

ChannelBandwidth flexible

类型：uint32

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

已移除：28 已添加：13

名称值说明
1
2
3
4
5
6

DataPlaneType flexible

类型：uint8

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

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

名称值说明
1
2

GuardInterval strict

类型：uint8

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

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

已移除：HEAD

名称值说明
1
2

MacImplementationType flexible

类型：uint8

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

指明 MAC 层的实现位置。

名称值说明
1
2

PowerSaveType strict

类型：uint32

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

名称值说明
0
1
2
3

ScanType strict

类型：uint32

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

名称值说明
1
2

WlanKeyType flexible

类型：uint8

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

已移除：HEAD 已添加：13

名称值说明
1
2
3
4

WlanMacRole flexible

类型：uint32

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

名称值说明
1
2
3

WlanPhyType flexible

类型：uint32

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

已移除：HEAD

名称值说明
1
2
3
4
5
6
7
8
9
10
11
12

WlanSoftmacHardwareCapabilityBit strict

类型：uint32

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

已移除：HEAD

名称值说明
32
256
512
1024
4096
65536

WlanTxResultCode flexible

类型：uint8

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

数据包传输的结果。

已移除：HEAD 已添加：13

名称值说明
0

未收到 ACK 或传输失败。
1

已从对等网关收到 ACK。

TABLES

ApfPacketFilterSupport

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

Android 数据包过滤器 (APF) 支持。

新增：31

序数字段类型说明
supported bool
version int32

仅在“supported”为 true 时有效。
max_filter_length int32

仅在“supported”为 true 时有效。

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

表示设备不是真实的硬件设备。此扩展程序仅用于支持 fuchsia.hardware.ethernet/EthernetFeature 中的 SYNTH 值。
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。

已移除：HEAD

序数字段类型说明
scan_offload ScanOffloadExtension
probe_response_offload ProbeResponseOffloadExtension

JoinBssRequest

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

加入请求的输入参数。此定义在 softmac.fidl 和 wlantap.fidl 之间共享。

已移除：HEAD 已添加：13

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

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 中定义

管理帧保护。 请参阅 IEEE 802.11-2016 4.5.4.9。 这是一项安全功能，可用于 fullmac 或 softmac。

序数字段类型说明
supported bool

OweFeature

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

机会性无线加密。 请参阅 RFC 8110。 这是一项安全功能，可用于 fullmac 或 softmac。

新增：31

序数字段类型说明
supported bool

ProbeResponseOffloadExtension

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

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

已移除：HEAD

序数字段类型说明
supported bool

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

RateSelectionOffloadExtension

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

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

序数字段类型说明
supported bool

如果为 true，则驱动程序会编排速率选择；否则，MLME 必须执行此操作。

RssiMonitorSupport

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

固件 RSSI 阈值监控分流支持。

新增：NEXT

序数字段类型说明
supported bool

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 处理。
hash_to_element_supported bool

指示驱动程序是否与 SAE hash-to-element 兼容。 在 SME 处理程序情况下，这只是意味着传递具有 SAE_HASH_TO_ELEMENT 状态代码的 SAE 帧。

新增：30
pmksa_caching_supported bool

指明驱动程序是否在 SAE 期间启用 PMKSA 缓存，如果启用，它会在关联请求中将新的 PMKID 附加到 RSNE。

新增：NEXT

ScanOffloadExtension

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

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

已移除：HEAD

序数字段类型说明
supported bool

如果为 true，则驱动程序会编排扫描；否则，MLME 必须执行此操作。
scan_cancel_supported bool
新增：10

ScheduledScanMatchSet

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

一组嵌套的属性，用于在预定扫描期间进行匹配。BSS 必须满足匹配集中的所有现有条件，才会被视为匹配。

由于并非所有硬件都支持匹配所有类型的属性，因此无法保证报告的 BSS 完全符合匹配集。如果驱动程序无法支持匹配集，则可能会返回 EINVAL，或者可能会忽略匹配条件。

Added: HEAD

序数字段类型说明
ssid fuchsia.wlan.ieee80211/Ssid

可选。
bssid fuchsia.wlan.ieee80211/MacAddr

可选。
min_rssi_threshold int8

可选。要应用于所有 BSS 的最低 RSSI 阈值。
relative_rssi_threshold int8

可选。RSSI 值增量，相对于当前连接的 BSS 的 RSSI，以满足匹配集。可能为负值（例如，-5 dB 表示观察到的 BSS 的 RSSI 必须不低于当前 RSSI - 5 dB）。如果当前未连接，系统会忽略此字段。
band_rssi_adjustments vector<BandRssiAdjustment>

可选。在与最小 RSSI 阈值和相对 RSSI 阈值进行比较之前，对观察到的 RSSI 值进行的 RSSI 频段调整。

ScheduledScanRequest

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

请求定期扫描。

Added: HEAD

序数字段类型说明
scan_plans vector<ScheduledScanPlan>

必需：一个或多个扫描方案，需连续运行。在某些固件实现中，最后一个扫描计划可能会无限期运行，而不管迭代字段值如何。
ssids vector<fuchsia.wlan.ieee80211/Ssid>

可选。要扫描的 SSID 数量不少于 0。

如果存在，SSID 应包含在探测请求中。 如果存在空字符串，则应在探测请求中发送广播 SSID。如果矢量为空或不存在，则应仅执行被动扫描。
frequencies vector<uint32>

可选。应扫描的零个或多个信道频率。如果为空或不存在，系统将扫描监管网域的所有频道。
min_rssi_threshold int8

可选。要应用于所有 BSS 的最低 RSSI 阈值。
relative_rssi_threshold int8

可选。RSSI 值增量，相对于当前连接的 BSS 的 RSSI，以满足匹配集。可能为负值（例如，-5 dB 表示观察到的 BSS 的 RSSI 必须不低于当前 RSSI - 5 dB）。如果当前未连接，系统会忽略此字段。
band_rssi_adjustments vector<BandRssiAdjustment>

可选。在与最小 RSSI 阈值和相对 RSSI 阈值进行比较之前，对观察到的 RSSI 值进行的 RSSI 频段调整。
match_sets vector<ScheduledScanMatchSet>

零组或多组匹配条件。

如果存在，则系统只会报告通过顶级 RSSI 阈值过滤条件且与任何匹配集匹配的 BSS。

SecuritySupport

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

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

序数字段类型说明
sae SaeFeature
mfp MfpFeature
owe OweFeature
新增：31

SpectrumManagementSupport

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

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

序数字段类型说明
dfs DfsFeature

常量

名称值类型说明
MAX_BANDS 16 uint8

此常量定义了数组的固定长度，这些数组包含设备驱动程序支持的每个频段的功能。
MAX_SUPPORTED_MAC_ROLES 16 uint8

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

此常量定义了包含 PHY 实体支持的 PHY 类型的数组的固定长度。
WLAN_MAC_MAX_EXT_RATES 255 uint32
已移除：32 已添加：13
WLAN_MAC_MAX_SUPP_RATES 8 uint32
已移除：32 已添加：13
WLAN_TX_RESULT_MAX_ENTRY 8 uint32
已移除：HEAD 已添加：13
WLAN_TX_VECTOR_IDX_INVALID 0 uint16
已移除：HEAD

别名

名称值说明
WlanSoftmacHardwareCapability uint32
已移除：HEAD