簡介面向嵌入式開發(fā)者的WK2114串口擴展驅(qū)動代碼針對STM32F2系列微控制器UART接口數(shù)量不足的常見問題提供將WK2114配置為UART1擴展的輕量實現(xiàn)適用于物聯(lián)網(wǎng)終端、工業(yè)自動化等多串口通信場景。壓縮包共2個文件以C源碼與頭文件為主大小約4KB其中C文件承載芯片初始化、波特率與數(shù)據(jù)格式設(shè)置、控制信號及收發(fā)數(shù)據(jù)等驅(qū)動邏輯頭文件給出函數(shù)原型、常量與結(jié)構(gòu)體聲明便于工程直接集成和模塊調(diào)用。已有1264人學(xué)習(xí)下載。讀者可據(jù)此理解WK2114與STM32F2的串行通信配合方式掌握基于HAL庫或寄存器操作擴展UART的驅(qū)動開發(fā)思路并借助發(fā)送、接收接口及終端測試方法完成聯(lián)調(diào)驗證學(xué)習(xí)多串口系統(tǒng)的初始化配置、數(shù)據(jù)收發(fā)與排錯流程提升嵌入式串行通信設(shè)計的靈活性。1. 一顆 SPI 芯片把 2 路 UART 變成 6 路的現(xiàn)實解法板子已經(jīng)定型主控是 STM32F2串口只引出了兩路可設(shè)備清單上排著掃碼槍、稱重模塊、兩路 RS485 傳感器和一路調(diào)試口。改主控意味著重畫板子、重新過認(rèn)證工期根本不允許。這種時候一片 WK2114 就能把問題按住它掛在 SPI 上一路 SPI 換出 4 路獨立 UART每路帶 256 字節(jié)收發(fā) FIFO主控這邊只多占一根片選和一根中斷線。這份驅(qū)動處理的正是從 SPI 時序、寄存器尋址、波特率分頻到中斷分發(fā)、環(huán)形緩沖這一整條鏈路目標(biāo)是讓上層業(yè)務(wù)像用片上串口一樣去用這 4 路通道。它適合板子已定型又要擴串口的 STM32F2 項目也適合想搞明白“SPI 轉(zhuǎn)多路 UART”這類芯片驅(qū)動到底該怎么寫的人。2. 硬件與寄存器模型WK2114 在 STM32F2 上的接線和地址空間動手寫代碼之前先把線接對、把地址空間想清楚。串口擴展芯片的驅(qū)動之所以容易翻車八成問題不在 C 代碼里而在 SPI 模式選錯、片選時序不對、或者壓根沒搞明白“全局寄存器”和“子串口寄存器”是兩套地址。這一章把硬件連接和寄存器模型拆開講后面所有函數(shù)都是圍繞這兩件事轉(zhuǎn)的。2.1 引腳連法與 SPI 模式選擇WK2114 與主控的連線不多但每一根都有講究。下面這張表是 STM32F2 上最常見的接法具體引腳號按你自己的板子改邏輯關(guān)系不變。WK2114 引腳STM32F2 側(cè)說明SCLKSPI1_SCKSPI 時鐘主機輸出SDIMOSISPI1_MOSI主控發(fā)往芯片SDOMISOSPI1_MISO芯片返回給主控CS#普通 GPIO軟件片選必須軟件控制一次事務(wù)拉低一次INT#GPIO EXTI低電平有效下降沿觸發(fā)RST#普通 GPIO上電復(fù)位低有效VCC / GND3.3V / GND就近放 0.1uF 加 10uF片選一定要用軟件 GPIO不要用 SPI 外設(shè)的硬件 NSS。原因很直接WK2114 的一次寄存器訪問是“命令字節(jié) 數(shù)據(jù)字節(jié)”兩個字節(jié)組成的一個完整事務(wù)硬件 NSS 在每次寫入 DR 之后就可能抬起來中間那個字節(jié)邊界會把事務(wù)切斷表現(xiàn)就是讀出來的值永遠差一位或者干脆是 0xFF。SPI 參數(shù)這塊芯片側(cè)支持的是標(biāo)準(zhǔn)模式實際工程里用 SPI Mode 0CPOL0CPHA0、MSB First、8 位數(shù)據(jù)、軟件片選最穩(wěn)。速率上我一般的做法是調(diào)試階段先壓到 1MHz等寄存器讀寫全部回讀正確、四路串口都能收發(fā)再逐步提到 68MHz。別一上來就拉滿SPI 時鐘太快時 MISO 上的建立時間不夠讀回來的數(shù)據(jù)會呈現(xiàn)“高位對、低位飄”的玄學(xué)現(xiàn)象查起來非常費時間。中斷引腳 INT# 按低電平有效處理配置成下降沿觸發(fā)的外部中斷。要注意這個腳是“電平 事件”混合語義芯片內(nèi)部有未處理的中斷時它會一直保持低所以中斷服務(wù)函數(shù)里必須把源頭的中斷標(biāo)志讀干凈否則退出中斷后引腳還是低的你會看到程序反復(fù)進中斷主循環(huán)一行都跑不動。注意RST# 不要圖省事直接接復(fù)位電路或者上拉省略。芯片上電到內(nèi)部邏輯穩(wěn)定需要時間驅(qū)動里主動拉低再釋放一次能省掉大量“第一次上電偶爾不工作”的問題。2.2 寄存器地址空間全局寄存器和子串口寄存器怎么區(qū)分WK2114 的寄存器分兩級這是整個驅(qū)動的地基。第一級是全局寄存器管整顆芯片的使能、總中斷、通道選擇第二級是子串口寄存器每個 UART 通道各有一套管波特率、線控格式、FIFO、中斷使能。訪問子串口寄存器不能直接給地址必須先往全局的通道選擇寄存器里寫一個位圖把目標(biāo)通道選中然后再訪問子串口地址。地址字節(jié)的最高位拿來做讀寫方向低位做寄存器偏移。驅(qū)動里我用一個頭文件把這件事固定下來手冊上名字不一樣也沒關(guān)系改這一個文件就行/* wk2114_reg.h —— 地址定義集中在這里換批次只改本文件 */ /* 全局寄存器bit7 1 表示讀bit6..0 為偏移 */ #define WK_GENA 0x00 /* 全局使能 */ #define WK_GCHS 0x01 /* 子串口通道選擇位圖 */ #define WK_GIER 0x02 /* 全局中斷使能 */ #define WK_GIFR 0x03 /* 全局中斷標(biāo)志 */ #define WK_GCFG 0x04 /* 全局配置FIFO 觸發(fā)點等 */ /* 子串口寄存器需先寫 WK_GCHS 選中通道 */ #define WK_SBAUD 0x00 /* 波特率分頻高低字節(jié) */ #define WK_SLCR 0x01 /* 線控字長/停止位/校驗 */ #define WK_SFCR 0x02 /* FIFO 控制清空/使能 */ #define WK_SIER 0x03 /* 子串口中斷使能 */ #define WK_SIFR 0x04 /* 子串口中斷標(biāo)志 */ #define WK_SFLR 0x05 /* FIFO 計數(shù)發(fā)送剩余 / 接收可用 */ #define WK_STHR 0x06 /* 寫發(fā)送 FIFO */ #define WK_SRHR 0x06 /* 讀接收 FIFO */ #define WK_SPI_READ 0x80 /* 命令字節(jié)的讀標(biāo)志 */WK_GCHS是一個位圖寫0x01選通道 0寫0x08選通道 3也可以一次選中多路但讀 FIFO 時這么做沒有意義因為數(shù)據(jù)寄存器是共用的地址。WK_SFLR是實際編碼里最容易被忽略的一個它同時告訴你發(fā)送 FIFO 還剩多少空位、接收 FIFO 里堆了多少字節(jié)寫發(fā)送邏輯和中斷收數(shù)據(jù)都靠它。提示手冊上如果給的是“全局寄存器 0x000x0F、子串口寄存器 0x000x0F”這類分區(qū)描述用最高位區(qū)分讀寫、用通道選擇寄存器切子串口是這類芯片通用的做法。地址對不上時先拿邏輯分析儀抓一次真實波形比對著手冊猜快得多。2.3 一次寄存器讀寫的完整時序一次寫操作是CS 拉低 → 發(fā)命令字節(jié)地址讀寫位為 0→ 發(fā)數(shù)據(jù)字節(jié) → 等 SPI 完全發(fā)送完成 → CS 拉高。一次讀操作是CS 拉低 → 發(fā)命令字節(jié)地址或上 0x80→ 發(fā)一個啞字節(jié) 0x00 換回數(shù)據(jù) → 等完成 → CS 拉高。這里有個很關(guān)鍵的細節(jié)CS 拉高之前必須確認(rèn) SPI 移位寄存器已經(jīng)把最后一個 bit 移出去了。STM32 HAL 里HAL_SPI_Transmit返回只代表數(shù)據(jù)進了 DR、傳到了移位寄存器不代表時鐘已經(jīng)打完。如果你緊接著就拉高 CS最后那一位會被截斷芯片收到的是一個殘缺字節(jié)寫進去的值就變成了另一個數(shù)——這種 bug 表現(xiàn)出來是“某些值能寫對、某些值寫不對”非常像玄學(xué)。正確的收尾方式是發(fā)送后輪詢狀態(tài)寄存器等 BSY 清零再動 CSstatic void wk_cs_low(wk_dev_t *dev) { HAL_GPIO_WritePin(dev-cs_port, dev-cs_pin, GPIO_PIN_RESET); } static void wk_cs_high(wk_dev_t *dev) { HAL_GPIO_WritePin(dev-cs_port, dev-cs_pin, GPIO_PIN_SET); } /* 等待 SPI 總線徹底空閑避免 CS 提前拉高截斷最后一個 bit */ static void wk_spi_wait_idle(wk_dev_t *dev) { while (__HAL_SPI_GET_FLAG(dev-hspi, SPI_FLAG_BSY) ! RESET) { /* 空轉(zhuǎn)通常幾微秒內(nèi)結(jié)束 */ } }dev-hspi是掛在 SPI1 上的句柄cs_port/cs_pin是軟件片選。把這兩個東西收進一個設(shè)備結(jié)構(gòu)體是為了后面支持多片級聯(lián)——兩片 WK2114 就是兩個wk_dev_t實例代碼一份都不用改。3. 驅(qū)動分層與上電初始化從目錄結(jié)構(gòu)到 4 個通道全部打通驅(qū)動能不能被別人接手一半看分層。全塞進一個.c里也能跑但只要換塊板子、換個 SPI 外設(shè)或者要加第二片芯片就得從頭改一遍。所以這份源碼按“移植層 / 核心層 / 應(yīng)用層”三層來切初始化流程也按這個順序排。3.1 目錄結(jié)構(gòu)與每層的職責(zé)邊界bsp/ wk2114/ wk2114_reg.h # 寄存器地址與位定義換批次只改這里 wk2114.h # 設(shè)備結(jié)構(gòu)體、對外 API wk2114_port.c # SPI 收發(fā)、片選、復(fù)位、延時的具體實現(xiàn) wk2114.c # 寄存器讀寫、初始化、波特率、FIFO 收發(fā) wk2114_irq.c # INT 引腳中斷入口與四通道分發(fā) app/ serial/ serial_ring.c # 每通道一個環(huán)形緩沖收發(fā)各一份 serial_ring.h serial_api.c # open/read/write/ioctl 風(fēng)格的上層接口wk2114_port.c只認(rèn)兩樣?xùn)|西一個 SPI 句柄和一組 GPIO。它對外只暴露wk_port_spi_xfer()、wk_port_reset()、wk_port_delay_us()這幾個函數(shù)核心層完全不出現(xiàn)HAL_前綴。這樣做的直接好處是換到別的 MCU 平臺時只重寫這一個文件wk2114.c一行不動。wk2114.c是核心管寄存器讀寫、初始化、波特率計算、FIFO 收發(fā)。它不知道環(huán)形緩沖的存在也不關(guān)心中斷是怎么進來的只提供“把這段數(shù)據(jù)塞進某個通道”和“從某個通道取一段數(shù)據(jù)”的能力。wk2114_irq.c是中斷分發(fā)把 INT 引腳的一次下降沿翻譯成“通道 N 有數(shù)據(jù)可讀”或者“通道 N 發(fā)送 FIFO 空了”再回調(diào)到應(yīng)用層。這三層的邊界清楚后面加功能才不會互相踩。3.2 上電初始化序列初始化順序不能亂尤其是“先復(fù)位再配置、先關(guān)中斷再設(shè)波特率”這兩條。亂序的典型后果是配置寫到一半被上電毛刺打斷波特率寄存器處于半寫狀態(tài)串口出來的是亂碼而你還以為是分頻算錯了。int wk2114_init(wk_dev_t *dev) { /* 1. 硬復(fù)位RST 拉低至少 1ms釋放后再等 5ms 讓內(nèi)部邏輯穩(wěn)定 */ wk_port_reset(dev); wk_port_delay_us(1000); wk_cs_high(dev); wk_port_delay_us(5000); /* 2. 全局軟復(fù)位 使能先關(guān)掉所有中斷再干活 */ wk_write_global(dev, WK_GIER, 0x00); wk_write_global(dev, WK_GENA, 0x01); /* 3. 逐通道配置關(guān)子串口中斷 - 設(shè)波特率 - 8N1 - 清 FIFO - 開子串口中斷 */ for (uint8_t ch 0; ch WK_CH_NUM; ch) { wk_write_sub(dev, ch, WK_SIER, 0x00); if (wk_set_baud(dev, ch, 115200) ! 0) { return -2; /* 分頻誤差過大直接報錯 */ } wk_write_sub(dev, ch, WK_SLCR, 0x03); /* 8 數(shù)據(jù)位1 停止位無校驗 */ wk_write_sub(dev, ch, WK_SFCR, 0x07); /* 清收發(fā) FIFO使能 FIFO */ wk_write_sub(dev, ch, WK_SIER, WK_IRQ_RX | WK_IRQ_TX_EMPTY); } /* 4. 全局中斷使能最后再開 MCU 側(cè)的 EXTI */ wk_write_global(dev, WK_GIER, 0x0F); /* 四通道全開 */ wk_port_irq_enable(dev); /* 使能 INT 引腳下降沿中斷 */ return 0; }幾個參數(shù)值得單獨說。WK_SLCR寫0x03對應(yīng) 8N1如果要 7 位數(shù)據(jù)加偶校驗改這一字節(jié)就行不用動別的邏輯。WK_SFCR的0x07是“清發(fā)送 FIFO 清接收 FIFO 使能 FIFO”的組合位初始化時清一次很有必要因為芯片復(fù)位后 FIFO 里可能有殘留的隨機值不清的話第一次讀會讀到臟數(shù)據(jù)。WK_GIER最后寫、而且放在 EXTI 使能之前是為了保證中斷進來的那一刻全局和子串口兩級的使能都已經(jīng)就位。提示如果板子上有多片 WK2114把wk2114_init()里的dev換成不同實例挨個調(diào)一遍就行。片選、SPI 句柄、中斷引腳都放在實例里初始化邏輯完全復(fù)用。3.3 上電自檢寫進去的值必須讀得回來初始化函數(shù)返回 0 不代表芯片真的在工作。SPI 線接反、片選接錯腳、芯片沒焊好這些情況初始化照樣“成功”因為寫操作不會報錯。所以初始化末尾一定要做一次回讀校驗把這個問題在產(chǎn)線或者上電階段就暴露出來。/* 回讀校驗寫一個特征值到全局配置寄存器再讀回來比對 */ int wk2114_self_test(wk_dev_t *dev) { uint8_t old wk_read_global(dev, WK_GCFG); wk_write_global(dev, WK_GCFG, 0x5A); if (wk_read_global(dev, WK_GCFG) ! 0x5A) { return -1; /* SPI 通路不通或芯片未就緒 */ } wk_write_global(dev, WK_GCFG, old); /* 還原避免影響原有配置 */ return 0; }WK_GCFG選它做自檢是因為這個寄存器基本是讀寫自由的配置位寫壞了也能還原。特征值用0x5A而不是0xFF或0x00是為了區(qū)分“讀到全 0”和“讀到全 1”這兩種典型故障——前者通常是 MISO 沒接或者從機沒響應(yīng)后者多半是 MISO 被上拉、SPI 模式不匹配。這兩種情況在排查章節(jié)里還會細說。3.4 上層接口長什么樣應(yīng)用層不該看到寄存器。serial_api.c里給每個通道包一層接近 POSIX 的接口業(yè)務(wù)代碼最后看到的是這樣接口參數(shù)說明serial_open通道號、波特率、模式返回句柄內(nèi)部完成通道配置serial_write句柄、緩沖區(qū)、長度非阻塞返回實際寫入字節(jié)數(shù)serial_read句柄、緩沖區(qū)、長度、超時從環(huán)形緩沖取取不到就等serial_ioctl句柄、命令、參數(shù)改波特率、清緩沖、查丟包計數(shù)serial_write設(shè)計成非阻塞是有意為之WK2114 每個通道的發(fā)送 FIFO 只有 256 字節(jié)業(yè)務(wù)側(cè)來一包 1KB 的數(shù)據(jù)一次根本塞不進去。返回實際寫入長度剩下的交給環(huán)形緩沖加發(fā)送中斷續(xù)傳主循環(huán)就不會被串口拖住。4. 核心代碼拆解寄存器讀寫、波特率分頻、FIFO 收發(fā)與中斷分發(fā)這一章是整份驅(qū)動的重心。四個模塊——寄存器訪問、波特率、發(fā)送、接收與中斷——每一個都有容易寫錯的地方下面逐段拆。4.1 地址打包與寄存器讀寫所有訪問最終都會收斂到兩個函數(shù)上。把“命令字節(jié) 數(shù)據(jù)字節(jié)”這個事務(wù)封死在里面上層就不用關(guān)心 CS 什么時候拉高拉低。/* 單次寄存器事務(wù)cmd 為地址讀操作時或上 WK_SPI_READ返回讀到的字節(jié) */ static uint8_t wk_xfer8(wk_dev_t *dev, uint8_t cmd, uint8_t wr_data, bool is_read) { uint8_t rx 0; wk_cs_low(dev); wk_port_spi_xfer(dev, cmd, NULL, 1); /* 先發(fā)命令字節(jié) */ if (is_read) { uint8_t dummy 0x00; wk_port_spi_xfer(dev, dummy, rx, 1); /* 啞字節(jié)換數(shù)據(jù) */ } else { wk_port_spi_xfer(dev, wr_data, NULL, 1); /* 直接發(fā)數(shù)據(jù) */ } wk_spi_wait_idle(dev); /* 等 BSY 清零再抬 CS */ wk_cs_high(dev); return rx; } uint8_t wk_read_global(wk_dev_t *dev, uint8_t reg) { return wk_xfer8(dev, reg | WK_SPI_READ, 0, true); } void wk_write_global(wk_dev_t *dev, uint8_t reg, uint8_t v) { wk_xfer8(dev, reg ~WK_SPI_READ, v, false); }cmd是地址字節(jié)讀操作把最高位置 1寫操作清 0。wr_data只在寫的時候有意義讀的時候傳 0 即可。is_read決定第二個字節(jié)是“發(fā)啞字節(jié)收數(shù)據(jù)”還是“直接發(fā)數(shù)據(jù)”。這里必須強調(diào)wk_spi_wait_idle()的位置它一定在wk_cs_high()之前。省略這一句在 1MHz 時鐘下可能看不出問題一旦提到 6MHz 就會開始丟配置而且是概率性的非常難查。4.2 子串口寄存器尋址與并發(fā)保護子串口寄存器不是獨立地址而是“先選通道、再訪問”。裸寫會有一個隱患中斷里正在讀通道 1 的 FIFO主循環(huán)此時把通道選擇改成了通道 2中斷回來后繼續(xù)讀讀到的就是通道 2 的數(shù)據(jù)。這類串?dāng)?shù)據(jù)的 bug 在現(xiàn)場極難復(fù)現(xiàn)因為要恰好撞上時序。/* 選中通道 - 訪問子串口寄存器整段必須原子 */ uint8_t wk_read_sub(wk_dev_t *dev, uint8_t ch, uint8_t reg) { uint8_t v; uint32_t primask __get_PRIMASK(); __disable_irq(); /* 關(guān)總中斷防通道選擇被搶改 */ wk_write_global(dev, WK_GCHS, (uint8_t)(1u ch)); v wk_xfer8(dev, reg | WK_SPI_READ, 0, true); __set_PRIMASK(primask); /* 恢復(fù)原中斷狀態(tài)別無條件開中斷 */ return v; }關(guān)中斷的粒度要控制在“一次寄存器事務(wù)”這個級別不能把整個初始化循環(huán)都包進去否則會明顯拉長中斷響應(yīng)延遲。用__get_PRIMASK()保存現(xiàn)場、__set_PRIMASK()恢復(fù)而不是簡單粗暴地__enable_irq()是因為這個函數(shù)可能在已經(jīng)關(guān)中斷的上下文里被調(diào)用無條件開中斷會把外層的臨界區(qū)破壞掉。如果項目跑的是 RTOS這里換成互斥量加短臨界區(qū)也可以但臨界區(qū)那一段不能省——互斥量擋得住任務(wù)擋不住中斷。4.3 波特率分頻計算與誤差判斷波特率算錯是亂碼的頭號原因而且它往往不是“算錯”是“時鐘源和代碼里假設(shè)的不一致”。WK2114 一般外掛晶振驅(qū)動里必須有一個宏和實際焊接的晶振對上。#define WK_CLK_HZ 11059200u /* 必須與板上晶振一致改板子記得改這里 */ /* 返回 0 成功-1 表示該波特率下誤差超過 2% */ int wk_set_baud(wk_dev_t *dev, uint8_t ch, uint32_t baud) { /* 常見分頻關(guān)系div fclk / (baud * 16)加半個除數(shù)做四舍五入 */ uint32_t div (WK_CLK_HZ baud * 8u) / (baud * 16u); if (div 0 || div 0xFFFFu) { return -1; } /* 反算實際波特率評估誤差 */ uint32_t real_baud WK_CLK_HZ / (div * 16u); int32_t err_ppm (int32_t)((real_baud baud) ? ((real_baud - baud) * 1000000u / baud) : ((baud - real_baud) * 1000000u / baud)); if (err_ppm 20000) { /* 2% 以上長幀一定會出錯 */ return -1; } wk_write_sub(dev, ch, WK_SBAUD, (uint8_t)(div 0xFF)); /* 低字節(jié) */ wk_write_sub(dev, ch, WK_SBAUD 1, (uint8_t)((div 8) 0xFF)); /* 高字節(jié) */ return 0; }div的公式是這類芯片最常見的fclk / (baud × 16)形式16 是內(nèi)部過采樣倍數(shù)。四舍五入那半個除數(shù)baud * 8別省省掉之后在 921600 這種高波特率下誤差會被放大。誤差判斷設(shè)成 2%20000 ppm是個工程經(jīng)驗值串口一幀 10 位累計相位偏差超過半個位寬就會采錯2% 在 10 位幀上剛好是安全邊界附近再大就危險。如果驅(qū)動跑起來波特率明顯不對但公式看著沒錯第一件事是確認(rèn)晶振實際頻率。板上焊的是 12MHz 而宏里寫 11.0592MHz算出來的分頻值偏高實際波特率就會整體偏移表現(xiàn)為“能收到數(shù)據(jù)但全是亂碼”而不是完全收不到。4.4 發(fā)送路徑查剩余空間再寫 FIFO發(fā)送不能一把梭。FIFO 只有 256 字節(jié)塞不下就得返回實際寫入量由上層續(xù)傳。/* 返回實際寫入的字節(jié)數(shù)0 表示 FIFO 滿 */ uint16_t wk_write(wk_dev_t *dev, uint8_t ch, const uint8_t *buf, uint16_t len) { uint8_t free_cnt wk_read_sub(dev, ch, WK_SFLR); /* 低 8 位為發(fā)送剩余空間 */ if (free_cnt 0) { return 0; } if (len free_cnt) { len free_cnt; } for (uint16_t i 0; i len; i) { wk_write_sub(dev, ch, WK_STHR, buf[i]); /* 寫入發(fā)送 FIFO */ } return len; }WK_SFLR的低字節(jié)給的是發(fā)送 FIFO 剩余空位高字節(jié)給的是接收 FIFO 里的字節(jié)數(shù)兩個方向共用同一個寄存器讀的時候按位段拆。這里每次寫一個字節(jié)都走一次完整 SPI 事務(wù)看起來效率不高但勝在簡單可靠量大的時候可以改成“一次拉低 CS 連續(xù)寫 N 個 STHR”也就是后面二次開發(fā)里說的 burst 優(yōu)化。4.5 中斷分發(fā)從 INT 引腳到具體通道的完整鏈路中斷這條鏈路是兩級INT 引腳拉低 → 讀全局中斷標(biāo)志 → 定位到具體通道 → 讀該通道的中斷標(biāo)志 → 處理 → 清標(biāo)志。少清一級引腳就一直保持低電平程序會卡在中斷里出不來。void wk2114_irq_handler(wk_dev_t *dev) { uint8_t gifr wk_read_global(dev, WK_GIFR); /* 第一級哪幾個通道有中斷 */ if (gifr 0x00 || gifr 0xFF) { return; /* 全 0 無中斷全 1 多半是 SPI 異常 */ } for (uint8_t ch 0; ch WK_CH_NUM; ch) { if ((gifr (1u ch)) 0) { continue; } uint8_t sifr wk_read_sub(dev, ch, WK_SIFR); /* 第二級通道內(nèi)什么事件 */ if (sifr WK_IRQ_RX) { uint8_t cnt wk_read_sub(dev, ch, WK_SFLR 1); /* 高字節(jié) 可讀字節(jié)數(shù) */ while (cnt--) { uint8_t b wk_read_sub(dev, ch, WK_SRHR); serial_ring_push(dev, ch, b); /* 進環(huán)形緩沖中斷里不做業(yè)務(wù) */ } } if (sifr WK_IRQ_TX_EMPTY) { serial_ring_on_tx_ready(dev, ch); /* 通知上層可以續(xù)傳了 */ } wk_write_sub(dev, ch, WK_SIFR, sifr); /* 寫回清標(biāo)志別漏 */ } }gifr讀到0xFF時直接返回是個防御性寫法正常情況全局標(biāo)志不會全為 1出現(xiàn)這個值大概率是 SPI 讀到了懸空電平繼續(xù)往下走會把隨機數(shù)據(jù)當(dāng)成真實中斷處理反而更亂。接收這部分一定要“一次讀空”。芯片的中斷是邊沿加電平的組合如果這次只讀了幾個字節(jié)就退出FIFO 里還有貨但引腳已經(jīng)因為標(biāo)志被清而抬高了下一批數(shù)據(jù)進來之前你不會再收到中斷表現(xiàn)就是“偶爾丟一串?dāng)?shù)據(jù)”。用WK_SFLR的高字節(jié)拿到可讀數(shù)量循環(huán)讀干凈是最穩(wěn)的做法。中斷里只做搬數(shù)據(jù)不做協(xié)議解析、不做打印、不發(fā)信號量之外的任何耗時動作。業(yè)務(wù)邏輯全部放在任務(wù)或者主循環(huán)里從環(huán)形緩沖取這是保證高波特率下不丟包的前提。5. 避坑與排查SPI 讀回 0xFF、串口亂碼和多通道串?dāng)?shù)據(jù)的現(xiàn)場處置這一章記錄的是實際調(diào)試?yán)镒畛Ｗ采系膸最悊栴}。它們有個共同點代碼編譯通過、邏輯看著沒錯但現(xiàn)象很迷惑。按“現(xiàn)象 → 原因 → 解決”的順序整理遇到類似癥狀可以直接對號入座。5.1 SPI 通路類讀回全 0xFF 或全 0x00現(xiàn)象自檢函數(shù)永遠返回 -1讀任何寄存器都是0xFF或者相反永遠是0x00寫進去什么讀出來還是什么。原因讀回0xFF通常是 MISO 懸空或者被上拉從機根本沒在驅(qū)動這根線常見于片選接錯引腳、CS 極性搞反、SPI 模式CPOL/CPHA和芯片要求不一致。讀回0x00且寫入無效多半是 CS 一直沒拉低事務(wù)壓根沒發(fā)出去或者 MOSI 和 MISO 接反了——主控在聽自己發(fā)出去的東西。解決先拿邏輯分析儀抓 CS、SCLK、MOSI、MISO 四根線看一次事務(wù)里 CS 低電平期間是不是正好 16 個時鐘。如果時鐘數(shù)不對問題在 SPI 配置如果時鐘對但 MISO 沒動靜把 SPI 時鐘降到 100kHz 再試還不動就查硬件連接和芯片供電。我一般的排查順序是先降速、再查模式、最后查線三步之內(nèi)基本能定位。5.2 通道串?dāng)_類四路數(shù)據(jù)全跑到一個口上現(xiàn)象四個通道同時接設(shè)備通道 0 收到了本該屬于通道 2 的數(shù)據(jù)或者某個通道間歇性收到空數(shù)據(jù)。單獨測一路完全正常四路一起跑就亂。原因子串口寄存器的通道選擇被并發(fā)改寫了。典型場景是中斷里正在讀通道 1 的 FIFO主循環(huán)此時調(diào)用了另一個通道的發(fā)送函數(shù)中間把WK_GCHS改掉了中斷回來繼續(xù)按原來的地址讀讀到的就是別的通道。這個問題在單通道測試時永遠不會出現(xiàn)。解決把所有“選通道 訪問子串口寄存器”的操作整體放進臨界區(qū)用保存并恢復(fù) PRIMASK 的方式而不是無條件開關(guān)中斷。如果用了 RTOS臨界區(qū)之外再加一層互斥量擋住任務(wù)級并發(fā)。改完之后建議做一次壓力測試四個通道同時以最高波特率對發(fā)跑半小時看有沒有串?dāng)?shù)據(jù)這個測試能把九成并發(fā)問題逼出來。5.3 波特率與物理層亂碼、丟字節(jié)、RS485 切不過來現(xiàn)象一數(shù)據(jù)能收到但全是亂碼換幾個波特率都一樣。原因分頻公式里的時鐘頻率和板上實際晶振對不上或者誤差超過 2% 卻沒被判斷邏輯攔住。也有一種情況是上位機自己的波特率就不準(zhǔn)兩邊都有偏差疊加起來超了容限。解決先用回環(huán)把芯片自己的 TX 和 RX 短接自發(fā)自收排除對端因素。然后用示波器量一個字節(jié)的位寬反算實際波特率和設(shè)定值對比。偏差超過 2% 就回去查WK_CLK_HZ宏十有八九是這里寫錯了。高波特率921600 以上建議把誤差閾值收緊到 1.5%?，F(xiàn)象二接 RS485 收發(fā)器時前幾個字節(jié)正常后面開始丟或者對方收到的幀頭對、幀尾缺。原因方向控制腳切得太早。數(shù)據(jù)寫進發(fā)送 FIFO 只代表進了芯片緩沖不代表已經(jīng)從引腳上移出去了。主控這邊一看wk_write()返回就立刻把 485 方向切回接收最后幾個字節(jié)就被截斷了。解決方向腳不能由寫函數(shù)的返回值驅(qū)動要等發(fā)送 FIFO 真正空掉。判斷依據(jù)是發(fā)送空中斷或者查詢WK_SFLR的發(fā)送計數(shù)歸零再留一個字節(jié)時間的余量按波特率算115200 下一個字節(jié)約 87 微秒才切方向。這個余量我一般給兩個字節(jié)時間寧可慢一點不要丟幀。5.4 中斷類進一次就出不來或者干脆不進現(xiàn)象一程序卡在中斷里出不來主循環(huán)完全沒機會跑。原因中斷標(biāo)志沒清干凈。INT 引腳是電平語義只要芯片內(nèi)部還有未處理的中斷源引腳就一直是低。如果只清了子串口標(biāo)志沒清全局標(biāo)志或者只處理了接收沒處理發(fā)送空中斷引腳就會一直拉著中斷反復(fù)觸發(fā)。解決進中斷后先把全局標(biāo)志讀出來存著按位逐個通道處理每個通道處理完把子串口標(biāo)志寫回清除最后確認(rèn)全局標(biāo)志也清了。調(diào)試階段可以在中斷入口翻轉(zhuǎn)一個空閑 GPIO用示波器看翻轉(zhuǎn)頻率正常應(yīng)該是和數(shù)據(jù)量相關(guān)的稀疏脈沖如果是持續(xù)的方波就說明在死循環(huán)觸發(fā)?，F(xiàn)象二數(shù)據(jù)明明進來了中斷一次都不進。原因EXTI 沒使能、NVIC 優(yōu)先級配置漏了、或者全局中斷使能寄存器在初始化最后被別的配置覆蓋了。還有一種隱蔽情況INT 引腳配置成了上拉輸入但沒配 EXTI 模式讀電平是對的就是不會觸發(fā)中斷。解決先在中斷服務(wù)函數(shù)第一行翻轉(zhuǎn) GPIO確認(rèn)到底進沒進沒進就去查 EXTI 的 IMR/EMR 寄存器和 NVIC 使能位。軟件層面還可以加一個兜底主循環(huán)里定期輪詢一次WK_GIFR如果發(fā)現(xiàn)有標(biāo)志但中斷沒觸發(fā)說明中斷鏈路有問題同時也能保證數(shù)據(jù)不丟。這個兜底在調(diào)試期很有用量產(chǎn)版本可以留著代價很小。6. 二次開發(fā)把單顆 4 通道做成多片級聯(lián)和透傳框架單顆 WK2114 跑通之后往下走通常是兩個方向通道數(shù)不夠要級聯(lián)多片或者要把這套東西做成一個通用的串口透傳框架。這兩件事的改造量差別很大下面分開說。多片級聯(lián)其實在wk_dev_t這個結(jié)構(gòu)體設(shè)計的時候就已經(jīng)預(yù)留好了。片選、SPI 句柄、INT 引腳全部放在實例里加一片就是多定義一個實例、多接一根片選和一根中斷線。要注意的是中斷線可以共用把兩片的 INT 都接到同一個 EXTI 上中斷里遍歷所有實例讀一遍WK_GIFR哪個有標(biāo)志處理哪個。省引腳代價是中斷里多幾次 SPI 事務(wù)在 8MHz 時鐘下完全可接受。改造點工作量收益多片實例化共用中斷線半天通道數(shù)按 4 的倍數(shù)擴代碼零復(fù)制寄存器 burst 讀一次 CS 讀空 FIFO一天中斷里 SPI 事務(wù)數(shù)降到 1/N高波特率下明顯每通道獨立環(huán)形緩沖 狀態(tài)機兩天支持不定長幀、超時斷幀、半雙工切換丟包與溢出計數(shù)上報兩小時現(xiàn)場問題可量化不用靠猜burst 讀是性價比最高的一項?，F(xiàn)在的實現(xiàn)是每讀一個字節(jié)都走一次完整事務(wù)CS 拉低拉高一次、兩個字節(jié)的 SPI 時間。改成“命令字節(jié)發(fā)出后保持 CS 低連續(xù)讀 N 個字節(jié)”N 等于 FIFO 里的字節(jié)數(shù)事務(wù)數(shù)從 N 降到 1。在 921600 波特率、四通道同時收數(shù)據(jù)的場景下這個改動能把中斷占用時間壓掉一大截。/* burst 讀一次 CS 內(nèi)把接收 FIFO 讀空減少事務(wù)開銷 */ uint16_t wk_read_burst(wk_dev_t *dev, uint8_t ch, uint8_t *buf, uint16_t max_len) { uint32_t primask __get_PRIMASK(); __disable_irq(); wk_write_global(dev, WK_GCHS, (uint8_t)(1u ch)); uint8_t cnt wk_read_sub_nolock(dev, ch, WK_SFLR 1); /* 已持鎖用不加鎖版本 */ if (cnt max_len) { cnt (uint8_t)max_len; } if (cnt) { uint8_t cmd WK_SRHR | WK_SPI_READ; wk_cs_low(dev); wk_port_spi_xfer(dev, cmd, NULL, 1); wk_port_spi_xfer(dev, NULL, buf, cnt); /* 連續(xù)讀回 cnt 個字節(jié) */ wk_spi_wait_idle(dev); wk_cs_high(dev); } __set_PRIMASK(primask); return cnt; }這里有個細節(jié)wk_read_sub_nolock()是不加鎖的版本因為外層已經(jīng)關(guān)了中斷再嵌套一次保存恢復(fù)雖然不會出錯但會讓代碼讀起來很繞。工程上的慣例是把“帶鎖”和“不帶鎖”兩個版本都提供出來帶鎖版本調(diào)不帶鎖版本調(diào)用方自己判斷上下文。max_len是調(diào)用方緩沖區(qū)的容量cnt取兩者較小值避免溢出。透傳框架的做法是每通道掛一個狀態(tài)機加兩個環(huán)形緩沖收方向在中斷里只管推數(shù)據(jù)主循環(huán)里按幀超時斷幀斷完把整幀交給業(yè)務(wù)回調(diào)發(fā)方向維護一個待發(fā)隊列發(fā)送空中斷觸發(fā)后續(xù)傳。這套結(jié)構(gòu)跑起來之后業(yè)務(wù)層完全不用碰 WK2114 的任何寄存器換芯片、加通道都不影響上層。驗證方法我一般分三步走。第一步是芯片級回環(huán)把某個通道的 TX 和 RX 短接自發(fā)自收一萬字節(jié)比對內(nèi)容第二步是板級對拷兩個通道互連一個發(fā)一個收跑一小時看丟包計數(shù)第三步是滿負荷壓測四通道同時以最高波特率對發(fā)同時用示波器看 INT 引腳和 SPI 時鐘確認(rèn)中斷響應(yīng)沒有明顯抖動。三步都過這套驅(qū)動才敢往現(xiàn)場放。注意壓測時一定要打開丟包和 FIFO 溢出計數(shù)。數(shù)據(jù)對不對肉眼看不出來計數(shù)器漲了才是真的有問題。從那以后我每次 bring-up 一塊新板子第一件事都是拿邏輯分析儀抓一遍 SPI 波形再寫代碼而不是先寫代碼再回頭查波形——省下來的時間遠比抓波形那十分鐘多。這套 WK2114 驅(qū)動的分層和自檢思路照著改一改也能套到其他 SPI 轉(zhuǎn)多串口的芯片上。希望幫到你。本文還有配套的精品資源點擊獲取