SPI 通信
在本章中,我们将学习 Luckfox Aura SPI 的设备树配置、回环测试以及 Python 和 C 程序通信方法。
1. SPI 子系统
在 Linux 系统中,SPI 子系统是一套核心驱动框架,负责管理、控制挂载于 SPI 总线上的各类外设。SPI 子系统的官方详细文档可在内核源码路径 <Linux内核源码>/Documentation/spi 下查阅。
SPI 子系统两大核心组成:
- sysfs 接口
SPI 子系统借助 sysfs 导出一系列文件与目录,实现 SPI 总线及设备的配置与管理。相关节点存放于
/sys/class/spi_master、/sys/bus/spi/devices,用户空间可通过该接口读取、修改 SPI 设备属性。 - 用户态设备节点
每一个注册成功的 SPI 设备都会在
/dev目录生成对应的字符设备节点,应用程序可通过标准文件 I/O 接口完成和外设的数据交互。设备节点命名格式一般为/dev/spidevX.Y:X代表 SPI 总线编号,Y代表该总线上的片选设备编号。
2. SPI测试(Shell)
2.1 引脚分布
| SPI | CLK | MISO | MOSI | CS |
|---|---|---|---|---|
| SPI0 M2 | 物理脚40 / GPIO5_A6 | 物理脚35 / GPIO5_A5 | 物理脚38 / GPIO5_A4 | CS0:物理脚10 / GPIO5_A3 |
| SPI1 M2 | 物理脚23 / GPIO5_D1 | 物理脚21 / GPIO5_D3 | 物理脚19 / GPIO5_D2 | CS0:物理脚24 / GPIO5_D0 |

2.2 设备树配置
-
板级设备树路径:
<Luckfox Aura SDK>/sysdrv/source/kernel/arch/arm64/boot/dts/rockchip/rv1126b-luckfox-aura.dtsi -
以 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";};}; -
编译内核:
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程序)
-
示例程序:本次测试连接物理引脚 19 和 21。
#!/usr/bin/env python3import spidevdef main():tx_buffer = [ord(char) for char in "hello world!"]spi = Nonetry:spi = spidev.SpiDev()spi.open(1, 0)spi.max_speed_hz = 1_000_000spi.mode = 0rx_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() -
程序运行结果:
发送字符串与接收字符串完全一致,说明 Python 回环测试成功。
4. SPI 测试(C程序)
-
完整代码:
#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;} -
打开 SPI 设备:
int spi_file = open("/dev/spidev1.0", O_RDWR);以读写方式打开指定 SPI 总线和片选对应的设备节点。
-
配置 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 模式、每字位数和通信频率。
-
发送和接收数据:
ioctl(spi_file, SPI_IOC_MESSAGE(1), &transfer);执行一次全双工 SPI 传输,发送
tx缓冲区并将接收数据保存到rx。 -
交叉编译:
aarch64-rockchip1240-linux-gnu-gcc SPI.c -o SPI -
运行程序:
程序输出的接收字符串与发送字符串一致,说明 C 程序回环测试成功。