在嵌入式Linux開發(fā)中，SPI（串行外設接口）憑借高速同步通信特性，廣泛應用于傳感器、存儲芯片、顯示模塊等外設交互場景。瑞芯微（Rockchip）作為主流嵌入式芯片廠商，其Linux平臺SPI驅(qū)動已形成完善的開發(fā)體系，支持Master/Slave雙模式、多速率適配及靈活配置。本文基于Rockchip官方開發(fā)指南，從功能特性、驅(qū)動配置、測試驗證到優(yōu)化方案，全方位拆解RK平臺SPI開發(fā)流程。

一、RK平臺SPI核心特性速覽

1.基礎支持能力

?協(xié)議兼容：默認采用摩托羅拉SPI協(xié)議，支持4種傳輸模式（CPOL/CPHA組合配置）

?數(shù)據(jù)寬度：支持8位/16位傳輸，16位模式可提升DMA傳輸效率

?片選擴展：每個SPI控制器支持1-2個硬件片選，可通過cs-gpios擴展更多片選信號

?內(nèi)核適配：兼容Linux4.4、Linux4.19及以上內(nèi)核（含Linux5.10），新增Slave模式框架支持

2.關(guān)鍵速率參數(shù)（全平臺匯總）

注意：表格速率為理論值，實際受PCB走線質(zhì)量、PLL分頻策略影響，需以實測為準；部分平臺需配置100MHz工作時鐘（二分頻后輸出50MHz）。

二、開發(fā)環(huán)境與核心代碼路徑

1.內(nèi)核配置前提

需在Kernel配置中啟用SPI相關(guān)支持，配置路徑如下：

DeviceDrivers ---> [*] SPI support --->  <*> Rockchip SPI controller driver # RK專用SPI控制器驅(qū)動  <*> User mode SPI device driver support # 用戶態(tài)訪問支持（可選）  [*] SPI slave protocol handlers # Slave模式支持（如需從機功能）

2.核心代碼位置

三、SPI驅(qū)動配置實戰(zhàn)（Master/Slave雙模式）

1. Master模式配置（RK芯片作為主機）

（1）DTS節(jié)點配置示例（以SPI0為例）

&spi0 {  status ="okay"; // 可選配置：關(guān)閉DMA僅用IRQ傳輸（默認開啟DMA） // dma-names; // 可選配置：讀采樣延時（單位ns，需根據(jù)外設調(diào)整） // rx-sample-delay-ns = <10>; // 可選配置：Runtime PM休眠延時（優(yōu)化功耗） // rockchip,autosuspend-delay-ms = <500>; spi_test@0{    compatible ="rockchip,spi_test_bus0_cs0"; // 與驅(qū)動匹配名    reg = <0>; // 片選編號（0或1）    spi-cpha; // 配置CPHA=1（默認0）    spi-cpol; // 配置CPOL=1（默認0）    spi-lsb-first; // 小端優(yōu)先傳輸（默認大端）    spi-max-frequency = <24000000>; // 傳輸速率（不超過50MHz）  };};

（2）時鐘配置說明

?SPI輸出時鐘（spi-max-frequency）由工作時鐘（assigned-clock-rates）分頻得到

?約束關(guān)系：assigned-clock-rates ≥ 2×spi-max-frequency（內(nèi)部分頻為偶數(shù)）

?示例：需50MHz傳輸速率時，配置assigned-clock-rates = <100000000>

2. Slave模式配置（RK芯片作為從機）

（1）關(guān)鍵依賴

需先確認SDK包含Slave驅(qū)動補?。?/span>commit 10cbf3c2），無補丁可通過瑞芯微Redmine獲取。

（2）DTS節(jié)點配置示例（以SPI1為例）

&spi1 {  compatible ="rockchip,spi-slave"; // 從機模式標識  status ="okay";  ready-gpios = <&gpio1 RK_PD3 GPIO_ACTIVE_LOW>; // 就緒信號（下降沿有效） // 可選配置：屏蔽CS釋放檢測（適用于長時序場景） // rockchip,cs-inactive-disable; slave@0{    compatible ="rockchip,spi_test_bus1_cs0";    reg = <0>; // 從機僅支持片選0    spi-cpha;    spi-cpol;    spi-lsb-first;    max-frequency = <33000000>; // 遵循對應SOC的Slave速率限制  };};

（3）從機模式關(guān)鍵須知

?傳輸順序：Slave需先啟動讀寫操作，Master再發(fā)起傳輸（避免數(shù)據(jù)丟失）

?DMA建議：Slave模式默認啟用DMA，不建議關(guān)閉（大長度傳輸需依賴DMA避免緩存溢出）

?性能模式：Master速率＞5MHz（8位）/10MHz（16位）時，需開啟performance模式

3. cs-gpios片選擴展（Linux4.19+）

當硬件片選不足時，可通過GPIO模擬片選，配置步驟如下：

// 1. 定義GPIO引腳功能&pinctrl {  spi1 {    spi1_cs2n: spi1-cs2n {      rockchip,pins = <0RK_PC4 RK_FUNC_GPIO &pcfg_pull_up_drv_level_0>;    };  };};// 2. SPI節(jié)點引用擴展片選&spi1 {  status ="okay";  cs-gpios = <&gpio0 RK_PC2 GPIO_ACTIVE_LOW>, // 原有片選0       <&gpio0 RK_PC3 GPIO_ACTIVE_LOW>, // 原有片選1       <&gpio0 RK_PC4 GPIO_ACTIVE_LOW>; // 擴展片選2};

四、驅(qū)動開發(fā)與測試驗證

1.內(nèi)核態(tài)驅(qū)動開發(fā)示例

核心實現(xiàn)probe函數(shù)（設備匹配與初始化）和讀寫接口，參考代碼：

#includestaticintspi_test_probe(structspi_device *spi){ intret; if(!spi)return-ENOMEM;
  spi->bits_per_word =8; // 設置數(shù)據(jù)寬度  ret =spi_setup(spi);  // 初始化SPI配置 if(ret 0) {   dev_err(&spi->dev,"SPI配置失敗n");   returnret;  } return0;}// 設備樹匹配表staticconststructof_device_idspi_test_dt_match[] = {  {.compatible ="rockchip,spi_test_bus0_cs0"},  {.compatible ="rockchip,spi_test_bus1_cs0"},  {},};MODULE_DEVICE_TABLE(of, spi_test_dt_match);// SPI驅(qū)動結(jié)構(gòu)體staticstructspi_driverspi_test_driver = {  .driver = {    .name ="spi_test",    .of_match_table =of_match_ptr(spi_test_dt_match),  },  .probe = spi_test_probe,  .remove = spi_test_remove,};module_init(spi_test_init); // 驅(qū)動注冊module_exit(spi_test_exit); // 驅(qū)動卸載

2.測試驗證步驟

（1）內(nèi)核態(tài)測試（使用spi-rockchip-test驅(qū)動）

1.編譯驅(qū)動：在drivers/spi/Makefile中添加obj-y += spi-rockchip-test.o

2.加載驅(qū)動后，執(zhí)行測試命令：

# 寫測試：向ID=0的設備寫入10次，每次255字節(jié)echowrite010255> /dev/spi_misc_test# 讀測試：從ID=0的設備讀取10次，每次255字節(jié)echoread010255> /dev/spi_misc_test# 速率設置：將ID=0的設備速率設為1MHzechosetspeed01000000> /dev/spi_misc_test

（2）用戶態(tài)測試（使用spidev設備節(jié)點）

1.編譯測試工具：make CROSS_COMPILE=xxx-linux-gnu- -C linux-src M=Documentation/spi

2.運行測試程序：

# 讀取spidev1.1設備，傳輸1024字節(jié)./spidev_test -D /dev/spidev1.1 -s 24000000 -r -n 1024

（3）Slave模式專項測試

1.Slave端啟動寫操作：echo write 0 1 16 > /dev/spi_misc_test

2.Master端啟動讀操作：echo read 0 1 16 > /dev/spi_misc_test

3.自動化壓測（Master端）：echo autotest 1024 64 1 > /dev/spidev_rkmst_misc（1024字節(jié)×64次，開啟校驗）

五、常見問題與優(yōu)化方案

1.高頻問題排查

（1）SPI無信號輸出

?檢查驅(qū)動加載狀態(tài)：lsmod | grep spi_rockchip

?確認引腳配置：驗證IOMUX是否正確映射為SPI功能

?排查DMA使能：串口無"Failed to request TX/RX DMA channel"則DMA正常

?增強驅(qū)動強度：高頻場景下提高GPIO驅(qū)動能力改善信號質(zhì)量

（2）傳輸數(shù)據(jù)錯誤

?速率匹配：確認Master/Slave速率不超過對應SOC的限制

?采樣延時：高速傳輸時添加rx-sample-delay-ns配置（如10ns）

?模式一致性：Master與Slave的CPOL/CPHA配置必須一致

2.性能優(yōu)化方向

（1）降低CPU占用率

?開啟Runtime PM：dts添加rockchip,autosuspend-delay-ms = <500>

?調(diào)整傳輸模式：小數(shù)據(jù)量場景改用IRQ傳輸（關(guān)閉DMA）

?優(yōu)化DMA水線：修改TX DMA水線值（如設為11）減少回調(diào)等待時間

（2）提升傳輸速率

?啟用16位數(shù)據(jù)寬度：最大化FIFO利用率，加速DMA傳輸

?開啟performance模式：避免DRAM變頻導致緩存溢出（參考如下代碼）

// 傳輸前開啟性能模式rockchip_set_system_status(SYS_STATUS_PERFORMANCE);// 執(zhí)行SPI傳輸spi_read_slt(id, rxbuf, size);// 傳輸后關(guān)閉性能模式rockchip_clear_system_status(SYS_STATUS_PERFORMANCE);

?減少傳輸次數(shù)：合并小數(shù)據(jù)包，降低調(diào)度開銷

RK平臺SPI開發(fā)的核心在于掌握DTS配置規(guī)范、模式匹配要點及性能優(yōu)化技巧。通過本文的步驟拆解，無論是快速搭建基礎通信鏈路，還是深度優(yōu)化傳輸性能，都能找到對應的實現(xiàn)方案。建議開發(fā)過程中結(jié)合具體SOC的速率限制和外設需求，靈活調(diào)整配置參數(shù)，確保SPI通信穩(wěn)定可靠。