簡(jiǎn)介面向嵌入式開(kāi)發(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)開(kāi)發(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è)備清單上排著掃碼槍、稱(chēng)重模塊、兩路 RS485 傳感器和一路調(diào)試口。改主控意味著重畫(huà)板子、重新過(guò)認(rèn)證工期根本不允許。這種時(shí)候一片 WK2114 就能把問(wèn)題按住它掛在 SPI 上一路 SPI 換出 4 路獨(dú)立 UART每路帶 256 字節(jié)收發(fā) FIFO主控這邊只多占一根片選和一根中斷線(xiàn)。這份驅(qū)動(dòng)處理的正是從 SPI 時(shí)序、寄存器尋址、波特率分頻到中斷分發(fā)、環(huán)形緩沖這一整條鏈路目標(biāo)是讓上層業(yè)務(wù)像用片上串口一樣去用這 4 路通道。它適合板子已定型又要擴(kuò)串口的 STM32F2 項(xiàng)目也適合想搞明白“SPI 轉(zhuǎn)多路 UART”這類(lèi)芯片驅(qū)動(dòng)到底該怎么寫(xiě)的人。2. 硬件與寄存器模型WK2114 在 STM32F2 上的接線(xiàn)和地址空間動(dòng)手寫(xiě)代碼之前先把線(xiàn)接對(duì)、把地址空間想清楚。串口擴(kuò)展芯片的驅(qū)動(dòng)之所以容易翻車(chē)八成問(wèn)題不在 C 代碼里而在 SPI 模式選錯(cuò)、片選時(shí)序不對(duì)、或者壓根沒(méi)搞明白“全局寄存器”和“子串口寄存器”是兩套地址。這一章把硬件連接和寄存器模型拆開(kāi)講后面所有函數(shù)都是圍繞這兩件事轉(zhuǎn)的。2.1 引腳連法與 SPI 模式選擇WK2114 與主控的連線(xiàn)不多但每一根都有講究。下面這張表是 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 的一次寄存器訪(fǎng)問(wèn)是“命令字節(jié) 數(shù)據(jù)字節(jié)”兩個(gè)字節(jié)組成的一個(gè)完整事務(wù)硬件 NSS 在每次寫(xiě)入 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等寄存器讀寫(xiě)全部回讀正確、四路串口都能收發(fā)再逐步提到 68MHz。別一上來(lái)就拉滿(mǎn)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 通道各有一套管波特率、線(xiàn)控格式、FIFO、中斷使能。訪(fǎng)問(wèn)子串口寄存器不能直接給地址必須先往全局的通道選擇寄存器里寫(xiě)一個(gè)位圖把目標(biāo)通道選中然后再訪(fǎng)問(wèn)子串口地址。地址字節(jié)的最高位拿來(lái)做讀寫(xiě)方向低位做寄存器偏移。驅(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)等 */ /* 子串口寄存器需先寫(xiě) WK_GCHS 選中通道 */ #define WK_SBAUD 0x00 /* 波特率分頻高低字節(jié) */ #define WK_SLCR 0x01 /* 線(xiàn)控字長(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 /* 寫(xiě)發(fā)送 FIFO */ #define WK_SRHR 0x06 /* 讀接收 FIFO */ #define WK_SPI_READ 0x80 /* 命令字節(jié)的讀標(biāo)志 */WK_GCHS是一個(gè)位圖寫(xiě)0x01選通道 0寫(xiě)0x08選通道 3也可以一次選中多路但讀 FIFO 時(shí)這么做沒(méi)有意義因?yàn)閿?shù)據(jù)寄存器是共用的地址。WK_SFLR是實(shí)際編碼里最容易被忽略的一個(gè)它同時(shí)告訴你發(fā)送 FIFO 還剩多少空位、接收 FIFO 里堆了多少字節(jié)寫(xiě)發(fā)送邏輯和中斷收數(shù)據(jù)都靠它。提示手冊(cè)上如果給的是“全局寄存器 0x000x0F、子串口寄存器 0x000x0F”這類(lèi)分區(qū)描述用最高位區(qū)分讀寫(xiě)、用通道選擇寄存器切子串口是這類(lèi)芯片通用的做法。地址對(duì)不上時(shí)先拿邏輯分析儀抓一次真實(shí)波形比對(duì)著手冊(cè)猜快得多。2.3 一次寄存器讀寫(xiě)的完整時(shí)序一次寫(xiě)操作是CS 拉低 → 發(fā)命令字節(jié)地址讀寫(xiě)位為 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é)寫(xiě)進(jìn)去的值就變成了另一個(gè)數(shù)——這種 bug 表現(xiàn)出來(lái)是“某些值能寫(xiě)對(duì)、某些值寫(xiě)不對(duì)”非常像玄學(xué)。正確的收尾方式是發(fā)送后輪詢(xún)狀態(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 總線(xiàn)徹底空閑避免 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 # 寄存器讀寫(xiě)、初始化、波特率、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í)只重寫(xiě)這一個(gè)文件wk2114.c一行不動(dòng)。wk2114.c是核心管寄存器讀寫(xiě)、初始化、波特率計(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è)波特率”這兩條。亂序的典型后果是配置寫(xiě)到一半被上電毛刺打斷波特率寄存器處于半寫(xiě)狀態(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 - 開(kāi)子串口中斷 */ 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. 全局中斷使能最后再開(kāi) MCU 側(cè)的 EXTI */ wk_write_global(dev, WK_GIER, 0x0F); /* 四通道全開(kāi) */ wk_port_irq_enable(dev); /* 使能 INT 引腳下降沿中斷 */ return 0; }幾個(gè)參數(shù)值得單獨(dú)說(shuō)。WK_SLCR寫(xiě)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à)第一次讀會(huì)讀到臟數(shù)據(jù)。WK_GIER最后寫(xiě)、而且放在 EXTI 使能之前是為了保證中斷進(jìn)來(lái)的那一刻全局和子串口兩級(jí)的使能都已經(jīng)就位。提示如果板子上有多片 WK2114把wk2114_init()里的dev換成不同實(shí)例挨個(gè)調(diào)一遍就行。片選、SPI 句柄、中斷引腳都放在實(shí)例里初始化邏輯完全復(fù)用。3.3 上電自檢寫(xiě)進(jìn)去的值必須讀得回來(lái)初始化函數(shù)返回 0 不代表芯片真的在工作。SPI 線(xiàn)接反、片選接錯(cuò)腳、芯片沒(méi)焊好這些情況初始化照樣“成功”因?yàn)閷?xiě)操作不會(huì)報(bào)錯(cuò)。所以初始化末尾一定要做一次回讀校驗(yàn)把這個(gè)問(wèn)題在產(chǎn)線(xiàn)或者上電階段就暴露出來(lái)。/* 回讀校驗(yàn)寫(xiě)一個(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è)寄存器基本是讀寫(xiě)自由的配置位寫(xiě)壞了也能還原。特征值用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í)際寫(xiě)入字節(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í)際寫(xiě)入長(zhǎng)度剩下的交給環(huán)形緩沖加發(fā)送中斷續(xù)傳主循環(huán)就不會(huì)被串口拖住。4. 核心代碼拆解寄存器讀寫(xiě)、波特率分頻、FIFO 收發(fā)與中斷分發(fā)這一章是整份驅(qū)動(dòng)的重心。四個(gè)模塊——寄存器訪(fǎng)問(wèn)、波特率、發(fā)送、接收與中斷——每一個(gè)都有容易寫(xiě)錯(cuò)的地方下面逐段拆。4.1 地址打包與寄存器讀寫(xiě)所有訪(fǎng)問(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寫(xiě)操作清 0。wr_data只在寫(xiě)的時(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ì)開(kāi)始丟配置而且是概率性的非常難查。4.2 子串口寄存器尋址與并發(fā)保護(hù)子串口寄存器不是獨(dú)立地址而是“先選通道、再訪(fǎng)問(wèn)”。裸寫(xiě)會(huì)有一個(gè)隱患中斷里正在讀通道 1 的 FIFO主循環(huán)此時(shí)把通道選擇改成了通道 2中斷回來(lái)后繼續(xù)讀讀到的就是通道 2 的數(shù)據(jù)。這類(lèi)串?dāng)?shù)據(jù)的 bug 在現(xiàn)場(chǎng)極難復(fù)現(xiàn)因?yàn)橐『米采蠒r(shí)序。/* 選中通道 - 訪(fǎng)問(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ú)條件開(kāi)中斷 */ 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ú)條件開(kāi)中斷會(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的公式是這類(lèi)芯片最常見(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 而宏里寫(xiě) 11.0592MHz算出來(lái)的分頻值偏高實(shí)際波特率就會(huì)整體偏移表現(xiàn)為“能收到數(shù)據(jù)但全是亂碼”而不是完全收不到。4.4 發(fā)送路徑查剩余空間再寫(xiě) FIFO發(fā)送不能一把梭。FIFO 只有 256 字節(jié)塞不下就得返回實(shí)際寫(xiě)入量由上層續(xù)傳。/* 返回實(shí)際寫(xiě)入的字節(jié)數(shù)0 表示 FIFO 滿(mǎn) */ 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]); /* 寫(xiě)入發(fā)送 FIFO */ } return len; }WK_SFLR的低字節(jié)給的是發(fā)送 FIFO 剩余空位高字節(jié)給的是接收 FIFO 里的字節(jié)數(shù)兩個(gè)方向共用同一個(gè)寄存器讀的時(shí)候按位段拆。這里每次寫(xiě)一個(gè)字節(jié)都走一次完整 SPI 事務(wù)看起來(lái)效率不高但勝在簡(jiǎn)單可靠量大的時(shí)候可以改成“一次拉低 CS 連續(xù)寫(xiě) N 個(gè) STHR”也就是后面二次開(kāi)發(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); /* 寫(xiě)回清標(biāo)志別漏 */ } }gifr讀到0xFF時(shí)直接返回是個(gè)防御性寫(xiě)法正常情況全局標(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)镒畛Ｗ采系膸最?lèi)問(wèn)題。它們有個(gè)共同點(diǎn)代碼編譯通過(guò)、邏輯看著沒(méi)錯(cuò)但現(xiàn)象很迷惑。按“現(xiàn)象 → 原因 → 解決”的順序整理遇到類(lèi)似癥狀可以直接對(duì)號(hào)入座。5.1 SPI 通路類(lèi)讀回全 0xFF 或全 0x00現(xiàn)象自檢函數(shù)永遠(yuǎn)返回 -1讀任何寄存器都是0xFF或者相反永遠(yuǎn)是0x00寫(xiě)進(jìn)去什么讀出來(lái)還是什么。原因讀回0xFF通常是 MISO 懸空或者被上拉從機(jī)根本沒(méi)在驅(qū)動(dòng)這根線(xiàn)常見(jiàn)于片選接錯(cuò)引腳、CS 極性搞反、SPI 模式CPOL/CPHA和芯片要求不一致。讀回0x00且寫(xiě)入無(wú)效多半是 CS 一直沒(méi)拉低事務(wù)壓根沒(méi)發(fā)出去或者 MOSI 和 MISO 接反了——主控在聽(tīng)自己發(fā)出去的東西。解決先拿邏輯分析儀抓 CS、SCLK、MOSI、MISO 四根線(xiàn)看一次事務(wù)里 CS 低電平期間是不是正好 16 個(gè)時(shí)鐘。如果時(shí)鐘數(shù)不對(duì)問(wèn)題在 SPI 配置如果時(shí)鐘對(duì)但 MISO 沒(méi)動(dòng)靜把 SPI 時(shí)鐘降到 100kHz 再試還不動(dòng)就查硬件連接和芯片供電。我一般的排查順序是先降速、再查模式、最后查線(xiàn)三步之內(nèi)基本能定位。5.2 通道串?dāng)_類(lèi)四路數(shù)據(jù)全跑到一個(gè)口上現(xiàn)象四個(gè)通道同時(shí)接設(shè)備通道 0 收到了本該屬于通道 2 的數(shù)據(jù)或者某個(gè)通道間歇性收到空數(shù)據(jù)。單獨(dú)測(cè)一路完全正常四路一起跑就亂。原因子串口寄存器的通道選擇被并發(fā)改寫(xiě)了。典型場(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)。解決把所有“選通道 訪(fǎng)問(wèn)子串口寄存器”的操作整體放進(jìn)臨界區(qū)用保存并恢復(fù) PRIMASK 的方式而不是無(wú)條件開(kāi)關(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宏十有八九是這里寫(xiě)錯(cuò)了。高波特率921600 以上建議把誤差閾值收緊到 1.5%?，F(xiàn)象二接 RS485 收發(fā)器時(shí)前幾個(gè)字節(jié)正常后面開(kāi)始丟或者對(duì)方收到的幀頭對(duì)、幀尾缺。原因方向控制腳切得太早。數(shù)據(jù)寫(xiě)進(jìn)發(fā)送 FIFO 只代表進(jìn)了芯片緩沖不代表已經(jīng)從引腳上移出去了。主控這邊一看wk_write()返回就立刻把 485 方向切回接收最后幾個(gè)字節(jié)就被截?cái)嗔?。解決方向腳不能由寫(xiě)函數(shù)的返回值驅(qū)動(dòng)要等發(fā)送 FIFO 真正空掉。判斷依據(jù)是發(fā)送空中斷或者查詢(xún)WK_SFLR的發(fā)送計(jì)數(shù)歸零再留一個(gè)字節(jié)時(shí)間的余量按波特率算115200 下一個(gè)字節(jié)約 87 微秒才切方向。這個(gè)余量我一般給兩個(gè)字節(jié)時(shí)間寧可慢一點(diǎn)不要丟幀。5.4 中斷類(lèi)進(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)志寫(xiě)回清除最后確認(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)里定期輪詢(xún)一次WK_GIFR如果發(fā)現(xiàn)有標(biāo)志但中斷沒(méi)觸發(fā)說(shuō)明中斷鏈路有問(wèn)題同時(shí)也能保證數(shù)據(jù)不丟。這個(gè)兜底在調(diào)試期很有用量產(chǎn)版本可以留著代價(jià)很小。6. 二次開(kāi)發(fā)把單顆 4 通道做成多片級(jí)聯(lián)和透?jìng)骺蚣軉晤w WK2114 跑通之后往下走通常是兩個(gè)方向通道數(shù)不夠要級(jí)聯(lián)多片或者要把這套東西做成一個(gè)通用的串口透?jìng)骺蚣?。這兩件事的改造量差別很大下面分開(kāi)說(shuō)。多片級(jí)聯(lián)其實(shí)在wk_dev_t這個(gè)結(jié)構(gòu)體設(shè)計(jì)的時(shí)候就已經(jīng)預(yù)留好了。片選、SPI 句柄、INT 引腳全部放在實(shí)例里加一片就是多定義一個(gè)實(shí)例、多接一根片選和一根中斷線(xiàn)。要注意的是中斷線(xiàn)可以共用把兩片的 INT 都接到同一個(gè) EXTI 上中斷里遍歷所有實(shí)例讀一遍WK_GIFR哪個(gè)有標(biāo)志處理哪個(gè)。省引腳代價(jià)是中斷里多幾次 SPI 事務(wù)在 8MHz 時(shí)鐘下完全可接受。改造點(diǎn)工作量收益多片實(shí)例化共用中斷線(xiàn)半天通道數(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 讀是性?xún)r(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ù)開(kāi)銷(xiāo) */ 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ù)第三步是滿(mǎn)負(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í)一定要打開(kāi)丟包和 FIFO 溢出計(jì)數(shù)。數(shù)據(jù)對(duì)不對(duì)肉眼看不出來(lái)計(jì)數(shù)器漲了才是真的有問(wèn)題。從那以后我每次 bring-up 一塊新板子第一件事都是拿邏輯分析儀抓一遍 SPI 波形再寫(xiě)代碼而不是先寫(xiě)代碼再回頭查波形——省下來(lái)的時(shí)間遠(yuǎn)比抓波形那十分鐘多。這套 WK2114 驅(qū)動(dòng)的分層和自檢思路照著改一改也能套到其他 SPI 轉(zhuǎn)多串口的芯片上。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取