跳到主要内容

SPI 通信

在本章中,我们将学习 Luckfox Aura SPI 的设备树配置、回环测试以及 Python 和 C 程序通信方法。

1. SPI 子系统​

在 Linux 系统中,SPI 子系统是一套核心驱动框架,负责管理、控制挂载于 SPI 总线上的各类外设。SPI 子系统的官方详细文档可在内核源码路径 <Linux内核源码>/Documentation/spi 下查阅。

SPI 子系统两大核心组成:

  1. sysfs 接口 SPI 子系统借助 sysfs 导出一系列文件与目录,实现 SPI 总线及设备的配置与管理。相关节点存放于 /sys/class/spi_master、/sys/bus/spi/devices,用户空间可通过该接口读取、修改 SPI 设备属性。
  2. 用户态设备节点 每一个注册成功的 SPI 设备都会在 /dev 目录生成对应的字符设备节点,应用程序可通过标准文件 I/O 接口完成和外设的数据交互。设备节点命名格式一般为 /dev/spidevX.Y:X 代表 SPI 总线编号,Y 代表该总线上的片选设备编号。

2. SPI测试(Shell)​

2.1 引脚分布​

SPICLKMISOMOSICS
SPI0 M2物理脚40 / GPIO5_A6物理脚35 / GPIO5_A5物理脚38 / GPIO5_A4CS0:物理脚10 / GPIO5_A3
SPI1 M2物理脚23 / GPIO5_D1物理脚21 / GPIO5_D3物理脚19 / GPIO5_D2CS0:物理脚24 / GPIO5_D0

2.2 设备树配置​

  1. 板级设备树路径:

    <Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi
  2. 以 SPI1 M2、CS0 为例,在设备树末尾添加以下配置:

    &spi1 {
    pinctrl-names = "default";
    pinctrl-0 = <&spi1m2_clk_pins
    &spi1m2_cs0_pins
    &spi1m2_miso_pins
    &spi1m2_mosi_pins>;
    status = "okay";

    spidev@0 {
    compatible = "rockchip,spidev";
    reg = <0>;
    spi-max-frequency = <10000000>;
    status = "okay";
    };
    };
  3. 编译内核:

    sudo ./build.sh kernel

2.3 查看设备​

在 /sys/bus/spi/devices 目录下,每个已注册的 SPI 设备对应一个 spiX.Y 目录;用户空间设备节点采用 /dev/spidevX.Y 格式,X 为总线号,Y 为片选号。

ls -l /dev/spidev* # 查看设备节点和驱动日志

dmesg | grep -i spi # 查看设备驱动日志

3. SPI 测试(Python程序)​

  1. 示例程序:本次测试连接物理引脚 19 和 21。

    #!/usr/bin/env python3

    import spidev


    def main():
    tx_buffer = [ord(char) for char in "hello world!"]
    spi = None

    try:
    spi = spidev.SpiDev()
    spi.open(1, 0)
    spi.max_speed_hz = 1_000_000
    spi.mode = 0

    rx_buffer = spi.xfer2(tx_buffer)
    print("tx_buffer:", ''.join(map(chr, tx_buffer)))
    print("rx_buffer:", ''.join(map(chr, rx_buffer)))
    except Exception as error:
    print(f"An error occurred: {error}")
    finally:
    if spi is not None:
    spi.close()


    if __name__ == "__main__":
    main()
  2. 程序运行结果:

    发送字符串与接收字符串完全一致,说明 Python 回环测试成功。

4. SPI 测试(C程序)​

  1. 完整代码:

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

    int main(void)
    {
    const char *device = "/dev/spidev1.0";
    uint8_t tx_buffer[] = "hello world!";
    uint8_t rx_buffer[sizeof(tx_buffer)] = {0};
    uint8_t mode = SPI_MODE_0;
    uint8_t bits = 8;
    uint32_t speed = 1000000;
    int spi_file = open(device, O_RDWR);

    if (spi_file < 0) {
    perror("Failed to open SPI device");
    return EXIT_FAILURE;
    }

    if (ioctl(spi_file, SPI_IOC_WR_MODE, &mode) < 0 ||
    ioctl(spi_file, SPI_IOC_WR_BITS_PER_WORD, &bits) < 0 ||
    ioctl(spi_file, SPI_IOC_WR_MAX_SPEED_HZ, &speed) < 0) {
    perror("Failed to configure SPI device");
    close(spi_file);
    return EXIT_FAILURE;
    }

    struct spi_ioc_transfer transfer = {
    .tx_buf = (unsigned long)tx_buffer,
    .rx_buf = (unsigned long)rx_buffer,
    .len = sizeof(tx_buffer) - 1,
    .delay_usecs = 0,
    .speed_hz = speed,
    .bits_per_word = bits,
    };

    if (ioctl(spi_file, SPI_IOC_MESSAGE(1), &transfer) < 0) {
    perror("Failed to perform SPI transfer");
    close(spi_file);
    return EXIT_FAILURE;
    }

    printf("tx_buffer: %s\n", tx_buffer);
    printf("rx_buffer: %s\n", rx_buffer);

    close(spi_file);
    return EXIT_SUCCESS;
    }
  2. 打开 SPI 设备:

    int spi_file = open("/dev/spidev1.0", O_RDWR);

    以读写方式打开指定 SPI 总线和片选对应的设备节点。

  3. 配置 SPI:

    ioctl(spi_file, SPI_IOC_WR_MODE, &mode);
    ioctl(spi_file, SPI_IOC_WR_BITS_PER_WORD, &bits);
    ioctl(spi_file, SPI_IOC_WR_MAX_SPEED_HZ, &speed);

    设置 SPI 模式、每字位数和通信频率。

  4. 发送和接收数据:

    ioctl(spi_file, SPI_IOC_MESSAGE(1), &transfer);

    执行一次全双工 SPI 传输,发送 tx 缓冲区并将接收数据保存到 rx。

  5. 交叉编译:

    aarch64-rockchip1240-linux-gnu-gcc SPI.c -o SPI
  6. 运行程序:

    程序输出的接收字符串与发送字符串一致,说明 C 程序回环测试成功。