嵌入式Linux串行驱动注册流程图解说明
深入嵌入式Linux串口驱动注册机制：从代码到设备节点的完整路径
在调试一块新板子时，你是否曾遇到过这样的问题——明明硬件接好了，串口线也插上了，但就是看不到
/dev/ttyS0
？或者打开设备后读出的数据全是乱码？这些问题背后，往往隐藏着对
Linux串行驱动注册流程
理解不够深入的根源。
今天我们就来“拆开内核”，一步步追踪一个物理UART控制器是如何从寄存器映射，最终变成用户空间可访问的字符设备文件的。这不仅关乎驱动能否正常工作，更是理解Linux设备模型和TTY子系统的绝佳入口。
为什么我们需要
serial_core
？
在嵌入式世界里，不同厂商的UART控制器长得五花八门：有的用内存映射寄存器（MMIO），有的走传统I/O端口（PIO）；中断触发方式有电平、边沿之分；时钟源也各不相同。如果每个驱动都从头实现一套TTY接口，那将是巨大的重复劳动。
于是，Linux内核设计了
serial_core
——位于
drivers/tty/serial/
的统一串口驱动框架。它就像一个“插座标准”，只要你按照规范接线（实现特定结构体），就能接入整个系统的电力网络（TTY子系统）。
它到底做了什么？
-
向上对接 TTY 子系统，提供标准的
open()、read()、write()等文件操作； - 向下封装通用逻辑，如波特率计算、termios配置转发；
-
中间管理设备生命周期，支持自动创建
/dev/ttySx节点； -
抽象出两个关键结构体：
uart_driver（驱动模板）和uart_port（具体端口实例）。
可以说，
没有
serial_core
，就没有今天我们高效稳定的串口支持体系
。
第一步：注册驱动类型 ——
uart_register_driver
想象你要开一家连锁咖啡店。首先得注册公司主体、确定品牌名、规划最多开几家分店。这就是
uart_register_driver()
干的事。
我们先定义一个“品牌”：
static struct uart_driver my_uart_driver = {
.owner = THIS_MODULE,
.driver_name = "my_serial",
.dev_name = "ttyMY", // 将生成 /dev/ttyMY0, ttyMY1...
.major = 0, // 0表示由内核自动分配主设备号
.minor = 0,
.nr = 4, // 最多支持4个串口实例
};
然后在模块初始化时注册这个“品牌”：
int __init my_serial_init(void)
{
int ret = uart_register_driver(&my_uart_driver);
if (ret) {
pr_err("Failed to register UART driver\n");
return ret;
}
pr_info("UART driver registered with major %d\n", my_uart_driver.major);
return 0;
}
内核内部发生了什么？
当你调用
uart_register_driver()
时，内核悄悄完成了以下几步：
-
分配状态数组
：根据
.nr值（这里是4），分配struct uart_state[nr]数组，用于跟踪每个端口的状态； -
创建TTY驱动实例
：生成一个
struct tty_driver，设置其ops.open = uart_open等回调函数； -
注册字符设备
：通过
cdev_add()将主设备号加入系统，等待后续绑定次设备号； -
准备设备类
：创建或引用名为
"tty"的 class，为udev/mdev动态生成设备节点做准备。
✅ 关键点：此时还没有任何硬件关联！这只是声明“我打算支持一种叫 ttyMY 的串口，最多4个”。真正的“开店营业”要等到硬件被发现。
第二步：添加实际端口 ——
uart_add_one_port
现在，Platform总线在设备树中发现了你的UART控制器，并调用了
.probe()
函数。这时才是“选址装修、正式开业”的时刻。
我们需要描述具体的硬件信息：
static struct uart_port my_uart_ports[4] = {
[0] = {
.line = 0,
.iotype = UPIO_MEM,
.mapbase = 0x48020000,
.irq = 24,
.uartclk = 48000000,
.ops = &my_uart_pops,
.flags = UPF_BOOT_AUTOCONF,
},
[1] = {
.line = 1,
.iotype = UPIO_MEM,
.mapbase = 0x48021000,
.irq = 25,
.uartclk = 48000000,
.ops = &my_uart_pops,
.flags = UPF_BOOT_AUTOCONF,
},
};
接着在
.probe()
中完成注册：
int my_uart_probe(struct platform_device *pdev)
{
struct resource *res;
int irq, idx = pdev->id;
struct uart_port *port;
if (idx >= ARRAY_SIZE(my_uart_ports))
return -ENODEV;
port = &my_uart_ports[idx];
/* 获取内存资源 */
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
port->mapbase = res->start;
port->membase = devm_ioremap_resource(&pdev->dev, res);
if (IS_ERR(port->membase))
return PTR_ERR(port->membase);
/* 获取中断 */
irq = platform_get_irq(pdev, 0);
if (irq < 0)
return irq;
port->irq = irq;
/* 绑定设备指针 */
port->dev = &pdev->dev;
/* 正式加入驱动框架 */
int ret = uart_add_one_port(&my_uart_driver, port);
if (ret) {
dev_err(&pdev->dev, "Failed to add port %d\n", idx);
return ret;
}
platform_set_drvdata(pdev, port);
dev_info(&pdev->dev, "Added UART port %d at %pap\n", idx, &res->start);
return 0;
}
这一步究竟干了啥？
uart_add_one_port()
是真正让设备“活起来”的关键函数，它的内部动作包括：
| 动作 | 说明 |
|---|---|
| 🔗 绑定关系 |
将
uart_port
与之前注册的
uart_driver
关联起来
|
| 🧱 初始化状态 |
初始化对应的
uart_state
和未来会用到的
tty_struct
|
| 💾 映射寄存器 |
若
.ops->setup_io()
存在，则调用进行地址映射（通常已在probe中完成）
|
| ⚡ 请求中断 |
调用
request_irq()
注册中断处理程序（延迟至第一次打开）
|
| 📣 通知用户空间 |
发送uevent事件，触发udev创建
/dev/ttyMY0
|
🛠️ 提示：如果你发现设备节点没出现，请检查是否漏掉了
uart_add_one_port()或者.line编号越界！
核心结构体详解：
uart_driver
vs
uart_port
| 结构体 | 角色 | 生命周期 |
|---|---|---|
struct uart_driver
| 驱动模板，代表一类设备（如所有 my-uart 控制器） | 全局唯一，模块加载时注册 |
struct uart_port
| 端口实例，代表一个物理串口通道（如 UART1） | 每个设备一份，在probe中填充并注册 |
你可以把前者看作“工厂生产线”，后者是“生产线上的一台机器”。
而其中最核心的成员之一是
.ops
—— 即
const struct uart_ops *ops;
，它定义了底层硬件如何响应各种操作：
static const struct uart_ops my_uart_pops = {
.tx_empty = my_uart_tx_empty,
.set_mctrl = my_uart_set_mctrl,
.get_mctrl = my_uart_get_mctrl,
.stop_tx = my_uart_stop_tx,
.start_tx = my_uart_start_tx,
.startup = my_uart_startup, // 首次打开时启用时钟等
.shutdown = my_uart_shutdown, // 关闭时释放资源
.set_termios = my_uart_set_termios, // 波特率、数据位等设置
.type = my_uart_type,
.release_port = my_uart_release_port,
.request_port = my_uart_request_port,
};
✅ 必须实现的关键函数：
-startup()/shutdown()：电源管理基础
-set_termios()：通信参数配置的核心
-start_tx()：启动发送的关键钩子
特别是
set_termios()
，它负责将用户设置的波特率转换为寄存器值，公式如下：
baud_base = port->uartclk / 16;
divisor = baud_base / desired_baud_rate;
若结果不准，就会导致 数据乱码 ——这是新手最常见的坑之一。
实际系统中的协作流程图解
在一个典型的ARM嵌入式Linux系统中，整个链路是这样协同工作的：
用户空间
┌──────────────────────┐
│ open("/dev/ttyMY0") │
└──────────────────────┘
↓
sys_call → VFS层查找inode
↓
TTY Layer（drivers/tty/）
调用 uart_open() → 查找 line=0 的 uart_state
↓
Serial Core 框架
调用 .ops->startup()
↓
Platform Driver
my_uart_startup() 中使能时钟、配置引脚复用
↓
Hardware (UART IP)
寄存器开始工作，进入可收发状态
整个过程高度模块化，每一层只关心自己的职责，却又无缝衔接。
常见问题排查清单
别再盲目重启了！以下是我在项目中总结的高频故障及应对策略：
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
/dev/ttySx
不存在
|
uart_add_one_port()
未调用
|
检查
.probe()
是否执行，
.line
是否合法
|
| 打开设备卡住 |
.ops->startup()
返回错误
| 检查时钟是否开启、GPIO复用是否正确 |
| 数据乱码 | 波特率不匹配 |
确认
uartclk
设置准确，检查PLL输出
|
| 接收不到数据 | 中断未触发 |
使用
cat /proc/interrupts
观察计数变化
|
| 多端口只能识别一个 |
.nr
设置太小
|
修改
uart_driver.nr
并重新编译模块
|
| 设备无法热拔插 | 未实现 suspend/resume |
添加
.suspend()
和
.resume()
回调
|
💡 秘籍：利用
printk在.startup()和.set_termios()中打印关键参数，可以快速定位初始化顺序问题。
最佳实践建议
经过多个项目的锤炼，这些经验值得铭记：
-
永远使用 Device Tree
不要硬编码地址和中断号。DTS示例如下：
dts serial@48020000 { compatible = "myvendor,my-uart"; reg = <0x48020000 0x1000>; interrupts = <GIC_SPI 24 IRQ_TYPE_LEVEL_HIGH>; clocks = <&clkc 48>; power-domains = <&power PD_UART>; status = "okay"; }; -
拥抱
devm_*资源管理
使用devm_ioremap_resource()、devm_request_irq()等函数，即使出错也能自动清理，避免泄漏。 -
合理启用 FIFO
在.config_port()中设置UPF_USE_FIFO标志，并根据芯片手册设置合适的触发级别（如16字节触发中断），大幅提升吞吐量。 -
实现完整的 ops 集合
特别是get_mctrl()和set_mctrl()，否则某些应用（如PPP拨号）可能失败。 -
支持低功耗模式
在.suspend()中关闭时钟、保存寄存器状态；.resume()中恢复。这对电池供电设备至关重要。 -
加入环回测试支持
通过 debugfs 提供 loopback 开关，便于产线自检硬件连通性。
写在最后：不只是串口，更是思维方式
掌握
serial_core
的注册流程，远不止学会写一个UART驱动那么简单。它教会我们：
- 抽象的价值 ：一个好的框架能让千差万别的硬件跑在同一套接口上；
- 分层的力量 ：每一层专注解决一个问题，组合起来却无比强大；
- 标准化的重要性 ：遵循规则比炫技更能保证长期稳定。
无论你是要做Modbus通信、连接GPS模块，还是调试无显示的嵌入式设备， 串口始终是最可靠的“生命线” 。而理解它的底层机制，就是握住了打开系统黑盒的钥匙。
下次当你看到
/dev/ttyS0
成功生成时，不妨想想背后这套精密协作的机制——它不仅是代码，更是一种工程智慧的体现。
如果你正在移植一个新的串口控制器，或者遇到了奇怪的注册问题，欢迎在评论区分享你的挑战，我们一起探讨解决方案。
更多推荐
21
0- 0
已为社区贡献19条内容
所有评论(0)