議詳解：從原理到實(shí)戰(zhàn)驅(qū)動(dòng)W25Q64 Flash)
1. 項(xiàng)目概述從“點(diǎn)燈”到“對(duì)話(huà)”為什么SPI是嵌入式開(kāi)發(fā)的必修課玩過(guò)STM32的朋友從點(diǎn)燈到串口打印算是邁入了嵌入式世界的大門(mén)。但當(dāng)你開(kāi)始驅(qū)動(dòng)一塊TFT屏幕、讀寫(xiě)一個(gè)SD卡或者連接一個(gè)高精度的傳感器時(shí)會(huì)發(fā)現(xiàn)GPIO和UART有點(diǎn)力不從心了。這時(shí)候一個(gè)名字就會(huì)高頻出現(xiàn)SPI。我剛開(kāi)始接觸SPI時(shí)覺(jué)得它比I2C復(fù)雜比UART“事兒多”但真正用熟了才發(fā)現(xiàn)它是連接外部高速器件的“高速公路”是項(xiàng)目從玩具級(jí)邁向產(chǎn)品級(jí)的關(guān)鍵一步。SPI全稱(chēng)Serial Peripheral Interface中文叫串行外設(shè)接口是ST、NXP、TI這些芯片大廠(chǎng)在自家MCU里普遍集成的一種高速、全雙工、同步的通信總線(xiàn)。簡(jiǎn)單說(shuō)它就像一條多車(chē)道的馬路主設(shè)備通常是你的STM32可以同時(shí)向從設(shè)備發(fā)送和接收數(shù)據(jù)而且大家踩著同一個(gè)時(shí)鐘節(jié)拍走效率非常高。這個(gè)筆記我們就來(lái)徹底拆解STM32的SPI外設(shè)。它適合誰(shuí)呢如果你已經(jīng)會(huì)用STM32的HAL庫(kù)點(diǎn)燈、調(diào)串口想驅(qū)動(dòng)SPI Flash如W25Q64、OLED屏SSD1306、或者像MPU6050這樣的傳感器那這篇內(nèi)容就是為你準(zhǔn)備的。我會(huì)避開(kāi)枯燥的協(xié)議手冊(cè)翻譯直接從一個(gè)實(shí)際開(kāi)發(fā)者的角度帶你理解SPI在STM32里怎么配置、怎么用以及那些手冊(cè)里不提但實(shí)際項(xiàng)目里一定會(huì)踩的坑。我們的目標(biāo)很明確看完之后你能獨(dú)立搞定一個(gè)SPI設(shè)備的驅(qū)動(dòng)并且明白每一個(gè)配置項(xiàng)背后的“為什么”。2. SPI通信核心原理與STM32的實(shí)現(xiàn)方式2.1 SPI協(xié)議的精髓四線(xiàn)制與主從時(shí)鐘同步要駕馭STM32的SPI外設(shè)死記寄存器不如先吃透協(xié)議本身。SPI協(xié)議的核心思想其實(shí)非常直觀它用四根線(xiàn)解決所有問(wèn)題SCK (Serial Clock)時(shí)鐘線(xiàn)由主設(shè)備產(chǎn)生。這是總線(xiàn)的“指揮棒”所有數(shù)據(jù)位的傳輸都嚴(yán)格跟隨它的上升沿或下降沿。這是SPI“同步”二字的來(lái)源也是其高速穩(wěn)定的基礎(chǔ)。MOSI (Master Output Slave Input)主設(shè)備輸出從設(shè)備輸入線(xiàn)。主設(shè)備通過(guò)這根線(xiàn)發(fā)送數(shù)據(jù)給從設(shè)備。MISO (Master Input Slave Output)主設(shè)備輸入從設(shè)備輸出線(xiàn)。主設(shè)備通過(guò)這根線(xiàn)接收從設(shè)備的數(shù)據(jù)。NSS (Slave Select)從設(shè)備選擇線(xiàn)通常也叫做CSChip Select或SS。這是主設(shè)備用來(lái)“點(diǎn)名”哪個(gè)從設(shè)備來(lái)跟自己通信的。當(dāng)NSS線(xiàn)被拉低有效對(duì)應(yīng)的從設(shè)備被激活開(kāi)始監(jiān)聽(tīng)時(shí)鐘和數(shù)據(jù)線(xiàn)當(dāng)被拉高從設(shè)備進(jìn)入“休眠”狀態(tài)忽略總線(xiàn)。這是一個(gè)硬件上的片選機(jī)制。這里有一個(gè)關(guān)鍵點(diǎn)MOSI和MISO是獨(dú)立的這意味著數(shù)據(jù)可以同時(shí)雙向流動(dòng)這就是“全雙工”。想象一下打電話(huà)SPI就像視頻通話(huà)雙方能同時(shí)說(shuō)和聽(tīng)而像I2C或單線(xiàn)UART則更像對(duì)講機(jī)同一時(shí)間只能一方說(shuō)。SPI的通信模式由兩個(gè)關(guān)鍵參數(shù)決定時(shí)鐘極性CPOL和時(shí)鐘相位CPHA。它們組合成了四種模式Mode 0, 1, 2, 3。很多新手在這里會(huì)懵我用一個(gè)生活化的比喻來(lái)解釋CPOL (Clock Polarity)時(shí)鐘空閑時(shí)的狀態(tài)。CPOL0表示SCK在空閑時(shí)為低電平CPOL1則為高電平。你可以把它想象成指揮棒的“預(yù)備姿勢(shì)”是放下低還是舉起高。CPHA (Clock Phase)數(shù)據(jù)采樣的時(shí)刻。CPHA0表示在時(shí)鐘的第一個(gè)邊沿如果CPOL0就是上升沿CPOL1就是下降沿采樣數(shù)據(jù)CPHA1則表示在時(shí)鐘的第二個(gè)邊沿采樣。這相當(dāng)于指揮棒揮動(dòng)一下有兩個(gè)動(dòng)作起和落你選擇在“起”的時(shí)候抓取數(shù)據(jù)還是在“落”的時(shí)候抓取。重要提示SPI模式必須主從設(shè)備嚴(yán)格匹配這是通信失敗的頭號(hào)殺手。你用的傳感器或Flash芯片的數(shù)據(jù)手冊(cè)里一定會(huì)明確寫(xiě)明它支持哪種SPI模式。STM32的配置必須與之完全一致差一點(diǎn)都不行。通常Mode 0和Mode 3最為常見(jiàn)。2.2 STM32 SPI外設(shè)的架構(gòu)與工作模式STM32的SPI外設(shè)是一個(gè)高度集成化的硬件模塊它把上述協(xié)議邏輯用硬件實(shí)現(xiàn)大大減輕了CPU的負(fù)擔(dān)。其核心架構(gòu)包括移位寄存器負(fù)責(zé)數(shù)據(jù)的并串轉(zhuǎn)換發(fā)送時(shí)和串并轉(zhuǎn)換接收時(shí)。當(dāng)你寫(xiě)入數(shù)據(jù)到發(fā)送數(shù)據(jù)寄存器DR時(shí)硬件會(huì)自動(dòng)將其移出到MOSI線(xiàn)同時(shí)MISO線(xiàn)上的數(shù)據(jù)也會(huì)被移入接收數(shù)據(jù)寄存器。波特率發(fā)生器由APB總線(xiàn)時(shí)鐘分頻得到SCK時(shí)鐘。分頻系數(shù)可以配置如2, 4, 8, 16, 32...256等這決定了通信速率。STM32F1系列的SPI最高可達(dá)18MbpsF4系列可達(dá)37.5MbpsH7系列更是能到上百M(fèi)bps。控制邏輯負(fù)責(zé)生成SCK、管理NSS信號(hào)、控制數(shù)據(jù)幀格式數(shù)據(jù)位寬通常是8位或16位、以及決定MSB最高位還是LSB最低位先傳輸。STM32的SPI主要有三種工作模式你需要根據(jù)應(yīng)用場(chǎng)景選擇全雙工主模式最常用STM32作為主機(jī)主動(dòng)產(chǎn)生SCK并通過(guò)MOSI發(fā)送數(shù)據(jù)同時(shí)通過(guò)MISO接收數(shù)據(jù)。這是驅(qū)動(dòng)絕大多數(shù)SPI從設(shè)備如Flash、ADC的標(biāo)準(zhǔn)模式。全雙工從模式STM32作為從機(jī)等待外部主機(jī)提供的SCK并根據(jù)時(shí)鐘在MISO上輸出數(shù)據(jù)從MOSI上輸入數(shù)據(jù)。這常用于STM32作為協(xié)處理器與另一個(gè)更強(qiáng)大的主MCU通信。半雙工單線(xiàn)雙向模式可以配置為只使用一根數(shù)據(jù)線(xiàn)要么當(dāng)MOSI用要么當(dāng)MISO用進(jìn)行單向或分時(shí)雙向通信。這可以節(jié)省一個(gè)GPIO引腳但速率和靈活性下降。有些特殊的ADC芯片會(huì)用到這種模式。NSS引腳管理的坑點(diǎn)STM32的NSS引腳管理有“硬件模式”和“軟件模式”之分。硬件模式NSSHardwareNSS引腳由硬件自動(dòng)管理。在主模式下你需要將該引腳配置為復(fù)用推挽輸出STM32會(huì)在通信開(kāi)始時(shí)自動(dòng)將其拉低結(jié)束時(shí)拉高。在從模式下該引腳必須配置為浮空輸入等待外部主機(jī)拉低。硬件模式的缺點(diǎn)是一個(gè)SPI外設(shè)只能控制一個(gè)從設(shè)備。軟件模式NSSSoftware這是更常用、更靈活的方式。你將NSS引腳配置為普通的GPIO輸出比如PA4然后在代碼里手動(dòng)控制它的高低電平。在發(fā)起傳輸前手動(dòng)拉低對(duì)應(yīng)的CS引腳傳輸完成后再手動(dòng)拉高。這樣你可以用同一個(gè)SPI外設(shè)同一組SCK、MOSI、MISO通過(guò)不同的GPIO片選控制多個(gè)從設(shè)備實(shí)現(xiàn)“一主多從”。3. 使用STM32CubeMX與HAL庫(kù)配置SPI的完整流程理論懂了我們上手實(shí)操。我會(huì)以驅(qū)動(dòng)一塊常見(jiàn)的SPI Flash芯片W25Q64為例使用STM32CubeMX圖形化工具和HAL庫(kù)展示從零到一的配置過(guò)程。選擇W25Q64是因?yàn)樗鼌f(xié)議標(biāo)準(zhǔn)應(yīng)用廣泛且包含了SPI通信的典型操作寫(xiě)使能、讀ID、讀數(shù)據(jù)、寫(xiě)數(shù)據(jù)、擦除扇區(qū)。3.1 CubeMX工程初始化與SPI參數(shù)配置首先打開(kāi)STM32CubeMX選擇你的芯片型號(hào)例如STM32F103C8T6。啟用SPI外設(shè)在Pinout Configuration標(biāo)簽頁(yè)的左側(cè)找到Connectivity-SPI1。將Mode設(shè)置為Full-Duplex Master全雙工主機(jī)。這時(shí)對(duì)應(yīng)的引腳PA5/SCK, PA6/MISO, PA7/MOSI會(huì)被自動(dòng)分配。配置GPIO for NSS我們不使用硬件NSS。在左側(cè)System Core-GPIO中找一個(gè)空閑的GPIO例如PA4作為軟件片選。將其模式設(shè)置為GPIO_Output初始輸出電平設(shè)為High默認(rèn)不選中從設(shè)備。精調(diào)SPI參數(shù)點(diǎn)擊SPI1進(jìn)入?yún)?shù)設(shè)置。Basic Parameters:Prescaler (波特率預(yù)分頻)根據(jù)你的主頻和從設(shè)備支持的速度計(jì)算。例如主頻72MHz選擇256分頻則SCK頻率約為281.25kHz。初次調(diào)試建議從低速開(kāi)始穩(wěn)定后再提高。W25Q64最高支持104MHz但我們先保守點(diǎn)。Data Size (數(shù)據(jù)大小)選擇8 bits。絕大多數(shù)SPI設(shè)備以8位為一個(gè)數(shù)據(jù)幀。First Bit (首位)選擇MSB First。這是最常用的格式即最高位先發(fā)送。Clock Polarity (CPOL)和Clock Phase (CPHA)這里必須查W25Q64的數(shù)據(jù)手冊(cè)手冊(cè)會(huì)寫(xiě)明其支持的模式。通常W25Q64支持Mode 0和Mode 3。我們選擇最常見(jiàn)的Low(CPOL0) 和1 Edge(CPHA0)即Mode 0。這意味著時(shí)鐘空閑為低在第一個(gè)邊沿上升沿采樣數(shù)據(jù)。NSS Signal Type (NSS信號(hào)類(lèi)型)選擇Software。這樣CubeMX就不會(huì)占用硬件NSS引腳PA4而是由我們通過(guò)GPIO控制。CRC Calculation禁用。除非你的通信協(xié)議要求CRC校驗(yàn)否則保持關(guān)閉。生成代碼配置好系統(tǒng)時(shí)鐘、工程名和IDEKeil或IAR等點(diǎn)擊Generate Code。3.2 HAL庫(kù)SPI驅(qū)動(dòng)函數(shù)詳解與封裝CubeMX生成的代碼為我們初始化好了SPI和GPIO。接下來(lái)我們編寫(xiě)應(yīng)用層驅(qū)動(dòng)。HAL庫(kù)提供了幾個(gè)核心的SPI傳輸函數(shù)阻塞式傳輸最簡(jiǎn)單HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);這些函數(shù)會(huì)一直等待直到傳輸完成或超時(shí)期間CPU被掛起。適合簡(jiǎn)單的、非實(shí)時(shí)的操作。例如發(fā)送一個(gè)命令uint8_t cmd 0x9F; // W25Q64的讀ID命令 HAL_SPI_Transmit(hspi1, cmd, 1, 100); // 發(fā)送1個(gè)字節(jié)超時(shí)100ms中斷式傳輸HAL_StatusTypeDef HAL_SPI_Transmit_IT(...); HAL_StatusTypeDef HAL_SPI_Receive_IT(...); HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(...);函數(shù)調(diào)用后立即返回傳輸完成后會(huì)產(chǎn)生中斷在中斷回調(diào)函數(shù)HAL_SPI_TxRxCpltCallback()中處理后續(xù)邏輯。適合需要并行處理其他任務(wù)的場(chǎng)景。DMA傳輸高效推薦用于大數(shù)據(jù)量HAL_StatusTypeDef HAL_SPI_Transmit_DMA(...); HAL_StatusTypeDef HAL_SPI_Receive_DMA(...); HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(...);利用DMA控制器在內(nèi)存和SPI數(shù)據(jù)寄存器之間搬運(yùn)數(shù)據(jù)完全不占用CPU時(shí)間。這是傳輸大量數(shù)據(jù)如讀寫(xiě)Flash、刷新屏幕的首選方式效率極高。封裝軟件片選和基礎(chǔ)讀寫(xiě)函數(shù) 為了讓代碼更清晰我們封裝幾個(gè)基礎(chǔ)函數(shù)// spi_flash.c #define W25Q64_CS_PIN GPIO_PIN_4 #define W25Q64_CS_PORT GPIOA static void CS_Low(void) { HAL_GPIO_WritePin(W25Q64_CS_PORT, W25Q64_CS_PIN, GPIO_PIN_RESET); } static void CS_High(void) { HAL_GPIO_WritePin(W25Q64_CS_PORT, W25Q64_CS_PIN, GPIO_PIN_SET); } // 單字節(jié)讀寫(xiě)全雙工同時(shí)收發(fā) uint8_t SPI_ReadWriteByte(uint8_t TxData) { uint8_t RxData; // 使用阻塞式傳輸同時(shí)發(fā)送和接收一個(gè)字節(jié) HAL_SPI_TransmitReceive(hspi1, TxData, RxData, 1, 100); return RxData; // 返回接收到的數(shù)據(jù) } // 發(fā)送一段數(shù)據(jù)只發(fā)不收 void SPI_WriteBuffer(uint8_t* pBuffer, uint16_t len) { HAL_SPI_Transmit(hspi1, pBuffer, len, 1000); } // 接收一段數(shù)據(jù)只收不發(fā)通常需要先發(fā)送啞元數(shù)據(jù)如0xFF void SPI_ReadBuffer(uint8_t* pBuffer, uint16_t len) { // 注意對(duì)于只接收HAL_SPI_Receive內(nèi)部會(huì)發(fā)送0xFF。確保從設(shè)備在MISO上有輸出。 HAL_SPI_Receive(hspi1, pBuffer, len, 1000); }3.3 W25Q64 Flash驅(qū)動(dòng)實(shí)現(xiàn)命令、讀ID與數(shù)據(jù)讀寫(xiě)有了基礎(chǔ)函數(shù)我們就可以實(shí)現(xiàn)W25Q64的具體驅(qū)動(dòng)了。SPI設(shè)備驅(qū)動(dòng)通常遵循“命令地址數(shù)據(jù)”的格式。1. 讀器件ID驗(yàn)證通信 這是驗(yàn)證SPI硬件連接和配置是否正確的最關(guān)鍵一步。uint32_t W25Q64_ReadID(void) { uint32_t ID 0; CS_Low(); SPI_ReadWriteByte(0x9F); // 發(fā)送讀ID命令 ID | (SPI_ReadWriteByte(0xFF) 16); // 讀制造商ID如0xEF (Winbond) ID | (SPI_ReadWriteByte(0xFF) 8); // 讀存儲(chǔ)器類(lèi)型如0x40 ID | SPI_ReadWriteByte(0xFF); // 讀容量ID如0x17 (64Mbit) CS_High(); return ID; // 期望結(jié)果可能是 0xEF4017 }如果讀回來(lái)的ID是0xFFFFFF或0x000000基本可以斷定SPI通信失敗需要檢查硬件連接、模式配置和片選信號(hào)。2. 讀取數(shù)據(jù)void W25Q64_ReadData(uint32_t addr, uint8_t* pBuffer, uint16_t len) { CS_Low(); SPI_ReadWriteByte(0x03); // 發(fā)送讀數(shù)據(jù)命令 SPI_ReadWriteByte((addr 16) 0xFF); // 發(fā)送24位地址的高8位 SPI_ReadWriteByte((addr 8) 0xFF); // 中8位 SPI_ReadWriteByte(addr 0xFF); // 低8位 // 連續(xù)讀取數(shù)據(jù) for(uint16_t i0; ilen; i) { pBuffer[i] SPI_ReadWriteByte(0xFF); // 發(fā)送啞元時(shí)鐘讀取數(shù)據(jù) } CS_High(); }3. 寫(xiě)入數(shù)據(jù)需要先擦除 Flash的寫(xiě)入必須先擦除變?yōu)?xFF然后才能編程將1變?yōu)?。W25Q64最小的擦除單位是扇區(qū)4KB。// 等待Flash空閑檢查BUSY位 void W25Q64_WaitBusy(void) { uint8_t status; do { CS_Low(); SPI_ReadWriteByte(0x05); // 讀狀態(tài)寄存器1命令 status SPI_ReadWriteByte(0xFF); CS_High(); } while(status 0x01); // 檢查BUSY位bit0 } // 寫(xiě)使能 void W25Q64_WriteEnable(void) { CS_Low(); SPI_ReadWriteByte(0x06); // 寫(xiě)使能命令 CS_High(); } // 擦除一個(gè)扇區(qū)4KB void W25Q64_EraseSector(uint32_t addr) { W25Q64_WriteEnable(); CS_Low(); SPI_ReadWriteByte(0x20); // 扇區(qū)擦除命令 SPI_ReadWriteByte((addr 16) 0xFF); SPI_ReadWriteByte((addr 8) 0xFF); SPI_ReadWriteByte(addr 0xFF); CS_High(); W25Q64_WaitBusy(); // 等待擦除完成 } // 頁(yè)編程最多256字節(jié) void W25Q64_PageProgram(uint32_t addr, uint8_t* pData, uint16_t len) { if(len 256) len 256; // 頁(yè)編程不能跨頁(yè) W25Q64_WriteEnable(); CS_Low(); SPI_ReadWriteByte(0x02); // 頁(yè)編程命令 SPI_ReadWriteByte((addr 16) 0xFF); SPI_ReadWriteByte((addr 8) 0xFF); SPI_ReadWriteByte(addr 0xFF); SPI_WriteBuffer(pData, len); // 發(fā)送數(shù)據(jù) CS_High(); W25Q64_WaitBusy(); }4. SPI實(shí)戰(zhàn)進(jìn)階DMA傳輸、多從設(shè)備管理與性能優(yōu)化4.1 使用DMA實(shí)現(xiàn)高速SPI數(shù)據(jù)傳輸當(dāng)需要讀寫(xiě)大量數(shù)據(jù)時(shí)例如從Flash讀取一幅圖片到LCD阻塞式傳輸會(huì)長(zhǎng)時(shí)間占用CPU中斷式傳輸也會(huì)產(chǎn)生大量中斷開(kāi)銷(xiāo)。此時(shí)DMA直接存儲(chǔ)器訪(fǎng)問(wèn)是唯一正確的選擇。它讓數(shù)據(jù)在內(nèi)存和外設(shè)之間自動(dòng)搬運(yùn)CPU只需發(fā)起和等待完成通知。CubeMX中配置SPI DMA在Connectivity-SPI1的DMA Settings標(biāo)簽頁(yè)中點(diǎn)擊Add。添加兩個(gè)DMA請(qǐng)求SPI1_TX方向Memory To Peripheral模式Normal單次傳輸或Circular循環(huán)傳輸用于連續(xù)流。SPI1_RX方向Peripheral To Memory模式Normal。生成代碼后HAL庫(kù)會(huì)自動(dòng)初始化DMA通道。使用DMA傳輸數(shù)據(jù)// 準(zhǔn)備發(fā)送和接收緩沖區(qū) uint8_t tx_buffer[1024]; uint8_t rx_buffer[1024]; // ... 填充tx_buffer ... // 啟動(dòng)DMA雙工傳輸 CS_Low(); if(HAL_SPI_TransmitReceive_DMA(hspi1, tx_buffer, rx_buffer, 1024) ! HAL_OK) { // 錯(cuò)誤處理 } // 此時(shí)CPU被釋放可以處理其他任務(wù) // 等待傳輸完成可以通過(guò)查詢(xún)標(biāo)志位、中斷或信號(hào)量 while(HAL_SPI_GetState(hspi1) ! HAL_SPI_STATE_READY) { // 或者使用 osDelay(1) 如果用了RTOS } CS_High(); // 此時(shí) rx_buffer 中已填充了接收到的數(shù)據(jù)DMA使用心得緩沖區(qū)對(duì)齊確保DMA操作的緩沖區(qū)在內(nèi)存中對(duì)齊通常是4字節(jié)可以提升性能并避免某些芯片的硬件問(wèn)題。可以使用__attribute__((aligned(4)))修飾。傳輸完成回調(diào)在HAL_SPI_TxRxCpltCallback()回調(diào)函數(shù)中處理完成事件并釋放信號(hào)量或設(shè)置標(biāo)志位是RTOS應(yīng)用中的標(biāo)準(zhǔn)做法。DMA與CPU緩存在帶有Cache的MCU如STM32H7上如果DMA操作的內(nèi)存區(qū)域開(kāi)啟了緩存必須在DMA傳輸前執(zhí)行SCB_CleanDCache_by_Addr()發(fā)送前清理在傳輸后執(zhí)行SCB_InvalidateDCache_by_Addr()接收后失效以確保數(shù)據(jù)一致性。這是H7系列開(kāi)發(fā)的一個(gè)大坑。4.2 一主多從的SPI總線(xiàn)管理策略一個(gè)SPI主機(jī)通過(guò)軟件片選控制多個(gè)從設(shè)備是常見(jiàn)的設(shè)計(jì)。關(guān)鍵在于嚴(yán)格的時(shí)序管理和總線(xiàn)沖突避免。硬件連接SCK、MOSI、MISO是所有設(shè)備共享的。每個(gè)從設(shè)備獨(dú)占一個(gè)GPIO作為片選CS1, CS2, CS3...。軟件管理要點(diǎn)互斥訪(fǎng)問(wèn)在任何時(shí)刻只能有一個(gè)從設(shè)備的CS引腳被拉低。在發(fā)起對(duì)某個(gè)設(shè)備的通信序列前必須確保其他所有設(shè)備的CS都為高。總線(xiàn)狀態(tài)在切換從設(shè)備時(shí)要留意SCK的時(shí)鐘極性。有些設(shè)備在CS拉高后要求SCK處于空閑狀態(tài)根據(jù)CPOL。安全的做法是在拉高一個(gè)設(shè)備的CS后稍微延遲幾個(gè)微秒再拉低下一個(gè)設(shè)備的CS。上拉電阻對(duì)于MISO線(xiàn)如果總線(xiàn)上有多個(gè)從設(shè)備當(dāng)它們都不被選中時(shí)MISO輸出為高阻態(tài)會(huì)導(dǎo)致總線(xiàn)浮空。最好在MISO線(xiàn)上加一個(gè)上拉電阻如4.7kΩ到VCC確保空閑時(shí)為確定的高電平。代碼示例typedef enum { DEV_FLASH 0, DEV_SENSOR, DEV_LCD, // ... 其他設(shè)備 } SPI_Device_t; void SPI_SelectDevice(SPI_Device_t dev) { // 首先取消所有片選 HAL_GPIO_WritePin(CS_FLASH_GPIO_Port, CS_FLASH_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(CS_SENSOR_GPIO_Port, CS_SENSOR_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(CS_LCD_GPIO_Port, CS_LCD_Pin, GPIO_PIN_SET); // 短暫延時(shí)確保總線(xiàn)穩(wěn)定 DWT_Delay_us(5); // 選中目標(biāo)設(shè)備 switch(dev) { case DEV_FLASH: HAL_GPIO_WritePin(CS_FLASH_GPIO_Port, CS_FLASH_Pin, GPIO_PIN_RESET); break; case DEV_SENSOR: HAL_GPIO_WritePin(CS_SENSOR_GPIO_Port, CS_SENSOR_Pin, GPIO_PIN_RESET); break; case DEV_LCD: HAL_GPIO_WritePin(CS_LCD_GPIO_Port, CS_LCD_Pin, GPIO_PIN_RESET); break; } DWT_Delay_us(2); // 片選建立時(shí)間根據(jù)從設(shè)備要求調(diào)整 }4.3 SPI時(shí)鐘配置與信號(hào)完整性?xún)?yōu)化隨著通信速率提高比如到幾十MHz信號(hào)完整性問(wèn)題會(huì)凸顯出來(lái)導(dǎo)致通信錯(cuò)誤。時(shí)鐘分頻與最大速率不要盲目使用最高速率。計(jì)算實(shí)際SCK頻率SCK APBx_Clock / Prescaler。確保它不超過(guò)從設(shè)備標(biāo)稱(chēng)的最大SCK頻率并留有一定余量比如80%。GPIO速度設(shè)置在CubeMX的GPIO配置中將SCK、MOSI、MISO引腳的速度Speed設(shè)置為High或Very High。這會(huì)影響IO口的壓擺率高速率下必須設(shè)為高速模式否則波形會(huì)畸變。PCB布局與走線(xiàn)等長(zhǎng)走線(xiàn)對(duì)于高速SPI10MHz盡量讓SCK、MOSI、MISO、CS這幾根線(xiàn)走線(xiàn)長(zhǎng)度接近以減少信號(hào)偏移。遠(yuǎn)離干擾源遠(yuǎn)離電源、電機(jī)驅(qū)動(dòng)、晶振等噪聲源。加串行電阻在靠近STM32輸出端SCK MOSI串聯(lián)一個(gè)22-33歐姆的小電阻可以抑制過(guò)沖和振鈴改善信號(hào)質(zhì)量。使用示波器調(diào)試這是最直接的調(diào)試手段。測(cè)量SCK、MOSI、MISO波形檢查幅值是否達(dá)標(biāo)3.3V或5V。上升/下降沿是否陡峭有無(wú)明顯的圓角或振鈴。數(shù)據(jù)在正確的時(shí)鐘邊沿是否穩(wěn)定建立時(shí)間和保持時(shí)間。5. SPI調(diào)試實(shí)戰(zhàn)常見(jiàn)問(wèn)題排查與解決方案實(shí)錄即使按照手冊(cè)配置SPI通信也常常出問(wèn)題。下面是我在項(xiàng)目中遇到的一些典型問(wèn)題及排查思路希望能幫你快速定位。5.1 通信完全失敗讀回?cái)?shù)據(jù)全為0xFF或0x00這是最常遇到的問(wèn)題表現(xiàn)為發(fā)送任何命令讀回來(lái)的數(shù)據(jù)都是0xFF上拉狀態(tài)或0x00。排查清單硬件連接這是第一嫌疑。用萬(wàn)用表蜂鳴檔逐根線(xiàn)檢查SCK、MOSI、MISO、CS是否連通有無(wú)虛焊、短路。特別注意MOSI和MISI是否接反了這是新手經(jīng)典錯(cuò)誤。電源與地確保從設(shè)備供電正常且與STM32共地。GPIO模式確認(rèn)STM32的SPI引腳模式是否正確。SCK和MOSI應(yīng)配置為Alternate Function Push-Pull復(fù)用推挽輸出MISO應(yīng)配置為Input或Alternate Function復(fù)用功能但方向是輸入。CS引腳如果軟件控制必須是Output Push-Pull。SPI模式CPOL/CPHA99%的通信失敗源于此再次、反復(fù)、確認(rèn)從設(shè)備數(shù)據(jù)手冊(cè)要求的SPI模式與CubeMX中的設(shè)置一字不差地匹配。嘗試四種模式逐一測(cè)試。片選信號(hào)用示波器或邏輯分析儀看CS引腳。通信序列開(kāi)始時(shí)CS是否被拉低序列結(jié)束后是否被拉高拉低和拉高的時(shí)機(jī)是否正確有些設(shè)備要求CS在兩次傳輸之間必須拉高至少幾個(gè)微秒。時(shí)鐘信號(hào)用示波器看SCK引腳。在CS拉低后發(fā)送數(shù)據(jù)時(shí)是否有時(shí)鐘波形頻率是否符合預(yù)期如果根本沒(méi)波形檢查SPI外設(shè)是否使能__HAL_SPI_ENABLE(hspi1)或者是否被其他代碼禁用了。5.2 數(shù)據(jù)錯(cuò)位或字節(jié)錯(cuò)亂表現(xiàn)為能收到數(shù)據(jù)但數(shù)據(jù)內(nèi)容不對(duì)比如命令響應(yīng)錯(cuò)位或者多出/少了幾個(gè)字節(jié)。排查清單數(shù)據(jù)位序MSB/LSB檢查CubeMX中First Bit設(shè)置。絕大多數(shù)設(shè)備是MSB First但極少數(shù)可能是LSB First。數(shù)據(jù)幀大小確認(rèn)是8 bit還是16 bit。W25Q64是8位但有些音頻編解碼器可能是16位。時(shí)鐘相位CPHA如果CPHA設(shè)置錯(cuò)誤可能會(huì)導(dǎo)致采樣點(diǎn)落在數(shù)據(jù)變化的邊緣造成數(shù)據(jù)不穩(wěn)定。在示波器上同時(shí)觀察SCK和MOSI看數(shù)據(jù)是否在正確的時(shí)鐘邊沿保持穩(wěn)定。軟件時(shí)序在發(fā)送命令、地址、數(shù)據(jù)的字節(jié)之間是否留有足夠的時(shí)間有些低速設(shè)備需要微秒級(jí)的延時(shí)。可以在SPI_ReadWriteByte函數(shù)調(diào)用之間加入DWT_Delay_us(1)試試。緩沖區(qū)溢出在使用DMA或中斷時(shí)如果數(shù)據(jù)處理太慢而下一幀數(shù)據(jù)已經(jīng)到來(lái)會(huì)導(dǎo)致數(shù)據(jù)被覆蓋。檢查DMA/中斷的完成處理是否及時(shí)緩沖區(qū)是否夠大。5.3 DMA傳輸不穩(wěn)定或卡死DMA配置相對(duì)復(fù)雜容易出問(wèn)題。排查清單DMA通道沖突確保SPI的TX和RX DMA請(qǐng)求分配到了不同的DMA流Stream和通道Channel或者同一流但優(yōu)先級(jí)不同避免沖突。內(nèi)存對(duì)齊如前所述DMA緩沖區(qū)地址對(duì)齊問(wèn)題。使用malloc分配的動(dòng)態(tài)內(nèi)存可能未對(duì)齊建議使用靜態(tài)數(shù)組或?qū)R分配。Cache一致性問(wèn)題Cortex-M7等這是最高頻的坑如果你的CPU有Cache而DMA操作的內(nèi)存區(qū)域開(kāi)啟了Cache必須手動(dòng)維護(hù)一致性。發(fā)送前Clean接收后Invalidate。傳輸完成判斷不要單純依賴(lài)HAL_SPI_GetState它可能返回BUSY狀態(tài)。結(jié)合使用DMA傳輸完成回調(diào)函數(shù)和自定義的標(biāo)志位更為可靠。超時(shí)設(shè)置雖然DMA不依賴(lài)超時(shí)但HAL庫(kù)的DMA傳輸啟動(dòng)函數(shù)可能有超時(shí)參數(shù)。如果設(shè)置過(guò)短可能在DMA還沒(méi)真正完成時(shí)就返回超時(shí)錯(cuò)誤。可以適當(dāng)加長(zhǎng)或使用中斷回調(diào)。5.4 多從設(shè)備相互干擾當(dāng)一個(gè)設(shè)備工作時(shí)另一個(gè)設(shè)備的數(shù)據(jù)異常。排查清單片選隔離確保你的SPI_SelectDevice函數(shù)在選中新設(shè)備前確實(shí)拉高了所有其他設(shè)備的片選。用邏輯分析儀同時(shí)抓取多個(gè)CS信號(hào)驗(yàn)證。從設(shè)備輸出使能有些從設(shè)備在CS為高時(shí)其MISO引腳不是高阻態(tài)而是仍然有輸出可能是低電平。這會(huì)與當(dāng)前選中設(shè)備在MISO線(xiàn)上的輸出沖突。檢查從設(shè)備手冊(cè)必要時(shí)在硬件上為每個(gè)從設(shè)備的MISO線(xiàn)加上隔離緩沖器如74HC125。總線(xiàn)負(fù)載掛載的設(shè)備太多可能導(dǎo)致總線(xiàn)電容過(guò)大信號(hào)上升沿變緩在高速下出錯(cuò)。減少設(shè)備數(shù)量或降低通信速率或在總線(xiàn)上串聯(lián)小電阻。調(diào)試SPI邏輯分析儀是比示波器更高效的利器。它能同時(shí)解碼多路信號(hào)直接顯示出十六進(jìn)制的數(shù)據(jù)字節(jié)讓你一眼就能看出命令、地址、數(shù)據(jù)是否正確極大提升調(diào)試效率。 STM32 SPI通信協(xié)議詳解：從原理到實(shí)戰(zhàn)驅(qū)動(dòng)W25Q64 Flash
1. 項(xiàng)目概述從“點(diǎn)燈”到“對(duì)話(huà)”為什么SPI是嵌入式開(kāi)發(fā)的必修課玩過(guò)STM32的朋友從點(diǎn)燈到串口打印算是邁入了嵌入式世界的大門(mén)。但當(dāng)你開(kāi)始驅(qū)動(dòng)一塊TFT屏幕、讀寫(xiě)一個(gè)SD卡或者連接一個(gè)高精度的傳感器時(shí)會(huì)發(fā)現(xiàn)GPIO和UART有點(diǎn)力不從心了。這時(shí)候一個(gè)名字就會(huì)高頻出現(xiàn)SPI。我剛開(kāi)始接觸SPI時(shí)覺(jué)得它比I2C復(fù)雜比UART“事兒多”但真正用熟了才發(fā)現(xiàn)它是連接外部高速器件的“高速公路”是項(xiàng)目從玩具級(jí)邁向產(chǎn)品級(jí)的關(guān)鍵一步。SPI全稱(chēng)Serial Peripheral Interface中文叫串行外設(shè)接口是ST、NXP、TI這些芯片大廠(chǎng)在自家MCU里普遍集成的一種高速、全雙工、同步的通信總線(xiàn)。簡(jiǎn)單說(shuō)它就像一條多車(chē)道的馬路主設(shè)備通常是你的STM32可以同時(shí)向從設(shè)備發(fā)送和接收數(shù)據(jù)而且大家踩著同一個(gè)時(shí)鐘節(jié)拍走效率非常高。這個(gè)筆記我們就來(lái)徹底拆解STM32的SPI外設(shè)。它適合誰(shuí)呢如果你已經(jīng)會(huì)用STM32的HAL庫(kù)點(diǎn)燈、調(diào)串口想驅(qū)動(dòng)SPI Flash如W25Q64、OLED屏SSD1306、或者像MPU6050這樣的傳感器那這篇內(nèi)容就是為你準(zhǔn)備的。我會(huì)避開(kāi)枯燥的協(xié)議手冊(cè)翻譯直接從一個(gè)實(shí)際開(kāi)發(fā)者的角度帶你理解SPI在STM32里怎么配置、怎么用以及那些手冊(cè)里不提但實(shí)際項(xiàng)目里一定會(huì)踩的坑。我們的目標(biāo)很明確看完之后你能獨(dú)立搞定一個(gè)SPI設(shè)備的驅(qū)動(dòng)并且明白每一個(gè)配置項(xiàng)背后的“為什么”。2. SPI通信核心原理與STM32的實(shí)現(xiàn)方式2.1 SPI協(xié)議的精髓四線(xiàn)制與主從時(shí)鐘同步要駕馭STM32的SPI外設(shè)死記寄存器不如先吃透協(xié)議本身。SPI協(xié)議的核心思想其實(shí)非常直觀它用四根線(xiàn)解決所有問(wèn)題SCK (Serial Clock)時(shí)鐘線(xiàn)由主設(shè)備產(chǎn)生。這是總線(xiàn)的“指揮棒”所有數(shù)據(jù)位的傳輸都嚴(yán)格跟隨它的上升沿或下降沿。這是SPI“同步”二字的來(lái)源也是其高速穩(wěn)定的基礎(chǔ)。MOSI (Master Output Slave Input)主設(shè)備輸出從設(shè)備輸入線(xiàn)。主設(shè)備通過(guò)這根線(xiàn)發(fā)送數(shù)據(jù)給從設(shè)備。MISO (Master Input Slave Output)主設(shè)備輸入從設(shè)備輸出線(xiàn)。主設(shè)備通過(guò)這根線(xiàn)接收從設(shè)備的數(shù)據(jù)。NSS (Slave Select)從設(shè)備選擇線(xiàn)通常也叫做CSChip Select或SS。這是主設(shè)備用來(lái)“點(diǎn)名”哪個(gè)從設(shè)備來(lái)跟自己通信的。當(dāng)NSS線(xiàn)被拉低有效對(duì)應(yīng)的從設(shè)備被激活開(kāi)始監(jiān)聽(tīng)時(shí)鐘和數(shù)據(jù)線(xiàn)當(dāng)被拉高從設(shè)備進(jìn)入“休眠”狀態(tài)忽略總線(xiàn)。這是一個(gè)硬件上的片選機(jī)制。這里有一個(gè)關(guān)鍵點(diǎn)MOSI和MISO是獨(dú)立的這意味著數(shù)據(jù)可以同時(shí)雙向流動(dòng)這就是“全雙工”。想象一下打電話(huà)SPI就像視頻通話(huà)雙方能同時(shí)說(shuō)和聽(tīng)而像I2C或單線(xiàn)UART則更像對(duì)講機(jī)同一時(shí)間只能一方說(shuō)。SPI的通信模式由兩個(gè)關(guān)鍵參數(shù)決定時(shí)鐘極性CPOL和時(shí)鐘相位CPHA。它們組合成了四種模式Mode 0, 1, 2, 3。很多新手在這里會(huì)懵我用一個(gè)生活化的比喻來(lái)解釋CPOL (Clock Polarity)時(shí)鐘空閑時(shí)的狀態(tài)。CPOL0表示SCK在空閑時(shí)為低電平CPOL1則為高電平。你可以把它想象成指揮棒的“預(yù)備姿勢(shì)”是放下低還是舉起高。CPHA (Clock Phase)數(shù)據(jù)采樣的時(shí)刻。CPHA0表示在時(shí)鐘的第一個(gè)邊沿如果CPOL0就是上升沿CPOL1就是下降沿采樣數(shù)據(jù)CPHA1則表示在時(shí)鐘的第二個(gè)邊沿采樣。這相當(dāng)于指揮棒揮動(dòng)一下有兩個(gè)動(dòng)作起和落你選擇在“起”的時(shí)候抓取數(shù)據(jù)還是在“落”的時(shí)候抓取。重要提示SPI模式必須主從設(shè)備嚴(yán)格匹配這是通信失敗的頭號(hào)殺手。你用的傳感器或Flash芯片的數(shù)據(jù)手冊(cè)里一定會(huì)明確寫(xiě)明它支持哪種SPI模式。STM32的配置必須與之完全一致差一點(diǎn)都不行。通常Mode 0和Mode 3最為常見(jiàn)。2.2 STM32 SPI外設(shè)的架構(gòu)與工作模式STM32的SPI外設(shè)是一個(gè)高度集成化的硬件模塊它把上述協(xié)議邏輯用硬件實(shí)現(xiàn)大大減輕了CPU的負(fù)擔(dān)。其核心架構(gòu)包括移位寄存器負(fù)責(zé)數(shù)據(jù)的并串轉(zhuǎn)換發(fā)送時(shí)和串并轉(zhuǎn)換接收時(shí)。當(dāng)你寫(xiě)入數(shù)據(jù)到發(fā)送數(shù)據(jù)寄存器DR時(shí)硬件會(huì)自動(dòng)將其移出到MOSI線(xiàn)同時(shí)MISO線(xiàn)上的數(shù)據(jù)也會(huì)被移入接收數(shù)據(jù)寄存器。波特率發(fā)生器由APB總線(xiàn)時(shí)鐘分頻得到SCK時(shí)鐘。分頻系數(shù)可以配置如2, 4, 8, 16, 32...256等這決定了通信速率。STM32F1系列的SPI最高可達(dá)18MbpsF4系列可達(dá)37.5MbpsH7系列更是能到上百M(fèi)bps。控制邏輯負(fù)責(zé)生成SCK、管理NSS信號(hào)、控制數(shù)據(jù)幀格式數(shù)據(jù)位寬通常是8位或16位、以及決定MSB最高位還是LSB最低位先傳輸。STM32的SPI主要有三種工作模式你需要根據(jù)應(yīng)用場(chǎng)景選擇全雙工主模式最常用STM32作為主機(jī)主動(dòng)產(chǎn)生SCK并通過(guò)MOSI發(fā)送數(shù)據(jù)同時(shí)通過(guò)MISO接收數(shù)據(jù)。這是驅(qū)動(dòng)絕大多數(shù)SPI從設(shè)備如Flash、ADC的標(biāo)準(zhǔn)模式。全雙工從模式STM32作為從機(jī)等待外部主機(jī)提供的SCK并根據(jù)時(shí)鐘在MISO上輸出數(shù)據(jù)從MOSI上輸入數(shù)據(jù)。這常用于STM32作為協(xié)處理器與另一個(gè)更強(qiáng)大的主MCU通信。半雙工單線(xiàn)雙向模式可以配置為只使用一根數(shù)據(jù)線(xiàn)要么當(dāng)MOSI用要么當(dāng)MISO用進(jìn)行單向或分時(shí)雙向通信。這可以節(jié)省一個(gè)GPIO引腳但速率和靈活性下降。有些特殊的ADC芯片會(huì)用到這種模式。NSS引腳管理的坑點(diǎn)STM32的NSS引腳管理有“硬件模式”和“軟件模式”之分。硬件模式NSSHardwareNSS引腳由硬件自動(dòng)管理。在主模式下你需要將該引腳配置為復(fù)用推挽輸出STM32會(huì)在通信開(kāi)始時(shí)自動(dòng)將其拉低結(jié)束時(shí)拉高。在從模式下該引腳必須配置為浮空輸入等待外部主機(jī)拉低。硬件模式的缺點(diǎn)是一個(gè)SPI外設(shè)只能控制一個(gè)從設(shè)備。軟件模式NSSSoftware這是更常用、更靈活的方式。你將NSS引腳配置為普通的GPIO輸出比如PA4然后在代碼里手動(dòng)控制它的高低電平。在發(fā)起傳輸前手動(dòng)拉低對(duì)應(yīng)的CS引腳傳輸完成后再手動(dòng)拉高。這樣你可以用同一個(gè)SPI外設(shè)同一組SCK、MOSI、MISO通過(guò)不同的GPIO片選控制多個(gè)從設(shè)備實(shí)現(xiàn)“一主多從”。3. 使用STM32CubeMX與HAL庫(kù)配置SPI的完整流程理論懂了我們上手實(shí)操。我會(huì)以驅(qū)動(dòng)一塊常見(jiàn)的SPI Flash芯片W25Q64為例使用STM32CubeMX圖形化工具和HAL庫(kù)展示從零到一的配置過(guò)程。選擇W25Q64是因?yàn)樗鼌f(xié)議標(biāo)準(zhǔn)應(yīng)用廣泛且包含了SPI通信的典型操作寫(xiě)使能、讀ID、讀數(shù)據(jù)、寫(xiě)數(shù)據(jù)、擦除扇區(qū)。3.1 CubeMX工程初始化與SPI參數(shù)配置首先打開(kāi)STM32CubeMX選擇你的芯片型號(hào)例如STM32F103C8T6。啟用SPI外設(shè)在Pinout Configuration標(biāo)簽頁(yè)的左側(cè)找到Connectivity-SPI1。將Mode設(shè)置為Full-Duplex Master全雙工主機(jī)。這時(shí)對(duì)應(yīng)的引腳PA5/SCK, PA6/MISO, PA7/MOSI會(huì)被自動(dòng)分配。配置GPIO for NSS我們不使用硬件NSS。在左側(cè)System Core-GPIO中找一個(gè)空閑的GPIO例如PA4作為軟件片選。將其模式設(shè)置為GPIO_Output初始輸出電平設(shè)為High默認(rèn)不選中從設(shè)備。精調(diào)SPI參數(shù)點(diǎn)擊SPI1進(jìn)入?yún)?shù)設(shè)置。Basic Parameters:Prescaler (波特率預(yù)分頻)根據(jù)你的主頻和從設(shè)備支持的速度計(jì)算。例如主頻72MHz選擇256分頻則SCK頻率約為281.25kHz。初次調(diào)試建議從低速開(kāi)始穩(wěn)定后再提高。W25Q64最高支持104MHz但我們先保守點(diǎn)。Data Size (數(shù)據(jù)大小)選擇8 bits。絕大多數(shù)SPI設(shè)備以8位為一個(gè)數(shù)據(jù)幀。First Bit (首位)選擇MSB First。這是最常用的格式即最高位先發(fā)送。Clock Polarity (CPOL)和Clock Phase (CPHA)這里必須查W25Q64的數(shù)據(jù)手冊(cè)手冊(cè)會(huì)寫(xiě)明其支持的模式。通常W25Q64支持Mode 0和Mode 3。我們選擇最常見(jiàn)的Low(CPOL0) 和1 Edge(CPHA0)即Mode 0。這意味著時(shí)鐘空閑為低在第一個(gè)邊沿上升沿采樣數(shù)據(jù)。NSS Signal Type (NSS信號(hào)類(lèi)型)選擇Software。這樣CubeMX就不會(huì)占用硬件NSS引腳PA4而是由我們通過(guò)GPIO控制。CRC Calculation禁用。除非你的通信協(xié)議要求CRC校驗(yàn)否則保持關(guān)閉。生成代碼配置好系統(tǒng)時(shí)鐘、工程名和IDEKeil或IAR等點(diǎn)擊Generate Code。3.2 HAL庫(kù)SPI驅(qū)動(dòng)函數(shù)詳解與封裝CubeMX生成的代碼為我們初始化好了SPI和GPIO。接下來(lái)我們編寫(xiě)應(yīng)用層驅(qū)動(dòng)。HAL庫(kù)提供了幾個(gè)核心的SPI傳輸函數(shù)阻塞式傳輸最簡(jiǎn)單HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout);這些函數(shù)會(huì)一直等待直到傳輸完成或超時(shí)期間CPU被掛起。適合簡(jiǎn)單的、非實(shí)時(shí)的操作。例如發(fā)送一個(gè)命令uint8_t cmd 0x9F; // W25Q64的讀ID命令 HAL_SPI_Transmit(hspi1, cmd, 1, 100); // 發(fā)送1個(gè)字節(jié)超時(shí)100ms中斷式傳輸HAL_StatusTypeDef HAL_SPI_Transmit_IT(...); HAL_StatusTypeDef HAL_SPI_Receive_IT(...); HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(...);函數(shù)調(diào)用后立即返回傳輸完成后會(huì)產(chǎn)生中斷在中斷回調(diào)函數(shù)HAL_SPI_TxRxCpltCallback()中處理后續(xù)邏輯。適合需要并行處理其他任務(wù)的場(chǎng)景。DMA傳輸高效推薦用于大數(shù)據(jù)量HAL_StatusTypeDef HAL_SPI_Transmit_DMA(...); HAL_StatusTypeDef HAL_SPI_Receive_DMA(...); HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(...);利用DMA控制器在內(nèi)存和SPI數(shù)據(jù)寄存器之間搬運(yùn)數(shù)據(jù)完全不占用CPU時(shí)間。這是傳輸大量數(shù)據(jù)如讀寫(xiě)Flash、刷新屏幕的首選方式效率極高。封裝軟件片選和基礎(chǔ)讀寫(xiě)函數(shù) 為了讓代碼更清晰我們封裝幾個(gè)基礎(chǔ)函數(shù)// spi_flash.c #define W25Q64_CS_PIN GPIO_PIN_4 #define W25Q64_CS_PORT GPIOA static void CS_Low(void) { HAL_GPIO_WritePin(W25Q64_CS_PORT, W25Q64_CS_PIN, GPIO_PIN_RESET); } static void CS_High(void) { HAL_GPIO_WritePin(W25Q64_CS_PORT, W25Q64_CS_PIN, GPIO_PIN_SET); } // 單字節(jié)讀寫(xiě)全雙工同時(shí)收發(fā) uint8_t SPI_ReadWriteByte(uint8_t TxData) { uint8_t RxData; // 使用阻塞式傳輸同時(shí)發(fā)送和接收一個(gè)字節(jié) HAL_SPI_TransmitReceive(hspi1, TxData, RxData, 1, 100); return RxData; // 返回接收到的數(shù)據(jù) } // 發(fā)送一段數(shù)據(jù)只發(fā)不收 void SPI_WriteBuffer(uint8_t* pBuffer, uint16_t len) { HAL_SPI_Transmit(hspi1, pBuffer, len, 1000); } // 接收一段數(shù)據(jù)只收不發(fā)通常需要先發(fā)送啞元數(shù)據(jù)如0xFF void SPI_ReadBuffer(uint8_t* pBuffer, uint16_t len) { // 注意對(duì)于只接收HAL_SPI_Receive內(nèi)部會(huì)發(fā)送0xFF。確保從設(shè)備在MISO上有輸出。 HAL_SPI_Receive(hspi1, pBuffer, len, 1000); }3.3 W25Q64 Flash驅(qū)動(dòng)實(shí)現(xiàn)命令、讀ID與數(shù)據(jù)讀寫(xiě)有了基礎(chǔ)函數(shù)我們就可以實(shí)現(xiàn)W25Q64的具體驅(qū)動(dòng)了。SPI設(shè)備驅(qū)動(dòng)通常遵循“命令地址數(shù)據(jù)”的格式。1. 讀器件ID驗(yàn)證通信 這是驗(yàn)證SPI硬件連接和配置是否正確的最關(guān)鍵一步。uint32_t W25Q64_ReadID(void) { uint32_t ID 0; CS_Low(); SPI_ReadWriteByte(0x9F); // 發(fā)送讀ID命令 ID | (SPI_ReadWriteByte(0xFF) 16); // 讀制造商ID如0xEF (Winbond) ID | (SPI_ReadWriteByte(0xFF) 8); // 讀存儲(chǔ)器類(lèi)型如0x40 ID | SPI_ReadWriteByte(0xFF); // 讀容量ID如0x17 (64Mbit) CS_High(); return ID; // 期望結(jié)果可能是 0xEF4017 }如果讀回來(lái)的ID是0xFFFFFF或0x000000基本可以斷定SPI通信失敗需要檢查硬件連接、模式配置和片選信號(hào)。2. 讀取數(shù)據(jù)void W25Q64_ReadData(uint32_t addr, uint8_t* pBuffer, uint16_t len) { CS_Low(); SPI_ReadWriteByte(0x03); // 發(fā)送讀數(shù)據(jù)命令 SPI_ReadWriteByte((addr 16) 0xFF); // 發(fā)送24位地址的高8位 SPI_ReadWriteByte((addr 8) 0xFF); // 中8位 SPI_ReadWriteByte(addr 0xFF); // 低8位 // 連續(xù)讀取數(shù)據(jù) for(uint16_t i0; ilen; i) { pBuffer[i] SPI_ReadWriteByte(0xFF); // 發(fā)送啞元時(shí)鐘讀取數(shù)據(jù) } CS_High(); }3. 寫(xiě)入數(shù)據(jù)需要先擦除 Flash的寫(xiě)入必須先擦除變?yōu)?xFF然后才能編程將1變?yōu)?。W25Q64最小的擦除單位是扇區(qū)4KB。// 等待Flash空閑檢查BUSY位 void W25Q64_WaitBusy(void) { uint8_t status; do { CS_Low(); SPI_ReadWriteByte(0x05); // 讀狀態(tài)寄存器1命令 status SPI_ReadWriteByte(0xFF); CS_High(); } while(status 0x01); // 檢查BUSY位bit0 } // 寫(xiě)使能 void W25Q64_WriteEnable(void) { CS_Low(); SPI_ReadWriteByte(0x06); // 寫(xiě)使能命令 CS_High(); } // 擦除一個(gè)扇區(qū)4KB void W25Q64_EraseSector(uint32_t addr) { W25Q64_WriteEnable(); CS_Low(); SPI_ReadWriteByte(0x20); // 扇區(qū)擦除命令 SPI_ReadWriteByte((addr 16) 0xFF); SPI_ReadWriteByte((addr 8) 0xFF); SPI_ReadWriteByte(addr 0xFF); CS_High(); W25Q64_WaitBusy(); // 等待擦除完成 } // 頁(yè)編程最多256字節(jié) void W25Q64_PageProgram(uint32_t addr, uint8_t* pData, uint16_t len) { if(len 256) len 256; // 頁(yè)編程不能跨頁(yè) W25Q64_WriteEnable(); CS_Low(); SPI_ReadWriteByte(0x02); // 頁(yè)編程命令 SPI_ReadWriteByte((addr 16) 0xFF); SPI_ReadWriteByte((addr 8) 0xFF); SPI_ReadWriteByte(addr 0xFF); SPI_WriteBuffer(pData, len); // 發(fā)送數(shù)據(jù) CS_High(); W25Q64_WaitBusy(); }4. SPI實(shí)戰(zhàn)進(jìn)階DMA傳輸、多從設(shè)備管理與性能優(yōu)化4.1 使用DMA實(shí)現(xiàn)高速SPI數(shù)據(jù)傳輸當(dāng)需要讀寫(xiě)大量數(shù)據(jù)時(shí)例如從Flash讀取一幅圖片到LCD阻塞式傳輸會(huì)長(zhǎng)時(shí)間占用CPU中斷式傳輸也會(huì)產(chǎn)生大量中斷開(kāi)銷(xiāo)。此時(shí)DMA直接存儲(chǔ)器訪(fǎng)問(wèn)是唯一正確的選擇。它讓數(shù)據(jù)在內(nèi)存和外設(shè)之間自動(dòng)搬運(yùn)CPU只需發(fā)起和等待完成通知。CubeMX中配置SPI DMA在Connectivity-SPI1的DMA Settings標(biāo)簽頁(yè)中點(diǎn)擊Add。添加兩個(gè)DMA請(qǐng)求SPI1_TX方向Memory To Peripheral模式Normal單次傳輸或Circular循環(huán)傳輸用于連續(xù)流。SPI1_RX方向Peripheral To Memory模式Normal。生成代碼后HAL庫(kù)會(huì)自動(dòng)初始化DMA通道。使用DMA傳輸數(shù)據(jù)// 準(zhǔn)備發(fā)送和接收緩沖區(qū) uint8_t tx_buffer[1024]; uint8_t rx_buffer[1024]; // ... 填充tx_buffer ... // 啟動(dòng)DMA雙工傳輸 CS_Low(); if(HAL_SPI_TransmitReceive_DMA(hspi1, tx_buffer, rx_buffer, 1024) ! HAL_OK) { // 錯(cuò)誤處理 } // 此時(shí)CPU被釋放可以處理其他任務(wù) // 等待傳輸完成可以通過(guò)查詢(xún)標(biāo)志位、中斷或信號(hào)量 while(HAL_SPI_GetState(hspi1) ! HAL_SPI_STATE_READY) { // 或者使用 osDelay(1) 如果用了RTOS } CS_High(); // 此時(shí) rx_buffer 中已填充了接收到的數(shù)據(jù)DMA使用心得緩沖區(qū)對(duì)齊確保DMA操作的緩沖區(qū)在內(nèi)存中對(duì)齊通常是4字節(jié)可以提升性能并避免某些芯片的硬件問(wèn)題。可以使用__attribute__((aligned(4)))修飾。傳輸完成回調(diào)在HAL_SPI_TxRxCpltCallback()回調(diào)函數(shù)中處理完成事件并釋放信號(hào)量或設(shè)置標(biāo)志位是RTOS應(yīng)用中的標(biāo)準(zhǔn)做法。DMA與CPU緩存在帶有Cache的MCU如STM32H7上如果DMA操作的內(nèi)存區(qū)域開(kāi)啟了緩存必須在DMA傳輸前執(zhí)行SCB_CleanDCache_by_Addr()發(fā)送前清理在傳輸后執(zhí)行SCB_InvalidateDCache_by_Addr()接收后失效以確保數(shù)據(jù)一致性。這是H7系列開(kāi)發(fā)的一個(gè)大坑。4.2 一主多從的SPI總線(xiàn)管理策略一個(gè)SPI主機(jī)通過(guò)軟件片選控制多個(gè)從設(shè)備是常見(jiàn)的設(shè)計(jì)。關(guān)鍵在于嚴(yán)格的時(shí)序管理和總線(xiàn)沖突避免。硬件連接SCK、MOSI、MISO是所有設(shè)備共享的。每個(gè)從設(shè)備獨(dú)占一個(gè)GPIO作為片選CS1, CS2, CS3...。軟件管理要點(diǎn)互斥訪(fǎng)問(wèn)在任何時(shí)刻只能有一個(gè)從設(shè)備的CS引腳被拉低。在發(fā)起對(duì)某個(gè)設(shè)備的通信序列前必須確保其他所有設(shè)備的CS都為高。總線(xiàn)狀態(tài)在切換從設(shè)備時(shí)要留意SCK的時(shí)鐘極性。有些設(shè)備在CS拉高后要求SCK處于空閑狀態(tài)根據(jù)CPOL。安全的做法是在拉高一個(gè)設(shè)備的CS后稍微延遲幾個(gè)微秒再拉低下一個(gè)設(shè)備的CS。上拉電阻對(duì)于MISO線(xiàn)如果總線(xiàn)上有多個(gè)從設(shè)備當(dāng)它們都不被選中時(shí)MISO輸出為高阻態(tài)會(huì)導(dǎo)致總線(xiàn)浮空。最好在MISO線(xiàn)上加一個(gè)上拉電阻如4.7kΩ到VCC確保空閑時(shí)為確定的高電平。代碼示例typedef enum { DEV_FLASH 0, DEV_SENSOR, DEV_LCD, // ... 其他設(shè)備 } SPI_Device_t; void SPI_SelectDevice(SPI_Device_t dev) { // 首先取消所有片選 HAL_GPIO_WritePin(CS_FLASH_GPIO_Port, CS_FLASH_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(CS_SENSOR_GPIO_Port, CS_SENSOR_Pin, GPIO_PIN_SET); HAL_GPIO_WritePin(CS_LCD_GPIO_Port, CS_LCD_Pin, GPIO_PIN_SET); // 短暫延時(shí)確保總線(xiàn)穩(wěn)定 DWT_Delay_us(5); // 選中目標(biāo)設(shè)備 switch(dev) { case DEV_FLASH: HAL_GPIO_WritePin(CS_FLASH_GPIO_Port, CS_FLASH_Pin, GPIO_PIN_RESET); break; case DEV_SENSOR: HAL_GPIO_WritePin(CS_SENSOR_GPIO_Port, CS_SENSOR_Pin, GPIO_PIN_RESET); break; case DEV_LCD: HAL_GPIO_WritePin(CS_LCD_GPIO_Port, CS_LCD_Pin, GPIO_PIN_RESET); break; } DWT_Delay_us(2); // 片選建立時(shí)間根據(jù)從設(shè)備要求調(diào)整 }4.3 SPI時(shí)鐘配置與信號(hào)完整性?xún)?yōu)化隨著通信速率提高比如到幾十MHz信號(hào)完整性問(wèn)題會(huì)凸顯出來(lái)導(dǎo)致通信錯(cuò)誤。時(shí)鐘分頻與最大速率不要盲目使用最高速率。計(jì)算實(shí)際SCK頻率SCK APBx_Clock / Prescaler。確保它不超過(guò)從設(shè)備標(biāo)稱(chēng)的最大SCK頻率并留有一定余量比如80%。GPIO速度設(shè)置在CubeMX的GPIO配置中將SCK、MOSI、MISO引腳的速度Speed設(shè)置為High或Very High。這會(huì)影響IO口的壓擺率高速率下必須設(shè)為高速模式否則波形會(huì)畸變。PCB布局與走線(xiàn)等長(zhǎng)走線(xiàn)對(duì)于高速SPI10MHz盡量讓SCK、MOSI、MISO、CS這幾根線(xiàn)走線(xiàn)長(zhǎng)度接近以減少信號(hào)偏移。遠(yuǎn)離干擾源遠(yuǎn)離電源、電機(jī)驅(qū)動(dòng)、晶振等噪聲源。加串行電阻在靠近STM32輸出端SCK MOSI串聯(lián)一個(gè)22-33歐姆的小電阻可以抑制過(guò)沖和振鈴改善信號(hào)質(zhì)量。使用示波器調(diào)試這是最直接的調(diào)試手段。測(cè)量SCK、MOSI、MISO波形檢查幅值是否達(dá)標(biāo)3.3V或5V。上升/下降沿是否陡峭有無(wú)明顯的圓角或振鈴。數(shù)據(jù)在正確的時(shí)鐘邊沿是否穩(wěn)定建立時(shí)間和保持時(shí)間。5. SPI調(diào)試實(shí)戰(zhàn)常見(jiàn)問(wèn)題排查與解決方案實(shí)錄即使按照手冊(cè)配置SPI通信也常常出問(wèn)題。下面是我在項(xiàng)目中遇到的一些典型問(wèn)題及排查思路希望能幫你快速定位。5.1 通信完全失敗讀回?cái)?shù)據(jù)全為0xFF或0x00這是最常遇到的問(wèn)題表現(xiàn)為發(fā)送任何命令讀回來(lái)的數(shù)據(jù)都是0xFF上拉狀態(tài)或0x00。排查清單硬件連接這是第一嫌疑。用萬(wàn)用表蜂鳴檔逐根線(xiàn)檢查SCK、MOSI、MISO、CS是否連通有無(wú)虛焊、短路。特別注意MOSI和MISI是否接反了這是新手經(jīng)典錯(cuò)誤。電源與地確保從設(shè)備供電正常且與STM32共地。GPIO模式確認(rèn)STM32的SPI引腳模式是否正確。SCK和MOSI應(yīng)配置為Alternate Function Push-Pull復(fù)用推挽輸出MISO應(yīng)配置為Input或Alternate Function復(fù)用功能但方向是輸入。CS引腳如果軟件控制必須是Output Push-Pull。SPI模式CPOL/CPHA99%的通信失敗源于此再次、反復(fù)、確認(rèn)從設(shè)備數(shù)據(jù)手冊(cè)要求的SPI模式與CubeMX中的設(shè)置一字不差地匹配。嘗試四種模式逐一測(cè)試。片選信號(hào)用示波器或邏輯分析儀看CS引腳。通信序列開(kāi)始時(shí)CS是否被拉低序列結(jié)束后是否被拉高拉低和拉高的時(shí)機(jī)是否正確有些設(shè)備要求CS在兩次傳輸之間必須拉高至少幾個(gè)微秒。時(shí)鐘信號(hào)用示波器看SCK引腳。在CS拉低后發(fā)送數(shù)據(jù)時(shí)是否有時(shí)鐘波形頻率是否符合預(yù)期如果根本沒(méi)波形檢查SPI外設(shè)是否使能__HAL_SPI_ENABLE(hspi1)或者是否被其他代碼禁用了。5.2 數(shù)據(jù)錯(cuò)位或字節(jié)錯(cuò)亂表現(xiàn)為能收到數(shù)據(jù)但數(shù)據(jù)內(nèi)容不對(duì)比如命令響應(yīng)錯(cuò)位或者多出/少了幾個(gè)字節(jié)。排查清單數(shù)據(jù)位序MSB/LSB檢查CubeMX中First Bit設(shè)置。絕大多數(shù)設(shè)備是MSB First但極少數(shù)可能是LSB First。數(shù)據(jù)幀大小確認(rèn)是8 bit還是16 bit。W25Q64是8位但有些音頻編解碼器可能是16位。時(shí)鐘相位CPHA如果CPHA設(shè)置錯(cuò)誤可能會(huì)導(dǎo)致采樣點(diǎn)落在數(shù)據(jù)變化的邊緣造成數(shù)據(jù)不穩(wěn)定。在示波器上同時(shí)觀察SCK和MOSI看數(shù)據(jù)是否在正確的時(shí)鐘邊沿保持穩(wěn)定。軟件時(shí)序在發(fā)送命令、地址、數(shù)據(jù)的字節(jié)之間是否留有足夠的時(shí)間有些低速設(shè)備需要微秒級(jí)的延時(shí)。可以在SPI_ReadWriteByte函數(shù)調(diào)用之間加入DWT_Delay_us(1)試試。緩沖區(qū)溢出在使用DMA或中斷時(shí)如果數(shù)據(jù)處理太慢而下一幀數(shù)據(jù)已經(jīng)到來(lái)會(huì)導(dǎo)致數(shù)據(jù)被覆蓋。檢查DMA/中斷的完成處理是否及時(shí)緩沖區(qū)是否夠大。5.3 DMA傳輸不穩(wěn)定或卡死DMA配置相對(duì)復(fù)雜容易出問(wèn)題。排查清單DMA通道沖突確保SPI的TX和RX DMA請(qǐng)求分配到了不同的DMA流Stream和通道Channel或者同一流但優(yōu)先級(jí)不同避免沖突。內(nèi)存對(duì)齊如前所述DMA緩沖區(qū)地址對(duì)齊問(wèn)題。使用malloc分配的動(dòng)態(tài)內(nèi)存可能未對(duì)齊建議使用靜態(tài)數(shù)組或?qū)R分配。Cache一致性問(wèn)題Cortex-M7等這是最高頻的坑如果你的CPU有Cache而DMA操作的內(nèi)存區(qū)域開(kāi)啟了Cache必須手動(dòng)維護(hù)一致性。發(fā)送前Clean接收后Invalidate。傳輸完成判斷不要單純依賴(lài)HAL_SPI_GetState它可能返回BUSY狀態(tài)。結(jié)合使用DMA傳輸完成回調(diào)函數(shù)和自定義的標(biāo)志位更為可靠。超時(shí)設(shè)置雖然DMA不依賴(lài)超時(shí)但HAL庫(kù)的DMA傳輸啟動(dòng)函數(shù)可能有超時(shí)參數(shù)。如果設(shè)置過(guò)短可能在DMA還沒(méi)真正完成時(shí)就返回超時(shí)錯(cuò)誤。可以適當(dāng)加長(zhǎng)或使用中斷回調(diào)。5.4 多從設(shè)備相互干擾當(dāng)一個(gè)設(shè)備工作時(shí)另一個(gè)設(shè)備的數(shù)據(jù)異常。排查清單片選隔離確保你的SPI_SelectDevice函數(shù)在選中新設(shè)備前確實(shí)拉高了所有其他設(shè)備的片選。用邏輯分析儀同時(shí)抓取多個(gè)CS信號(hào)驗(yàn)證。從設(shè)備輸出使能有些從設(shè)備在CS為高時(shí)其MISO引腳不是高阻態(tài)而是仍然有輸出可能是低電平。這會(huì)與當(dāng)前選中設(shè)備在MISO線(xiàn)上的輸出沖突。檢查從設(shè)備手冊(cè)必要時(shí)在硬件上為每個(gè)從設(shè)備的MISO線(xiàn)加上隔離緩沖器如74HC125。總線(xiàn)負(fù)載掛載的設(shè)備太多可能導(dǎo)致總線(xiàn)電容過(guò)大信號(hào)上升沿變緩在高速下出錯(cuò)。減少設(shè)備數(shù)量或降低通信速率或在總線(xiàn)上串聯(lián)小電阻。調(diào)試SPI邏輯分析儀是比示波器更高效的利器。它能同時(shí)解碼多路信號(hào)直接顯示出十六進(jìn)制的數(shù)據(jù)字節(jié)讓你一眼就能看出命令、地址、數(shù)據(jù)是否正確極大提升調(diào)試效率。