4. Linux 内核 UART 驱动框架：serial_core、tty 层、uart_ops 结构体、中断处理入口

Linux 内核的 UART 驱动并非一个孤立的字符设备驱动，而是构建在 serial_core 与 TTY 层 之上的分层架构。理解这一框架是开发 DMA 传输完成中断与错误处理流程的前提。本章将拆解 serial_core 的核心作用、TTY 层的抽象机制、uart_ops 操作表以及中断处理入口的注册与分发逻辑。

4.1 serial_core 层：UART 驱动的中间件

serial_core（位于 drivers/tty/serial/serial_core.c）是 Linux 内核为串口驱动提供的一套通用基础设施。它位于底层硬件驱动与上层 TTY 层之间，承担以下职责：

• 端口管理：统一管理 uart_port 结构体的分配、注册与注销。
• 操作抽象：定义 uart_ops 回调函数表，驱动开发者只需实现底层硬件操作。
• TTY 接口适配：将 TTY 层的标准调用（如 open、close、write）转换为 uart_ops 中的具体函数。
• 中断分发：提供统一的中断处理入口，并根据中断类型分发到对应的处理函数。

4.2 TTY 层：用户空间与内核的桥梁

TTY 层是 Linux 内核中处理终端设备的抽象层。对于 UART 驱动而言，TTY 层提供了以下能力：

用户空间通过 /dev/ttyS* 或 /dev/ttyAMA* 等设备节点访问串口，所有读写操作最终通过 TTY 层转发到 serial_core，再由 uart_ops 回调进入底层硬件驱动。

4.3 uart_ops 结构体：硬件操作回调表

struct uart_ops 是驱动开发者必须实现的核心接口。它定义了 UART 硬件从初始化到数据收发的全部操作。以下是最关键的几个回调函数：

// uart_ops 结构体定义示例（位于 include/linux/serial_core.h）
struct uart_ops {
    unsigned int    (*tx_empty)(struct uart_port *);
    void            (*set_mctrl)(struct uart_port *, unsigned int);
    unsigned int    (*get_mctrl)(struct uart_port *);
    void            (*stop_tx)(struct uart_port *);
    void            (*start_tx)(struct uart_port *);
    void            (*stop_rx)(struct uart_port *);
    void            (*enable_ms)(struct uart_port *);
    void            (*break_ctl)(struct uart_port *, int);
    int             (*startup)(struct uart_port *);
    void            (*shutdown)(struct uart_port *);
    void            (*set_termios)(struct uart_port *, struct ktermios *new,
                                   struct ktermios *old);
    void            (*pm)(struct uart_port *, unsigned int state,
                          unsigned int oldstate);
    int             (*handle_irq)(struct uart_port *);
    // ... 其他回调
};

4.4 中断处理入口：从硬件中断到 serial_core 分发

UART 中断处理是驱动中最关键的路径之一。serial_core 提供了两种中断处理模式：

1. 传统模式：驱动在 startup 中调用 request_irq 注册自己的中断处理函数，然后在处理函数中读取中断状态寄存器，判断中断类型（接收、发送、错误、状态变化），并调用 serial_core 提供的辅助函数（如 uart_insert_char、uart_handle_sysrq_char）。
2. serial_core 统一入口模式：驱动在 uart_ops 中实现 handle_irq 回调，serial_core 会在其注册的中断处理函数中自动调用该回调。这种方式更简洁，推荐用于新驱动。

以下是一个典型的中断处理入口实现：

// 中断处理函数示例（传统模式）
static irqreturn_t my_uart_irq_handler(int irq, void *dev_id)
{
    struct uart_port *port = dev_id;
    unsigned int iir;  // 中断标识寄存器

    // 读取中断状态，判断中断类型
    iir = readl(port->membase + UART_IIR);
    if (iir & UART_IIR_NO_INT) {
        return IRQ_NONE;  // 非本设备中断
    }

    // 接收中断
    if (iir & UART_IIR_RX_TIMEOUT || iir & UART_IIR_RX_AVAIL) {
        my_uart_rx_handler(port);
    }

    // 发送中断
    if (iir & UART_IIR_TX_EMPTY) {
        my_uart_tx_handler(port);
    }

    // 错误中断（溢出、帧错误、奇偶校验错误等）
    if (iir & UART_IIR_ERROR) {
        my_uart_error_handler(port);
    }

    // 调制解调器状态变化
    if (iir & UART_IIR_MS_CHANGE) {
        uart_handle_cts_change(port, read_msr(port));
    }

    return IRQ_HANDLED;
}

4.5 框架整体架构图

下图展示了从用户空间到硬件寄存器的完整 UART 驱动分层架构，以及中断处理路径：

4.6 中断处理流程：从硬件到 TTY 层

当 UART 硬件产生中断时，完整的中断处理流程如下：

1. 硬件触发：UART 控制器检测到接收 FIFO 达到阈值、发送 FIFO 为空、或发生错误，向中断控制器（GIC）发送中断信号。
2. 内核中断处理：CPU 响应中断，调用驱动注册的 irq_handler（或 serial_core 的统一入口）。
3. 中断类型判断：读取中断状态寄存器（如 IIR），判断中断来源（接收、发送、错误、调制解调器状态）。
4. 数据接收：对于接收中断，从 FIFO 或 DMA 缓冲区读取数据，调用 uart_insert_char 将数据放入 TTY 翻转缓冲区。
5. 错误处理：对于溢出、帧错误、奇偶校验错误，记录统计信息，必要时清空 FIFO 或重启 DMA。
6. 唤醒 TTY 层：调用 tty_flip_buffer_push 通知 TTY 层有数据可读，最终传递到用户空间。

4.7 错误中断处理：溢出、帧错误与奇偶校验

UART 硬件在接收数据时可能检测到三种常见错误，每种错误都需要在中断处理中妥善处理：

// 错误中断处理示例
static void my_uart_error_handler(struct uart_port *port)
{
    unsigned int lsr = readl(port->membase + UART_LSR);

    // 溢出错误
    if (lsr & UART_LSR_OE) {
        port->icount.overrun++;
        // 清空 FIFO，防止错误扩散
        writel(UART_FCR_CLEAR_RCVR, port->membase + UART_FCR);
        dev_warn(port->dev, "FIFO overrun error\n");
    }

    // 帧错误
    if (lsr & UART_LSR_FE) {
        port->icount.frame++;
        dev_dbg(port->dev, "frame error detected\n");
    }

    // 奇偶校验错误
    if (lsr & UART_LSR_PE) {
        port->icount.parity++;
        dev_dbg(port->dev, "parity error detected\n");
    }

    // 通知 TTY 层错误状态（可选）
    uart_handle_break(port);
}

4.8 本章小结