3. 内核源码结构解析：设备树与 SPI 关键目录

在开始设备树移植与 SPI 驱动适配之前，必须精准定位内核源码中三个核心目录：设备树源文件目录、SPI 控制器驱动目录、SPI 子系统头文件目录。本章将逐一拆解其功能、文件组织方式与协作关系。

3.1 arch/arm/boot/dts —— 设备树源文件仓库

该目录存放 ARM 架构下所有已支持的 SoC 与开发板的设备树源文件（.dts）及其包含头文件（.dtsi）。设备树是描述硬件拓扑与资源分配的数据结构，内核在启动时通过 Flattened Device Tree (FDT) 解析硬件信息。

3.1.1 文件命名与层级规则

3.1.2 设备树节点结构示例（SPI 控制器）

/* imx6ull.dtsi 中的 SPI 控制器节点 */
spi1: spi@02010000 {
    compatible = "fsl,imx6ul-ecspi", "fsl,imx51-ecspi";
    reg = <0x02010000 0x4000>;
    interrupts = <GIC_SPI 33 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&clks IMX6UL_CLK_ECSPI1>,
             <&clks IMX6UL_CLK_ECSPI1>;
    clock-names = "ipg", "per";
    dmas = <&sdma 3 7 1>, <&sdma 4 7 2>;
    dma-names = "rx", "tx";
    status = "disabled";
    #address-cells = <1>;
    #size-cells = <0>;
};

3.1.3 设备树文件层级关系图

3.2 drivers/spi —— SPI 控制器驱动实现

该目录包含所有 SPI 控制器（SPI Master）的驱动代码，以及 SPI 子系统核心层（spi.c）与通用传输接口。每个 SPI 控制器驱动通常对应一个 .c 文件，命名规则为 spi-<controller>.c。

3.2.1 目录文件分类

3.2.2 驱动与设备树的匹配机制

SPI 控制器驱动通过 of_match_table 与设备树节点中的 compatible 属性进行匹配。以下为 spi-imx.c 中的匹配表示例：

static const struct of_device_id spi_imx_dt_ids[] = {
    { .compatible = "fsl,imx1-cspi", .data = &imx1_cspi_devtype_data, },
    { .compatible = "fsl,imx21-cspi", .data = &imx21_cspi_devtype_data, },
    { .compatible = "fsl,imx27-cspi", .data = &imx27_cspi_devtype_data, },
    { .compatible = "fsl,imx31-cspi", .data = &imx31_cspi_devtype_data, },
    { .compatible = "fsl,imx35-cspi", .data = &imx35_cspi_devtype_data, },
    { .compatible = "fsl,imx51-ecspi", .data = &imx51_ecspi_devtype_data, },
    { .compatible = "fsl,imx6ul-ecspi", .data = &imx6ul_ecspi_devtype_data, },
    { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, spi_imx_dt_ids);

3.2.3 SPI 控制器驱动注册流程

3.3 include/linux/spi —— SPI 子系统头文件

该目录定义了 SPI 子系统对外暴露的数据结构、接口函数与宏。无论是 SPI 控制器驱动还是 SPI 设备驱动，都需要引用这些头文件。

3.3.1 核心头文件清单

3.3.2 关键数据结构关系

3.4 三个目录的协作关系

设备树、SPI 控制器驱动、SPI 子系统头文件三者构成完整的 SPI 硬件支持链路：

1. 设备树（arch/arm/boot/dts）描述 SPI 控制器的寄存器地址、中断、时钟、引脚复用。
2. SPI 控制器驱动（drivers/spi/spi-*.c）解析设备树节点，初始化硬件，并通过 include/linux/spi/spi.h 中的接口注册到 SPI 核心。
3. SPI 核心（spi.c + spi.h）管理总线、设备枚举、传输队列，向上层提供统一的 spi_write_then_read() 等 API。