3. DMA引擎工作原理：DMA描述符环、DMA引擎寄存器、DMA传输流程

DMA（Direct Memory Access）引擎是PCIe设备实现高性能数据传输的核心部件。当PCIe设备作为Bus Master发起DMA传输时，它绕过CPU，直接在系统内存与设备之间搬运数据。理解DMA引擎的工作原理，是定位pci_set_master关闭后传输超时故障的前提。

3.1 DMA描述符环（Descriptor Ring）

DMA描述符环是位于系统内存中的一个环形缓冲区，由一组固定大小的描述符（Descriptor）组成。每个描述符定义了一次DMA传输的源地址、目的地址、传输长度、控制标志以及下一个描述符的指针。设备端DMA引擎通过读取描述符环来获取传输任务，并在完成后更新描述符的状态。

3.1.1 描述符结构

一个典型的DMA描述符包含以下字段（以64位系统为例）：

3.1.2 描述符环的环形结构

描述符环通过NEXT_DESC字段形成闭环。最后一个描述符的NEXT_DESC指向环的起始地址。DMA引擎内部维护两个指针：

• Head指针（生产者指针）：CPU写入新描述符的位置，由CPU更新。
• Tail指针（消费者指针）：DMA引擎当前正在处理或即将处理的位置，由DMA引擎更新。

当Head == Tail时，环为空；当Head + 1 == Tail时，环为满（通常预留一个空位以区分空/满状态）。

3.2 DMA引擎寄存器

DMA引擎通过一组MMIO寄存器与CPU交互。这些寄存器通常映射在PCIe设备的BAR空间中。以下是关键的DMA引擎寄存器：

3.3 DMA传输流程

一次完整的DMA传输分为三个阶段：准备阶段、传输阶段、完成阶段。下面以“设备从内存读取数据”为例（Memory Read DMA）：

3.3.1 准备阶段（CPU侧）

1. 分配内存缓冲区：CPU分配连续的物理内存（或通过IOMMU映射），确保缓冲区物理地址连续且对齐。
2. 填充描述符：CPU在描述符环中写入源地址（内存缓冲区）、目的地址（设备内部FIFO）、传输长度、中断使能标志等。
3. 更新Head指针：CPU将新的Head指针值写入DMA_HEAD_PTR寄存器，通知DMA引擎有新的任务。
4. 启动DMA：CPU设置DMA_CTRL寄存器的启动位（通常为bit 0）。

3.3.2 传输阶段（DMA引擎侧）

1. 读取描述符：DMA引擎通过PCIe Memory Read从DMA_DESC_BASE + Tail * sizeof(desc)处读取描述符。
2. 解析描述符：提取源地址、目的地址、传输长度等信息。
3. 执行数据传输：DMA引擎发起PCIe Memory Read从源地址读取数据，然后通过内部数据通路将数据写入目的地址（设备内部寄存器或FIFO）。
4. 更新描述符状态：传输完成后，DMA引擎将描述符的STATUS字段写为“完成”，并更新Tail指针。
5. 触发中断（可选）：如果描述符的CONTROL字段设置了中断使能，DMA引擎向CPU发送MSI-X中断。

3.3.3 完成阶段（CPU侧）

1. 处理中断或轮询：CPU收到中断（或轮询到描述符STATUS为“完成”），确认传输结束。
2. 处理数据：CPU读取设备内部缓冲区中的数据，或直接使用已写入内存的数据。
3. 回收描述符：CPU将已完成的描述符标记为可用，准备下一轮传输。

3.4 DMA传输的关键时序

理解DMA传输的时序对于排查超时故障至关重要。以下是一个典型的DMA传输时序序列：

3.5 描述符环的软件管理

在Linux内核中，DMA描述符环的管理通常由设备驱动程序的probe函数初始化，并在数据传输过程中由start_xmit或submit_urb等函数填充。以下是一个简化的描述符环初始化代码示例：

/* 描述符环初始化（简化示例） */
struct dma_ring {
    struct dma_desc *desc_virt;   /* 虚拟地址（CPU访问） */
    dma_addr_t desc_phys;         /* 物理地址（DMA引擎访问） */
    u32 size;                     /* 描述符个数 */
    u32 head;                     /* 生产者指针 */
    u32 tail;                     /* 消费者指针 */
};

int dma_ring_init(struct pci_dev *pdev, struct dma_ring *ring, u32 size)
{
    /* 分配一致DMA内存（物理连续、非缓存） */
    ring->desc_virt = dma_alloc_coherent(&pdev->dev,
                                         size * sizeof(struct dma_desc),
                                         &ring->desc_phys,
                                         GFP_KERNEL);
    if (!ring->desc_virt)
        return -ENOMEM;

    ring->size = size;
    ring->head = 0;
    ring->tail = 0;

    /* 初始化描述符环：设置NEXT_DESC形成闭环 */
    for (int i = 0; i < size; i++) {
        struct dma_desc *desc = &ring->desc_virt[i];
        desc->next_desc = ring->desc_phys +
                          ((i + 1) % size) * sizeof(struct dma_desc);
        desc->status = 0;  /* 初始状态：未完成 */
    }

    /* 将描述符环基地址写入DMA引擎寄存器 */
    writel(ring->desc_phys, pdev->bar_addr + DMA_DESC_BASE_LOW);
    writel(ring->desc_phys >> 32, pdev->bar_addr + DMA_DESC_BASE_HIGH);
    writel(size, pdev->bar_addr + DMA_DESC_SIZE);

    return 0;
}

3.6 总结：DMA引擎与pci_set_master的关联