告别盲调！手把手教你用Linux自带的spidev_test工具调试SPI设备（附常用命令速查表）

SPI设备调试实战指南：从零掌握Linux spidev_test工具

刚拿到一块全新的SPI传感器模块时，很多工程师的第一反应是兴奋，但紧接着就会陷入迷茫——如何快速验证这块芯片是否正常工作？硬件连接是否正确？与主控的通信是否畅通？这些问题往往让初学者手足无措。本文将带你深入Linux系统自带的spidev_test工具，从参数解析到实战案例，一步步拆解SPI设备调试的全过程。

1. 环境准备与工具获取

在开始SPI调试之前，我们需要确保系统环境已经就绪。大多数现代Linux发行版的内核已经包含了SPI子系统支持，但spidev_test工具可能需要单独获取。

首先检查你的系统是否已经安装了必要的SPI驱动和工具：

ls /dev/spidev*

如果看到类似/dev/spidev0.0或/dev/spidev1.1的设备节点，说明SPI驱动已经加载。如果没有，你可能需要手动加载SPI内核模块：

sudo modprobe spi_bcm2835 # 树莓派示例 sudo modprobe spidev

获取spidev_test工具通常有两种方式：

1. 从内核源码编译：

   git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git cd linux/tools/spi/ make

2. 通过包管理器安装（某些发行版）：

   sudo apt install spi-tools # Debian/Ubuntu

提示：如果你使用的是嵌入式开发板（如树莓派、BeagleBone等），建议先查阅板级支持包(BSP)文档，确认SPI接口是否默认启用，有时需要在设备树中手动配置。

安装完成后，可以通过简单命令验证工具是否可用：

./spidev_test -v

2. 参数深度解析：从命令行到物理信号

spidev_test的参数看似简单，但每个选项都对应着SPI总线上的实际物理信号特性。理解这些参数对于正确调试至关重要。

2.1 基本通信参数

2.2 时钟模式(CPOL/CPHA)详解

SPI的时钟模式由CPOL(Clock Polarity)和CPHA(Clock Phase)两个参数组合决定，共有四种模式：

• 模式0：CPOL=0，CPHA=0
  • 时钟空闲时为低电平
  • 数据在上升沿采样
• 模式1：CPOL=0，CPHA=1
  • 时钟空闲时为低电平
  • 数据在下降沿采样
• 模式2：CPOL=1，CPHA=0
  • 时钟空闲时为高电平
  • 数据在下降沿采样
• 模式3：CPOL=1，CPHA=1
  • 时钟空闲时为高电平
  • 数据在上升沿采样

注意：大多数SPI设备的数据手册会明确指定所需的时钟模式，错误设置会导致通信完全失败。

2.3 高级功能参数

• -l/--loop：启用回环测试模式，用于验证SPI控制器本身是否工作正常
• -C/--cs-high：片选信号高电平有效（默认为低电平有效）
• -3/--3wire：启用三线制SPI（共用MISO和MOSI）
• -N/--no-cs：禁用片选信号（某些特殊设备需要）
• -R/--ready：启用从设备就绪信号

3. 实战案例：常见SPI设备调试

3.1 基础读写测试

让我们从一个最简单的例子开始，向SPI设备发送几个字节并读取返回：

./spidev_test -D /dev/spidev0.0 -s 1000000 -p "\\x01\\x02\\x03\\x04"

这个命令会：

1. 使用/dev/spidev0.0设备
2. 设置1MHz的通信速率
3. 发送四个字节(0x01, 0x02, 0x03, 0x04)
4. 显示接收到的数据

典型输出如下：

spi mode: 0x0 bits per word: 8 max speed: 1000000 Hz (1000 KHz) TX | 01 02 03 04 __ __ __ __ __ __ __ __ __ __ __ __ ................ RX | 00 00 00 00 __ __ __ __ __ __ __ __ __ __ __ __ ................

3.2 读取SPI Flash芯片ID

许多SPI Flash芯片(如Winbond W25Q系列)可以通过0x9F命令读取设备ID：

./spidev_test -D /dev/spidev0.0 -s 10000000 -p "\\x9F\\x00\\x00\\x00"

这里我们：

• 将速度提高到10MHz
• 发送0x9F命令后跟三个空字节
• 芯片应该返回制造商ID、设备类型和容量信息

成功时的输出可能类似：

RX | EF 40 18 00 __ __ __ __ __ __ __ __ __ __ __ __ .@..............

(EF表示Winbond，4018表示16MB容量)

3.3 配置加速度计传感器

以ADXL345加速度计为例，我们需要先写入配置寄存器，然后读取数据：

1. 设置测量模式(写入0x2D寄存器值为0x08)：

   ./spidev_test -D /dev/spidev0.0 -s 5000000 -H -O -p "\\x2D\\x08"

2. 读取X轴数据(从0x32开始6个寄存器)：

   ./spidev_test -D /dev/spidev0.0 -s 5000000 -H -O -p "\\xB2\\x00\\x00\\x00\\x00\\x00\\x00"

   (0xB2 = 0x32 | 0x80，表示读取操作)

3.4 批量数据传输测试

对于需要传输大量数据的场景，可以使用文件输入输出：

# 生成测试数据 echo -ne "\\x01\\x02\\x03\\x04\\x05" > test.bin # 发送文件内容并保存响应 ./spidev_test -D /dev/spidev0.0 -i test.bin -o response.bin -s 1000000 # 查看响应 hexdump -C response.bin

4. 故障排查与结果分析

当SPI通信出现问题时，系统化的排查方法能节省大量时间。以下是一些常见问题及解决方案：

4.1 常见错误模式

1. 无任何响应

   • 检查硬件连接：电源、地线、四根SPI线(SCLK,MOSI,MISO,CS)
   • 验证设备节点权限：ls -l /dev/spidev*
   • 尝试降低通信速率

2. 响应全为零或全为FF

   • 确认时钟模式(CPOL/CPHA)设置正确
   • 检查片选信号是否有效
   • 尝试启用-v参数查看实际发送的数据

3. 数据错位或部分正确

   • 检查数据传输顺序(LSB/MSB)
   • 验证字长设置(--bpw)
   • 考虑信号完整性问题（过长导线、干扰等）

4.2 使用示波器验证信号

当软件调试无法解决问题时，硬件信号分析是最终手段。使用示波器检查：

• 时钟信号：频率是否正确？占空比是否正常？
• 数据信号：与时钟边沿的对齐关系是否符合CPHA设置？
• 片选信号：是否在传输期间保持有效电平？

4.3 高级调试技巧

1. 回环测试：

   ./spidev_test -D /dev/spidev0.0 -l -p "\\xAA\\x55\\x01\\x02"

   在回环模式下，发送的数据会直接被接收，用于验证SPI控制器是否正常工作。

2. 速度测试：

   for speed in 1000000 5000000 10000000 20000000; do echo "Testing at $speed Hz" ./spidev_test -D /dev/spidev0.0 -s $speed -p "\\xAA\\x55\\x01\\x02" done

   逐步提高通信速率，找到设备的稳定工作极限。

3. 压力测试：

   dd if=/dev/urandom of=test.bin bs=1024 count=10 ./spidev_test -D /dev/spidev0.0 -i test.bin -o out.bin -s 10000000 md5sum test.bin out.bin

   通过大数据量传输验证通信稳定性。

5. 常用命令速查表

为了便于日常使用，这里总结了一份spidev_test常用命令速查表：

5.1 基本测试命令

5.2 设备特定命令

5.3 文件操作命令

掌握这些命令组合后，大多数SPI设备的初步调试都能迎刃而解。实际项目中，建议将常用命令保存为脚本，方便重复使用。