2. Linux SPI子系统架构：SPI核心层、SPI控制器驱动、SPI设备驱动、数据结构关系图

Linux SPI子系统采用标准的分层架构设计，将硬件控制逻辑与设备协议处理解耦。整个架构自底向上分为三层：SPI控制器驱动层、SPI核心层和SPI设备驱动层。理解这三层的职责边界与数据结构关系，是开发高质量SPI驱动的基石。

2.1 三层架构总览

下图展示了SPI子系统的完整分层结构，以及各层之间的调用关系与数据流向：

2.2 核心数据结构关系图

SPI子系统的核心数据结构包括 spi_master、spi_device、spi_driver、spi_message 和 spi_transfer。它们之间的关联关系如下图所示：

2.3 各层职责与关键接口

2.4 数据结构初始化与注册流程

SPI子系统的初始化遵循自底向上的顺序：先注册控制器驱动，核心层自动创建 spi_device，然后设备驱动通过 spi_driver 匹配并绑定。关键步骤与数据结构操作如下：

1. 控制器驱动注册：调用 spi_register_master()，核心层分配 spi_master 并初始化消息队列、DMA相关字段。
2. 设备枚举：核心层根据设备树（Device Tree）或板级代码中的SPI子节点，为每个片选创建 spi_device，并关联到对应的 spi_master。
3. 设备驱动绑定：设备驱动调用 spi_register_driver()，核心层通过 spi_bus_type 的匹配逻辑将 spi_driver 与 spi_device 配对，触发 probe()。
4. 传输通道建立：在 probe() 中，设备驱动保存 spi_device 指针，后续通过该指针发起所有传输请求。

/* 控制器驱动注册示例 (伪代码) */
static struct spi_master *master;
master = spi_alloc_master(&pdev->dev, sizeof(struct my_spi_controller));
master->bus_num = 1;
master->num_chipselect = 2;
master->transfer_one_message = my_transfer_one_message;
master->can_dma = my_can_dma;
master->dma_map = my_dma_map;
master->dma_unmap = my_dma_unmap;
spi_register_master(master);

/* 设备驱动 probe 示例 */
static int my_spi_device_probe(struct spi_device *spi)
{
    struct my_device_data *data;
    data = devm_kzalloc(&spi->dev, sizeof(*data), GFP_KERNEL);
    spi_set_drvdata(spi, data);
    data->spi = spi;  /* 保存 spi_device 指针 */
    /* 配置 SPI 参数 */
    spi->mode = SPI_MODE_0;
    spi->max_speed_hz = 10000000;
    spi->bits_per_word = 8;
    spi_setup(spi);
    return 0;
}

2.5 消息队列与DMA传输的整合点

在SPI子系统中，消息队列与DMA传输的整合发生在核心层与控制器驱动的接口处。核心层提供以下关键机制：

2.6 数据结构关系总结

下表汇总了SPI子系统中主要数据结构之间的引用关系与生命周期：