Linux 内核 802.11 无线网络子系统开发指南导读：cfg80211 与 mac80211 全景解析
【免费下载链接】linuxLinux kernel source tree项目地址: https://gitcode.com/GitHub_Trending/li/linux
导读
本文以 Linux 内核文档 Documentation/driver-api/80211/introduction.rst 为骨架，为内核开发者系统梳理 Linux 中 802.11 无线网络各个子系统的角色划分、文档体系与源码入口。读完本文，你将掌握 cfg80211 与 mac80211 在内核无线栈中的定位与边界、两者与驱动及用户空间的调用关系，以及如何借助内核源码（include/net/cfg80211.h、include/net/mac80211.h、net/mac80211/）逐层深入研究无线驱动开发。
一、这份文档是什么：Linux 802.11 驱动开发者指南的"开篇"
introduction.rst是内核文档集中Linux 802.11 Driver Developer's Guide（见 Documentation/driver-api/80211/index.rst）的引言部分。它由 mac80211/cfg80211 的主要维护者 Johannes Berg 撰写，版权标注为 2007–2009 年，属于面向内核开发者而非普通用户的技术手册。
引言明确阐述了整本手册的写作宗旨：
这些"书"试图描述 Linux 中参与 802.11 无线网络的各种子系统；由于面向内核开发者，它们不仅给出高层概览，还致力于记录内核中使用的结构与函数。
这句话定义了整套文档的两个层次：
- 高层概览——各子系统如何协作完成无线连接、扫描、监管等任务；
- 底层 API 记录——通过
kernel-doc机制直接嵌入头文件注释，把结构体、枚举与函数签名完整呈现给驱动作者。
该引言对应整本手册的四个组成部分（见 index.rst 的 toctree）：introduction（本引言）、cfg80211（配置子系统）、mac80211（MAC 层基础）、mac80211-advanced（高级主题）。
二、阅读前提：对 IEEE 802.11 标准的熟悉程度
引言对读者提出了明确的前置要求：
读者应当熟悉 IEEE 在 802.11-2007（或之后版本）中发布的 802.11 标准。文档中对标准的引用将采用"802.11-2007 8.1.5"这样的格式。
这说明两点：
- 该指南不重复讲解 802.11 协议本身（如管理帧格式、认证/关联流程、信道划分），而是假设读者已具备协议基础；
- 文档中所有对标准条目的引用都遵循"
标准版本 章.节"的约定，例如802.11-2007 8.1.5即指向 802.11-2007 标准的第 8 章第 1.5 节。在内核代码注释与文档中遇到类似引用时，可按此格式回溯 IEEE 标准原文。
三、内核 802.11 无线栈的整体架构：三个层次的分工
虽然引言本身篇幅简短，但它所介绍的"多个子系统"正是理解 Linux 无线栈的关键。结合 include/net/cfg80211.h 中DOC: Introduction的注释，可以完整还原 802.11 在 Linux 内核中的分层结构：
用户空间 (wpa_supplicant / iw / NetworkManager) │ nl80211 netlink 协议 ▼ cfg80211 ──── 配置与监管子系统：设备注册、扫描、连接配置 │ ├──► mac80211（软件 MAC 层实现，为多数 WiFi 芯片提供协议栈） │ ▼ 驱动（如 iwlwifi、ath10k、mt76 等）──► 硬件关键事实（均可从cfg80211.h的DOC: Introduction注释确认）：
- cfg80211 是 802.11 设备的配置 API，它在用户空间与驱动之间架起桥梁，并提供与 802.11 相关的通用工具功能；
- 所有现代无线驱动必须直接或间接（经由 mac80211）使用 cfg80211，从而通过 nl80211 向用户空间提供一致的 API；
- 出于向后兼容，cfg80211 仍向用户空间提供 wireless extensions，但对驱动完全屏蔽这一层——驱动作者只需要面向统一的 cfg80211 接口编程；
- cfg80211 还包含频谱监管（regulatory）强制执行的代码，确保无线设备遵守各国无线电频谱使用限制。
因此，"802.11 无线网络在内核中由多个子系统共同支撑"这句话的实质是：cfg80211 负责配置与策略，mac80211 负责 MAC 层协议处理，驱动负责硬件抽象，三者通过明确的 API 契约衔接。
四、cfg80211 子系统：设备注册到监管执行的完整功能面
Documentation/driver-api/80211/cfg80211.rst 把 cfg80211 划分为八个功能章节，对应include/net/cfg80211.h中通过kernel-doc提取的结构与函数，是驱动开发者查阅 API 的索引：
| 章节 | 核心内容 | 代表符号（均在 include/net/cfg80211.h） |
|---|---|---|
| Device registration | 设备注册流程 | wiphy、wireless_dev、wiphy_new、wiphy_register、wiphy_unregister、wiphy_priv |
| Actions and configuration | 连接动作与配置 | cfg80211_ops、cfg80211_connect_params、cfg80211_roamed、cfg80211_disconnected |
| Scanning and BSS list handling | 扫描与 BSS 列表 | cfg80211_scan_request、cfg80211_scan_done、cfg80211_bss、cfg80211_inform_bss |
| Utility functions | 通用工具函数 | ieee80211_channel_to_frequency、ieee80211_frequency_to_channel、ieee80211_hdrlen |
| Data path helpers | 数据通路辅助 | ieee80211_data_to_8023、ieee80211_amsdu_to_8023s、cfg80211_classify8021d |
| Regulatory enforcement infrastructure | 监管强制执行 | regulatory_hint、wiphy_apply_custom_regulatory、freq_reg_info |
| RFkill integration | RFkill 集成 | wiphy_rfkill_set_hw_state、wiphy_rfkill_start_polling |
| Test mode | 测试模式 | cfg80211_testmode_alloc_reply_skb、cfg80211_testmode_event |
4.1 设备注册：wiphy 与 wireless_dev
cfg80211.h的DOC: Device registration注释解释了注册模型的核心概念：
wiphy是每个物理无线设备的根本结构，每个实例描述系统上一个物理无线设备；驱动必须先分配并注册 wiphy，才能使用 cfg80211；- 每个 wiphy 可以关联零个、一个或多个虚拟接口（virtual interface），虚拟接口通过网络设备结构中的
ieee80211_ptr指针指向struct wireless_dev来标识其无线属性，wireless_dev通常嵌入在网络接口的私有数据区； - 驱动可以允许运行时动态创建/销毁虚拟接口，但至少需要一个接口或具备创建接口的能力，否则无线设备无法发挥作用；
wiphy结构同时承载设备能力信息与驱动操作函数指针（cfg80211_ops）。
从源码看，通道能力通过enum ieee80211_channel_flags描述（include/net/cfg80211.h），覆盖从禁用通道、NO_IR（禁止主动辐射）、雷达检测要求，到 HT40/80/160/320 MHz 带宽限制、HE/EHT 使能限制乃至 6 GHz 频段 VLP/AFC 客户端限制等细分场景，这些标志由监管代码设置，驱动读取后决定可用信道与工作参数。
4.2 监管强制执行与 RFkill
cfg80211 不只做配置转发，还承担两个系统级职责：
- 监管强制执行：
regulatory_hint允许驱动或用户空间给出监管提示，freq_reg_info查询频率监管信息，确保信道功率、可用性与各国法规一致； - RFkill 集成：
wiphy_rfkill_set_hw_state等接口把硬件射频开关状态接入内核 rfkill 框架，实现软开关与硬开关的统一管理。
五、mac80211 子系统：基础篇与高级篇的内容地图
mac80211 是内核提供的软件 MAC 层实现。整本手册中关于 mac80211 的内容分为两大部分：
5.1 mac80211 基础篇（mac80211.rst）
基础篇开篇即声明：本部分只覆盖站点（station）与监听（monitor）模式，其余模式所需信息放在高级篇。章节安排包括：
- Basic hardware handling（基本硬件处理）：
ieee80211_hw结构的分配与注册、rate/mode 结构的建立、ieee80211_ops回调模型、硬件能力描述。对应ieee80211_alloc_hw、ieee80211_register_hw、ieee80211_unregister_hw、ieee80211_free_hw（均在include/net/mac80211.h）； - PHY configuration：PHY 的启动/停止回调与
ieee80211_conf、ieee80211_conf_flags结构； - Virtual interfaces（虚拟接口）：
add_iface/remove_iface回调与接口配置回调，AP 模式相关话题也在此讨论；文档特别强调一个"大而显眼的建议"——初期只允许 STA 模式下单一接口，避免多接口复杂度； - Receive and transmit processing（收发处理）：mac80211 与驱动之间的收/发路径、发送状态（TX status）处理，细分到帧格式、包对齐（见 net/mac80211/rx.c 的
DOC: Packet alignment）、从中断调用 mac80211 的约束，以及ieee80211_rx、ieee80211_tx_status_skb、队列唤醒/停止（ieee80211_wake_queue等）全套 API； - Frame filtering（帧过滤）：
ieee80211_filter_flags与驱动向 mac80211 上报的接收过滤能力； - mac80211 workqueue：
ieee80211_queue_work、ieee80211_queue_delayed_work，用于驱动把需要进程上下文的操作延迟到 mac80211 工作队列执行。
5.2 mac80211 高级篇（mac80211-advanced.rst）
高级篇面向"利用更多硬件能力、提升性能"的进阶交互，主题包括：
- LED 支持：设备 LED 应尽量暴露为 LED class 设备并挂接合适触发器，mac80211 提供 TX/RX/关联/射频四类 LED 名称接口与吞吐量闪烁触发器（
ieee80211_create_tpt_led_trigger）； - 硬件加密加速：
set_key_cmd、ieee80211_key_conf及 TKIP 密钥派生辅助函数（ieee80211_get_tkip_p1k等）； - 省电支持（Powersave）与Beacon 过滤支持（
ieee80211_beacon_loss）； - 多队列与 QoS：
ieee80211_tx_queue_params； - AP 模式支持：重点包括对省电客户端的支持——
ieee80211_beacon_get、ieee80211_get_buffered_bc、ieee80211_sta_eosp、ieee80211_sta_set_buffered等，以及ieee80211_sta_ps_transition系列接口； - 多虚拟接口支持：
ieee80211_iterate_active_interfaces（及 atomic 变体），文档提示相同 MAC 地址的 WDS 接口几乎总是可行的； - Station 处理：
ieee80211_sta、ieee80211_find_sta、sta_notify_cmd； - 硬件扫描卸载：
ieee80211_scan_completed； - 聚合（Aggregation）：TX 方向见 net/mac80211/agg-tx.c 的
DOC: TX A-MPDU aggregation，RX 方向见 net/mac80211/agg-rx.c 的DOC: RX A-MPDU aggregation，入口为ieee80211_ampdu_mlme_action； - 空间复用省电（SMPS）：
ieee80211_request_smps、ieee80211_smps_mode； - 速率控制 API：
ieee80211_start_tx_ba_session、ieee80211_stop_tx_ba_session、ieee80211_rate_control_changed、ieee80211_tx_rate_control； - Key 处理：见 net/mac80211/key.c 的
DOC: Key handling basics； - Station 信息处理：
sta_info结构与生命周期规则（见 net/mac80211/sta_info.c 的DOC: STA information lifetime rules）、聚合相关的tid_ampdu_tx/tid_ampdu_rx，以及"大量 RCU 同步"的锁模型说明。
从仓库结构看，net/mac80211/目录（如agg-tx.c、agg-rx.c、key.c、sta_info.c、ap.c、chan.c、cfg.c等）正是这些文档章节对应的实现实体，阅读文档时可随时对照源码验证。
六、如何在仓库中继续深入：一条可操作的阅读路径
对希望上手 Linux 无线驱动开发的读者，推荐按以下路径在仓库内展开：
- 建立全貌：通读 Documentation/driver-api/80211/introduction.rst 与 index.rst，明确手册四部分结构；
- 理解配置面：对照 cfg80211.rst 阅读 include/net/cfg80211.h 中的
DOC: Introduction与DOC: Device registration注释，掌握 wiphy 注册与cfg80211_ops回调全集； - 深入协议实现：按 mac80211.rst 与 mac80211-advanced.rst 的章节索引，逐一在 include/net/mac80211.h 中查阅
ieee80211_hw、ieee80211_ops、ieee80211_rx_status、ieee80211_tx_info等核心结构，再进入 net/mac80211/ 目录阅读rx.c、tx.c、agg-tx.c、agg-rx.c、key.c、sta_info.c等实现； - 对照真实驱动：在 drivers/net/wireless/ 下选择一个使用 mac80211 的驱动（如 iwlwifi、ath10k、mt76），观察其如何实现
ieee80211_ops、注册 wiphy，将文档中的 API 描述落到实际调用上。
七、结语
introduction.rst虽短，却为整本"Linux 802.11 Driver Developer's Guide"定下了基调：面向内核开发者、兼具高层概览与底层 API 细节、以 802.11 标准为共同语言。它以 cfg80211 与 mac80211 为两大支柱，配合驱动层，共同构成了 Linux 无线栈的完整图景。后续的 cfg80211、mac80211 与 mac80211-advanced 三份文档，正是沿着引言勾画的轮廓，把 wiphy 注册、扫描/连接、收发路径、省电、聚合、速率控制等主题逐一展开——它们是内核无线驱动开发者的第一手参考手册，而include/net/cfg80211.h、include/net/mac80211.h与net/mac80211/中的实现代码，则为手册中的每一处 API 提供了可验证的最终依据。
【免费下载链接】linuxLinux kernel source tree项目地址: https://gitcode.com/GitHub_Trending/li/linux
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
