STM32F2多串口扩展:WK2114驱动实现与避坑指南

简介:这份资源面向嵌入式开发工程师与STM32学习者,提供WK2114串口扩展芯片的驱动实现,用于解决STM32F2系列微控制器UART接口不足、难以同时与多个外设进行串行通信的问题,适用于物联网设备、工业自动化等需要多路串口通信的场景。压缩包共2个文件,包含1个c源文件与1个h头文件,整体约4KB,其中源文件负责WK2114的初始化、波特率与数据格式设置、控制信号及收发数据等函数实现,头文件则定义函数原型、常量与结构体,便于其他模块调用与编译。目前已有1263人学习下载。通过该驱动,读者可掌握WK2114芯片与STM32F2 UART1的配合方式、HAL库或寄存器操作思路,以及串口扩展的测试与调试方法,为多串口嵌入式项目提供可直接复用的代码基础。

1. 从一颗冷门串口芯片说起:WK2114 到底能解决什么问题

去年帮一个做工业网关的朋友调板子,STM32F207 上已经挂了 4 路 UART,结果项目临时要接 8 个 RS232 传感器,主控的串口资源直接见底。换 MCU 不现实,软件模拟串口又扛不住 115200 的稳定收发。最后选了一颗 WK2114 串口拓展芯片,一颗 SPI 挂上去,硬生生多出 4 路独立 UART,问题当场解决。这份资源就是围绕 WK2114 在 STM32F2 平台上的驱动实现,包含寄存器操作、SPI 通信封装、中断收发和环形缓冲区管理。适合正在做多串口扩展、工业采集、嵌入式网关的开发者,尤其是主控串口不够用又不想换方案的人。它不是什么通用库,而是一份能直接嵌进你工程里的驱动代码,改改引脚和 SPI 句柄就能跑。

2. 芯片与平台选型:WK2114 凭什么挂在 STM32F2 上

2.1 WK2114 的定位与关键特性

WK2114 是一颗四通道 UART 扩展芯片,通过 SPI 或并口与主控通信。它内部集成了 4 个独立的 UART 控制器,每个通道都有独立的波特率发生器、收发 FIFO 和中断控制。对主控来说,它就是一个 SPI 从设备,你往对应寄存器写数据,它帮你把串口时序全部搞定。

关键特性直接决定驱动怎么写:

  • 通信接口:SPI 从模式,最高时钟支持到 10MHz 左右,STM32F2 的 SPI1 跑在 18MHz 以下都没问题
  • 通道数:4 路独立 UART,每路可单独配置波特率、数据位、停止位、校验位
  • FIFO:每通道收发各 16 字节,减少主控中断频率
  • 中断输出:一根 IRQ 引脚,低电平有效,主控通过读中断状态寄存器判断是哪个通道触发
  • 供电:3.3V,和 STM32F2 电平直接匹配,不需要电平转换

我一般会先确认板子上 WK2114 的片选接在哪个 GPIO,IRQ 接在哪个 EXTI 线上,这两根线定下来,驱动框架就清晰了。

2.2 为什么选 STM32F2 而不是 F1/F4

STM32F2 系列在工业现场很常见,Cortex-M3 内核,主频 120MHz,SPI 外设支持 8 位和 16 位数据帧,DMA 通道也够用。相比 F1,F2 的 SPI 时钟更高,配合 WK2114 的 FIFO 可以做到更低的 CPU 占用;相比 F4,F2 的外设寄存器布局更简单,驱动代码不需要处理太多缓存一致性问题。

常见做法是 SPI1 跑在 9MHz 左右,用 DMA 发送、中断接收。WK2114 的 SPI 时序是标准模式 0,CPOL=0,CPHA=0,MSB 先行。STM32F2 的 SPI_CR1 寄存器里把 CPOL 和 CPHA 都清零就行。

2.3 硬件连接与引脚分配

以某工业采集板为例,典型连接如下:

WK2114 引脚STM32F2 引脚说明
SCLKPA5 (SPI1_SCK)SPI 时钟
MOSIPA7 (SPI1_MOSI)主出从入
MISOPA6 (SPI1_MISO)主入从出
CSPA4 (GPIO)软件片选,低有效
IRQPB0 (EXTI0)中断输出,低有效
RSTPB1 (GPIO)复位,低有效

片选我习惯用软件控制,因为 WK2114 的 SPI 事务之间需要拉高 CS 来锁存数据,硬件 NSS 有时候时序不好控。IRQ 接 EXTI 下降沿触发,进中断后先读 WK2114 的中断状态寄存器,再决定处理哪个通道。

3. 驱动架构拆解:SPI 通信层与 UART 通道管理

3.1 分层设计思路

驱动分成三层:最底层是 SPI 读写字节函数,中间层是 WK2114 寄存器读写封装,最上层是 4 个 UART 通道的收发管理。这样分层的好处是,换主控平台只需要改 SPI 底层,换芯片只需要改寄存器定义。

目录结构大致如下:

wk2114_driver/ ├── inc/ │ ├── wk2114.h // 寄存器定义、结构体、API 声明 │ └── wk2114_port.h // 平台相关宏,SPI 句柄、CS/IRQ 引脚 ├── src/ │ ├── wk2114.c // 寄存器读写、初始化、中断处理 │ └── wk2114_uart.c // 4 通道收发、环形缓冲区 └── example/ └── main.c // 初始化示例、收发测试

3.2 SPI 读写与寄存器操作

WK2114 的寄存器地址是 8 位,数据也是 8 位。SPI 事务格式:先发地址字节,最高位表示读/写(1 读 0 写),然后跟数据字节。下面是我常用的两个基础函数:

// wk2114.c #include "wk2114.h" #include "wk2114_port.h" // 写一个寄存器 void WK2114_WriteReg(uint8_t addr, uint8_t data) { WK2114_CS_LOW(); // 片选拉低 SPI_TransferByte(addr & 0x7F); // 最高位 0 表示写 SPI_TransferByte(data); // 写入数据 WK2114_CS_HIGH(); // 片选拉高,锁存 } // 读一个寄存器 uint8_t WK2114_ReadReg(uint8_t addr) { uint8_t val; WK2114_CS_LOW(); SPI_TransferByte(addr | 0x80); // 最高位 1 表示读 val = SPI_TransferByte(0xFF); // 发哑元,收数据 WK2114_CS_HIGH(); return val; }

逻辑说明:addr & 0x7F把地址最高位清零表示写操作,addr | 0x80置一表示读操作。SPI_TransferByte是平台相关函数,STM32F2 上可以用标准库的SPI_I2S_SendData加等待SPI_I2S_GetFlagStatus实现,也可以用 HAL 的HAL_SPI_TransmitReceive。片选必须在每个事务结束后拉高,否则 WK2114 不会锁存数据,这是血泪经验,早期调试时数据写不进去就是 CS 忘了拉高。

参数说明:addr范围 0x00~0x7F,data是 8 位寄存器值。读操作时发 0xFF 是因为 SPI 全双工,必须给时钟才能收到数据,哑元值无所谓。

3.3 通道初始化与波特率配置

WK2114 每个通道有一组寄存器:波特率分频低字节、高字节、线路控制寄存器、FIFO 控制寄存器。初始化时先软复位,再逐通道配置。

// 初始化 WK2114,配置 4 个通道 void WK2114_Init(uint32_t baudrate) { WK2114_RST_LOW(); // 硬件复位 Delay_ms(10); WK2114_RST_HIGH(); Delay_ms(10); // 全局中断使能,FIFO 使能 WK2114_WriteReg(WK2114_REG_GLOBAL_CTRL, 0x01); for (uint8_t ch = 0; ch < 4; ch++) { uint16_t divisor = WK2114_CLK_FREQ / (baudrate * 16); WK2114_WriteReg(WK2114_REG_BR_L(ch), divisor & 0xFF); WK2114_WriteReg(WK2114_REG_BR_H(ch), (divisor >> 8) & 0xFF); // 8 数据位,1 停止位,无校验,使能收发 FIFO WK2114_WriteReg(WK2114_REG_LCR(ch), 0x03); WK2114_WriteReg(WK2114_REG_FCR(ch), 0x07); // 使能接收中断 WK2114_WriteReg(WK2114_REG_IER(ch), 0x01); } }

逻辑说明:WK2114_CLK_FREQ是芯片内部基准时钟,常见为 14.7456MHz 或 7.3728MHz,具体看板子晶振。分频公式是基准时钟 / (波特率 * 16),算出 16 位分频值。LCR寄存器 0x03 表示 8N1,FCR寄存器 0x07 表示使能 FIFO 并清空收发缓冲。IER寄存器 0x01 表示接收数据可用中断。

参数说明:baudrate支持 9600、19200、38400、57600、115200 等标准值。如果波特率有偏差,优先检查基准时钟频率是否和实际晶振一致,这个坑我踩过,板子焊的是 7.3728MHz 但代码里写 14.7456MHz,结果所有通道波特率翻倍,数据全是乱码。

3.4 中断处理与环形缓冲区

WK2114 的 IRQ 引脚是 4 个通道共享的,进中断后必须读全局中断状态寄存器,判断是哪个通道有数据,然后读该通道的接收寄存器,塞进对应的环形缓冲区。

// 环形缓冲区结构 typedef struct { uint8_t buf[256]; volatile uint16_t head; volatile uint16_t tail; } RingBuf_t; static RingBuf_t rx_buf[4]; // EXTI 中断服务函数 void EXTI0_IRQHandler(void) { if (EXTI_GetITStatus(EXTI_Line0) != RESET) { uint8_t int_status = WK2114_ReadReg(WK2114_REG_INT_STATUS); for (uint8_t ch = 0; ch < 4; ch++) { if (int_status & (1 << ch)) { while (WK2114_ReadReg(WK2114_REG_LSR(ch)) & 0x01) { uint8_t data = WK2114_ReadReg(WK2114_REG_RBR(ch)); uint16_t next = (rx_buf[ch].head + 1) % 256; if (next != rx_buf[ch].tail) { rx_buf[ch].buf[rx_buf[ch].head] = data; rx_buf[ch].head = next; } } } } EXTI_ClearITPendingBit(EXTI_Line0); } }

逻辑说明:INT_STATUS寄存器的 bit0~bit3 分别对应 4 个通道。LSR寄存器的 bit0 是数据就绪标志,循环读到没有数据为止。环形缓冲区用 head 和 tail 两个索引,head 由中断写,tail 由主循环读,不需要关中断,因为单生产者单消费者模型下读写各自索引不会冲突。

参数说明:缓冲区大小 256 字节,可以根据实际数据量调整。如果波特率 115200 且数据连续,建议至少 512 字节,否则主循环处理慢会丢数据。WK2114_REG_LSR的 bit0 是 DR(Data Ready),bit1 是 OE(Overrun Error),如果发现 OE 置位说明缓冲区满了,需要加大缓冲区或提高主循环读取频率。

4. 避坑与排查:调 WK2114 时最容易翻车的几个点

4.1 数据写进去读出来全是 0xFF

现象:初始化后读任何寄存器都返回 0xFF,写进去的值也读不回来。

原因:SPI 模式不对,或者 MISO 线没接好。WK2114 要求 SPI 模式 0,如果 CPHA 设成 1,采样边沿错了,读出来全是高电平。另外如果 MISO 虚焊,主控读到的就是浮空的高电平。

解决:用示波器看 SCLK 和 MOSI,确认时钟空闲低、第一个边沿采样。检查 MISO 焊接。STM32F2 的 SPI_CR1 寄存器里 CPOL=0、CPHA=0,BR 分频先设大一点,比如 64 分频,低速调通再提速。

4.2 能读能写但串口发不出数据

现象:寄存器读写正常,但外部串口工具收不到任何数据。

原因:通道的发送使能没开,或者波特率分频算错。WK2114 的 LCR 寄存器里除了数据位停止位,还有一位是发送使能,有些型号需要单独置位。另外分频值算错会导致波特率偏差太大,接收端识别不了。

解决:先确认 LCR 的值,8N1 通常是 0x03,如果芯片手册要求发送使能位,就改成 0x43。然后用示波器测 TX 引脚,看有没有波形,有波形但数据错就是波特率问题,重新算分频值。

4.3 中断进不去或者进去出不来

现象:IRQ 引脚一直是低电平,或者中断触发一次后再也不触发。

原因:中断状态寄存器没清,或者 EXTI 触发边沿设成了双边沿。WK2114 的 IRQ 是电平方式,低电平表示有中断,读走数据后自动变高。如果 EXTI 设成下降沿触发,但中断服务里没读数据,IRQ 一直低,就不会再有下降沿。

解决:EXTI 配置成下降沿触发,中断服务里必须读到 LSR 的 DR 位为 0 才退出。另外确认 WK2114 的全局中断使能位已经打开,有些批次芯片默认是关闭的。

4.4 多通道同时收发时数据串扰

现象:通道 0 收到的数据跑到了通道 1 的缓冲区里。

原因:读接收寄存器时地址算错,或者中断状态判断时通道索引搞混。WK2114 的通道寄存器地址是基址加通道偏移,如果偏移量算错,读的就是隔壁通道的数据。

解决:把通道基址定义成宏,比如#define WK2114_REG_RBR(ch) (0x00 + (ch) * 0x08),确保每个通道的寄存器块间隔正确。中断里用for循环遍历 4 个通道时,索引和寄存器地址要对应上。

4.5 高速收发时丢数据

现象:115200 波特率下连续发几百字节,接收端偶尔少几个字节。

原因:环形缓冲区太小,或者主循环读取太慢。WK2114 的 FIFO 只有 16 字节,如果主循环不及时读,FIFO 溢出就丢数据。

解决:加大环形缓冲区到 512 或 1024 字节,主循环里用while循环把缓冲区数据全部读走再处理。如果还丢,考虑用 DMA 把 SPI 接收也做成自动搬运,减少中断延迟。

5. 二次开发与验证:从能跑到好用的改造思路

5.1 把驱动移植到其他 STM32 系列

这份驱动的平台相关部分集中在wk2114_port.h和 SPI 底层函数里。移植到 STM32F1 或 F4 时,只需要改三个地方:SPI 句柄初始化、CS/IRQ 引脚宏定义、延时函数。寄存器操作和环形缓冲区逻辑完全不用动。

我一般会先把SPI_TransferByte换成目标平台的实现,然后跑一个寄存器读写测试,读 WK2114 的版本寄存器或者随便写一个测试寄存器再读回来,确认 SPI 通路正常。这一步过了,后面基本不会有大问题。

5.2 增加 DMA 收发降低 CPU 占用

如果 4 个通道都跑 115200 且数据量大,中断方式会吃掉不少 CPU。改造思路是:SPI 接收用 DMA,WK2114 的 IRQ 触发后启动一次 DMA 传输,把 FIFO 里的数据批量搬到内存。发送方向也可以做 DMA 队列,主循环把数据塞进发送缓冲区,DMA 自动搬运。

关键点是 DMA 传输长度要动态计算,根据 LSR 寄存器里的数据个数来决定搬多少字节。STM32F2 的 DMA 支持单次传输,配置好外设地址和内存地址,使能通道就行。

5.3 用 shell 命令验证每个通道

调通之后,我习惯在工程里加一个简单的 shell,通过主串口输入命令来测试 4 个扩展通道。比如:

// 测试命令:wk2114 send <ch> <string> void Cmd_WK2114_Send(int ch, char *str) { while (*str) { while (!(WK2114_ReadReg(WK2114_REG_LSR(ch)) & 0x20)); WK2114_WriteReg(WK2114_REG_THR(ch), *str++); } }

逻辑说明:LSR的 bit5 是发送保持寄存器空标志,等待它置位再写下一个字节。这样可以在不接外部设备的情况下,用回环线把 TX 和 RX 短接,自己发自己收,验证通道是否正常。

参数说明:ch范围 0~3,str是要发送的字符串。回环测试时把对应通道的 TX 和 RX 用杜邦线短接,发什么就应该收到什么。

5.4 一个我踩过的坑

早期调试时,我把 WK2114 的 IRQ 接在了 STM32F2 的 PB0 上,但 EXTI0 的中断优先级设得比 SysTick 还低,结果主循环里HAL_Delay一执行,中断就被挂起,数据丢了一大半。后来把 EXTI0 的抢占优先级调到比 SysTick 高,问题消失。从那以后我每次配中断优先级都强制走一遍优先级分组检查,确保串口中断不会被系统滴答打断。希望帮到你。

本文还有配套的精品资源,点击获取

相关新闻

基于豆包与 Dola 模型构建可视化节点式 AI 工作流的技术探索

基于豆包与 Dola 模型构建可视化节点式 AI 工作流的技术探索

摘要&#xff1a; 在 AI 多媒体批量生成场景中&#xff0c;传统网页交互模式存在素材反复上传、任务串行执行、提示词版本难以管理等问题。本文探讨如何搭建一套节点画布系统&#xff0c;实现可视化编排 AI 生成任务&#xff0c;对接豆包、Dola 以及第三方模型 API&#xff1b;…

2026/11/18 23:07:00 阅读更多 →
24GB 显存跑 740 亿参数 Agent:Nemotron 3.5 Bolt 本地部署工程拆解 | RiseClaw玄策

24GB 显存跑 740 亿参数 Agent:Nemotron 3.5 Bolt 本地部署工程拆解 | RiseClaw玄策

24GB 显存跑 740 亿参数 Agent&#xff1a;Nemotron 3.5 Bolt 本地部署工程拆解 | RiseClaw玄策 10 月 15 日&#xff0c;NVIDIA 在官方研究页发布 Nemotron 3.5 Bolt 74B-A9B&#xff1a;总参数 740 亿、每 token 只激活 90 亿的 MoE 混合架构模型&#xff0c;2-bit 量化后压…

2026/11/18 6:45:00 阅读更多 →
深圳结构设计基本功:把 DFM 写进每一张图

深圳结构设计基本功:把 DFM 写进每一张图

深圳的结构设计公司整体强&#xff0c;不是天赋使然&#xff0c;而是被产业链"训"出来的。深圳八千里设计公司的TONY结构总监讲清它强在哪&#xff0c;以及 DFM 为何是基本功。 一、DFM 是默认共识 深圳背靠全国密度领先的制造配套&#xff0c;结构工程师天天和模具厂…

2026/11/9 21:40:12 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年&#xff0c;我大部分时间都在跟浏览器标签页打交道&#xff0c;直到第一次把桌面应用跑起来&#xff0c;才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词&#xff0c;最开始是在某段时间频繁出现在同事的讨论里&#xff0c;一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档&#xff0c;主要面向智能锁安装人员、终端用户及售后维护者&#xff0c;帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件&#xff0c;大小4.37MB&#xff0c;内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统&#xff0c;整车要求空载跑到8m/s&#xff0c;电机转速已经拉到额定点&#xff0c;驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令&#xff0c;转速纹丝不动&#xff0c;三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年&#xff0c;用它写过嵌入式驱动、做过游戏服务端&#xff0c;也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词&#xff0c;我其实挺感慨的——这门语言的难点从来不是语法多&#xff0c;而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书以PDF格式发布&#xff0c;适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开&#xff0c;先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能&#xff0c;再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历&#xff1a;翻开源码注释、论文摘要或者一份专业报告&#xff0c;每个字都认识&#xff0c;连在一起却像天书。想找人聊聊&#xff0c;身边要么没人懂&#xff0c;要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型&#xff0c;几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻