深入Linux PCIe EP驱动：从数据结构pci_epc到硬件配置dw_pcie

Linux PCIe EP驱动深度解析：从pci_epc到dw_pcie_setup的完整链路

PCI Express（PCIe）作为现代计算机系统中至关重要的高速串行总线标准，其Endpoint（EP）模式在嵌入式系统、数据中心加速卡等领域有着广泛应用。本文将深入剖析Linux内核中PCIe EP驱动的完整实现链路，聚焦核心数据结构pci_epc、dw_pcie_ep和dw_pcie的交互关系，以及从设备注册到硬件配置的完整流程。

1. PCIe EP驱动架构概览

Linux内核中的PCIe EP驱动采用分层设计架构，主要分为三个层次：

EPC核心层：提供PCIe EP控制器的通用抽象接口
控制器驱动层：实现特定硬件控制器的具体操作
功能驱动层：管理具体的PCIe功能设备

这种分层设计使得内核能够支持多种不同的PCIe控制器硬件，同时为上层功能驱动提供统一的编程接口。

1.1 核心数据结构关系

三个关键数据结构构成了EP驱动的骨架：

struct dw_pcie { struct dw_pcie_ep ep; // 其他成员... }; struct dw_pcie_ep { struct pci_epc *epc; // 其他成员... }; struct pci_epc { const struct pci_epc_ops *ops; // 其他成员... };

它们的关系可以表示为：dw_pcie → dw_pcie_ep → pci_epc，形成了一个从具体到抽象的层次结构。

2. EP设备初始化流程

EP驱动的初始化始于dw_pcie_ep_init()函数，这个函数完成了从硬件资源获取到数据结构初始化的关键步骤。

2.1 资源获取与映射

驱动首先通过platform_get_resource_byname()获取硬件资源：

res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "dbi"); pci->dbi_base = devm_pci_remap_cfg_resource(dev, res);

这段代码完成了以下工作：

从设备树获取名为"dbi"的寄存器区域资源
将物理地址映射到内核虚拟地址空间
存储映射结果在dw_pcie结构的dbi_base成员中

2.2 地址窗口管理

EP驱动需要管理两种地址窗口：

窗口类型	描述	关键数据结构成员
Inbound窗口	从PCIe总线到本地内存的映射	`ib_window_map`
Outbound窗口	从本地内存到PCIe总线的映射	`ob_window_map`,`outbound_addr`

窗口的初始化通过以下代码完成：

ep->ib_window_map = devm_kcalloc(dev, BITS_TO_LONGS(pci->num_ib_windows), sizeof(long), GFP_KERNEL); ep->ob_window_map = devm_kcalloc(dev, BITS_TO_LONGS(pci->num_ob_windows), sizeof(long), GFP_KERNEL);

3. EPC设备创建与配置

devm_pci_epc_create()函数创建并初始化EPC设备：

epc = devm_pci_epc_create(dev, &epc_ops); if (IS_ERR(epc)) { dev_err(dev, "Failed to create epc device\n"); return PTR_ERR(epc); }

3.1 EPC操作集

pci_epc_ops结构定义了一组操作函数指针，实现了EP控制器的基本功能：

struct pci_epc_ops { int (*write_header)(struct pci_epc *epc, u8 func_no, u8 vfunc_no, struct pci_epf_header *hdr); int (*set_bar)(struct pci_epc *epc, u8 func_no, u8 vfunc_no, struct pci_epf_bar *epf_bar); // 其他操作... };

这些操作包括配置空间头写入、BAR设置、地址映射、中断处理等核心功能。

3.2 地址空间初始化

pci_epc_mem_init()初始化EP控制器的地址空间：

ret = pci_epc_mem_init(epc, ep->phys_base, ep->addr_size, ep->page_size); if (ret < 0) { dev_err(dev, "Failed to initialize address space\n"); return ret; }

这个函数建立了EP控制器可用的内存区域，为后续的窗口映射和MSI/MSI-X中断配置奠定了基础。

4. 硬件最终配置

dw_pcie_ep_init_complete()是初始化流程的最后一步，它完成了硬件的最终配置：

int dw_pcie_ep_init_complete(struct dw_pcie_ep *ep) { struct dw_pcie *pci = to_dw_pcie_from_ep(ep); // 检查EP模式设置 hdr_type = dw_pcie_readb_dbi(pci, PCI_HEADER_TYPE) & PCI_HEADER_TYPE_MASK; if (hdr_type != PCI_HEADER_TYPE_NORMAL) { dev_err(pci->dev, "PCIe controller is not set to EP mode!\n"); return -EIO; } // 配置Resizable BAR if (offset) { reg = dw_pcie_readl_dbi(pci, offset + PCI_REBAR_CTRL); nbars = (reg & PCI_REBAR_CTRL_NBAR_MASK) >> PCI_REBAR_CTRL_NBAR_SHIFT; for (i = 0; i < nbars; i++, offset += PCI_REBAR_CTRL) dw_pcie_writel_dbi(pci, offset + PCI_REBAR_CAP, 0x0); } // 最终硬件设置 dw_pcie_setup(pci); return 0; }