WK2124 SPI转4串口Linux驱动移植：RK3288平台适配3大关键步骤与排错
WK2124 SPI转4串口Linux驱动移植：RK3288平台适配3大关键步骤与排错
在嵌入式系统开发中，串口资源不足是常见问题。WK2124作为一款通过SPI接口扩展4路UART的高性能芯片，能够有效解决这一痛点。本文将深入探讨如何在RK3288平台上完成WK2124驱动的移植与适配，分享从设备树配置到中断调试的全流程实战经验。
1. 环境准备与硬件连接
RK3288作为一款广泛应用于工业控制领域的四核Cortex-A17处理器，其丰富的SPI接口使其成为连接WK2124的理想平台。在开始驱动移植前，需确保硬件连接正确：
- SPI接口：WK2124的SCLK、MOSI、MISO分别连接RK3288的SPI1_CLK、SPI1_TXD、SPI1_RXD
- 片选信号：CS引脚连接RK3288的GPIO7_C1（可根据实际需求调整）
- 中断引脚：IRQ连接RK3288的GPIO7_B5（下降沿触发）
- 电源配置：VCC接3.3V，GND良好接地
硬件连接验证可通过示波器或逻辑分析仪检查SPI信号质量。常见问题包括：
- 信号线过长导致波形畸变
- 未正确配置上拉电阻
- 电源噪声干扰
// 示例硬件连接验证代码 #include <stdio.h> #include <wiringPi.h> #include <wiringPiSPI.h> #define SPI_CHANNEL 0 #define SPI_SPEED 1000000 int main() { wiringPiSetup(); int fd = wiringPiSPISetup(SPI_CHANNEL, SPI_SPEED); if (fd == -1) { printf("SPI初始化失败\n"); return -1; } printf("SPI初始化成功，文件描述符：%d\n", fd); return 0; }2. 设备树配置详解
RK3288平台采用设备树机制管理硬件资源，WK2124的配置主要涉及SPI控制器和中断设置。以下是关键配置项：
2.1 SPI控制器配置
&spi1 { status = "okay"; max-freq = <48000000>; wk2124: wk2124@0 { compatible = "wkmisc,wk2124"; reg = <0>; spi-max-frequency = <10000000>; spi-cpol; spi-cpha; interrupt-parent = <&gpio7>; interrupts = <13 IRQ_TYPE_EDGE_FALLING>; // GPIO7_B5 pinctrl-names = "default"; pinctrl-0 = <&spi1_clk &spi1_tx &spi1_rx &spi1_cs0>; }; };配置要点说明：
spi-max-frequency：根据实际需求设置，最高支持10MHzspi-cpol/spi-cpha：必须与WK2124规格书中的模式一致（通常为模式0）interrupts：指定GPIO引脚和触发方式
2.2 引脚复用配置
在pinctrl节点中添加SPI引脚复用定义：
pinctrl: pinctrl { spi1 { spi1_clk: spi1-clk { rockchip,pins = <7 12 RK_FUNC_2 &pcfg_pull_up>; }; spi1_tx: spi1-tx { rockchip,pins = <7 11 RK_FUNC_2 &pcfg_pull_up>; }; spi1_rx: spi1-rx { rockchip,pins = <7 10 RK_FUNC_2 &pcfg_pull_up>; }; spi1_cs0: spi1-cs0 { rockchip,pins = <7 9 RK_FUNC_2 &pcfg_pull_up>; }; }; };常见配置错误包括：
- 引脚功能复用号（RK_FUNC_X）错误
- 上下拉电阻配置不当
- 未启用SPI控制器（status = "okay"）
3. 驱动移植关键修改点
WK2124官方驱动通常需要针对具体平台进行适配，以下是RK3288平台的关键修改部分：
3.1 中断处理优化
原始驱动可能使用GPIO中断号直接注册，而RK3288需要转换为Linux标准中断号：
static int wk2124_probe(struct spi_device *spi) { struct wk2124_private *priv; int irq, ret; // 获取设备树中定义的中断 irq = of_irq_get(dev->of_node, 0); if (irq <= 0) { dev_err(dev, "无法获取有效中断号\n"); return -EINVAL; } // 注册中断处理函数 ret = devm_request_irq(dev, irq, wk2124_irq, IRQF_TRIGGER_FALLING, dev_name(dev), priv); if (ret) { dev_err(dev, "无法注册中断%d\n", irq); return ret; } // 其他初始化代码... }3.2 SPI传输速率调整
RK3288的SPI控制器支持多种时钟分频配置，需根据实际需求调整：
static int wk2124_spi_setup(struct spi_device *spi) { struct spi_transfer xfer = {0}; u8 mode = SPI_MODE_0; spi->mode = mode; spi->bits_per_word = 8; spi_setup(spi); // 设置SPI传输参数 xfer.speed_hz = 10000000; // 10MHz xfer.len = 1; xfer.tx_buf = &tx_data; xfer.rx_buf = &rx_data; return spi_sync_transfer(spi, &xfer, 1); }3.3 串口设备注册
确保每个子串口正确注册为TTY设备：
static int wk2124_uart_register(struct wk2124_private *priv, int port) { struct uart_port *uart = &priv->ports[port].uart; uart->line = port; uart->type = PORT_WK2124; uart->fifosize = 256; uart->ops = &wk2124_uart_ops; uart->flags = UPF_BOOT_AUTOCONF; return uart_add_one_port(&wk2124_uart_driver, uart); }4. 调试与问题排查
驱动移植过程中常见问题及解决方法：
4.1 SPI通信失败排查步骤
检查硬件连接：
- 确认电源电压稳定（3.3V±5%）
- 测量SPI时钟信号是否正常
- 检查片选信号是否有效
内核日志分析：
dmesg | grep spi dmesg | grep wk2124SPI信号质量测试：
- 使用逻辑分析仪捕获SPI波形
- 检查时钟极性(CPOL)和相位(CPHA)设置
4.2 中断不触发问题
常见原因及解决方案：
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 完全无中断 | GPIO配置错误 | 检查设备树interrupts属性 |
| 偶发中断丢失 | 中断消抖未配置 | 添加防抖延迟或硬件滤波 |
| 中断频繁触发 | 中断线干扰 | 检查PCB布局，缩短走线 |
调试技巧：
# 查看中断统计 cat /proc/interrupts | grep wk2124 # 手动触发GPIO中断测试 echo 123 > /sys/class/gpio/gpio213/value4.3 串口数据异常处理
当出现数据丢失或乱码时，可按以下流程排查：
检查波特率一致性：
// 驱动中确保波特率设置正确 static void wk2124_set_baud(struct uart_port *port, int baud) { u32 div = (priv->clk_rate / (baud * 16)) - 1; wk2124_write_reg(port, WK2XXX_LCR, WK2XXX_LCR_DLAB); wk2124_write_reg(port, WK2XXX_DLL, div & 0xff); wk2124_write_reg(port, WK2XXX_DLH, (div >> 8) & 0xff); wk2124_write_reg(port, WK2XXX_LCR, 0); }FIFO状态监控：
# 查看串口FIFO状态 cat /proc/tty/driver/wk2124流量控制配置：
- 硬件流控：确保RTS/CTS接线正确
- 软件流控：驱动中启用XON/XOFF支持
5. 性能优化技巧
针对RK3288平台的特定优化策略：
5.1 SPI传输效率提升
DMA传输配置：
struct dma_slave_config config = { .direction = DMA_MEM_TO_DEV, .dst_addr = spi->phys_addr + SPI_TXDR, .dst_addr_width = DMA_SLAVE_BUSWIDTH_1_BYTE, }; dmaengine_slave_config(priv->dma_tx, &config);双缓冲机制：
static irqreturn_t wk2124_irq(int irq, void *dev_id) { // 在处理当前缓冲区时，DMA已开始填充下一个缓冲区 if (priv->current_buf == 0) { process_buf(priv->buf1); dma_start(priv->buf2); } else { process_buf(priv->buf2); dma_start(priv->buf1); } priv->current_buf ^= 1; }
5.2 中断延迟优化
实时性调整：
# 设置线程为实时调度 chrt -f -p 99 $(pgrep irq/123-wk2124)中断亲和性设置：
# 将中断绑定到特定CPU核心 echo 2 > /proc/irq/123/smp_affinity线程化中断优化：
static int wk2124_probe(struct spi_device *spi) { irq_set_status_flags(irq, IRQ_NOAUTOEN); ret = request_threaded_irq(irq, NULL, wk2124_threaded_irq, IRQF_ONESHOT, dev_name(dev), priv); }
6. 实际应用案例
在某工业控制器项目中，我们使用RK3288+WK2124方案实现了8路串口扩展（两个WK2124级联）。关键配置如下：
&spi1 { status = "okay"; num-cs = <2>; wk2124_0: wk2124@0 { compatible = "wkmisc,wk2124"; reg = <0>; spi-max-frequency = <10000000>; interrupts = <13 IRQ_TYPE_EDGE_FALLING>; }; wk2124_1: wk2124@1 { compatible = "wkmisc,wk2124"; reg = <1>; spi-max-frequency = <10000000>; interrupts = <14 IRQ_TYPE_EDGE_FALLING>; }; };项目经验总结：
- 双芯片共享中断线时需添加互斥锁
- 高波特率(1Mbps以上)需降低SPI时钟分频
- 长时间运行需监控芯片温度（特别是密闭环境）