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