ATH12K驱动框架架构图（分层描述）

I. 顶层架构

┌───────────────────────────────────────────────────────┐
│                     Linux Kernel                      │
├───────────────────────────────────────────────────────┤
│                      mac80211                         │
├───────────────────────────────────────────────────────┤
│                     ATH12K Driver                     │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐  │
│  │  Core   │ │   MAC   │ │   DP    │ │Debug/Tracing│  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────────┘  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────────┐  │
│  │   HAL   │ │   HTC   │ │   WMI   │ │     CE      │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────────┘  │
├───────────────────────────────────────────────────────┤
│           PCI/AHB 总线接口层 (Bus Interface)          │
├───────────────────────────────────────────────────────┤
│                      Hardware                         │
└───────────────────────────────────────────────────────┘

II. 核心数据结构层次关系

┌──────────────────────────────────────────────────────────────┐
│                     struct ath12k_hw_group                   │
│  ┌──────────────────────────────────────────────┐            │
│  │               struct ath12k_hw               │            │
│  │  ┌──────────────┐  ┌──────────────┐          │            │
│  │  │  struct      │  │  struct      │          │            │
│  │  │  ath12k      │  │  ath12k      │...       │            │
│  │  │  (radio 0)   │  │  (radio 1)   │          │            │
│  │  └──────────────┘  └──────────────┘          │            │
│  └──────────────────────────────────────────────┘            │
│                                                              │
│  ┌──────────────────────────────────────────────┐            │
│  │           struct ath12k_base  (SOC 0)        │            │
│  │  ┌─────────────┐ ┌─────────────┐             │            │
│  │  │struct ath12k│ │struct ath12k│...          │            │
│  │  │_pdev (0)    │ │_pdev (1)    │             │            │
│  │  └─────────────┘ └─────────────┘             │            │
│  └──────────────────────────────────────────────┘            │
│                                                              │
│  ┌──────────────────────────────────────────────┐            │
│  │           struct ath12k_base  (SOC 1)        │            │
│  │  ┌─────────────┐ ┌─────────────┐             │            │
│  │  │struct ath12k│ │struct ath12k│...          │            │
│  │  │_pdev (0)    │ │_pdev (1)    │             │            │
│  │  └─────────────┘ └─────────────┘             │            │
│  └──────────────────────────────────────────────┘            │
└──────────────────────────────────────────────────────────────┘

III. 主要模块详解

1. 核心模块 (Core)

┌──────────────────────────────────────────────────────────────┐
│                       Core Module                            │
├──────────────────────────────────────────────────────────────┤
│ ┌────────────────────┐  ┌─────────────────────────────────┐  │
│ │ Initialization     │  │ Resource Management             │  │
│ │ - ath12k_core_init │  │ - Memory allocation            │  │
│ │ - ath12k_core_qmi  │  │ - Interrupts                   │  │
│ │ - Firmware loading │  │ - Device tree parsing          │  │
│ └────────────────────┘  └─────────────────────────────────┘  │
│                                                              │
│ ┌────────────────────┐  ┌─────────────────────────────────┐  │
│ │ Power Management   │  │ Recovery handling               │  │
│ │ - Suspend/Resume   │  │ - SSR (Subsystem restart)       │  │
│ │ - Runtime PM       │  │ - FW crash handling             │  │
│ └────────────────────┘  └─────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────┘

2. 硬件抽象层 (HAL)

┌─────────────────────────────────