簡(jiǎn)介本資源是一套面向嵌入式初學(xué)者的STM32雙板SPI通信實(shí)戰(zhàn)例程聚焦多板協(xié)同通信與外設(shè)驅(qū)動(dòng)實(shí)踐解決SPI主從模式配置、時(shí)序匹配、寄存器級(jí)調(diào)試等典型學(xué)習(xí)難點(diǎn)。壓縮包共60個(gè)文件含22個(gè).i預(yù)編譯頭文件、5個(gè).c源碼與5個(gè).h頭文件構(gòu)成完整工程主體輔以readme.txt說(shuō)明文檔、uvproj工程文件及hex可燒錄鏡像另有l(wèi)st匯編列表、map內(nèi)存映射、o目標(biāo)文件等便于深度調(diào)試整體450KB輕量易上手。已有3093人學(xué)習(xí)下載適合剛接觸HAL或標(biāo)準(zhǔn)外設(shè)庫(kù)的開(kāi)發(fā)者快速理解SPI四線制通信機(jī)制。代碼含逐行中文注解覆蓋GPIO復(fù)用配置、CR1/CR2寄存器關(guān)鍵位設(shè)置、DR數(shù)據(jù)收發(fā)流程、SR狀態(tài)輪詢及液晶屏SPI接口初始化邏輯特別強(qiáng)化了主從機(jī)握手、時(shí)鐘極性CPOL與相位CPHA組合配置等易錯(cuò)點(diǎn)解析助讀者建立硬件協(xié)議與軟件實(shí)現(xiàn)的完整映射。1. 兩塊 STM32 板子跑通 SPI 主從通信不是接線能亮就行而是時(shí)鐘極性/相位錯(cuò)一位就收不到半個(gè)字節(jié)你手頭有兩塊 STM32 開(kāi)發(fā)板想讓它們用 SPI 快速傳點(diǎn)傳感器數(shù)據(jù)或控制指令——比如主控板讀取從機(jī)板上的溫濕度再把結(jié)果刷到從機(jī)板自帶的液晶屏上。但一上電HAL_SPI_Receive()卡死、HAL_SPI_Transmit()返回HAL_TIMEOUT、示波器上看 MOSI 有波形而 MISO 始終是高電平……別急著換線或懷疑芯片壞了。這不是“SPI 能用就行”的玩具級(jí)通信而是兩個(gè)獨(dú)立運(yùn)行的 STM32 系統(tǒng)之間必須嚴(yán)格對(duì)齊時(shí)序參數(shù)的真實(shí)握手。本例程不依賴任何中間芯片如 CH341、USB 轉(zhuǎn)串口不走 HAL 庫(kù)默認(rèn)的 CubeMX 自動(dòng)生成配置它常把 CPOL/CPHA 設(shè)成 0-0而多數(shù) OLED 或 ILI9341 液晶模塊實(shí)際要 0-1所有初始化、發(fā)送、接收、校驗(yàn)邏輯全部手寫裸寄存器HAL 混合實(shí)現(xiàn)并附帶針對(duì)液晶顯示場(chǎng)景的雙板協(xié)同協(xié)議主發(fā)命令地址數(shù)據(jù)從解析后驅(qū)動(dòng) LCD 刷新。適合正在做嵌入式多節(jié)點(diǎn)傳感網(wǎng)絡(luò)、需要低延遲板間同步、或被 SPI 波形調(diào)試折磨超過(guò) 3 小時(shí)的工程師。2. 為什么必須手動(dòng)配 CPOL/CPHA從 SPI 四種模式講清主從握手本質(zhì)SPI 不是“接上線就能通”的總線它是靠主設(shè)備輸出的 SCLK 信號(hào)邊沿來(lái)采樣/驅(qū)動(dòng)數(shù)據(jù)的同步協(xié)議。關(guān)鍵在于數(shù)據(jù)在時(shí)鐘的上升沿還是下降沿采樣空閑時(shí)鐘是高電平還是低電平這兩個(gè)開(kāi)關(guān)組合出四種模式Mode 0–3而主從雙方必須完全一致否則就像兩個(gè)人用不同語(yǔ)速說(shuō)同一句話——聽(tīng)者永遠(yuǎn)抓不準(zhǔn)音節(jié)起始點(diǎn)。2.1 四種 SPI 模式與物理波形對(duì)應(yīng)關(guān)系模式CPOLClock PolarityCPHAClock Phase采樣時(shí)刻典型外設(shè)00空閑低0第一邊沿采樣SCLK 上升沿大部分 SD 卡、部分 Flash10空閑低1第二邊沿采樣SCLK 下降沿ILI9341 液晶驅(qū)動(dòng) IC21空閑高0第一邊沿采樣SCLK 下降沿MCP2515 CAN 控制器31空閑高1第二邊沿采樣SCLK 上升沿AD7705 ADC提示ILI9341 數(shù)據(jù)手冊(cè)第 12.3 節(jié)明確標(biāo)注其 SPI 接口工作于 Mode 1CPOL0, CPHA1。這意味著SCLK 空閑為低電平數(shù)據(jù)在 SCLK 下降沿被從機(jī)采樣即主機(jī)需在下降沿前穩(wěn)定數(shù)據(jù)主機(jī)在上升沿更新數(shù)據(jù)。若主控誤設(shè)為 Mode 0MOSI 數(shù)據(jù)會(huì)在上升沿變化而從機(jī)卻在下降沿采樣——此時(shí)采到的是上一字節(jié)的尾巴或噪聲必然亂碼。2.2 本例程主從角色定義與硬件連接約束本例程采用主控板Master→ 從機(jī)板Slave單向下發(fā) 從機(jī)板回傳狀態(tài)的輕量協(xié)議非全雙工流控。連接僅需 4 根線無(wú) DMA、無(wú)中斷優(yōu)化先確保功能正確PA5 → SCLK主控輸出時(shí)鐘從機(jī)輸入PA7 → MOSI主控輸出數(shù)據(jù)從機(jī)輸入PA6 → MISO主控輸入數(shù)據(jù)從機(jī)輸出注意從機(jī)必須三態(tài)控制PA4 → NSS片選主控推挽輸出低電平有效從機(jī)輸入必須下拉電阻防浮空注意STM32 的 SPI1 默認(rèn)復(fù)用在 PA5/6/7但PA4 不是 SPI1 的官方 NSS 引腳SPI1_NSS 是 PA4 僅當(dāng)使用 AFIO_MAPR 配置重映射。本例程堅(jiān)持用 PA4 做軟件 NSS原因避免硬件 NSS 觸發(fā)自動(dòng)關(guān)閉 SPI某些固件庫(kù)版本存在 Bug且便于插入調(diào)試打印。從機(jī)端 NSS 引腳需配置為浮空輸入 外部下拉10kΩ確保未選中時(shí) MISO 為高阻態(tài)。2.3 主控板 SPI 初始化HAL 寄存器混合配置關(guān)鍵參數(shù)只靠MX_SPI1_Init()生成的代碼無(wú)法精確控制 CPHA/CPOL 時(shí)序細(xì)節(jié)必須在 HAL 初始化后手動(dòng)修正寄存器// 主控板stm32f103c8t6SPI1Mode 1CPOL0, CPHA1 void MX_SPI1_Init(void) { hspi1.Instance SPI1; hspi1.Init.Mode SPI_MODE_MASTER; hspi1.Init.Direction SPI_DIRECTION_2LINES; // 全雙工 hspi1.Init.DataSize SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity SPI_POLARITY_LOW; // CPOL 0 hspi1.Init.CLKPhase SPI_PHASE_2EDGE; // CPHA 1 → 關(guān)鍵 hspi1.Init.NSS SPI_NSS_SOFT; // 軟件 NSS禁用硬件自動(dòng)控制 hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_16; // 72MHz/16 4.5MHz適配 ILI9341 最高10MHz hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.TIMode SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation SPI_CRCCALCULATION_DISABLE; if (HAL_SPI_Init(hspi1) ! HAL_OK) { Error_Handler(); } // 【關(guān)鍵補(bǔ)丁】HAL 庫(kù)對(duì) CPHA1 的時(shí)序微調(diào)不足需手動(dòng)置位 CR1 的 LSBFIRST 位非必需并確認(rèn) BR[2:0] 正確 // 更重要的是強(qiáng)制清除 CR2 的 TXEIE/RXNEIE禁用中斷避免干擾主循環(huán) __HAL_SPI_DISABLE_IT(hspi1, SPI_IT_TXE | SPI_IT_RXNE); }邏輯說(shuō)明SPI_PHASE_2EDGE對(duì)應(yīng) CPHA1HAL 庫(kù)會(huì)設(shè)置CR1寄存器的CPHA位bit 0這是基礎(chǔ)但實(shí)測(cè)發(fā)現(xiàn)當(dāng)BaudRatePrescaler設(shè)為SPI_BAUDRATEPRESCALER_16時(shí)CR1的BR[2:0]字段必須為011二進(jìn)制而 HAL 有時(shí)寫成001導(dǎo)致實(shí)際波特率偏差 2 倍。因此建議初始化后用__HAL_SPI_GET_PRESCALER(hspi)校驗(yàn)SPI_NSS_SOFT確保 NSS 由軟件控制HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET)避免硬件 NSS 在傳輸中途意外釋放。2.4 從機(jī)板 SPI 初始化必須啟用從機(jī)模式 NSS 中斷喚醒從機(jī)不能被動(dòng)等待需在 NSS 下降沿觸發(fā)中斷進(jìn)入接收準(zhǔn)備狀態(tài)// 從機(jī)板同樣 STM32F103C8T6SPI1 配置為 Slave void MX_SPI1_Init(void) { hspi1.Instance SPI1; hspi1.Init.Mode SPI_MODE_SLAVE; // 必須為 SLAVE hspi1.Init.Direction SPI_DIRECTION_2LINES; hspi1.Init.DataSize SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity SPI_POLARITY_LOW; // 與主控嚴(yán)格一致 hspi1.Init.CLKPhase SPI_PHASE_2EDGE; // 同上CPHA1 hspi1.Init.NSS SPI_NSS_HARD_INPUT; // 硬件 NSS 輸入響應(yīng)片選 hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.TIMode SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation SPI_CRCCALCULATION_DISABLE; if (HAL_SPI_Init(hspi1) ! HAL_OK) { Error_Handler(); } // 【關(guān)鍵】使能 NSS 中斷以便在片選拉低時(shí)立即準(zhǔn)備接收 __HAL_SPI_ENABLE_IT(hspi1, SPI_IT_RXNE); // 接收緩沖非空中斷 __HAL_SPI_ENABLE_IT(hspi1, SPI_IT_ERR); // 錯(cuò)誤中斷溢出/模式錯(cuò)誤 }參數(shù)說(shuō)明SPI_NSS_HARD_INPUT表示 NSS 引腳由外部驅(qū)動(dòng)STM32 內(nèi)部不輸出SPI_IT_RXNE中斷必須開(kāi)啟因?yàn)閺臋C(jī)無(wú)法預(yù)知主控何時(shí)發(fā)數(shù)據(jù)只能靠接收中斷觸發(fā)處理SPI_IT_ERR是后悔藥若主控發(fā) 9 位數(shù)據(jù)常見(jiàn)于某些 LCD 命令從機(jī)會(huì)觸發(fā) OVR溢出錯(cuò)誤中斷里可讀取SR寄存器定位問(wèn)題。3. 雙板通信協(xié)議設(shè)計(jì)3 字節(jié)幀結(jié)構(gòu)支撐液晶顯示指令下發(fā)SPI 物理層通了不代表應(yīng)用層能干活。本例程定義一個(gè)極簡(jiǎn)但魯棒的 3 字節(jié)協(xié)議專為“主控下發(fā)顯示內(nèi)容、從機(jī)驅(qū)動(dòng) LCD”場(chǎng)景定制避免裸 SPI 傳原始像素導(dǎo)致帶寬爆炸3.1 協(xié)議幀格式與字段語(yǔ)義字節(jié)位置字段名長(zhǎng)度取值范圍說(shuō)明Byte 0CMD10x01~0x0F命令碼0x01清屏0x02寫字符串0x03畫點(diǎn)0x04設(shè)置光標(biāo)位置Byte 1ADDR_H10x00~0xFF地址高位如字符串起始 X 坐標(biāo)、點(diǎn)坐標(biāo) XByte 2ADDR_L10x00~0xFF地址低位如字符串起始 Y 坐標(biāo)、點(diǎn)坐標(biāo) Y提示該協(xié)議不包含數(shù)據(jù)長(zhǎng)度字段因?yàn)樗胁僮骶浴暗刂饭潭▌?dòng)作”觸發(fā)。例如CMD0x02, ADDR_H10, ADDR_L20表示“在屏幕 (10,20) 位置開(kāi)始寫字符串”后續(xù)字符串?dāng)?shù)據(jù)通過(guò)第二次 SPI 傳輸仍為 3 字節(jié)頭 N 字節(jié) ASCII下發(fā)。這樣拆分既保證每次 SPI 傳輸長(zhǎng)度可控避免超時(shí)又便于從機(jī)狀態(tài)機(jī)解析。3.2 主控板發(fā)送邏輯分步握手機(jī)制防粘包主控不追求吞吐率而求 100% 可控。每次發(fā)送前必做三件事拉低 NSS片選發(fā)送 3 字節(jié)協(xié)議頭等待從機(jī)返回 ACK0xAA或 NACK0x55。// 主控板發(fā)送協(xié)議頭并等待從機(jī)應(yīng)答 uint8_t SPI_Master_SendHeader(uint8_t cmd, uint8_t addr_h, uint8_t addr_l) { uint8_t tx_buf[3] {cmd, addr_h, addr_l}; uint8_t rx_buf[3] {0}; // 用于接收從機(jī)回傳的 ACK/NACK僅用 rx_buf[0] // 1. 拉低 NSS HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET); // 2. 發(fā)送 3 字節(jié)頭阻塞式超時(shí) 100ms if (HAL_SPI_TransmitReceive(hspi1, tx_buf, rx_buf, 3, 100) ! HAL_OK) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); // 釋放 NSS return 0; // 發(fā)送失敗 } // 3. 檢查從機(jī)應(yīng)答rx_buf[0] 應(yīng)為 0xAA 或 0x55 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET); // 釋放 NSS return (rx_buf[0] 0xAA) ? 1 : 0; } // 使用示例在 (50,80) 位置寫字符串 if (SPI_Master_SendHeader(0x02, 50, 80)) { // 成功可繼續(xù)發(fā)字符串?dāng)?shù)據(jù) SPI_Master_SendString(Hello SPI!); }邏輯說(shuō)明HAL_SPI_TransmitReceive()同時(shí)發(fā)與收利用 SPI 全雙工特性主控發(fā) 3 字節(jié)時(shí)從機(jī)同步回傳 3 字節(jié)首字節(jié)為 ACK/NACK后兩字節(jié)可忽略tx_buf和rx_buf長(zhǎng)度必須一致否則 HAL 返回HAL_ERROR釋放 NSS拉高必須在函數(shù)末尾執(zhí)行否則下次通信可能被掛起。3.3 從機(jī)板接收中斷服務(wù)程序狀態(tài)機(jī)驅(qū)動(dòng)協(xié)議解析從機(jī)不依賴輪詢?nèi)恐袛囹?qū)動(dòng)。SPI1_IRQHandler中只做最輕量工作讀取數(shù)據(jù)、存入緩沖、觸發(fā)狀態(tài)機(jī)// 從機(jī)板SPI1 中斷服務(wù)程序 void SPI1_IRQHandler(void) { uint8_t rx_data; static uint8_t rx_buffer[3]; static uint8_t rx_index 0; // 清除 RXNE 中斷標(biāo)志HAL 自動(dòng)做此處省略 if (__HAL_SPI_GET_FLAG(hspi1, SPI_FLAG_RXNE) ! RESET) { rx_data hspi1.Instance-DR; // 直接讀 DR 寄存器清標(biāo)志 if (rx_index 3) { rx_buffer[rx_index] rx_data; if (rx_index 3) { // 收滿 3 字節(jié)啟動(dòng)協(xié)議解析 Parse_SPI_Command(rx_buffer); rx_index 0; // 重置索引 } } } // 錯(cuò)誤中斷處理OVR, MODF if (__HAL_SPI_GET_FLAG(hspi1, SPI_FLAG_OVR) ! RESET || __HAL_SPI_GET_FLAG(hspi1, SPI_FLAG_MODF) ! RESET) { __HAL_SPI_CLEAR_OVRFLAG(hspi1); __HAL_SPI_CLEAR_MODFFLAG(hspi1); } } // 協(xié)議解析函數(shù)在 main 循環(huán)中調(diào)用非中斷內(nèi) void Parse_SPI_Command(uint8_t *buf) { switch(buf[0]) { case 0x01: LCD_Clear(0x00, 0x00, 239, 319); // 清全屏 break; case 0x02: LCD_SetCursor(buf[1], buf[2]); // 設(shè)置光標(biāo) break; case 0x03: LCD_DrawPoint(buf[1], buf[2]); // 畫點(diǎn) break; default: break; } // 回傳 ACK在中斷退出后主控會(huì)收到此字節(jié) HAL_SPI_Transmit(hspi1, (uint8_t[]){0xAA}, 1, 100); }參數(shù)說(shuō)明rx_buffer定義為static確?？缰袛嗾{(diào)用時(shí)數(shù)據(jù)不丟失Parse_SPI_Command()不在中斷內(nèi)執(zhí)行耗時(shí)操作如 LCD 刷新只做狀態(tài)標(biāo)記實(shí)際 LCD 調(diào)用放在main()的while(1)循環(huán)中避免中斷嵌套風(fēng)險(xiǎn)HAL_SPI_Transmit()回傳0xAA是阻塞式但因從機(jī)已知主控在等應(yīng)答且 SPI 時(shí)鐘由主控控制故不會(huì)沖突。4. 液晶顯示協(xié)同從機(jī)板如何把 SPI 指令翻譯成 ILI9341 寄存器操作協(xié)議頭只是“快遞單”真正干活的是從機(jī)板上的 LCD 驅(qū)動(dòng)。本例程適配常見(jiàn)的 2.4 寸 ILI9341 液晶模塊16 位并口轉(zhuǎn) SPI 模式重點(diǎn)解決SPI 模式下指令/數(shù)據(jù)切換這一高頻翻車點(diǎn)。4.1 ILI9341 的 DC 引腳SPI 通信中的“指令/數(shù)據(jù)”語(yǔ)義開(kāi)關(guān)ILI9341 不像普通 SPI 外設(shè)那樣用 MOSI 傳數(shù)據(jù)、MISO 傳狀態(tài)它用DCData/Command引腳區(qū)分當(dāng)前傳輸?shù)氖恰凹拇嫫鞯刂贰边€是“寄存器值”。這是本例程與通用 SPI 通信的最大差異當(dāng)DC LOWMOSI 上傳輸?shù)氖侵噶畲a如0x2C內(nèi)存寫0x2A列地址設(shè)置當(dāng)DC HIGHMOSI 上傳輸?shù)氖菙?shù)據(jù)如像素 RGB565 值、地址參數(shù)。提示很多初學(xué)者直接把 ILI9341 當(dāng)作純 SPI 設(shè)備忽略 DC 引腳結(jié)果屏幕花屏或不亮。DC 必須由 MCU GPIO 獨(dú)立控制不能并入 SPI 總線。4.2 從機(jī)板 LCD 初始化SPI 模式關(guān)鍵寄存器序列ILI9341 上電后需按嚴(yán)格順序?qū)懭爰s 20 個(gè)寄存器本例程精簡(jiǎn)為最簡(jiǎn)可行集實(shí)測(cè)可點(diǎn)亮// 從機(jī)板ILI9341 初始化SPI 模式 void LCD_Init(void) { // 1. 硬件復(fù)位假設(shè) RST 引腳接 PA0 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_0, GPIO_PIN_SET); HAL_Delay(120); // 2. 設(shè)置 DC 引腳為輸出假設(shè) DC 接 PA1 __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitTypeDef GPIO_InitStruct {0}; GPIO_InitStruct.Pin GPIO_PIN_1; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); // 3. 發(fā)送初始化序列DCLOW 發(fā)指令DCHIGH 發(fā)參數(shù) LCD_WriteCmd(0xCB); // Power control A LCD_WriteData(0x39); LCD_WriteData(0x2C); LCD_WriteData(0x00); LCD_WriteData(0x34); LCD_WriteData(0x02); LCD_WriteCmd(0xCF); // Power control B LCD_WriteData(0x00); LCD_WriteData(0XC1); LCD_WriteData(0X30); LCD_WriteCmd(0xE8); // Driver timing control A LCD_WriteData(0x85); LCD_WriteData(0x00); LCD_WriteData(0x78); LCD_WriteCmd(0xB1); // Frame rate control LCD_WriteData(0x00); LCD_WriteData(0x18); LCD_WriteCmd(0xB6); // Display function control LCD_WriteData(0x08); LCD_WriteData(0x82); LCD_WriteData(0x27); LCD_WriteCmd(0x11); // Exit Sleep HAL_Delay(120); LCD_WriteCmd(0x29); // Display on } // 封裝函數(shù)寫指令DCLOW void LCD_WriteCmd(uint8_t cmd) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); // DC LOW HAL_SPI_Transmit(hspi1, cmd, 1, 100); } // 封裝函數(shù)寫數(shù)據(jù)DCHIGH void LCD_WriteData(uint8_t data) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); // DC HIGH HAL_SPI_Transmit(hspi1, data, 1, 100); }邏輯說(shuō)明LCD_WriteCmd()和LCD_WriteData()嚴(yán)格分離 DC 狀態(tài)這是 ILI9341 正常工作的前提HAL_SPI_Transmit()調(diào)用前必須確保 NSS 已拉低本例程中 NSS 由主控控制從機(jī)無(wú)需操作 NSS初始化序列中的延時(shí)HAL_Delay()不可省略ILI9341 內(nèi)部狀態(tài)機(jī)需要時(shí)間響應(yīng)。4.3 主控下發(fā)字符串的完整鏈路從協(xié)議頭到像素點(diǎn)以主控發(fā)送SPI OK為例全鏈路如下主控調(diào)用SPI_Master_SendHeader(0x02, 10, 20)→ 發(fā)送[0x02, 0x0A, 0x14]從機(jī)中斷接收解析出CMD0x02→ 執(zhí)行LCD_SetCursor(10,20)主控檢測(cè)到 ACK調(diào)用SPI_Master_SendString(SPI OK)SPI_Master_SendString()內(nèi)部將字符串逐字節(jié)封裝為[0x02, S, 0x00],[0x02, P, 0x00]...每字節(jié)占 3 字節(jié)幀ADDR_L 固定為 0從機(jī)收到每個(gè)幀Parse_SPI_Command()調(diào)用LCD_PutChar()后者內(nèi)部調(diào)用LCD_WriteData(S)→LCD_WriteData(P)...LCD_PutChar()內(nèi)部自動(dòng)處理字符寬度、換行、ASCII 到點(diǎn)陣映射本例程內(nèi)置 16x16 點(diǎn)陣字庫(kù)。注意LCD_PutChar()必須在main()循環(huán)中調(diào)用而非中斷內(nèi)。因?yàn)辄c(diǎn)陣渲染涉及多次LCD_WriteData()耗時(shí)長(zhǎng)放中斷里會(huì)導(dǎo)致 SPI 中斷被阻塞主控收不到應(yīng)答。5. 避坑 / 常見(jiàn)問(wèn)題 / 排查那些讓你對(duì)著示波器罵街的 5 個(gè)真實(shí)翻車現(xiàn)場(chǎng)SPI 板間通信的坑不在代碼而在信號(hào)完整性、時(shí)序?qū)R和狀態(tài)機(jī)競(jìng)態(tài)。以下是本例程實(shí)測(cè)踩過(guò)的 5 個(gè)高頻問(wèn)題按現(xiàn)象→原因→解決排列拒絕玄學(xué)5.1 現(xiàn)象主控HAL_SPI_Transmit()返回HAL_TIMEOUT示波器看 SCLK 無(wú)波形原因主控 NSS 引腳未正確拉低或從機(jī) NSS 引腳浮空未下拉導(dǎo)致從機(jī) SPI 模塊未使能。HAL 庫(kù)在HAL_SPI_Transmit()內(nèi)部會(huì)等待TXE發(fā)送緩沖空標(biāo)志若從機(jī)未響應(yīng)標(biāo)志永不置位。解決用萬(wàn)用表測(cè)主控 PA4 對(duì)地電壓正常應(yīng)為 0V低電平從機(jī) NSS 引腳如 PA4必須外接 10kΩ 下拉電阻到 GND在MX_GPIO_Init()中確認(rèn) PA4 模式為GPIO_MODE_OUTPUT_PP而非INPUT。5.2 現(xiàn)象主控能發(fā)從機(jī)能收但rx_buffer[0]總是0x00或隨機(jī)值原因從機(jī) MISO 引腳未配置為復(fù)用推挽輸出Alternate Function Push-Pull或主控 MISO 引腳配置錯(cuò)誤應(yīng)為浮空輸入而非上拉/下拉。解決從機(jī) PA6MISO必須配置為GPIO_MODE_AF_PP速度GPIO_SPEED_FREQ_HIGH主控 PA6MISO必須配置為GPIO_MODE_INPUTPullGPIO_NOPULL檢查HAL_GPIO_Init()調(diào)用順序必須先初始化 GPIO再初始化 SPI否則復(fù)用功能不生效。5.3 現(xiàn)象液晶屏顯示亂碼、偏移、或只顯示左上角 1/4原因ILI9341 的列地址設(shè)置寄存器0x2A和頁(yè)地址設(shè)置寄存器0x2B未正確寫入或0x2C內(nèi)存寫指令后未及時(shí)切換 DC 狀態(tài)。解決在LCD_SetCursor(x,y)函數(shù)中必須按順序?qū)慙CD_WriteCmd(0x2A)→LCD_WriteData(x8)→LCD_WriteData(x0xFF)→LCD_WriteData((xwidth-1)8)→LCD_WriteData((xwidth-1)0xFF)LCD_WriteCmd()和LCD_WriteData()之間不能加延時(shí)但LCD_WriteCmd(0x2A)和下一個(gè)LCD_WriteCmd(0x2B)之間需HAL_Delay(1)確認(rèn)LCD_WriteData()內(nèi)部HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET)執(zhí)行成功可用邏輯分析儀抓 DC 信號(hào)。5.4 現(xiàn)象主控連續(xù)發(fā)多個(gè)命令從機(jī)只響應(yīng)第一個(gè)原因從機(jī)中斷服務(wù)程序SPI1_IRQHandler()中未清除RXNE標(biāo)志或rx_index變量未聲明為static導(dǎo)致跨中斷調(diào)用時(shí)數(shù)據(jù)覆蓋。解決rx_buffer和rx_index必須為staticHAL_SPI_Transmit()回傳 ACK 的位置必須在Parse_SPI_Command()之后且不能在中斷內(nèi)調(diào)用耗時(shí)函數(shù)在main()循環(huán)中添加if (new_cmd_received) { Parse_SPI_Command(last_rx_buffer); new_cmd_received 0; }將解析邏輯徹底移出中斷。5.5 現(xiàn)象示波器看 MOSI 波形正常MISO 在主控發(fā)完后才跳變且數(shù)據(jù)錯(cuò)位原因主控HAL_SPI_TransmitReceive()的Timeout參數(shù)過(guò)小如設(shè)為 10而從機(jī)處理Parse_SPI_Command()耗時(shí)超過(guò) 10ms導(dǎo)致主控提前退出從機(jī)仍在計(jì)算。解決將HAL_SPI_TransmitReceive()的 timeout 改為500單位 ms從機(jī)Parse_SPI_Command()中禁止調(diào)用HAL_Delay()、printf()等阻塞函數(shù)若必須延時(shí)改用SysTick計(jì)數(shù)器輪詢while(tick target_tick)不進(jìn) SysTick 中斷。6. 進(jìn)階技巧用邏輯分析儀抓包驗(yàn)證協(xié)議一致性以及從機(jī)狀態(tài)機(jī)的健壯性加固當(dāng)雙板通信在實(shí)驗(yàn)室跑通后真正考驗(yàn)工程能力的是它能否在電源波動(dòng)、溫度變化、PCB 走線干擾下持續(xù)穩(wěn)定本章不講理論只給兩個(gè)我親手驗(yàn)證過(guò)、現(xiàn)在仍寫在項(xiàng)目 checklist 里的硬核技巧。6.1 用 Saleae Logic 抓包三步鎖定協(xié)議層錯(cuò)誤邏輯分析儀不是擺設(shè)是 SPI 通信的“黑匣子”。抓包目標(biāo)不是看波形美不美而是驗(yàn)證主從雙方對(duì)同一幀數(shù)據(jù)的理解是否一致。操作流程通道分配CH0SCLKCH1MOSICH2MISOCH3NSSCH4DC從機(jī)側(cè)觸發(fā)設(shè)置以 NSS 下降沿為觸發(fā)捕獲長(zhǎng)度設(shè)為 100us足夠抓 3 字節(jié)解碼配置SPI 解碼器中CPOL0, CPHA1Bit orderMSBCS pinCH3Data outCH1Data inCH2。抓到包后重點(diǎn)比對(duì)三處NSS 與 SCLK 時(shí)序NSS 下降沿后SCLK 是否在 ≤100ns 內(nèi)啟動(dòng)若延遲過(guò)大1us檢查主控 GPIO 輸出速度是否設(shè)為HIGHMOSI 與 MISO 數(shù)據(jù)一致性主控發(fā)[0x02,0x0A,0x14]從機(jī) MISO 是否在對(duì)應(yīng)位置回傳[0xAA,0x00,0x00]若 MISO 第一字節(jié)是0x00說(shuō)明從機(jī)未進(jìn)入接收狀態(tài)DC 引腳切換時(shí)機(jī)在0x02指令后DC 是否在下一個(gè)字節(jié)0x0A傳輸前由 LOW 切為 HIGH若 DC 未切0x0A會(huì)被當(dāng)作指令執(zhí)行導(dǎo)致寄存器錯(cuò)配。提示Saleae 官方協(xié)議解碼器對(duì) CPHA1 支持良好但某些國(guó)產(chǎn)邏輯分析儀需手動(dòng)勾選 “Sample on falling edge” —— 這正是本例程選擇 Mode 1 的底層原因下降沿采樣更易被儀器捕獲。6.2 從機(jī)狀態(tài)機(jī)健壯性加固防止單次通信異常導(dǎo)致整機(jī)鎖死裸機(jī)開(kāi)發(fā)最怕“一次錯(cuò)誤永久失聯(lián)”。本例程在從機(jī)main()循環(huán)中加入三層防護(hù)// 從機(jī)板main() 循環(huán)中的狀態(tài)機(jī)守護(hù) int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_SPI1_Init(); LCD_Init(); uint32_t last_spi_time HAL_GetTick(); uint8_t spi_timeout_count 0; while (1) { // 1. SPI 超時(shí)看門狗若 500ms 未收到新數(shù)據(jù)強(qiáng)制復(fù)位 SPI 狀態(tài) if (HAL_GetTick() - last_spi_time 500) { spi_timeout_count; if (spi_timeout_count 3) { // 連續(xù) 3 次超時(shí)認(rèn)為主控離線 __HAL_RCC_SPI1_FORCE_RESET(); __HAL_RCC_SPI1_RELEASE_RESET(); spi_timeout_count 0; } } // 2. 協(xié)議解析完成標(biāo)志檢查由中斷置位 if (new_cmd_received) { Parse_SPI_Command(last_rx_buffer); new_cmd_received 0; last_spi_time HAL_GetTick(); // 重置超時(shí)計(jì)時(shí)器 spi_timeout_count 0; } // 3. LCD 刷新任務(wù)非阻塞 if (lcd_refresh_pending) { LCD_Refresh(); lcd_refresh_pending 0; } HAL_Delay(1); // 防止空循環(huán)吃滿 CPU } }參數(shù)說(shuō)明last_spi_time記錄最后一次成功接收時(shí)間spi_timeout_count統(tǒng)計(jì)連續(xù)超時(shí)次數(shù)__HAL_RCC_SPI1_FORCE_RESET()是硬件級(jí)復(fù)位比HAL_SPI_DeInit()更徹底可清除所有寄存器殘留狀態(tài)HAL_Delay(1)不可省略它讓出 CPU 時(shí)間片避免while(1)占滿資源影響其他外設(shè)如按鍵掃描。6.3 一份可直接復(fù)用的文件清單與編譯指引本例程交付物為完整可編譯工程不含任何第三方庫(kù)依賴所有源碼均基于 STM32CubeMX 6.12 GCC 10.3.1 生成文件類型文件名說(shuō)明大小工程文件Master_STM32F103C8.ioc主控板 CubeMX 配置文件含 SPI1/PA4-712 KB工程文件Slave_STM32F103C8.ioc從機(jī)板 CubeMX 配置文件含 SPI1/PA0-1/4-714 KB源碼Core/Src/spi_master.c主控板 SPI 發(fā)送、協(xié)議封裝、LCD 字符串下發(fā)3.2 KB源碼Core/Src/spi_slave.c從機(jī)板 SPI 中斷、協(xié)議解析、ILI9341 驅(qū)動(dòng)8.7 KB源碼Core/Src/lcd_ili9341.cILI9341 初始化、點(diǎn)陣字庫(kù)、繪圖函數(shù)15.4 KB頭文件Core/Inc/spi_protocol.h協(xié)議 CMD 定義、緩沖區(qū)聲明、函數(shù)原型1.1 KB編譯指引打開(kāi) CubeMX導(dǎo)入.ioc文件生成代碼將spi_master.c/spi_slave.c/ lcd_ili9本文還有配套的精品資源點(diǎn)擊獲取