3. Memory Read/Write TLP：格式、地址与数据对齐

Memory Read/Write TLP 是 PCIe 设备驱动开发中最核心的报文类型，负责主机与设备之间的数据搬运。本章深入解析 Memory Read Request/Completion 与 Memory Write TLP 的逐字段格式、地址映射规则以及数据对齐要求，为后续 DMA 传输实现奠定协议基础。

3.1 Memory Read Request TLP 格式

Memory Read Request TLP 由发起者（Requester）发送给完成者（Completer），请求从指定地址读取一定长度的数据。其格式遵循 PCIe Base Spec 定义的通用 TLP 头结构，包含以下关键字段：

3.2 Memory Read Completion TLP 格式

Completer 收到 Memory Read Request 后，返回一个或多个 Completion TLP。Completion 包含请求的数据以及完成状态。其格式如下：

3.3 Memory Write TLP 格式

Memory Write TLP 由发起者直接向目标地址写入数据，无需 Completion 响应（Posted 事务）。其格式如下：

3.4 地址与数据对齐要求

PCIe 协议对 Memory TLP 的地址和数据对齐有严格约束，违反对齐会导致 UR（Unsupported Request）或数据错误。以下是核心规则：

• 地址 DW 对齐： Memory Read/Write 的起始地址必须对齐到 4 字节边界（Address[1:0] = 00）。低 2 位在 TLP 头中隐含为 0。
• 长度 DW 对齐： Length 字段以 DW 为单位，数据总长度必须是 4 的倍数。例如 Length=3 表示 12 字节。
• Max Payload Size (MPS)： 单个 TLP 的数据负载不能超过设备/系统协商的 MPS（通常为 128/256/512/1024 字节）。超长请求必须拆分为多个 TLP。
• Read Completion 边界： Completion 返回的数据必须与 Request 的地址和长度严格对应，且不能跨 4KB 边界（除非设备支持 4KB 边界跨越）。
• Write 合并： 多个连续的 Memory Write 可能被 RC 或 Switch 合并为一个更大的 TLP，但合并后的地址和长度仍需满足对齐。

3.5 Memory TLP 传输流程 SVG 图

下图展示了 Memory Read Request/Completion 与 Memory Write 的完整传输流程，包含地址映射、TLP 封装、数据对齐检查等关键环节：

3.6 数据对齐检查代码示例

以下代码展示驱动中如何检查 Memory TLP 的地址和数据对齐，确保符合 PCIe 协议要求：

/* 检查 Memory TLP 地址和数据对齐 */
static int check_tlp_alignment(u64 addr, size_t size)
{
    /* 1. 地址必须 4 字节对齐 */
    if (addr & 0x3) {
        pr_err("TLP address 0x%llx not DW aligned\n", addr);
        return -EINVAL;
    }

    /* 2. 数据长度必须 4 字节对齐 */
    if (size & 0x3) {
        pr_err("TLP size %zu not DW aligned\n", size);
        return -EINVAL;
    }

    /* 3. 长度不能超过 Max Payload Size (MPS) */
    u16 mps = pcie_get_mps(dev);
    if (size > mps) {
        pr_err("TLP size %zu exceeds MPS %u\n", size, mps);
        return -EINVAL;
    }

    /* 4. 地址 + 长度不能跨 4KB 边界（除非设备支持） */
    u64 end = addr + size;
    if ((addr & 0xFFF) + size > 0x1000) {
        pr_warn("TLP crosses 4KB boundary, may cause UR\n");
        return -EPERM;
    }

    /* 5. 对于 64 位地址，检查高 32 位是否有效 */
    if (addr & 0xFFFFFFFF00000000ULL) {
        if (!pci_is_pcie(dev) || !pcie_has_flr(dev)) {
            pr_err("64-bit address not supported by device\n");
            return -EOPNOTSUPP;
        }
    }

    return 0;
}

/* 拆分大请求为多个 TLP */
static int split_and_send_tlp(struct pci_dev *dev, u64 addr, void *data, size_t size)
{
    u16 mps = pcie_get_mps(dev);
    size_t offset = 0;
    int ret;

    while (offset < size) {
        size_t chunk = min_t(size_t, size - offset, mps);
        
        /* 确保每个 chunk 对齐 */
        if ((addr + offset) & 0x3 || chunk & 0x3) {
            pr_err("Split chunk misaligned at offset %zu\n", offset);
            return -EINVAL;
        }

        ret = pcie_send_memory_write(dev, addr + offset, data + offset, chunk);
        if (ret)
            return ret;

        offset += chunk;
    }

    return 0;
}

3.7 常见对齐错误与避坑指南

3.8 本章小结

• Memory Read Request 使用 Non-Posted 事务，必须等待 Completion 返回数据；Memory Write 使用 Posted 事务，无需等待。
• TLP 头中的 Address 字段低 2 位隐含为 0，Length 字段以 DW 为单位，数据负载必须是 4 的倍数。
• 地址对齐、长度对齐、MPS 限制和 4KB 边界是驱动开发中最常见的协议约束，违反会导致 UR 或数据损坏。
• 驱动中应实现对齐检查函数，并在 DMA 缓冲区分配时确保起始地址和大小满足 PCIe 要求。