3. SPI设备驱动开发环境搭建：交叉编译工具链配置、内核源码树准备、设备树SPI节点编写

SPI设备驱动的开发与调试，离不开一个稳固且可复现的嵌入式开发环境。本章将聚焦于搭建这一环境的三个核心环节：交叉编译工具链的配置、内核源码树的准备，以及设备树（Device Tree）SPI节点的编写。这三者构成了从代码编译到硬件描述的基础链路，任何一环的缺失或错误，都会导致驱动无法正确加载或运行。

3.1 交叉编译工具链配置

嵌入式Linux开发中，宿主机（通常是x86架构的PC）无法直接编译出目标机（ARM、RISC-V等架构）可执行的二进制文件，必须使用交叉编译工具链。配置过程分为选择、安装与验证三步。

3.1.1 工具链选择与安装

根据目标SoC架构选择对应的工具链。主流选择包括：

安装步骤（以ARM 32-bit为例）：

1. 下载：从Linaro官网或芯片厂商SDK中获取预编译工具链压缩包（如 gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz）。
2. 解压：tar -xvf gcc-linaro-*.tar.xz -C /opt/
3. 添加至PATH：编辑 ~/.bashrc，添加 export PATH=$PATH:/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin，然后执行 source ~/.bashrc。

3.1.2 工具链验证

安装完成后，必须验证工具链是否可用且版本正确：

# 检查编译器版本
arm-linux-gnueabihf-gcc --version

# 编译一个简单的测试程序
echo 'int main(){ return 0; }' > test.c
arm-linux-gnueabihf-gcc -o test test.c

# 查看生成文件的架构信息
file test
# 预期输出: test: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), ...

3.2 内核源码树准备

编译SPI设备驱动模块（.ko文件）时，必须依赖完整的内核源码树，尤其是已配置好的 .config 文件和编译生成的 Module.symvers 文件。

3.2.1 获取与解压内核源码

从芯片厂商提供的BSP（Board Support Package）或Linux内核官方仓库获取源码：

# 以Linux 5.10.y 版本为例
wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.10.120.tar.xz
tar -xvf linux-5.10.120.tar.xz
cd linux-5.10.120

3.2.2 配置内核

使用目标平台的默认配置文件生成 .config：

# 假设目标平台为 STM32MP157
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- stm32mp157_defconfig

# 如果需要微调SPI相关选项，使用菜单配置
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig
# 进入 Device Drivers -> SPI support，确保 CONFIG_SPI_STM32 或对应驱动被选中为 M 或 Y

3.2.3 编译内核与模块

首次编译需要生成必要的头文件和版本信息：

# 编译内核镜像（耗时较长）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- uImage LOADADDR=0xC2000040 -j4

# 编译内核模块
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules -j4

# 安装模块到临时目录（用于后续打包到根文件系统）
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- modules_install INSTALL_MOD_PATH=./modules_install

3.3 设备树（Device Tree）SPI节点编写

设备树是描述硬件资源的静态数据结构。SPI控制器及其从设备（Slave Device）的节点编写质量，直接决定了驱动能否正确探测到硬件。

3.3.1 SPI控制器节点结构

SPI控制器节点通常由SoC厂商在 .dtsi 文件中定义，开发者只需在板级 .dts 文件中使能并配置管脚复用。以下是一个典型的SPI控制器节点示例：

/* 在 stm32mp157.dtsi 中定义 */
spi2: spi@4000b000 {
    compatible = "st,stm32h7-spi";
    reg = <0x4000b000 0x400>;
    interrupts = <36>;
    clocks = <&rcc SPI2_K>;
    resets = <&rcc SPI2_R>;
    dmas = <&dmamux1 39 0x400 0x05>,
           <&dmamux1 40 0x400 0x05>;
    dma-names = "rx", "tx";
    status = "disabled";
};

/* 在板级 myboard.dts 中使能并配置管脚 */
&spi2 {
    pinctrl-names = "default", "sleep";
    pinctrl-0 = <&spi2_pins_a>;
    pinctrl-1 = <&spi2_pins_sleep>;
    cs-gpios = <&gpioc 1 GPIO_ACTIVE_LOW>;
    status = "okay";

    /* SPI从设备节点 */
    spidev@0 {
        compatible = "rohm,dh2228fv";
        reg = <0>;
        spi-max-frequency = <10000000>;
    };
};

3.3.2 SPI从设备节点关键属性

3.3.3 设备树编译与反编译

编写完成后，需要将 .dts 源文件编译为 .dtb 二进制文件，供U-Boot或内核加载：

# 编译设备树
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- dtbs

# 或者单独编译指定文件
./scripts/dtc/dtc -I dts -O dtb -o myboard.dtb myboard.dts

# 反编译验证（检查生成的dtb是否正确）
./scripts/dtc/dtc -I dtb -O dts -o myboard_reverse.dts myboard.dtb

3.4 环境验证清单

完成上述配置后，建议按照以下清单逐项确认环境就绪：