3. Zephyr 设备驱动模型：设备树、驱动绑定与 API 分层

Zephyr RTOS 的设备驱动模型是其可移植性与硬件抽象能力的核心。本章将深入剖析驱动模型的三大支柱：设备树（Devicetree）作为硬件描述语言、驱动绑定机制作为软件与硬件的桥梁、以及API 分层结构作为软件架构的骨架。理解这三者之间的协作关系，是进行 SPI 驱动配置与性能优化的前提。

3.1 设备树（Devicetree）概念与结构

设备树是一种描述硬件资源的数据结构，采用树形层级组织。Zephyr 使用 Devicetree Source（.dts） 文件来描述 SoC 内部外设、板级引脚分配、内存映射及中断配置。编译时，这些描述被转换为 C 宏定义，供驱动代码使用。

一个典型的设备树节点包含以下关键属性：

设备树文件通过 #include 机制实现层级复用：SoC 级 .dtsi 定义通用外设，板级 .dts 覆盖引脚与使能状态。

3.2 驱动绑定机制：从设备树到驱动实例

驱动绑定是设备树节点与驱动代码之间的匹配与实例化过程。Zephyr 使用 兼容字符串（compatible string） 作为匹配键。当系统启动时，内核遍历设备树中的使能节点，查找注册了相同 compatible 字符串的驱动，并调用其初始化函数。

绑定过程分为三个步骤：

1. 驱动注册： 使用 DEVICE_DT_DEFINE() 宏将驱动与设备树节点关联。
2. 节点使能： 设备树中 status = "okay" 的节点才会被绑定。
3. 初始化排序： 根据 init_prio 参数决定初始化顺序（如 POST_KERNEL、APPLICATION）。

以下是一个典型的 SPI 驱动绑定代码示例：

/* 驱动绑定宏：将 spi2 节点与 stm32_spi 驱动关联 */
#define DT_DRV_COMPAT st_stm32_spi

/* 驱动 API 结构体定义 */
static const struct spi_driver_api stm32_spi_api = {
    .transceive = stm32_spi_transceive,
    .configure  = stm32_spi_configure,
};

/* 驱动实例化：每个使能的 SPI 控制器生成一个实例 */
DEVICE_DT_DEFINE(DT_NODELABEL(spi2),
                 &stm32_spi_init,      /* 初始化函数 */
                 NULL,                 /* PM 控制函数 */
                 &stm32_spi_data,      /* 运行时数据 */
                 &stm32_spi_config,    /* 编译时配置（来自设备树） */
                 POST_KERNEL,          /* 初始化优先级 */
                 CONFIG_SPI_INIT_PRIORITY,
                 &stm32_spi_api);      /* API 结构体指针 */

3.3 API 分层结构：HAL → Driver → Application

Zephyr 的 SPI 驱动软件栈采用严格的三层架构，层与层之间通过抽象接口解耦。这种分层设计使得应用代码无需关心底层硬件寄存器操作，同时也便于驱动在不同 SoC 之间移植。

各层之间的数据流与调用关系如下：

• Application → Driver： 通过 spi_transceive()、spi_configure() 等标准 API 调用，传入 struct spi_config 和 struct spi_buf_set。
• Driver → HAL： 驱动内部调用 HAL 函数操作寄存器，如设置波特率、触发传输、检查状态标志。
• HAL → 硬件： HAL 函数直接读写内存映射寄存器，完成物理层操作。

3.4 分层架构的 SPI 配置传递路径

理解配置参数如何从应用层传递到硬件寄存器，是进行性能调优的基础。以 SPI 模式、频率和位序配置为例，其传递路径如下：

1. 应用层： 填充 struct spi_config，设置 frequency、operation（模式/位序/CS 控制）等字段。
2. Driver 层： spi_configure() 将 spi_config 转换为硬件寄存器值，调用 HAL 函数写入控制寄存器。
3. HAL 层： 执行寄存器写入，如 LL_SPI_SetBaudRatePrescaler()、LL_SPI_SetCPOL()。

下表总结了各层在 SPI 配置中的关键参数与职责：