嵌入式 Linux 与 RTOS / 系统课时

调通 UART 串口设备

调通 UART 串口设备

串口能收发之前,既要让 UART 控制器驱动成功,也要让 tty 层正确创建设备节点并匹配通信参数。本节从设备关系、设备树、节点检查到 stty 配置走一遍,并区分控制台串口、普通串口和由内核协议驱动占用的串口。

学习目标

  • 说明 tty、串口核心与 UART 控制器驱动之间的职责关系
  • 检查串口设备节点,并正确设置波特率、数据位、校验位和流控
  • 判断一个 UART 应作为内核控制台、普通字符设备还是协议层总线使用

先看清 UART 在 Linux 中的位置

用户空间通常面对 /dev/ttyS*、/dev/ttyAMA* 等 tty 设备,而不是直接操作 UART 寄存器。tty core 提供字符设备语义,serial core 负责串口通用能力,具体 UART 驱动再把这些操作映射到 SoC 控制器寄存器和引脚。

UART 从用户空间到控制器的数据路径

因此“有 UART 控制器”和“出现 /dev/tty* 节点”不是同一件事。控制器可能被禁用、引脚复用未配置,也可能已经被内核中的蓝牙、GNSS 等协议驱动作为消费者绑定。

在设备树中启用控制器

下面是片段示例,依赖 SoC 已有的 UART 控制器节点和 pinctrl 定义;节点名、时钟与引脚组必须以当前板级 DTS/DTSI 为准。

text
&uart2 {
    pinctrl-names = "default";
    pinctrl-0 = <&uart2_pins>;
    status = "okay";
};

这段配置生效后,内核应探测对应 UART 驱动并注册 tty 设备。若该 UART 还被其他设备节点通过 serdev 等机制引用,就不要同时把它当作普通用户空间串口打开,否则会形成资源归属冲突。

验证时先看内核日志和设备节点。<PATH> 代表实际串口设备,例如 /dev/ttyS1。

bash
DEV="<PATH>"
test -c "$DEV" || { echo "missing tty device: $DEV"; exit 1; }
printf 'tty node ready: %s\n' "$DEV"

预期输出

text
tty node ready: <PATH>

如果节点不存在,优先检查设备树 status、pinctrl、时钟与复位,再确认对应 UART 驱动是否已编入内核或成功加载;不要先用 mknod 人工造节点,因为那不会让硬件驱动真正工作。

配置通信参数并做最小验证

两端参数必须一致。下面把串口设置为 115200 bit/s、8 数据位、1 停止位、无校验,并关闭软件与硬件流控。运行前把 <PATH> 替换为实际 tty 设备。

bash
DEV="<PATH>"

stty -F "$DEV" 115200 cs8 -cstopb -parenb \
  -ixon -ixoff -crtscts

printf 'UART configured: %s, 115200 8N1, flow-control=off\n' "$DEV"

预期输出

text
UART configured: <PATH>, 115200 8N1, flow-control=off

若对端使用 RTS/CTS 硬件流控,则应确认原理图确实连接 RTS/CTS,并启用 crtscts;只改软件参数而板上没有对应信号线,常见结果是发送端一直等待。

随后可用串口助手或另一块板做回环/对发测试。TX 与 RX 必须交叉连接并共地;若做本机回环,则临时将本 UART 的 TX 与 RX 相连。收发正常但偶发乱码时,优先核对波特率时钟误差、地线质量、逻辑电平和流控,而不是立即修改驱动。

区分三类串口用途

控制台串口由内核启动参数中的 console=ttySx,<baud> 或平台等价配置指定,内核日志和登录终端可能持续占用它。把应用协议也放到同一个 tty 上,会出现启动日志混入业务数据、登录程序抢读字节等问题。

普通串口没有内核协议消费者,适合用户空间通过 tty API 或工具直接打开。此时设备节点、权限、波特率和线路参数是主要检查点。

协议层设备则由内核驱动在 UART 之上实现蓝牙 HCI、GNSS 或其他设备协议,常通过 serdev 绑定。此时目标不是“找到一个可随便打开的 /dev/tty*”,而是让对应协议驱动正确匹配并注册更高层设备。

出现故障时按链路定位

排查顺序应从“设备有没有出现”走向“电气和协议是否一致”。先确认驱动探测和 tty 节点,再确认 pinctrl 与引脚复用,然后核对两端的 8N1、波特率和流控,最后再看示波器或逻辑分析仪上的实际波形。

如果发送命令成功但引脚没有波形,问题更接近控制器时钟、pinctrl 或驱动;如果有稳定波形但对端乱码,问题更接近波特率、时钟误差、电平或线路质量;如果字符正确但应用偶发丢包,则再检查流控、缓冲区和上层协议。按这条链路逐层收缩范围,比反复修改设备树或终端参数更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

调通 UART 串口设备

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通