1. SPI调试入门从硬件连接到基础验证当你第一次遇到SPI设备无法正常工作时先别急着翻看内核代码。根据我多年调试经验80%的SPI问题都出在硬件层或基础配置上。让我们从最基础的硬件检查开始硬件检查清单用万用表测量所有SPI线路SCLK/MOSI/MISO/CS是否导通确认供电电压符合器件规格3.3V器件接5V会直接损坏检查PCB上信号线是否出现交叉我就曾遇到MOSI和MISO画反的案例在U-Boot阶段最实用的工具莫过于sspi命令。这个内置命令可以直接操作SPI控制器绕过驱动层进行硬件级验证。假设我们调试的是SPI FlashCS0典型操作如下# 读取Flash IDJEDEC标准命令 sspi 0:0.0 8 9f这里参数分解0:0.0表示SPI总线0、CS0、模式08是传输位数9f是JEDEC ID指令正常应该返回3字节的厂商ID如Winbond返回EF4018。如果得到全FF或00说明硬件连接有问题。2. U-Boot阶段的深度调试技巧当基础通信建立后我们需要验证SPI的完整功能。U-Boot的sf命令集提供了高级操作# 擦除4K扇区地址0x10000开始 sf erase 0x10000 1000 # 写入测试数据 mw.l 0x82000000 0x12345678 1 sf write 0x82000000 0x10000 4 # 回读验证 sf read 0x82001000 0x10000 4 md.l 0x82001000 1常见坑点时钟极性设置错误模式0 vs 模式3片选信号未正确拉低用逻辑分析仪抓波形最直观DMA缓冲区未对齐遇到过32位系统必须4字节对齐我曾遇到一个典型案例SPI Flash在U-Boot能读写但内核无法识别。最终发现是U-Boot配置了双线模式而内核驱动默认单线模式。解决方法是在DTS中添加spi-flash0 { compatible jedec,spi-nor; spi-rx-bus-width 2; };3. 内核驱动的调试艺术进入内核阶段后动态调试dynamic debug是我们的利器。首先启用SPI子系统调试# 启用SPI核心调试 echo file spi* p /sys/kernel/debug/dynamic_debug/control # 启用具体控制器驱动调试以pl022为例 echo file drivers/spi/spi-pl022.c p /sys/kernel/debug/dynamic_debug/control关键API实战// 在驱动中添加调试打印 dev_dbg(spi-dev, Xfer: len%d tx%*ph rx%*ph\n, xfer-len, 16, xfer-tx_buf, 16, xfer-rx_buf); // 检查传输错误 status spi_sync(spi, msg); if (status) dev_err(spi-dev, 传输失败: %d\n, status);性能调优参数spiff190000 { compatible rockchip,rk3399-spi; reg 0x0 0xff190000 0x0 0x1000; clocks cru SCLK_SPI1, cru PCLK_SPI1; clock-names spiclk, apb_pclk; dmas dmac_peri 12, dmac_peri 13; dma-names tx, rx; pinctrl-names default; pinctrl-0 spi1_clk spi1_tx spi1_rx spi1_cs0; #address-cells 1; #size-cells 0; status okay; /* 关键性能参数 */ spi-max-frequency 50000000; // 50MHz rx-sample-delay-ns 10; // 采样延迟 };4. 系统性排错指南当SPI完全不通时按照这个检查表逐步排查电源检查测量VCC电压3.3V±10%检查去耦电容每个电源引脚至少0.1μF信号完整性用示波器看SCLK频率不得超过器件规格检查信号过冲超过VCC0.3V需要加串阻软件配置# 确认驱动已加载 ls /sys/bus/spi/devices # 检查时钟配置 cat /sys/kernel/debug/clk/clk_summary | grep spi # 验证引脚复用 cat /sys/kernel/debug/pinctrl/pinctrl-handlesDTS常见错误// 错误示例缺少CS引脚配置 spi4 { status okay; pinctrl-names default; pinctrl-0 spi4_clk spi4_mosi spi4_miso; // 缺少spi4_cs0会导致CS信号不动作 }; // 正确配置 spi4 { pinctrl-0 spi4_clk spi4_mosi spi4_miso spi4_cs0; };5. 高级调试工具链对于复杂问题需要组合使用多种工具逻辑分析仪配置采样率至少4倍于SCLK频率设置SPI协议解码器模式/位序要匹配推荐使用PulseView配合廉价逻辑分析仪内核trace调试# 启用ftrace echo 1 /sys/kernel/debug/tracing/tracing_on echo function_graph /sys/kernel/debug/tracing/current_tracer echo spi_sync /sys/kernel/debug/tracing/set_ftrace_filter # 捕获数据10秒 cat /sys/kernel/debug/tracing/trace_pipe trace.log sleep 10 killall catSPI压力测试// 构造伪随机测试数据 static void build_test_pattern(u8 *buf, size_t len) { u8 val 0xA5; for (int i 0; i len; i) { buf[i] val; val 0x17; } } // 在驱动中添加测试接口 static ssize_t spi_test_write(struct file *file, const char __user *buf, size_t len, loff_t *ppos) { struct spi_device *spi ...; u8 *tx_buf kmalloc(len, GFP_KERNEL); u8 *rx_buf kmalloc(len, GFP_KERNEL); build_test_pattern(tx_buf, len); spi_read(spi, rx_buf, len); if (memcmp(tx_buf, rx_buf, len)) pr_err(Data mismatch!\n); kfree(tx_buf); kfree(rx_buf); return len; }6. 真实案例复盘案例1时序临界故障现象SPI Flash随机读写错误排查逻辑分析仪显示SCLK边沿有振铃解决在SCLK线加33Ω串阻DTS中降低时钟频率案例2电源干扰现象SPI ADC读数跳变排查示波器发现电源纹波达300mV解决增加10μF钽电容并联0.1μF陶瓷电容案例3DMA内存问题现象大数据传输出现错位排查发现缓存未做非缓存映射解决使用dma_alloc_coherent分配缓冲区记得在每次调试后把有效解决方案记录在驱动注释里——这对后续维护者会是宝贵财富。就像我在一个驱动里留下的注释/* * 2023-03-15修复必须配置RX采样延迟为10ns * 硬件问题SCLK到MISO的PCB走线过长152mm * 临时方案通过rx-sample-delay-ns补偿 * 根治方案改板缩短走线至50mm内 */