RK3566 SPI设备节点实战：从内核配置到用户空间spidev3.0测试

1. RK3566 SPI开发基础与实战意义SPI总线作为嵌入式系统中最常用的通信协议之一在RK3566这类高性能处理器上的应用尤为广泛。我最近在立创泰山派开发板上折腾SPI设备时发现很多新手都会卡在内核配置和用户空间测试的衔接环节。这篇文章就来手把手带你打通这个全流程。先说说为什么需要掌握SPI设备节点的配置。当你需要连接显示屏、传感器比如IMU或环境传感器、存储设备如SPI Flash时SPI往往是首选方案。相比I2C它的传输速率更高RK3566的SPI3控制器最高支持50MHz时钟相比并行总线它又节省引脚资源。在实际项目中我遇到过需要同时控制多个SPI从设备的情况这时候理解设备树配置就尤为重要。RK3566的SPI控制器有多个实例SPI0-SPI3其中SPI3是最常用的通用接口。内核自带的spidev驱动让我们可以像操作普通文件一样操作SPI设备极大简化了开发流程。不过要注意的是生产环境中建议使用专用驱动而非spidev后者更适合快速原型开发。2. SPI核心概念快速掌握2.1 四线制与工作模式SPI通信最基础的就是要理解四根信号线SCLK时钟信号由主设备产生MOSI主设备输出从设备输入MISO主设备输入从设备输出CS片选信号低电平有效我常用一个水管工的比喻来理解SCLK就像水泵的脉冲MOSI和MISO是双向水管CS则是决定哪个水龙头打开。这种全双工通信方式让数据可以同时进出实测在RK3566上传输效率能达到I2C的3-5倍。2.2 极性与相位详解CPOL和CPHA这两个参数决定了数据采样的时机CPOL0时钟空闲时为低电平CPOL1时钟空闲时为高电平CPHA0在第一个时钟边沿采样CPHA1在第二个时钟边沿采样最常用的模式是Mode 0CPOL0, CPHA0这也是大多数传感器的默认模式。我在调试OLED屏时就遇到过模式不匹配导致花屏的问题后来用逻辑分析仪抓取信号才发现从设备要求Mode 3。2.3 时钟频率与数据位宽RK3566的SPI控制器支持灵活的配置时钟频率可从几KHz到50MHz数据位宽支持4-32bit常用8bit支持DMA传输减轻CPU负担需要注意的是实际速率受限于PCB布线质量。我曾在20MHz以上速率遇到信号完整性问题通过缩短走线长度和添加端接电阻解决。3. 设备树配置实战3.1 定位设备树文件在立创泰山派的SDK中设备树文件通常位于kernel/arch/arm64/boot/dts/rockchip/tspi-rk3566-user-v10-linux.dts建议先备份原文件我吃过没备份的亏——一次错误的修改导致系统无法启动最后只能重新烧录固件。3.2 SPI控制器节点配置找到或添加SPI3控制器节点spi3: spife640000 { compatible rockchip,rk3066-spi; reg 0x0 0xfe640000 0x0 0x1000; interrupts GIC_SPI 106 IRQ_TYPE_LEVEL_HIGH; clocks cru CLK_SPI3, cru PCLK_SPI3; clock-names spiclk, apb_pclk; dmas dmac0 26, dmac0 27; dma-names tx, rx; pinctrl-names default, high_speed; pinctrl-0 spi3m0_cs0 spi3m0_pins; pinctrl-1 spi3m0_cs0 spi3m0_pins_hs; status disabled; };关键参数说明reg控制器寄存器物理地址和范围interrupts中断号配置pinctrl-0默认引脚配置组dmas启用DMA传输通道3.3 启用SPI设备节点在设备树末尾添加spi3 { status okay; pinctrl-names default; pinctrl-0 spi3m1_cs0 spi3m1_pins; spi_dev0 { compatible rockchip,spidev; reg 0; spi-max-frequency 10000000; status okay; }; };这里有几个容易踩坑的点pinctrl-0必须与硬件实际连接引脚一致spi-max-frequency不要超过从设备规格reg 0表示使用CS0片选4. 内核编译与烧写4.1 编译配置检查执行make menuconfig确保以下选项启用Device Drivers - SPI support - Rockchip SPI controller Device Drivers - SPI support - User mode SPI device driver我建议同步开启CONFIG_SPI_DEBUG选项这样可以通过dmesg查看详细的SPI传输日志。4.2 编译与烧录使用以下命令编译内核和设备树make ARCHarm64 CROSS_COMPILEaarch64-linux-gnu- -j8烧录生成的boot.img到开发板后启动时应该能看到类似这样的内核日志[ 1.235678] spi-nor spi3.0: spi3.0 at 0MHz (mode 0)5. 用户空间测试实战5.1 验证设备节点成功启动后检查是否存在设备节点ls /dev/spidev3.0可以用ioctl命令快速测试ioctl -l /dev/spidev3.05.2 使用内核测试工具内核自带的spi-tools位于cd kernel/tools/spi make CROSS_COMPILEaarch64-linux-gnu-将生成的spidev_test拷贝到开发板运行./spidev_test -D /dev/spidev3.0 -s 1000000 -p \x01\x025.3 自定义测试程序这里给出一个增强版的测试程序支持模式切换和连续传输#include stdio.h #include fcntl.h #include linux/spi/spidev.h void spi_config(int fd, uint8_t mode, uint32_t speed) { int ret; ret ioctl(fd, SPI_IOC_WR_MODE, mode); ret ioctl(fd, SPI_IOC_WR_MAX_SPEED_HZ, speed); } void spi_loopback_test(int fd) { uint8_t tx[] {0xAA, 0x55, 0xF0, 0x0F}; uint8_t rx[4] {0}; struct spi_ioc_transfer tr { .tx_buf (unsigned long)tx, .rx_buf (unsigned long)rx, .len sizeof(tx), .delay_usecs 0, .speed_hz 1000000, .bits_per_word 8, }; ioctl(fd, SPI_IOC_MESSAGE(1), tr); printf(Sent: ); for(int i0; isizeof(tx); i) printf(%02X , tx[i]); printf(\nReceived: ); for(int i0; isizeof(rx); i) printf(%02X , rx[i]); printf(\n); }编译命令aarch64-linux-gnu-gcc -o spi_test spi_test.c6. 高级调试技巧6.1 逻辑分析仪抓包推荐使用Saleae Logic Analyzer配合PulseView软件连接时注意探头接地要可靠采样率至少设为时钟频率的4倍使用协议解码器自动解析SPI数据6.2 内核调试信息查看SPI控制器寄存器cat /sys/kernel/debug/regmap/spi3/registers监控传输统计cat /sys/kernel/debug/spi/spi3/stats6.3 性能优化建议启用DMA传输减少CPU占用合理设置SPI时钟分频批量传输代替单字节操作使用ioctl的SPI_IOC_MESSAGE接口在最近的一个项目中通过优化SPI传输参数我们将传感器数据采集效率提升了40%。关键点在于找到了设备支持的最高稳定时钟频率——不是所有设备都能跑在标称的最高频率下。