2、DMA引擎基础：DMA工作原理、总线主控与从控模式、描述符环（Descriptor Ring）概念

直接存储器访问（Direct Memory Access, DMA）是网络设备驱动中实现高性能数据搬移的核心硬件机制。在Linux网络设备驱动中，MAC控制器与系统内存之间的数据交换几乎全部依赖DMA引擎完成。理解DMA的工作原理、总线控制模式以及描述符环结构，是掌握网络驱动数据路径的基础。

2.1 DMA工作原理

DMA是一种允许硬件设备直接读写系统内存的机制，无需CPU介入每次数据传输。在典型的网络设备中，DMA传输流程如下：

1. CPU初始化： 驱动程序分配DMA缓冲区（内存区域），并将缓冲区地址、长度等信息写入DMA控制器的寄存器或描述符。
2. 启动传输： CPU向DMA控制器发送“启动”命令，或使能描述符环的“有效”位。
3. 硬件自主传输： DMA控制器独立控制总线，在MAC控制器与内存之间搬移数据。传输过程中，CPU可以执行其他任务。
4. 传输完成通知： DMA传输完成后，控制器通过中断或轮询状态位通知CPU。CPU随后处理已就绪的数据包。

下图展示了DMA引擎在系统架构中的位置与数据流向：

2.2 总线主控与从控模式

DMA引擎在系统总线上的角色分为两种模式：总线主控（Bus Master）和总线从控（Bus Slave）。这两种模式决定了DMA引擎对总线的控制权大小。

总线主控模式下的典型DMA传输序列如下：

• 步骤1： 驱动将描述符写入内存中的描述符环，设置缓冲区地址、长度和控制标志。
• 步骤2： 驱动向DMA引擎的“传输启动”寄存器写入命令，或更新描述符的“所有权”位。
• 步骤3： DMA引擎作为总线主控，从描述符环中读取描述符，解析传输参数。
• 步骤4： DMA引擎直接控制总线，在MAC FIFO与内存缓冲区之间搬移数据。
• 步骤5： 传输完成后，DMA引擎更新描述符状态位，并可选地触发中断。

下图对比了两种模式的总线控制关系：

2.3 描述符环（Descriptor Ring）概念

描述符环是总线主控DMA引擎的核心数据结构。它是一个位于系统内存中的环形缓冲区，由一组连续的描述符（Descriptor）组成。每个描述符包含DMA传输所需的全部参数，以及传输完成后的状态信息。

2.3.1 描述符结构

一个典型的DMA描述符包含以下字段：

2.3.2 描述符环的工作流程

描述符环采用“生产者-消费者”模型：

• 软件（驱动）作为生产者： 分配缓冲区，填充描述符，将所有权交给硬件。
• 硬件（DMA引擎）作为消费者： 从环中获取描述符，执行DMA传输，更新状态，将所有权交还软件。
• 环形结构： 描述符在内存中连续排列，当指针到达环尾时自动回绕到环首，形成无限循环。

下图展示了描述符环的结构与数据流：

2.3.3 描述符环的驱动实现要点

在Linux网络驱动中，描述符环的初始化与管理通常包含以下关键步骤：

/* 描述符环初始化伪代码 */
struct dma_ring {
    struct dma_desc *desc;      /* 描述符数组基地址 */
    dma_addr_t       dma_addr;  /* 描述符环的DMA地址 */
    unsigned int     count;     /* 描述符数量 */
    unsigned int     cur;       /* 当前处理位置 */
    unsigned int     dirty;     /* 脏描述符计数 */
};

/* 单个描述符结构（以DesignWare GMAC为例） */
struct dma_desc {
    __le32 txdes0;  /* 控制/状态字 */
    __le32 txdes1;  /* 缓冲区长度 */
    __le32 txdes2;  /* 缓冲区地址低32位 */
    __le32 txdes3;  /* 缓冲区地址高32位/下一个描述符指针 */
};

/* 初始化描述符环 */
int dma_ring_init(struct net_device *ndev, struct dma_ring *ring, int count)
{
    /* 1. 分配一致DMA内存 */
    ring->desc = dma_alloc_coherent(ndev->dev.parent,
                                    count * sizeof(struct dma_desc),
                                    &ring->dma_addr, GFP_KERNEL);
    if (!ring->desc)
        return -ENOMEM;

    /* 2. 清零描述符 */
    memset(ring->desc, 0, count * sizeof(struct dma_desc));

    /* 3. 设置所有权位为软件所有 */
    for (int i = 0; i < count; i++)
        ring->desc[i].txdes0 |= DESC_OWN_BIT;

    /* 4. 初始化指针 */
    ring->count = count;
    ring->cur   = 0;
    ring->dirty = 0;

    /* 5. 将环基地址写入DMA引擎寄存器 */
    writel(ring->dma_addr, ioaddr + DMA_TX_BASE_ADDR);

    return 0;
}

2.3.4 描述符环的常见问题与调试

2.4 本章小结