1. 項(xiàng)目背景與整體設(shè)計(jì)思路這一篇我來聊聊GD32H759和RT-Thread組合下的SPI實(shí)戰(zhàn)。先說項(xiàng)目背景我手頭這套工控板是一個(gè)現(xiàn)場(chǎng)溫控模塊核心工作由三路SPI外設(shè)承擔(dān)一路240x320的TFT屏幕顯示實(shí)時(shí)溫度曲線一路MAX31865讀PT100鉑電阻溫度還有一路W25Q64 NOR Flash存配置參數(shù)和運(yùn)行日志。工控場(chǎng)景下這種“屏幕傳感器存儲(chǔ)”的三件套很典型但也是最容易出現(xiàn)調(diào)度沖突的組合。以前這個(gè)板子用STM32F407裸機(jī)開發(fā)三路SPI全靠中斷和標(biāo)志位輪詢來協(xié)調(diào)。屏刷到一半Flash寫入突然插入畫面撕裂是小事最怕的是總線上出現(xiàn)半截?cái)?shù)據(jù)導(dǎo)致Flash狀態(tài)字讀取錯(cuò)誤、整塊數(shù)據(jù)報(bào)廢。換到GD32H759之后我干脆把系統(tǒng)切成RT-Thread所有SPI外設(shè)統(tǒng)一掛到RT-Thread設(shè)備模型下面用總線鎖和線程調(diào)度來解決這種訪問沖突。運(yùn)行了大半年穩(wěn)定性比我預(yù)想的好這也正是我覺得值得把過程整理出來分享的原因。選GD32H759不是拍腦袋。這顆芯片是Cortex-M7內(nèi)核主頻能跑到550MHzRAM和Flash容量比F407高一個(gè)量級(jí)而且SPI外設(shè)資源特別充足。我用的三路SPI分別掛在不同的SPI控制器上從硬件層面避免了共享總線的尷尬。再加上GD32的外設(shè)庫是傳統(tǒng)寄存器風(fēng)格熟悉標(biāo)準(zhǔn)外設(shè)庫的人上手很快配置SPI時(shí)直接操作CTL、STAT、DATA這幾個(gè)寄存器就能完成大部分工作。1.1 裸機(jī)方案與RTOS方案的取舍邏輯把SPI從裸機(jī)搬到RT-Thread本質(zhì)上解決的是“誰先用總線”的問題。裸機(jī)環(huán)境下所有SPI操作都跑在中斷里遇到高優(yōu)先級(jí)中斷搶占低優(yōu)先級(jí)的傳輸就會(huì)被延遲。你無法預(yù)測(cè)一個(gè)Flash寫入會(huì)被屏幕刷新打斷多少次。每次打斷都意味著總線狀態(tài)要保存、恢復(fù)還要保證片選時(shí)序不出錯(cuò)這種復(fù)雜度到后期根本壓不住。RT-Thread里SPI設(shè)備模型自帶一個(gè)互斥鎖。任何線程想要操作SPI必須先拿到總線鎖操作結(jié)束后釋放。如果兩個(gè)線程同時(shí)發(fā)請(qǐng)求后者的線程會(huì)掛起進(jìn)入等待狀態(tài)而不是像裸機(jī)那樣直接沖進(jìn)臨界區(qū)。從應(yīng)用層看SPI的訪問被串行化了底層驅(qū)動(dòng)不需要做任何加鎖保護(hù)只要保證一次傳輸過程中不主動(dòng)讓出CPU就行。這種做法帶來的直接收益是我可以在應(yīng)用層隨便開線程一個(gè)線程刷屏一個(gè)線程讀溫度一個(gè)線程寫Flash三者之間不需要自己設(shè)計(jì)復(fù)雜的“信號(hào)量標(biāo)志位超時(shí)”仲裁機(jī)制。RT-Thread把這層工作全部收納進(jìn)框架我只專注于業(yè)務(wù)邏輯。1.2 三路SPI外設(shè)的需求拆解三路SPI外設(shè)的性質(zhì)完全不同必須區(qū)別對(duì)待外設(shè)傳輸方向數(shù)據(jù)量特征實(shí)時(shí)性要求頻率選擇W25Q64 Flash雙向讀多寫少單次最大256字節(jié)頁編程低可容忍等待40MHzMAX31865 溫度芯片雙向固定2~3字節(jié)周期輪詢中100ms內(nèi)完成即可3MHzTFT SPI屏幕單向?yàn)橹鞔罅髁咳了⑿?~3ms高盡量不被阻塞30MHzFlash寫入偶爾大塊屏幕刷新持續(xù)高頻溫度讀取是固定節(jié)奏的小包。如果三個(gè)任務(wù)調(diào)度不好屏幕最容易出問題因?yàn)樗⑿卵舆t哪怕幾十毫秒人眼都能捕捉到閃爍。我最終的方案是屏幕線程優(yōu)先級(jí)最高掛在SPI2上并配獨(dú)立DMA通道溫度讀取線程次之固定每100ms喚醒一次Flash寫入優(yōu)先級(jí)最低只在日志模塊觸發(fā)時(shí)才跑。三者之間靠RT-Thread的優(yōu)先級(jí)搶占和SPI總線鎖共同保障時(shí)序。2. GD32H759 SPI硬件資源與速率計(jì)算跑通RT-Thread驅(qū)動(dòng)之前得先把GD32H759的SPI硬件底子摸透。這顆芯片有多個(gè)SPI控制器名字從SPI0一路排到后面每一路都支持主模式和從模式也都有獨(dú)立的DMA請(qǐng)求通道。不同控制器掛在不同的APB總線上分頻系數(shù)來源不一樣配置速率之前必須搞清楚時(shí)鐘樹。2.1 SPI外設(shè)的時(shí)鐘來源與分頻計(jì)算GD32H759的SPI時(shí)鐘來自APB總線時(shí)鐘。我用的主頻是550MHzAPB1和APB2分別可以配置不同的分頻。假設(shè)APB2輸出時(shí)鐘是137.5MHz550MHz/4掛在這個(gè)總線上的SPI控制器它的工作頻率就是從137.5MHz往下分出來的。SPI的最終波特率公式是SPI時(shí)鐘頻率 APB總線頻率 / 分頻系數(shù)。GD32標(biāo)準(zhǔn)外設(shè)庫里通常用spi_baudirq_prescaler這個(gè)枚舉來選分頻系數(shù)常見值有2、4、8、16、32、64、128、256。如果我想要40MHz而APB2是137.5MHz那么137.5 / 4 34.375MHz最接近又不超過40MHz的就是這個(gè)值。如果你對(duì)速率有嚴(yán)格需求就得回頭調(diào)整APB分頻。我自己在項(xiàng)目里是這樣定的屏幕用30MHzFlash用40MHzMAX31865用3MHz。這幾個(gè)速率分別對(duì)應(yīng)不同的分頻系數(shù)。由于三路SPI掛在不同總線上互不牽扯配置起來自由度很大。2.2 硬件片選與軟件片選怎么選SPI片選CS是總線仲裁的關(guān)鍵。GD32H759的SPI控制器支持硬件片選和軟件片選兩種方式。硬件片選模式下只要向SPI數(shù)據(jù)寄存器寫數(shù)據(jù)硬件會(huì)自動(dòng)拉低CS傳輸結(jié)束后拉高全程不需要CPU介入。軟件片選模式下CS由普通GPIO控制驅(qū)動(dòng)里手動(dòng)拉低再拉高。我的建議是工控場(chǎng)景一律用軟件片選。原因有兩個(gè)。第一硬件片選的拉高時(shí)機(jī)不完全可控有些從設(shè)備要求在最后一個(gè)字節(jié)移位完成后再等一小段時(shí)間釋放CS硬件的自動(dòng)時(shí)序不總是滿足。第二多路外設(shè)分時(shí)復(fù)用時(shí)如果有兩個(gè)設(shè)備掛在同一個(gè)SPI控制器上軟件片選可以精準(zhǔn)控制“先抬起A設(shè)備的CS再拉低B設(shè)備的CS”避免兩個(gè)設(shè)備同時(shí)使能造成總線沖突。我實(shí)際操作時(shí)SPI0上的W25Q64和SPI2上的屏幕片選都是獨(dú)立GPIO只有MAX31865的片選直接復(fù)用硬件支持因?yàn)樗淖x時(shí)序固定CS釋放快慢影響不大。片選GPIO的推挽輸出速度建議設(shè)置到高速尤其是屏幕刷新場(chǎng)景CS翻轉(zhuǎn)頻率很高如果GPIO速度不夠波形上升沿會(huì)變緩影響時(shí)序裕量。2.3 數(shù)據(jù)位寬與傳輸模式配置GD32H759的SPI外設(shè)支持8位和16位數(shù)據(jù)位寬。初始化時(shí)用spi_data_frame_format配置。工控設(shè)備里大部分SPI從設(shè)備默認(rèn)都是8位模式但有一種情況要注意16位模式下有些芯片是按16位frame來收發(fā)數(shù)據(jù)的比如某些串行DAC和溫度傳感器。如果驅(qū)動(dòng)框架里用的數(shù)據(jù)寬度和底層配置對(duì)不上讀出來的數(shù)據(jù)會(huì)整體錯(cuò)位。傳輸模式方面SPI有模式0、1、2、3四種組合對(duì)應(yīng)CPOL時(shí)鐘極性和CPHA時(shí)鐘相位兩個(gè)參數(shù)。W25Q64和MAX31865都支持模式0和模式3屏幕驅(qū)動(dòng)芯片通常也兼容模式0。我統(tǒng)一選用模式0空閑時(shí)SCK為低電平第一個(gè)時(shí)鐘沿采樣數(shù)據(jù)。這樣三個(gè)設(shè)備不用切換配置降低復(fù)雜度。3. RT-Thread SPI驅(qū)動(dòng)框架從總線注冊(cè)到設(shè)備掛載RT-Thread對(duì)SPI的抽象分兩層總線層和設(shè)備層。這個(gè)設(shè)計(jì)跟Linux的SPI子系統(tǒng)很像只不過RT-Thread的API更簡(jiǎn)潔。你得先注冊(cè)一個(gè)SPI總線驅(qū)動(dòng)然后在這個(gè)總線上掛載具體設(shè)備應(yīng)用層操作的是設(shè)備句柄。3.1 底層總線驅(qū)動(dòng)需要實(shí)現(xiàn)什么SPI總線驅(qū)動(dòng)在RT-Thread里對(duì)應(yīng)struct rt_spi_ops需要實(shí)現(xiàn)兩個(gè)回調(diào)configure和xfer。configure負(fù)責(zé)把SPI控制器配置成目標(biāo)模式xfer負(fù)責(zé)一次實(shí)際的數(shù)據(jù)收發(fā)。整個(gè)框架只依賴這兩個(gè)函數(shù)剩下的總線加鎖、片選控制都由RT-Thread設(shè)備模型幫你處理。我在GD32H759上實(shí)現(xiàn)configure時(shí)做了這幾件事根據(jù)傳入的max_hz計(jì)算分頻系數(shù)調(diào)用GD32庫函數(shù)設(shè)置SPI模式、數(shù)據(jù)寬度、時(shí)鐘極性和相位。xfer函數(shù)則是核心需要遍歷一個(gè)rt_spi_message消息鏈逐條完成發(fā)送和接收。RT-Thread的xfer設(shè)計(jì)很有特點(diǎn)。消息鏈上可以掛多個(gè)rt_spi_message每條消息還能標(biāo)記cs_take和cs_release分別表示“這次傳輸前拉低片選”和“這次傳輸后拉高片選”。這意味著一次總線操作可以串行執(zhí)行一長(zhǎng)串命令中間不釋放總線非常適合Flash芯片的“讀狀態(tài)字-讀數(shù)據(jù)”這種復(fù)合操作。3.2 總線注冊(cè)與設(shè)備掛載的完整流程代碼層面整個(gè)過程分三步走。第一步注冊(cè)總線static struct rt_spi_bus gd32_spi0_bus; static const struct rt_spi_ops spi0_ops { .configure spi0_configure, .xfer spi0_xfer, }; rt_spi_bus_register(gd32_spi0_bus, spi0, spi0_ops);注冊(cè)之后系統(tǒng)里就有了一個(gè)名叫spi0的總線。應(yīng)用層可以用rt_device_find(spi0)拿到總線設(shè)備但常規(guī)做法是在總線上掛載子設(shè)備。第二步掛載設(shè)備static struct rt_spi_device spi0_dev_w25q64; rt_spi_bus_attach_device(spi0_dev_w25q64, w25q64, spi0, RT_NULL);這里w25q64是設(shè)備名spi0是總線名。掛載成功后應(yīng)用層直接通過rt_device_find(w25q64)拿到設(shè)備。第三個(gè)參數(shù)傳入片選GPIO等私有數(shù)據(jù)我一般放一個(gè)自定義結(jié)構(gòu)體指針。第三步配置參數(shù)struct rt_spi_configuration cfg; cfg.mode RT_SPI_MODE_0 | RT_SPI_MASTER | RT_SPI_MSB; cfg.data_width 8; cfg.max_hz 40 * 1000 * 1000; rt_spi_configure(spi0_dev_w25q64, cfg);配置好之后底層configure回調(diào)就會(huì)被調(diào)用硬件寄存器完成最終設(shè)置。之后應(yīng)用層只需要調(diào)用rt_spi_transfer或者rt_spi_take_busrt_spi_transfer組合就能收發(fā)數(shù)據(jù)。3.3 總線鎖的正確使用方式RT-Thread的SPI API有一個(gè)容易混淆的地方rt_spi_transfer它內(nèi)部并不自動(dòng)拿總線鎖。如果你直接調(diào)用總線上同時(shí)只能有一個(gè)線程操作但問題是RTOS調(diào)度下多個(gè)線程可能同時(shí)執(zhí)行rt_spi_transfer這時(shí)候就需要手動(dòng)加鎖。標(biāo)準(zhǔn)用法是rt_spi_take_bus(dev); rt_spi_take_cs(dev); result rt_spi_transfer(dev, send_buf, recv_buf, len); rt_spi_release_cs(dev); rt_spi_release_bus(dev);take_bus拿鎖take_cs拉低片選。如果整個(gè)消息鏈不需要中間釋放CS還有一種簡(jiǎn)便寫法struct rt_spi_message msg; msg.send_buf send_buf; msg.recv_buf recv_buf; msg.length len; msg.cs_take 1; msg.cs_release 1; rt_spi_transfer_message(dev, msg);transfer_message內(nèi)部會(huì)統(tǒng)一拿鎖、操作片選再釋放使用起來相對(duì)安全。我在底層驅(qū)動(dòng)封裝里給每個(gè)設(shè)備都做了一層spi_read_reg和spi_write_reg接口這些接口內(nèi)部統(tǒng)一處理鎖和片選應(yīng)用層看不到這些細(xì)節(jié)。4. 實(shí)操代碼三路外設(shè)從底層到應(yīng)用一次跑通理論框架聊完了這里直接給可以抄作業(yè)的驅(qū)動(dòng)代碼。我會(huì)按W25Q64、MAX31865、屏幕三路分別說重點(diǎn)講每路驅(qū)動(dòng)里跟其他設(shè)備不一樣的地方。4.1 W25Q64 Flash驅(qū)動(dòng)頁寫入和狀態(tài)輪詢W25Q64是8Mbit的SPI NOR Flash容量1MB。驅(qū)動(dòng)它核心是幾個(gè)命令0x06寫使能0x90讀設(shè)備ID0x02頁編程0x03讀數(shù)據(jù)0x05讀狀態(tài)寄存器。頁編程一次最多寫256字節(jié)寫入期間Flash的BUSY位會(huì)置1你必須輪詢狀態(tài)寄存器等它完成。初始化時(shí)先發(fā)0x90讀ID驗(yàn)證硬件通路uint8_t cmd[4] {0x90, 0x00, 0x00, 0x00}; uint8_t buf[4]; rt_spi_take_bus(w25q64_dev); rt_spi_take_cs(w25q64_dev); rt_spi_transfer(w25q64_dev, cmd, buf, 4); rt_spi_release_cs(w25q64_dev); rt_spi_release_bus(w25q64_dev); // buf[2] 是高字節(jié)IDW25Q64應(yīng)該返回0x40ID正確后初始化完成。寫入一個(gè)頁的流程是這樣的發(fā)寫使能0x06拉高CS再發(fā)頁編程命令0x02、目標(biāo)地址的高中低三字節(jié)和最多256字節(jié)數(shù)據(jù)最后等BUSY位清零。這個(gè)流程里“發(fā)寫使能”和“發(fā)數(shù)據(jù)”之間CS必須拉高再拉低Flash要求這么嚴(yán)格的時(shí)序CS一直接低無效。誤以為可以用rt_spi_transfer_message把整條鏈一次完成實(shí)際上我在調(diào)試時(shí)發(fā)現(xiàn)有些Flash對(duì)“寫使能命令和頁編程命令必須是一次獨(dú)立的CS周期”有硬性要求。所以底層驅(qū)動(dòng)要拆成兩次獨(dú)立操作中間插入CS拉高動(dòng)作其他環(huán)節(jié)保持不變。4.2 MAX31865溫度驅(qū)動(dòng)周期輪詢與字節(jié)拼接MAX31865是一款RTD數(shù)字轉(zhuǎn)換芯片配置寄存器和溫度數(shù)據(jù)寄存器都是8位寬的通信協(xié)議很簡(jiǎn)單。它內(nèi)部有故障檢測(cè)讀數(shù)據(jù)還要順帶檢查故障標(biāo)志位。驅(qū)動(dòng)邏輯按照100ms周期執(zhí)行先寫配置寄存器選擇轉(zhuǎn)換模式再讀兩個(gè)字節(jié)的溫度數(shù)據(jù)寄存器把高低字節(jié)拼成15位數(shù)值然后乘上對(duì)應(yīng)的比例系數(shù)得到電阻值再由查表計(jì)算出PT100溫度。MAX31865對(duì)片選時(shí)序特別敏感CS必須在整次傳輸期間保持低電平中途不能拉高。如果中間不小心釋放了CS芯片的轉(zhuǎn)換流程會(huì)被打斷讀出來可能是全1或者上次的緩存數(shù)據(jù)。所以我把讀溫度封裝成一個(gè)函數(shù)內(nèi)部用rt_spi_take_busrt_spi_take_cs包住保證CS在函數(shù)內(nèi)不變化。代碼片段static uint32_t max31865_read_reg(uint8_t reg) { uint8_t buf[2] {reg, 0x00}; uint8_t recv[2] {0, 0}; struct rt_spi_message msg {0}; msg.send_buf buf; msg.recv_buf recv; msg.length 2; msg.cs_take 1; msg.cs_release 1; rt_spi_transfer_message(max31865_dev, msg); return recv[1]; }這里cs_take和cs_release都置1表示這次傳輸是獨(dú)占CS的?；卣{(diào)函數(shù)里需要注意RT-Thread的xfer操作在每次取CS之后底層驅(qū)動(dòng)要真實(shí)地把GPIO拉低不能只在軟件層面模擬。4.3 SPI屏幕驅(qū)動(dòng)DMA刷新和幀緩沖配合屏幕刷新是性能要求最高的場(chǎng)景。我用的TFT屏是240x320RGB565格式一個(gè)全屏幀緩沖是240 * 320 * 2 153600字節(jié)。每次刷新全屏意味著要往SPI總線上灌15萬字節(jié)如果純靠CPU從SPI數(shù)據(jù)寄存器逐字節(jié)搬運(yùn)按30MHz速率算也要幾十毫秒期間CPU什么都干不了。方案是給SPI2配一個(gè)DMA通道。初始化時(shí)把DMA的源地址設(shè)為屏幕幀緩沖目的地址設(shè)為SPI2的數(shù)據(jù)寄存器地址傳輸方向是內(nèi)存到外設(shè)傳輸完成后觸發(fā)DMA中斷在中斷里釋放一次刷新的信號(hào)量。RT-Thread的設(shè)備模型本身對(duì)DMA友好底層xfer可以判斷消息的send_buf是否非空、recv_buf是否為空如果屬于純發(fā)送方向就往DMA通道上掛任務(wù)dma_config(spi2_dma_tx, (uint32_t)msg-send_buf, (uint32_t)SPI2-DATA, msg-length); dma_start(spi2_dma_tx);注意DMA搬運(yùn)期間SPI總線鎖不能釋放否則另一路SPI操作會(huì)篡改GPIO狀態(tài)。我的處理方式是xfer函數(shù)里等待DMA完成等待期間調(diào)用rt_sem_take掛起當(dāng)前線程DMA中斷里釋放信號(hào)量。這樣鎖的持有時(shí)間被壓縮到最小不會(huì)影響其他SPI設(shè)備的調(diào)度。屏幕刷新還有一個(gè)細(xì)節(jié)是開窗命令。全屏刷新可以不開窗但顯示波形曲線或者局部變化時(shí)必須先發(fā)0x2A和0x2B命令設(shè)置窗口范圍之后只刷新窗口內(nèi)的數(shù)據(jù)。這個(gè)邏輯寫在應(yīng)用層底層驅(qū)動(dòng)不關(guān)心窗口的事。5. 調(diào)試實(shí)錄我踩過的那些SPI坑這一節(jié)是我的實(shí)務(wù)記錄。SPI看起來協(xié)議簡(jiǎn)單實(shí)際聯(lián)調(diào)的問題五花八門波形、時(shí)序、片選、數(shù)據(jù)錯(cuò)位、時(shí)鐘極性問題都可能讓系統(tǒng)措手不及。5.1 波形異常先查時(shí)鐘極性和相位再說屏幕刷新出現(xiàn)花屏第一反應(yīng)不要懷疑屏幕先查SCK波形。用示波器看SCK空閑電平如果是低電平說明當(dāng)前是模式0或模式2如果SCK空閑時(shí)是高電平說明配置成了模式1或模式3。大多數(shù)SPI設(shè)備默認(rèn)模式0也就是CPOL0、CPHA0。如果你的驅(qū)動(dòng)配置成了模式1對(duì)不上數(shù)據(jù)會(huì)全部移位半個(gè)時(shí)鐘周期導(dǎo)致屏幕識(shí)別命令全部錯(cuò)亂。一個(gè)特別容易踩的坑是GD32庫函數(shù)的模式枚舉和RT-Thread的RT_SPI_MODE_0之間的轉(zhuǎn)換。RT-Thread用位標(biāo)來標(biāo)記模式底層驅(qū)動(dòng)在configure回調(diào)里必須正確解析這些位標(biāo)映射到GD32的SPI時(shí)鐘極性寄存器位。我一開始直接用賦值方式把RT_SPI_MODE_0映射成GD32庫函數(shù)的模式值結(jié)果模式3的配置正好反了屏幕出來是倒像查了很久才發(fā)現(xiàn)是映射關(guān)系寫錯(cuò)。5.2 總線鎖死線程掛起消耗排查RT-Thread下最常見的死鎖場(chǎng)景是一個(gè)線程拿了總線鎖在傳輸過程中調(diào)用了會(huì)阻塞的API。比如在xfer函數(shù)內(nèi)部執(zhí)行等待DMA完成的rt_sem_take時(shí)如果信號(hào)量遲遲不釋放而DMA中斷本身因?yàn)閮?yōu)先級(jí)配置問題進(jìn)不來整個(gè)SPI就永久卡住。我的排查方法是給底層xfer函數(shù)加超時(shí)機(jī)制。rt_sem_take有一個(gè)帶超時(shí)的版本rt_sem_take(sem, rt_tick_from_millisecond(100))超時(shí)后返回錯(cuò)誤碼并主動(dòng)釋放總線鎖。這樣即使DMA沒觸發(fā)系統(tǒng)也能恢復(fù)不會(huì)因?yàn)閱未蜸PI異常導(dǎo)致整個(gè)板子死機(jī)。這個(gè)防護(hù)在工控現(xiàn)場(chǎng)至關(guān)重要。另一個(gè)隱藏問題是總線鎖釋放遺漏。如果你在應(yīng)用層用rt_spi_take_bus獲取鎖中途業(yè)務(wù)判斷出錯(cuò)直接return了忘了調(diào)用rt_spi_release_bus那么其他線程會(huì)永久阻塞在這個(gè)設(shè)備上。我的習(xí)慣是使用rt_spi_transfer_message接口因?yàn)樗鼉?nèi)部會(huì)自動(dòng)管理鎖應(yīng)用層不需要也不應(yīng)該手動(dòng)拿鎖。5.3 數(shù)據(jù)錯(cuò)位字節(jié)序與位寬陷阱MAX31865和屏幕上出現(xiàn)“數(shù)值整體偏移一個(gè)字節(jié)”的現(xiàn)象多半是數(shù)據(jù)位寬配置成了16位。GD32的SPI硬件配置成16位模式后哪怕你只發(fā)一個(gè)字節(jié)硬件也會(huì)把寄存器的高8位當(dāng)成第一個(gè)字節(jié)發(fā)送這樣接收端看到的就是0x00有效字節(jié)數(shù)據(jù)整體錯(cuò)位。我的排查流程固定是先讀設(shè)備ID然后用示波器數(shù)一個(gè)字節(jié)的SCK時(shí)鐘個(gè)數(shù)。如果是16個(gè)脈沖說明數(shù)據(jù)位寬設(shè)置錯(cuò)了如果是8個(gè)脈沖但數(shù)據(jù)不對(duì)再查發(fā)送數(shù)據(jù)的字節(jié)序是MSB還是LSB。GD32的SPI默認(rèn)高位在前大部分SPI設(shè)備也都是高位在前但有一小撮傳感器芯片是LSB first如果不注意就會(huì)得到“反過來”的數(shù)據(jù)。下面是實(shí)際項(xiàng)目里最容易碰到的問題速查表現(xiàn)象優(yōu)先排查方向解決方案屏幕花屏/亂碼SCK空閑電平、模式映射確認(rèn)CPOL/CPHA與設(shè)備匹配檢查RT-Thread模式解析溫度讀數(shù)跳變片選時(shí)序、CS拉高時(shí)機(jī)用軟件片選確保傳輸期間CS不變Flash寫失敗寫使能命令獨(dú)立CS周期拆兩次傳輸中間拉高CSSPI設(shè)備找不到設(shè)備掛載名拼寫檢查rt_spi_bus_attach_device的名字參數(shù)DMA數(shù)據(jù)傳輸錯(cuò)位字節(jié)寬度配置、DMA突發(fā)長(zhǎng)度確認(rèn)DMA數(shù)據(jù)寬度為8位突發(fā)長(zhǎng)度設(shè)為1多線程死鎖鎖未釋放、信號(hào)量超時(shí)xfer里加超時(shí)機(jī)制異常路徑自動(dòng)釋放5.4 從波形到執(zhí)行的聯(lián)調(diào)順序最后分享一個(gè)聯(lián)調(diào)順序能幫你少走彎路。每次新板子回來我不會(huì)直接跑RT-Thread應(yīng)用層而是先寫一個(gè)裸機(jī)循環(huán)把SPI初始化好然后對(duì)著示波器量SCK和MOSI的波形確認(rèn)電平、頻率、相位都正確。波形對(duì)了再做第二步用邏輯分析儀看片選時(shí)序確保每次傳輸CS的拉低、拉高時(shí)間符合設(shè)備要求。前兩步都過了才把RT-Thread設(shè)備樹掛起來跑應(yīng)用。這套流程的底層邏輯是分層隔離。如果把RTOS調(diào)度問題、鎖沖突、驅(qū)動(dòng)bug全部混在一起調(diào)輸出就會(huì)是同一個(gè)癥狀可能有幾十個(gè)原因根本無從下手。一步步來每個(gè)環(huán)節(jié)都把問題縮小到一個(gè)可確認(rèn)的范圍內(nèi)調(diào)試效率高很多。關(guān)于SPI這塊我實(shí)際體驗(yàn)下來最值錢的建議是不要過度信任示例代碼一定要用示波器或邏輯分析儀給自己留一份“真實(shí)波形參照”。GD32H759性能強(qiáng)、外設(shè)多跑RT-Thread完全沒有適配壓力但在最高頻的SPI速率先一家一步去摸透底層時(shí)序后面所有應(yīng)用代碼都穩(wěn)了。下一步我準(zhǔn)備在SPI鏈路里把加密和校驗(yàn)也加上給工業(yè)現(xiàn)場(chǎng)的數(shù)據(jù)再上一道保險(xiǎn)。