UART驱动错误日志与调试
[toc]
本文以 Rockchip SDK 内核 6.1.172 的 DesignWare APB UART 驱动为例,讲解 UART 驱动的调用链、寄存器布局,并按寄存器逐个分析每条错误日志的含义与调试方法,最后给出从设备树到波形的分层调试流程。
适用环境:
- 内核:
kernel-6.1(Makefile 实际版本 6.1.172)。 - 目标:RK3506,UART 节点 compatible 为
"rockchip,rk3506-uart", "snps,dw-apb-uart"。 - 驱动:
drivers/tty/serial/8250/下的8250_dw.c、8250_dwlib.c、8250_port.c、8250_core.c,以及drivers/tty/serial/serial_core.c。
1. 驱动结构与调用链
1.1 文件分工
UART 功能横跨多个层次,以下按数据流从硬件到用户态列出全部相关文件。路径相对内核根目录,标注”本配置编译”的文件在当前 defconfig 下确实生成了 .o,其余为依赖或参考。
8250 核心层(drivers/tty/serial/8250/)
| 文件 | 职责 |
|---|---|
8250_core.c | 8250 驱动框架:模块初始化、端口注册、共享中断分发(本配置编译) |
8250_port.c | 8250 核心逻辑:中断处理、收发字符、错误统计、termios(本配置编译) |
8250.h | struct uart_8250_port 定义和内部接口声明 |
DesignWare 平台层(RK3506 实际使用)
| 文件 | 职责 |
|---|---|
8250_dw.c | DesignWare 平台驱动:probe、时钟、复位、寄存器访问、USR busy、RX timeout 处理(本配置编译) |
8250_dwlib.c | DesignWare 公共库:termios、DMA 配置、CPR/版本寄存器读取(本配置编译) |
8250_dwlib.h | dwlib 内部接口 |
DMA 与其他已编译 8250 文件
| 文件 | 职责 |
|---|---|
8250_dma.c | 8250 通用 DMA 引擎支持,见第 5 章(本配置编译) |
8250_early.c | 8250 earlycon 早期控制台(本配置编译) |
8250_of.c | ns16550a 等旧式 DT 绑定,RK3506 的 DW UART 不走此路径(本配置编译) |
8250_fsl.c、8250_pericom.c | NXP/Pericom 平台支持,本配置编译但与 RK3506 无关,读代码可跳过 |
串口核心层(drivers/tty/serial/)
| 文件 | 职责 |
|---|---|
serial_core.c | uart_port/uart_driver 管理、tty 操作、/proc/tty/driver/serial、RS485 参数校验 |
earlycon.c | earlycon 框架,解析 bootargs 的 earlycon= |
tty 层(drivers/tty/)
| 文件 | 职责 |
|---|---|
tty_io.c | /dev/ttySx 文件操作和 tty 生命周期 |
tty_buffer.c | flip buffer,tty_insert_flip_char() 的落点 |
tty_ldisc.c | 行规程切换框架 |
n_tty.c | 默认行规程:行缓冲、回显、特殊字符 |
Rockchip 调试控制台(drivers/soc/rockchip/fiq_debugger/)
| 文件 | 职责 |
|---|---|
rk_fiq_debugger.c | 注册 ttyFIQ0 调试控制台,处理 bootargs console=ttyFIQ0 |
fiq_debugger.c | FIQ debugger 核心:命令解析、ringbuf |
fiq_debugger_arm.c | ARM32 FIQ 入口(RK3506 为 32 位,arm64 版本不适用) |
fiq_watchdog.c | FIQ 看门狗 |
依赖的子系统驱动
| 文件 | 职责 |
|---|---|
drivers/dma/pl330.c | PL330 DMA 控制器驱动(dmac0/dmac1) |
drivers/pinctrl/pinctrl-rockchip.c | pinmux 与上下拉偏置 |
drivers/clk/rockchip/clk.c | CRU 时钟树,uart baudclk/pclk 的来源 |
关键头文件
| 文件 | 内容 |
|---|---|
include/linux/serial_core.h | struct uart_port、struct uart_driver、tty 标志 |
include/linux/serial_8250.h | 8250 平台数据和对外接口 |
include/uapi/linux/serial_reg.h | UART_RX、UART_IER、UART_LSR 等寄存器偏移定义 |
include/linux/serial.h | 串口核心通用定义 |
设备树文件(arch/arm/boot/dts/)
| 文件 | 内容 |
|---|---|
rk3502.dtsi | uart0~5 节点、dmac0、aliases(rk3506.dtsi 包含它) |
rk3506-pinctrl.dtsi | uart0 等引脚组定义 |
rk3506-pinctrl-rmio.dtsi | rm_io 重映射引脚组(uart3/uart4 板级使用) |
rk3506g-evb1-v10.dts | 板级 uart3/uart4 启用和 pinctrl 选择 |
rockchip-pinconf.dtsi | pcfg_pull_up、pcfg_pull_none 等偏置定义 |
1.2 设备树节点
RK3506 的 uart0 节点定义在 arch/arm/boot/dts/rk3502.dtsi:565:
uart0: serial@ff0a0000 {
compatible = "rockchip,rk3506-uart", "snps,dw-apb-uart";
reg = <0xff0a0000 0x100>;
interrupts = <GIC_SPI 34 IRQ_TYPE_LEVEL_HIGH>;
reg-shift = <2>;
reg-io-width = <4>;
dmas = <&dmac0 4 ...>, <&dmac0 5 ...>;
clocks = <&cru SCLK_UART0>, <&cru PCLK_UART0>;
clock-names = "baudclk", "apb_pclk";
pinctrl-names = "default";
pinctrl-0 = <&uart0_xfer_pins>;
status = "disabled";
};
调试时先逐项确认:status 是否为 okay、reg 地址、中断号、两个时钟、pinctrl 是否都正确。aliases 中 serial0 = &uart0 决定 ttyS 编号(rk3502.dtsi:31)。
1.3 接收调用链
硬件中断
-> dw8250_handle_irq() 8250_dw.c:250 读 IIR,处理 RX timeout / USR busy
-> serial8250_handle_irq() 8250_port.c:1998 读 LSR,打印 Rockchip 错误日志
-> serial8250_rx_chars() 8250_port.c:1844 循环读 RX FIFO
-> serial8250_do_read_char() 8250_port.c:1769 统计错误计数,转 TTY 标志
-> uart_insert_char() serial_core.c:3361 写入 tty flip buffer
-> tty_flip_buffer_push() 交付给用户态 read()
发送方向由 serial8250_tx_chars()(8250_port.c:1864)在 THRE 中断中把 tty 层数据写入 TX FIFO。
1.4 DesignWare UART 寄存器分析
1.4.1 寻址方式
16550 兼容寄存器用索引编号(0~7),设备树两个属性决定物理偏移:
reg-shift = <2>:物理偏移 = 索引 << 2(即索引 × 4)。reg-io-width = <4>:按 32 位宽度读写。
以 uart4(基址 0xff0e0000,rk3502.dtsi:619)为例:
| 索引 | 物理偏移 | 地址 | 名称 |
|---|---|---|---|
| 0 | 0x00 | 0xff0e0000 | RBR(读)/ THR(写)/ DLL(DLAB=1) |
| 1 | 0x04 | 0xff0e0004 | IER(读)/ DLH(DLAB=1) |
| 2 | 0x08 | 0xff0e0008 | IIR(读)/ FCR(写) |
| 3 | 0x0c | 0xff0e000c | LCR |
| 4 | 0x10 | 0xff0e0010 | MCR |
| 5 | 0x14 | 0xff0e0014 | LSR |
| 6 | 0x18 | 0xff0e0018 | MSR |
| 7 | 0x1c | 0xff0e001c | SCR |
DesignWare 扩展寄存器(定义在 8250_dw.c:40 和 8250_dwlib.c:24)。注意驱动里存在两种访问约定,读代码时容易混淆:
- 经
serial_in/serial_out访问的会左移 regshift(USR、RFL),宏定义是移位前的索引。 - 经
dw8250_readl_ext/dw8250_writel_ext访问的不移位(DMASA、CPR、UCV,8250_dwlib.h:63/70),宏定义就是物理偏移。
| 寄存器 | 驱动宏 | 物理偏移 | 地址(uart4) | 访问方式 |
|---|---|---|---|---|
| USR 状态 | DW_UART_USR 0x1f | 0x7c | 0xff0e007c | serial_in(移位) |
| RFL 接收 FIFO 深度 | DW_UART_RFL 0x21 | 0x84 | 0xff0e0084 | serial_in(移位) |
| DMASA DMA 软件握手 | DW_UART_DMASA 0xa8 | 0xa8 | 0xff0e00a8 | writel_ext(不移位) |
| CPR 配置参数 | DW_UART_CPR 0xf4 | 0xf4 | 0xff0e00f4 | readl_ext(不移位) |
| UCV 版本号 | DW_UART_UCV 0xf8 | 0xf8 | 0xff0e00f8 | readl_ext(不移位) |
8250_dma.c 中另有 DW_UART_DMASA 0x2a(8250_dma.c:18),因为它经 serial_port_out 移位访问,0x2a << 2 同样落在物理偏移 0xa8。
1.4.2 基础寄存器位定义
位定义全部来自 include/uapi/linux/serial_reg.h。
IER 中断使能(索引 1)
| 位 | 宏 | 含义 |
|---|---|---|
| 0x01 | UART_IER_RDI | 接收数据中断 |
| 0x02 | UART_IER_THRI | 发送保持寄存器空中断 |
| 0x04 | UART_IER_RLSI | 线路状态中断(OE/PE/FE/BI) |
| 0x08 | UART_IER_MSI | Modem 状态中断 |
| 0x80 | UART_IER_PTIME | 可编程发送中断模式(DW 扩展) |
IIR 中断标识(索引 2 读)
| 值 | 宏 | 含义 |
|---|---|---|
| 0x00 | UART_IIR_MSI | Modem 状态 |
| 0x01 | UART_IIR_NO_INT | 无中断挂起 |
| 0x02 | UART_IIR_THRI | 发送保持寄存器空 |
| 0x04 | UART_IIR_RDI | 接收数据到达 |
| 0x06 | UART_IIR_RLSI | 线路状态错误 |
| 0x07 | UART_IIR_BUSY | DW 忙检测(改波特率时) |
| 0x0c | UART_IIR_RX_TIMEOUT | 接收超时(FIFO 有数据但未满) |
dw8250_handle_irq() 第一步就是读 IIR 判断中断类型,3.2 节的 RX timeout 分析即基于此。
FCR FIFO 控制(索引 2 写)
| 位 | 宏 | 含义 |
|---|---|---|
| 0x01 | UART_FCR_ENABLE_FIFO | 使能 FIFO |
| 0x02 | UART_FCR_CLEAR_RCVR | 清空接收 FIFO |
| 0x04 | UART_FCR_CLEAR_XMIT | 清空发送 FIFO |
| 0x08 | UART_FCR_DMA_SELECT | DMA 模式选择 |
| [7:6] | UART_FCR_R_TRIG_xx | 接收触发级别 |
| [5:4] | UART_FCR_T_TRIG_xx | 发送触发级别 |
LCR 线路控制(索引 3)
| 位 | 宏 | 含义 |
|---|---|---|
| [1:0] | UART_LCR_WLEN5~8 | 数据位宽 |
| 0x04 | UART_LCR_STOP | 停止位:0=1 位,1=2 位 |
| 0x08 | UART_LCR_PARITY | 使能校验 |
| 0x10 | UART_LCR_EPAR | 偶校验 |
| 0x40 | UART_LCR_SBC | 发送 break |
| 0x80 | UART_LCR_DLAB | 分频系数访问位 |
设置波特率时先置 DLAB 读写 DLL/DLH,完成后清 DLAB,见 serial8250_set_divisor()。
MCR Modem 控制(索引 4)
| 位 | 宏 | 含义 |
|---|---|---|
| 0x01 | UART_MCR_DTR | DTR |
| 0x02 | UART_MCR_RTS | RTS |
| 0x10 | UART_MCR_LOOP | 环回测试模式(内部短接 TX/RX) |
| 0x20 | UART_MCR_AFE | 自动 RTS/CTS 硬件流控 |
LSR 线路状态(索引 5,只读)
| 位 | 宏 | 含义 |
|---|---|---|
| 0x01 | UART_LSR_DR | 接收缓冲有数据 |
| 0x02 | UART_LSR_OE | Overrun |
| 0x04 | UART_LSR_PE | Parity 错误 |
| 0x08 | UART_LSR_FE | Frame 错误 |
| 0x10 | UART_LSR_BI | Break |
| 0x20 | UART_LSR_THRE | 发送保持寄存器空 |
| 0x40 | UART_LSR_TEMT | 发送器完全空 |
| 0x80 | UART_LSR_FIFOE | FIFO 内有错误字符 |
UART_LSR_BRK_ERROR_BITS(BI|FE|PE|OE)是驱动判断线路错误的掩码,第 3 章日志全部由它触发。
MSR Modem 状态(索引 6,只读)
| 位 | 宏 | 含义 |
|---|---|---|
| 0x10 | UART_MSR_CTS | CTS 当前电平 |
| 0x20 | UART_MSR_DSR | DSR |
| 0x40 | UART_MSR_RI | RI |
| 0x80 | UART_MSR_DCD | DCD |
| 0x0f | 各 delta 位 | 上述信号的变化标志,读后清零 |
1.4.3 DesignWare 扩展寄存器
USR(物理 0x7c):bit0 为 BUSY。修改波特率等配置前控制器会进入 busy,此时写 LCR/DLL 无效。dw8250_handle_irq() 收到 UART_IIR_BUSY 时读 USR 清除(8250_dw.c:300)。
RFL(物理 0x84):接收 FIFO 当前字节数。RX timeout 假读逻辑用它判断 FIFO 是否真的为空(8250_dw.c:275)。
DMASA(物理 0xa8):DMA 软件握手确认,Rockchip DMA 发送前写 1 清除残留请求(8250_dma.c:186)。
CPR(物理 0xf4):综合时固化的配置参数,关键字段(8250_dwlib.c:58):
| 字段 | 位 | 含义 |
|---|---|---|
APB_DATA_WIDTH | [1:0] | APB 数据宽度 |
AFCE_MODE | [4] | 支持自动流控 |
THRE_MODE | [5] | THRE 中断模式 |
FIFO_MODE | [23:16] | FIFO 深度 = 该值 × 16 |
RK 分支 CPR 读不到时使用内置值 0x00023ff2(8250_dw.c:853):FIFO_MODE=2,即 FIFO 深度 32 字节,支持自动流控。fifosize 决定第 5 章 DMA 是否启用及 burst 大小。
UCV(物理 0xf8):控制器版本号,对应 Designware UART version 调试日志(8250_dwlib.c:310)。读 UCV 为 0 说明控制器未实现扩展特性,驱动直接跳过后续探测(8250_dwlib.c:306)。
1.4.4 devmem 读取实例与注意事项
以 uart4 为例:
devmem 0xff0e0014 32 # LSR:bit0=有数据,bit1-4=OE/PE/FE/BI
devmem 0xff0e0008 32 # IIR:当前中断类型
devmem 0xff0e007c 32 # USR:bit0=BUSY
devmem 0xff0e0084 32 # RFL:接收 FIFO 字节数
devmem 0xff0e00f4 32 # CPR:配置参数
注意部分寄存器读操作有副作用,调试时避免随意读:
- 读 RBR(索引 0)会取走一个接收字节。
- 读 IIR 可能影响中断状态判断。
- 读 MSR 会清除 delta 位,干扰流控逻辑。
- 驱动正在运行时用 devmem 写任何寄存器都可能破坏驱动状态,只建议读,且优先在端口未打开时操作。
2. probe 阶段的日志与错误处理
2.1 probe 成功日志
dw8250_probe()(8250_dw.c:565)成功后,serial_core.c:2535 打印:
ff0a0000.serial: ttyS0 at MMIO 0xff0a0000 (irq = 65, base_baud = 1500000) is a 16550A
字段含义:
ff0a0000.serial:platform 设备名,来自设备树节点地址。ttyS0:注册的 tty 设备,编号由 aliases 决定。base_baud:uartclk / 16。若该值与预期不符,说明时钟配置错误,波特率必然不准。is a 16550A:自动配置识别出的端口类型。
看不到这行日志时,说明 probe 没成功或节点没启用,按 2.2 排查。
2.2 probe 失败日志
dw8250_probe() 使用 dev_err_probe() 报错,日志与原因对照:
| 日志 | 位置 | 原因与排查 |
|---|---|---|
no registers defined | 8250_dw.c:579 | 设备树缺少 reg 属性 |
could not enable optional baudclk | 8250_dw.c:677 | baudclk 使能失败,查 CRU 时钟树 |
clock rate not defined | 8250_dw.c:688 | 时钟已使能但频率为 0,查时钟父链和 assigned-clock-rates |
could not enable apb_pclk | 8250_dw.c:696 | APB 总线时钟使能失败 |
failed to deassert resets | 8250_dw.c:708 | 复位解除失败,查 reset 控制器 |
Failed to set the clock notifier | 8250_dw.c:742 | 时钟通知器注册失败 |
注意两点:
-
dev_err_probe()遇到-EPROBE_DEFER(依赖的时钟、复位资源还没注册)时不打印错误,只推迟 probe。反复 defer 时查看:cat /sys/kernel/debug/devices_deferred -
probe 返回错误码后设备不会注册。用
dmesg | grep -i serial和ls /sys/bus/platform/drivers/dw-apb-uart/确认绑定结果。
2.3 DMA 相关日志
serial8250_do_startup()(8250_port.c:2554 附近)请求 DMA 失败时打印:
failed to request DMA, use interrupt mode
这是 Rockchip 修改过的提示,表示退回中断模式,功能仍可用,只是高速收发性能下降。内核控制台端口则打印 forbid DMA for kernel console,属于预期行为。DMA 的完整机制与排查见第 5 章。
3. 按寄存器分析日志
UART 运行时日志几乎都由驱动读取某个寄存器后产生。本章按寄存器地址从低到高的顺序逐个分析:该寄存器的作用、哪些位触发哪些日志、日志背后的机制,以及对应的调试手段。寄存器地址与位定义见 1.4 节。
3.1 DLL/DLH 分频寄存器与 LCR(索引 0/1、3):波特率相关日志
波特率由 LCR 的 DLAB 位 + DLL/DLH 分频系数决定(见 1.4.2)。这一组寄存器关联三条日志。
ttyS%d set divisor fail, quot:%d != dll,dlh:%d
机制:serial8250_set_divisor() 置 DLAB 写入 DLL/DLH 后回读校验,读回值与写入值不一致(Rockchip 补丁,8250_port.c:2802)。
常见原因:
- 控制器时钟未真正使能,寄存器写入无效。
- 控制器处于 BUSY 状态(USR bit0),此时不应修改波特率。
- 总线访问异常。
分析:devmem 读 USR(基址 + 0x7c)确认 busy 位;再核对 clk_summary 中 pclk/baudclk 是否使能。
set rate:%ld, but get rate:%d
机制:Rockchip 分支设置波特率时钟时,小数分频失败后改用整数分频,实际频率与目标偏差仍超过 2%(8250_dw.c:398/401)。
后果:波特率误差偏大,高速通信可能出现 frame error。检查时钟父链能否整除出目标频率。
clock rate not defined
probe 阶段时钟已使能但频率为 0(8250_dw.c:688),见第 2 章。此时 base_baud 无从谈起,波特率必然错误。
验证 base_baud:probe 成功日志中的 base_baud = uartclk / 16,应与 clk_summary 中 uart 时钟频率对应。偏差大说明时钟配置错误。
3.2 IIR 中断标识寄存器(索引 2 读):决定中断路径
IIR(物理偏移 0x08)本身不产生日志,但中断类型决定走哪条处理路径,这些路径上的问题往往没有日志,是调试盲区。
RX_TIMEOUT 与假读(无日志的错误处理)
机制:DesignWare 存在 RX_TIMEOUT 中断置位但 FIFO 为空的状态。dw8250_handle_irq() 通过一次假读清除(8250_dw.c:267)。若该逻辑未生效,中断会无限触发。
现象:没有明确错误日志,但 CPU 占用异常、系统卡顿,甚至 RCU stall。
分析:
cat /proc/interrupts # 串口中断计数疯狂增长
结合 dynamic debug 观察 IIR 值确认。
BUSY(IIR=0x07)
DesignWare 修改配置期间的忙状态中断,处理方式是读 USR 清除(8250_dw.c:300),见 3.7。
RLSI(IIR=0x06)
线路状态中断,触发 3.5 节的全部错误日志。
RDI / THRI
接收数据 / 发送保持寄存器空中断,正常收发路径,无日志。
3.3 FCR FIFO 控制寄存器(索引 2 写)
FCR 控制 FIFO 使能、清空和触发级别。
TX FIFO Threshold errors, skipping
serial8250_startup() 中设置 Altera 端口 TX 触发级别时越界(8250_port.c:2425)。RK3506 的 DW UART 不会触发,仅在使用 Altera 16550 变体时出现。
无日志的相关行为:Rockchip 的 serial8250_rx_dma() 会临时改写 FCR 触发级别再恢复(8250_dma.c:231),属于 DMA 路径的正常操作。
3.4 MCR Modem 控制寄存器(索引 4):无错误日志
MCR(物理偏移 0x10)控制流控和环回,驱动中没有针对它的错误日志:
UART_MCR_AFE:自动 RTS/CTS 硬件流控。CTS 无效时发送暂停,现象是”发不出去”而非报错。UART_MCR_LOOP:环回测试模式,控制器内部短接 TX/RX,可用于隔离板内问题。UART_MCR_RTS:RS485 方向控制复用该位。
3.5 LSR 线路状态寄存器(索引 5):错误日志的主要来源
LSR(物理偏移 0x14)是错误定位的核心寄存器,驱动每次接收中断都会读它。错误位:
| 位 | 宏 | 含义 |
|---|---|---|
| OE | UART_LSR_OE | Overrun:新数据到达时旧数据还没被读走,数据丢失 |
| PE | UART_LSR_PE | Parity:校验位错误 |
| FE | UART_LSR_FE | Frame:停止位无效,通常是波特率不匹配或电气干扰 |
| BI | UART_LSR_BI | Break:RX 被拉低超过一帧时间 |
触发的日志:当中断是线路状态中断(IIR=RLSI)且 LSR 带错误位时,Rockchip 在 serial8250_handle_irq() 中增加的直接打印(8250_port.c:2014):
if ((iir & 0xf) == UART_IIR_RLSI &&
(status & UART_LSR_BRK_ERROR_BITS)) {
if (status & UART_LSR_OE)
pr_err("%s: Overrun error!\n", port->name);
...
pr_err("%s: maybe rx pin is low or baudrate is not correct!\n",
port->name);
}
ttyS4: Overrun error!
ttyS4: Break interrupt!
ttyS4: Parity error!
ttyS4: Frame error!
ttyS4: maybe rx pin is low or baudrate is not correct!
最后一句是 Rockchip 给出的排查提示:RX 引脚被拉低或波特率不对。这些日志用 pr_err() 直接打印,出现即说明物理层或配置有问题。
以下按位逐个分析。
OE 位:Overrun error
机制:接收 FIFO 已满,上一个字符还没被驱动读走,新字符又完成了接收,硬件丢弃数据并置位 OE。
驱动侧背景:serial8250_rx_chars() 每次中断最多读 256 个字符。只要中断能及时进来,FIFO 不会溢出。因此 overrun 几乎总是”中断来得太晚”或”数据没人搬”。
常见原因:
- DMA 未生效,纯中断模式跑高波特率(如 1.5M 以上突发数据)。
- 本中断被长时间屏蔽或抢占(其他 IRQ、长自旋锁临界区)。
- CPU 满载,softirq/线程处理不过来。
分析步骤:
cat /proc/tty/driver/serial # 对比 oe 增量
dmesg | grep -i "interrupt mode" # 确认 DMA 是否回退
cat /proc/interrupts # 观察串口中断计数增速
若降波特率后 oe 不再增长,即可确认是吞吐能力问题。
FE 位:Frame error
机制:UART 没有时钟线,接收方从 start bit 下降沿开始,按波特率逐位采样。若双方波特率不一致,采样点逐位漂移,到停止位时采到低电平,即 frame error。
常见原因:
- 波特率不匹配(最常见)。
- 数据位、停止位配置不一致(如一方 8N1 一方 8N2)。
- RX 悬空或干扰,被误认为 start bit。
- 时钟源误差大,
base_baud与配置值偏差超过 3%。
分析步骤:
- 双方统一改为 9600 8N1 重试。低速下容错高,若恢复正常即是波特率问题。
- 对比 probe 日志中的
base_baud与clk_summary里 uart 时钟频率。 - 示波器测一个位的宽度,换算实际波特率。
PE 位:Parity error
机制:校验位与数据位的奇偶关系不符合预期。
常见原因:
- 一端开校验、另一端没开(或奇偶设置相反)。
- 电气噪声恰好破坏校验位。
嵌入式场景普遍使用 8N1 无校验。出现 PE 时先检查双方 termios:
stty -F /dev/ttyS4 | grep -i parity
BI 位:Break interrupt
机制:RX 持续低电平超过一帧时间(start + 数据位 + 校验 + 停止位),硬件判定为 break。
常见原因:
- 对端主动发送 break(如 SysRq、协议约定)。
- 热插拔线缆、接触不良瞬间拉低 RX。
- RX 短路到 GND。
分析:break 常伴随 frame error 一起出现。若 brk 和 fe 同时增长,优先怀疑电气和接线;只有单独、偶发的 break,才考虑对端有意发送。驱动侧另有 handling break 调试日志(8250_port.c:1817,需 dynamic debug)。
LSR 读出 0xff:LSR safety check engaged
机制:serial8250_startup() 读 LSR 得到 0xff(全 1)。真实 UART 的 LSR 不可能为 0xff,说明该地址上没有设备响应,读到的是悬空总线值(8250_port.c:2393)。
常见原因:
- 设备树
reg地址写错。 - 时钟或复位未解除,控制器不响应总线访问。
结果:startup 返回 -ENODEV,端口打开失败。
错误计数与 tty 标志
serial8250_do_read_char()(8250_port.c:1769)对每个接收字符检查 LSR,并累加 port->icount:
if (lsr & UART_LSR_BI) port->icount.brk++;
else if (lsr & UART_LSR_PE) port->icount.parity++;
else if (lsr & UART_LSR_FE) port->icount.frame++;
if (lsr & UART_LSR_OE) port->icount.overrun++;
随后转换为 tty 标志 TTY_BREAK、TTY_PARITY、TTY_FRAME,交给 uart_insert_char()(serial_core.c:3361):
ignore_status_mask决定哪些错误被丢弃。- flip buffer 满时累加
icount.buf_overrun,这是软件缓冲溢出,和硬件 OE 不同。
各错误常见原因汇总:
| 错误 | 常见原因 |
|---|---|
| Frame error | 波特率不匹配、数据位/停止位配置不一致、RX 悬空或干扰 |
| Parity error | 双方校验配置不一致 |
| Overrun | CPU/DMA 来不及取数:中断被长时间屏蔽、波特率过高、DMA 未生效 |
| Break | 对端主动发 break、RX 短路到地、插拔线缆瞬间 |
| buf_overrun | 用户态读取太慢或 tty flip buffer 不足 |
调试:devmem 基址+0x14 32 直接读 LSR 看当前状态;cat /proc/tty/driver/serial 看累计计数。
3.6 MSR Modem 状态寄存器(索引 6):无错误日志
MSR(物理偏移 0x18)反映对端流控信号状态,驱动中没有针对它的错误日志:
- CTS/DSR/DCD/RI 位反映对端信号当前电平;CTS 无效时发送暂停,现象是”发不出去”而非报错。
- 低 4 位是 delta 位(变化标志),读后清零,驱动用它检测流控变化。
- 设备树可用
cts-override、dsr-override、dcd-override属性强制信号有效(8250_dw.c:630附近),常用于没有流控线的场景。
调试:devmem 基址+0x18 32 读 MSR,确认 CTS(bit4)是否有效;检查对端是否拉住了流控线。
3.7 USR 状态寄存器(物理 0x7c):BUSY 保护
USR bit0 为 BUSY。控制器在修改波特率等配置时会进入 busy,此时写 LCR/DLL 无效。
相关错误处理:
dw8250_handle_irq()收到UART_IIR_BUSY时读 USR 清除(8250_dw.c:300)。- RX timeout 假读逻辑先读 USR 确认控制器不忙(
8250_dw.c:273)。 - USR 长期 busy 会导致分频系数写入失败,表现为 3.1 节的
set divisor fail。
调试:devmem 基址+0x7c 32,正常空闲时应为 0。
3.8 CPR/UCV 配置与版本寄存器(物理 0xf4/0xf8)
CPR(物理 0xf4)和 UCV(物理 0xf8)是综合时固化的配置,只读。
CPR is not available, using 0x%08x instead
CPR 读出 0 时使用驱动内置值(8250_dwlib.c:328)。RK 分支内置 0x00023ff2(8250_dw.c:853),解码出 FIFO 深度 32 字节。这是 dbg 级别日志,需 dynamic debug。
Designware UART version %c.%c%c
UCV 读出的控制器版本号(8250_dwlib.c:310),dbg 级别。UCV 为 0 则跳过全部扩展特性探测。
detected caps %08x should be %08x
端口能力自动检测(autoconf)结果与预期不符(8250_port.c:1372)。通常说明寄存器访问异常或端口类型判断有误,伴随收发异常时优先检查时钟和复位。
无日志但关键:CPR 决定的 fifosize 是 DMA 启用的前提,见第 5 章。
4. 电平属性分析
UART 错误有很大比例来自电气层面。日志只能告诉你”错了”,电平分析才能回答”为什么错”。
4.1 UART 信号与电平基础
UART 是异步协议,无时钟线,电平约定:
- 空闲(Idle):高电平。
- Start bit:拉低一个位时间,通知接收方开始采样。
- 数据位:LSB 先发,每位一个位时间。
- 停止位:回到高电平。
因此空闲时 RX 必须是稳定的高电平。任何让 RX 悬空或被拉低的因素,都会被接收方当成 start bit 或错误位。
4.2 常见电平标准
| 标准 | 电平 | 说明 |
|---|---|---|
| TTL 3.3V | 0 / 3.3V | SoC 引脚直连,距离短(厘米到米级) |
| TTL 1.8V | 0 / 1.8V | 低压 IO 域,注意对端是否兼容 |
| RS232 | ±3 ~ ±15V,逻辑反相 | 必须经 MAX3232 等电平转换芯片 |
| RS485 | A/B 差分 | 半双工,需 DE/RE 方向控制 |
电平不匹配的典型后果:
- 5V 设备 TX 直连 3.3V SoC RX:高电平超过 IO 耐压,可能损坏引脚或读入错误。
- 3.3V SoC TX 直连 5V 设备:3.3V 高电平可能低于 5V 端的识别门限,对端持续读错。
- TTL 设备直接接 RS232 接口:电平和极性都不对,必然全乱码。
4.3 RK3506 引脚电平属性配置
设备树 pinctrl 决定每个引脚的偏置。RK3506 的实际配置:
/* rk3506-pinctrl.dtsi:1187 */
uart0_xfer_pins: uart0-xfer-pins {
rockchip,pins =
/* uart0_rx */
<0 RK_PC7 1 &pcfg_pull_up>,
/* uart0_tx */
<0 RK_PC6 1 &pcfg_pull_up>;
};
/* rk3506-pinctrl-rmio.dtsi:13364 */
rm_io27_uart4_tx: rm-io27-uart4-tx {
rockchip,pins = <1 RK_PC2 24 &pcfg_pull_none>;
};
rm_io27_uart4_rx: rm-io27-uart4-rx {
rockchip,pins = <1 RK_PC2 25 &pcfg_pull_up>;
};
偏置定义在 rockchip-pinconf.dtsi:9:
pcfg_pull_up: pcfg-pull-up {
bias-pull-up;
};
pcfg_pull_none: pcfg-pull-none {
bias-disable;
};
设计意图:
- RX 上拉:保证空闲为高电平。RX 悬空时引脚电平不定,噪声会被当成 start bit,产生随机的 frame error 和 break。
- TX 无上拉或上拉:TX 是输出,正常驱动时偏置不影响信号;上拉的作用是在控制器尚未使能(如 bootloader 前)时保持线路高电平,避免对端收到乱码。
电压域:EVB1 上 uart4 引脚属于 vccio1 域(rk3506g-evb1-v10.dts:143 注释)。IO 域电压由外部电源决定,对端设备电平必须与该域一致。
4.4 电平问题与日志的对应关系
| 电平问题 | 典型日志/计数表现 |
|---|---|
| RX 悬空(未接或断线) | 随机 Frame error!、Break interrupt!,fe/brk 持续增长 |
| 电平幅度不匹配 | 乱码 + 大量 frame error |
| 两端未共地 | 持续乱码,错误计数快速增长 |
| 长线无屏蔽 | 偶发 fe/oe,数据偶尔丢字节 |
| RX 被拉低(短路/对端常发 break) | 持续 Break interrupt! |
4.5 电平测量方法
- 万用表测 RX 空闲电压:应接近所在 IO 域电压(如 3.3V)。明显偏低(如低于 2V)说明接线、电平或对端驱动有问题。
- 示波器测 RX/TX 波形:确认幅度、位宽(换算波特率)、边沿是否干净、空闲是否稳定为高。
- 检查两端是否共地:TTL 直连必须接 GND。
- 怀疑板内电平时,断开外设,短接本端 TX/RX 自环测试,隔离板内与板外问题。
5. UART DMA 机制与错误处理
UART 高速收发时,中断模式每收几个字节就要进一次中断。DMA 让控制器直接把 FIFO 数据搬到内存,CPU 只在传输完成或超时时介入。RK3506 的 DMA 控制器是 ARM PL330(rk3502.dtsi:510)。
5.1 DMA 何时被启用
两个条件都要满足:
-
probe 阶段:
dw8250_probe()中只有fifosize有效才挂上 DMA 结构(8250_dw.c:724):if (p->fifosize) { data->data.dma.rxconf.src_maxburst = p->fifosize / 4; data->data.dma.txconf.dst_maxburst = p->fifosize / 4; up->dma = &data->data.dma; } -
端口打开阶段:
serial8250_do_startup()调用serial8250_request_dma()。内核控制台端口禁止 DMA(打印forbid DMA for kernel console);请求失败则打印failed to request DMA, use interrupt mode并置up->dma = NULL,回退中断模式(8250_port.c:2554)。
因此”有 DMA 配置”不等于”DMA 在跑”,必须看启动日志确认。
5.2 设备树 DMA 描述
uart 节点的 dmas 属性(rk3502.dtsi:571):
dmas = <&dmac0 4 0xff2880a8 0x03000100 0x0 0x0>,
<&dmac0 5 0xff2880a8 0x0c000400 0x0 0x0>;
dmac0 是 PL330,#dma-cells = <5>:第一个 cell 是通道号,其余描述外设请求参数。两行分别对应 RX 和 TX 通道。dmas 缺失或通道被其他设备占用时,请求会失败并回退中断模式。
5.3 DMA 请求与能力检查
serial8250_request_dma()(8250_dma.c:329)的失败路径:
| 失败点 | 返回码 | 原因 |
|---|---|---|
dma_request_slave_channel_compat() 拿不到 rx 通道 | -ENODEV | dmas 未配、通道被占用、DMA 驱动未加载 |
| rx 通道不支持 pause/terminate,或 residue 粒度太粗 | -EINVAL | DMA 驱动能力不足 |
dma_alloc_coherent() 分配 rx 缓冲失败 | -ENOMEM | 内存不足(RK 版本缓冲为 2 页) |
TX 通道是可选的:拿到则打印 got rx and tx dma channels,只拿到 RX 则打印 got rx dma channels only。这些失败最终都表现为 2.3 节的回退警告。
5.4 RX DMA 路径(Rockchip 实现)
Rockchip 分支(CONFIG_NO_GKI)使用循环 DMA:
- 请求成功后立即
serial8250_start_rx_dma(),用dmaengine_prep_dma_cyclic()提交循环传输,不设回调(8250_dma.c:264)。 - RX timeout 中断里,
handle_rx_dma()只处理UART_IIR_RX_TIMEOUT,调用serial8250_rx_dma()(8250_port.c:1962)。 serial8250_rx_dma()读 DMA residue 算出已收字节数,从循环缓冲拷入 tty;FIFO 里 DMA 没搬完的剩余字节用 PIO 读出补齐(8250_dma.c:231)。- 任何一步失败,
serial8250_handle_irq()回退到 PIO 的serial8250_rx_chars()(8250_port.c:2039)。
要点:RX DMA 模式下数据仍然靠中断触发搬运,只是单次中断搬走的数据量更大。
5.5 TX DMA 路径
__start_tx()优先尝试tx_dma()(8250_port.c:1579)。- Rockchip 分支规定小于 64 字节(
MAX_TX_BYTES)的传输不走 DMA,返回-EBUSY改用 PIO,避免小数据量下 DMA 建立开销大于收益(8250_dma.c:157)。 - DMA 传输成功后,完成回调
__dma_tx_complete()推进 xmit 环形缓冲的 tail,并尝试续传下一段(8250_dma.c:21)。 desc准备失败时置dma->tx_err = 1并回退 PIO。
5.6 DMA 相关问题与日志对照
| 现象/日志 | 含义与排查 |
|---|---|
failed to request DMA, use interrupt mode | DMA 未生效。高速场景 overrun 风险增大;按 6.3 表查原因 |
got rx dma channels only | TX 走 PIO,大量发送时 CPU 占用偏高 |
| 高速接收丢数据、oe 增长 | 对比中断模式与 DMA 模式;检查 PL330 是否报错 |
| 收发正常但 CPU 占用高 | 确认是否回退到了中断模式 |
5.7 DMA 调试方法
dmesg | grep -iE "dma|serial" # 确认是否回退中断模式
ls /sys/class/dma/ # 系统有哪些 DMA 通道
cat /sys/kernel/debug/dmaengine/summary # 通道分配情况(需 CONFIG_DMADEVICES_DEBUG)
cat /proc/tty/driver/serial # rx 计数验证数据是否真的到达
怀疑 DMA 本身故障时,可临时在设备树删除 dmas 属性强制中断模式对比:若问题消失,说明与 DMA 路径相关。
6. 日志机制与调试开关
6.1 日志 API 约定
驱动中按严重程度选择 API,读代码时据此判断问题级别:
| API | 用途 |
|---|---|
dev_err_probe() | probe 失败,自动处理 defer 不打印 |
dev_err() / pr_err() | 必须处理的错误 |
dev_warn_ratelimited() | 可恢复但异常,限频防止刷屏 |
dev_dbg() / pr_debug() | 默认关闭,需 dynamic debug 打开 |
6.2 提高内核日志可见度
dmesg -n 8 # 控制台 loglevel 调到最高
dmesg -w # 实时跟踪
cat /proc/cmdline # 确认 earlycon / console / loglevel 参数
RK3506 默认 bootargs 包含 earlycon=uart8250,mmio32,0xff0a0000 console=ttyFIQ0:earlycon 在驱动 probe 前就能输出日志,ttyFIQ0 是 Rockchip FIQ debugger 提供的调试控制台(drivers/soc/rockchip/fiq_debugger/)。启动早期挂死时,earlycon 是唯一能看到日志的手段。
6.3 dynamic debug
打开 8250 的 dev_dbg/pr_debug:
mount -t debugfs none /sys/kernel/debug # 若未挂载
echo 'file drivers/tty/serial/8250/* +p' > /sys/kernel/debug/dynamic_debug/control
例如可看到 handling break 等调试信息。关闭时把 +p 改为 -p。
6.4 端口统计:/proc/tty/driver/serial
cat /proc/tty/driver/serial
输出示例(字段来自 serial_core.c:2006):
serinfo:1.0 driver revision:
4: uart:16550A MMIO:0xff0e0000 irq:68 tx:1024 rx:2048 oe:3 fe:1
tx/rx:收发字符总数。oe/fe/pe/brk/bo:overrun、frame、parity、break、软件缓冲溢出计数。
调试前先记录一次,复现问题后再读一次,对比增量即可判断错误类型。
6.5 Rockchip 收发包 trace
serial8250_trace_packet()(8250_port.c:1741)是 Rockchip 加入的收包十六进制打印:
ttyS4 RX [1234.567] len=8 offset=0 data=01 02 03 04 05 06 07 08
注意当前代码中该功能硬编码只对 ttyS4 生效(SERIAL8250_TRACE_LINE 定义为 4,注释写明复现于 RK3506 EVB1 UART4),且使用 printk_deferred() 在中断上下文直接输出。学习时可参考其实现,实际项目建议改用 dynamic debug 或 ftrace,避免硬编码端口号。
7. 分层调试方法
按从底层到上层的顺序排查,确认一层再上一层:
设备树和DTB
-> probe与驱动绑定
-> 时钟、复位、pinctrl
-> 中断
-> 寄存器(LSR/USR/IIR)
-> 引脚电平和波形
-> tty层和用户态
7.1 检查绑定与资源
dmesg | grep -i serial
ls /sys/bus/platform/drivers/dw-apb-uart/ # 看绑定了哪些设备
cat /proc/interrupts | grep serial # 中断号与计数
cat /sys/kernel/debug/clk/clk_summary | grep uart # 时钟频率是否为预期值
中断计数不增长:检查设备树中断号、触发方式,以及对端是否真的有数据。
7.2 检查 tty 配置与收发
stty -F /dev/ttyS4 115200 cs8 -cstopb -parenb raw
cat /proc/tty/driver/serial
echo hello > /dev/ttyS4 # 发送测试
cat /dev/ttyS4 # 接收测试
预期:对端收到 hello;短接本端 TX/RX 自环时能收到自己发的数据。
7.3 寄存器级确认
用 devmem 直接读寄存器(寄存器布局见 1.4 节):
devmem 0xff0e0014 32 # uart4 LSR:bit0 DR=有数据,bit1 OE,bit2 PE,bit3 FE
devmem 0xff0e007c 32 # USR:bit0 BUSY
LSR 长期为 0 且 RX 有输入:怀疑 pinmux 或电气问题;BUSY 长期为 1:控制器状态异常。
7.4 波形确认
示波器或逻辑分析仪测 RX 引脚:
- 空闲应为高电平;持续低电平会产生 break 和 frame error。
- 测量单个位的宽度,换算实际波特率,与配置值对比(误差应小于 3%)。
- 时钟频率错误时,
base_baud和实际波形波特率会同时偏离。
8. 常见问题速查
| 现象 | 可能原因 | 验证方法 |
|---|---|---|
| 无任何 probe 日志 | 节点 status 未开、DTB 未更新、compatible 不匹配 | 反编译运行中 DTB 确认节点 |
| probe 一直 defer | 时钟/复位 provider 未就绪 | cat /sys/kernel/debug/devices_deferred |
clock rate not defined | 时钟父链未配置频率 | clk_summary 查 uart 时钟 |
| 收发全乱码 | 波特率时钟错误、pinmux 错 | 对比 base_baud 与波形位宽 |
| 大量 frame error | 波特率不匹配、RX 干扰 | 双方改 9600 对比,测波形 |
| 大量 overrun | 中断延迟、DMA 未生效、速率过高 | 看是否有 use interrupt mode,降速对比 |
| 能发不能收 | RX pinmux、断线、GND 未接 | 自环测试,测 RX 引脚电平 |
| 系统卡死伴 RX timeout | 假读逻辑未生效或硬件异常 | 打 dynamic debug 看 IIR 值 |
| 数据偶尔丢几个字节 | OE 或 buf_overrun | 对比 /proc/tty/driver/serial 增量 |
| 持续乱码且 fe 快速增长 | 两端未共地、电平幅度不匹配 | 万用表测空闲电平,检查共地和电平标准 |
| 空闲时随机出现 fe/brk | RX 悬空 | 检查 pinctrl 上拉配置和接线 |
持续 Break interrupt! | RX 短路到地、对端持续发 break | 断开对端测 RX 空闲电压 |
高速接收丢数据且出现 use interrupt mode | DMA 请求失败回退中断模式 | 按第 5 章检查 dmas、通道占用和 DMA 能力 |
| 发送大量数据 CPU 占用高 | TX DMA 未生效或小包走 PIO | dmesg 确认 got rx and tx dma channels |
9. 练习
- 在板子上执行
dmesg | grep ttyS,找到 uart4 的 probe 成功日志,解释每个字段,并验证base_baud与时钟树一致。 - 读取
/proc/tty/driver/serial,记录 tx/rx/oe/fe;短接 TX/RX 以错误波特率自发自收,观察新增的错误日志和计数。 - 用 dynamic debug 打开 8250 调试日志,发送一个字节,跟踪从
dw8250_handle_irq到 tty 的路径。 - 阅读
serial8250_do_read_char()(8250_port.c:1769),说明 OE、FE、PE、BI 同时出现时计数和 tty 标志如何处理,为什么 break 优先。 - 对比
uart0_xfer_pins与rm_io27_uart4_tx/rx的 pinctrl 配置,解释 RX 用pcfg_pull_up、TX 用pcfg_pull_none的原因,并预测 RX 去掉上拉且线缆悬空时会出现哪些错误日志。 - 用万用表测量一个 UART RX 引脚的空闲电平,确认其与所在 IO 域电压一致;再用示波器测一帧波形,换算实际波特率并与配置值对比。
- 阅读
serial8250_request_dma()(8250_dma.c:329),列出三个失败返回码及触发条件;在板子上确认当前端口是 DMA 模式还是中断模式,并说明判断依据。 - 对比 Rockchip 分支与通用分支的
serial8250_rx_dma()实现,说明循环 DMA 与单次 DMA 的区别,以及为什么 Rockchip 版本要在中断里用 PIO 补读剩余字节。 - 用
devmem读一个未打开端口的 LSR、IIR、USR、CPR,对照 1.4 节逐位解释;再说明为什么 USR/RFL 的宏定义要移位而 DMASA/CPR 不需要。
10. 附录:UART 驱动日志完整清单
以下清单覆盖 RK3506 UART 相关全部源文件中的日志。前文已详细分析的条目只给章节引用,其余逐条说明。
10.1 驱动初始化与端口注册
| 日志 | 级别 | 位置 | 含义与处理 |
|---|---|---|---|
Serial: 8250/16550 driver, %d ports, IRQ sharing %sabled | info | 8250_core.c:1183 | 驱动模块初始化横幅,正常日志。可确认编译的端口数和 IRQ 共享开关 |
unable to register port at index %d (IO%lx MEM%llx IRQ%d): %d | err | 8250_core.c:842 | ISA/PNP 风格端口注册失败。RK3506 走 DT 路径一般不会触发 |
skipping CIR port at 0x%lx / 0x%llx, IRQ %d | info | 8250_core.c:1103 | 跳过红外(CIR)端口,正常行为 |
Cannot register tty device on line %d | err | serial_core.c:3162 | tty 设备注册失败,用户态将看不到 /dev/ttySx。检查 tty 驱动号和 line 编号冲突 |
%s%s at MMIO 0x%x (irq = %d, base_baud = %d) is a %s | info | serial_core.c:2535 | probe 成功标志,见 2.1 |
%s extra baud rates supported: %d, %d | info | serial_core.c:2543 | 端口支持额外波特率(magic multiplier),RK3506 不触发 |
SysRq is enabled by magic sequence '%s' on serial | info | serial_core.c:3388 | 串口 SysRq 魔序列使能提示,正常日志 |
10.2 时钟与波特率
| 日志 | 级别 | 位置 | 含义与处理 |
|---|---|---|---|
set rate:%ld, but get rate:%d | info | 8250_dw.c:398/401 | Rockchip 分支:小数分频失败后改用整数分频,实际频率与目标偏差仍超过 2%。波特率误差会偏大,高速通信可能出现 frame error。检查时钟父链能否整除出目标频率 |
ttyS%d set divisor fail, quot:%d != dll,dlh:%d | warn | 8250_port.c:2804 | 见 3.1 |
Designware UART version %c.%c%c | dbg | 8250_dwlib.c:310 | 读控制器版本寄存器,仅 dynamic debug 可见 |
CPR is not available, using 0x%08x instead | dbg | 8250_dwlib.c:328 | CPR(配置参数寄存器)读不到,使用设备树/驱动内置值。RK 分支内置 0x00023ff2(8250_dw.c:853),决定 fifosize 等参数 |
10.3 运行时线路与收发
| 日志 | 级别 | 位置 | 含义与处理 |
|---|---|---|---|
Overrun/Break/Parity/Frame error! | err | 8250_port.c:2020-2026 | 见 3.5 |
maybe rx pin is low or baudrate is not correct! | err | 8250_port.c:2028 | 见 3.5 |
handling break | dbg | 8250_port.c:1817 | 收到 break 的调试跟踪,需 dynamic debug |
LSR safety check engaged! | info | 8250_port.c:2393 | 见 3.5 |
TX FIFO Threshold errors, skipping | err | 8250_port.c:2425 | 仅 Altera 端口类型触发,RK3506 不会出现 |
enabling bad tx status workarounds | dbg | 8250_port.c:2530 | 检测到控制器 TX 状态位不可靠(UART_BUG_TXEN),启用备用定时器轮询。出现时说明硬件有勘误行为 |
%s: Unable to drain transmitter | err | serial_core.c:2393 | 关闭端口时等待发送 FIFO 排空,3 次 10ms 重试后仍未空。常见于发送中途关闭端口、时钟异常或对端流控拉住。偶发可忽略,持续出现要查 TX 通路 |
%s %s [时间戳] len=%zu offset=%zu data=%*ph | info | 8250_port.c:1760 | Rockchip 收发包 trace,见 6.5 |
10.4 RS485 配置(serial_core.c)
用户态通过 TIOCSRS485 配置 RS485 时,参数不合法会打印以下警告并自动修正:
| 日志 | 位置 | 含义 |
|---|---|---|
%s (%d): RTS delay before sending not supported | serial_core.c:1330 | 请求的发送前 RTS 延时不被支持,已清零 |
%s (%d): RTS delay before sending clamped to %u ms | serial_core.c:1337 | 延时超过上限,已截断 |
%s (%d): RTS delay after sending not supported | serial_core.c:1344 | 发送后 RTS 延时不被支持,已清零 |
%s (%d): RTS delay after sending clamped to %u ms | serial_core.c:1351 | 发送后延时超过上限,已截断 |
%s (%d): invalid RTS setting, using RTS_ON_SEND instead | serial_core.c:1375 | RTS_ON_SEND 与 RTS_AFTER_SEND 同时置位或同时清零,自动选前者 |
%s (%d): invalid RTS setting, using RTS_AFTER_SEND instead | serial_core.c:1382 | 同上,自动选后者 |
Cannot get rs485-term-gpios | serial_core.c:3489 | 获取 RS485 终端电阻 GPIO 失败,probe 报错 |
10.5 DMA 相关
| 日志 | 级别 | 位置 | 含义与处理 |
|---|---|---|---|
forbid DMA for kernel console | warn | 8250_port.c:2557 | 见 2.3 |
failed to request DMA, use interrupt mode | warn | 8250_port.c:2561 | 见 2.3、5.3 |
got rx and tx dma channels | info | 8250_dma.c:416 | RX/TX DMA 都请求成功 |
got rx dma channels only | info | 8250_dma.c:418 | 只有 RX DMA,TX 走 PIO |
dma channels released | dbg | 8250_dma.c:459 | 端口关闭释放 DMA,需 dynamic debug |
10.6 8250_of.c(非 DW 兼容路径)
compatible 为 ns16550a 等旧式节点走 8250_of.c,RK3506 的 UART 不走这条路径,但同内核可能出现:
| 日志 | 位置 | 含义与处理 |
|---|---|---|
failed to get clock: %d | 8250_of.c:53 | 无 clock-frequency 属性且时钟获取失败 |
invalid address | 8250_of.c:70 | reg 地址解析失败 |
reg-offset %u exceeds region size %pa | 8250_of.c:88 | reg-offset 超出 reg 区域 |
unsupported reg-io-width (%d) | 8250_of.c:112 | reg-io-width 只支持 1/2/4 |
10.7 纯调试日志(默认不输出)
以下日志需要 dynamic debug 或特殊编译开关,正常 dmesg 看不到,读代码时遇到不用奇怪:
| 日志 | 位置 | 说明 |
|---|---|---|
serial8250_interrupt(%d): start/end | 8250_core.c:114/140 | 中断进出跟踪 |
%s - using backup timer | 8250_core.c:310 | UART_BUG_THRE 勘误启用备用定时器 |
uart_flush_buffer/uart_close/uart_wait_until_sent/uart_hangup | serial_core.c:647/1721/1810/1840 | tty 操作函数跟踪 |
DEBUG_AUTOCONF 系列(950id=、EFRv1、IER test failed、LOOP test failed 等) | 8250_port.c:57 | 端口类型自动配置跟踪,源码中 #if 0 默认关闭,需改代码打开 |
注释掉的 Couldn't set LCR to %d | 8250_dw.c:137 | 已注释,不会输出 |