3. DMA寻址掩码（DMA Mask）定义

DMA寻址掩码是PCI/PCIe设备向操作系统声明其物理地址宽度能力的核心参数。它决定了设备能够访问的主存地址范围，直接影响DMA传输的正确性与系统内存布局的灵活性。

3.1 什么是DMA掩码

DMA掩码（DMA Mask）是一个位掩码（bitmask），用于描述设备DMA引擎能够处理的最大物理地址位数。在Linux内核中，设备驱动通过dma_set_mask()或pci_set_dma_mask()函数向内核声明这一能力。

掩码与地址位数的对应关系：

掩码值（十六进制）	二进制表示（低32/64位）	支持的地址位数	最大可寻址内存
0x00FFFFFF	低24位全1	24位	16 MB
0xFFFFFFFF	低32位全1	32位	4 GB
0xFFFFFFFFFFFFFFFF	低64位全1	64位	16 EB
0x00000001FFFFFFFF	低33位全1	33位	8 GB

3.2 掩码的位宽意义

掩码的位宽直接决定了设备DMA操作的地址空间范围和系统内存映射的灵活性。位宽越大，设备能够访问的物理地址范围越广，但同时也对硬件设计提出更高要求。

位宽与系统行为的关系：

• 低位宽（≤32位）：设备只能访问低4GB物理地址空间。在配备大内存（>4GB）的系统中，内核必须为DMA分配低端内存（ZONE_DMA），可能导致内存碎片和性能下降。
• 高位宽（≥64位）：设备可以访问全部物理地址空间。内核无需为DMA预留低端内存，DMA缓冲区可以从任意物理地址分配，显著提升大内存系统的效率。
• 非标准位宽（如33位、40位）：某些老旧或专用设备支持介于32位和64位之间的地址宽度。内核通过dma_set_mask_and_coherent()等接口处理这些特殊情况。

以下SVG图展示了不同位宽掩码下设备可访问的物理地址空间范围：

3.3 32位与64位寻址的区别

32位与64位DMA寻址是当前PCIe设备最常用的两种配置模式。两者在地址空间、系统兼容性、性能影响和驱动实现方面存在显著差异。

对比维度	32位寻址	64位寻址
最大地址范围	4 GB（0x00000000 – 0xFFFFFFFF）	16 EB（0x0000_0000_0000_0000 – 0xFFFF_FFFF_FFFF_FFFF）
内存分配区域	ZONE_DMA（低16MB）或ZONE_NORMAL（低1GB）	任意物理地址（ZONE_NORMAL / ZONE_HIGHMEM）
大内存系统效率	低——DMA缓冲区必须从低端内存分配，容易耗尽	高——DMA缓冲区可从任意位置分配，无低端内存压力
IOMMU/SMMU需求	通常不需要，但可配合IOMMU做地址翻译	强烈推荐——IOMMU可提供地址翻译和访问保护
硬件复杂度	低——DMA引擎只需32位地址总线	高——需要64位地址总线和更大的DMA描述符
典型设备	老旧网卡、声卡、USB控制器、嵌入式简单DMA	现代GPU、NVMe SSD、万兆网卡、RDMA适配器
驱动配置函数	pci_set_dma_mask(pdev, DMA_BIT_MASK(32))	pci_set_dma_mask(pdev, DMA_BIT_MASK(64))

以下SVG图展示了32位与64位DMA寻址在系统内存中的实际工作方式：

3.4 驱动中的掩码配置实践

在Linux内核中，驱动通过DMA_BIT_MASK()宏生成掩码值，并调用pci_set_dma_mask()进行配置。以下代码展示了32位和64位设备的典型配置流程：

/* 32位设备配置示例 */
static int my_pci_probe_32bit(struct pci_dev *pdev,
                               const struct pci_device_id *id)
{
    int ret;

    /* 尝试设置64位掩码，如果失败则回退到32位 */
    ret = pci_set_dma_mask(pdev, DMA_BIT_MASK(64));
    if (ret) {
        ret = pci_set_dma_mask(pdev, DMA_BIT_MASK(32));
        if (ret) {
            dev_err(&pdev->dev, "无法设置DMA掩码\n");
            return ret;
        }
        dev_info(&pdev->dev, "使用32位DMA寻址\n");
    } else {
        /* 64位掩码成功，同步设置一致DMA掩码 */
        pci_set_consistent_dma_mask(pdev, DMA_BIT_MASK(64));
        dev_info(&pdev->dev, "使用64位DMA寻址\n");
    }

    return 0;
}

掩码配置的决策流程如下：

1. 查询设备能力：读取PCIe配置空间的Device Capabilities寄存器，确认设备是否支持64位寻址。
2. 尝试高位掩码：调用pci_set_dma_mask(pdev, DMA_BIT_MASK(64))，检查返回值。
3. 成功处理：如果返回0，同时设置一致DMA掩码（pci_set_consistent_dma_mask），完成配置。
4. 失败回退：如果返回非0，尝试32位掩码DMA_BIT_MASK(32)。
5. 最终失败：如果32位也失败，驱动应中止初始化，因为设备无法进行DMA操作。

以下SVG图展示了驱动中DMA掩码配置的完整决策流程：

3.5 掩码配置的常见问题与排查

排查DMA掩码问题的常用命令：

# 查看设备当前DMA掩码设置
cat /sys/bus/pci/devices/0000:01:00.0/dma_mask

# 查看设备支持的最大DMA掩码
cat /sys/bus/pci/devices/0000:01:00.0/dma_mask_bits

# 查看系统内存区域使用情况
cat /proc/zoneinfo | grep -A 20 "DMA"

# 查看DMA分配失败日志
dmesg | grep -i "dma\|allocation failure"