Linux ARM平台spidev_test设置SPI模式失败问题排查

这个错误的核心原因是应用层发起的SPI模式设置IOCTL命令未被驱动正确响应，大概率源于驱动层配置或实现问题，但也需要先排除应用层的小概率异常。以下是具体排查方向：

一、先排除应用层问题 #

1. 验证编译环境一致性 #

• 确认编译spidev_test时使用的是目标ARM架构的交叉编译工具链，且编译依赖的头文件（尤其是linux/spi/spidev.h）与目标系统的Linux内核v6.4.0完全匹配。
• 对比编译用的spidev.h和内核源码中的对应文件，检查SPI_IOC_WR_MODE、SPI_IOC_RD_MODE等IOCTL宏的定义是否一致——宏定义不匹配会导致命令码无效，触发"不适当的IOCTL"错误。
• 可以用strings spidev_test | grep SPI_IOC_WR_MODE快速验证程序中是否包含正确的IOCTL命令码。

2. 极简程序验证 #

编写一个仅包含"打开设备+设置模式"的极简测试程序，排除spidev_test中其他逻辑的干扰：

#include <fcntl.h>
#include <linux/spi/spidev.h>
#include <stdio.h>
#include <sys/ioctl.h>
#include <unistd.h>

int main() {
    int fd = open("/dev/spidev1.0", O_RDWR);
    if (fd < 0) {
        perror("open failed");
        return 1;
    }
    uint8_t mode = 0;
    int ret = ioctl(fd, SPI_IOC_WR_MODE, &mode);
    if (ret < 0) {
        perror("ioctl set mode failed");
        close(fd);
        return 1;
    }
    printf("set spi mode success\n");
    close(fd);
    return 0;
}

交叉编译后运行，如果仍报相同错误，可直接排除应用层问题。

二、驱动层核心排查方向 #

1. 检查spidev驱动状态 #

• 确认内核配置中CONFIG_SPI_SPIDEV已开启：执行zcat /proc/config.gz | grep CONFIG_SPI_SPIDEV，输出应为=y（编译进内核）或=m（作为模块）。
• 如果是模块模式，检查模块是否加载：lsmod | grep spidev，若未加载则手动加载modprobe spidev。

2. 验证SPI控制器与spidev节点的注册状态 #

• 查看内核启动日志：dmesg | grep spi，确认存在类似以下的日志：

  spi spi1.0: spidev spi1.0: user slave mode
  spi spi1: registered master spi controller on bus 1

• 如果日志中没有spidev相关的注册信息，说明即使/dev/spidev1.0节点存在，也可能是手动创建的空节点，并非驱动正常生成。

3. 检查SPI控制器驱动的IOCTL实现 #

部分定制化的SPI控制器驱动可能未完整实现spidev所需的接口：

• 查看内核源码中对应SPI控制器驱动的spi_ops结构体，确认set_mode、transfer等核心函数已正确实现。
• 若控制器驱动未实现set_mode，会直接导致SPI模式设置的IOCTL命令无法被响应。

4. 设备节点与设备树验证 #

• 检查节点属性：ls -l /dev/spidev1.0，SPI设备的主设备号应为153，若不是则说明节点是手动创建的无效节点。
• 设备树配置检查（针对设备树系统）：确认SPI1总线节点下的spidev子节点配置正确，需包含compatible = "linux,spidev"，且该总线未被其他硬件设备占用。

5. 权限验证 #

尝试用sudo spidev_test -D /dev/spidev1.0执行测试，排除当前用户无设备读写权限的可能。

总结 #

该错误90%以上源于驱动层问题：要么是spidev驱动未正确加载/注册，要么是SPI控制器驱动缺失必要的IOCTL实现，或是设备树/内核配置错误。应用层问题仅可能出现在编译环境不匹配的场景。

内容的提问来源于stack exchange，提问作者Vimer