t113s3使用Tina5编译UART0时设备节点未生成？

Question

在Tina5系统下为T113-S3平台编译UART0时，常见问题为`/dev/ttyS0`设备节点未自动生成。根本原因多为：① DTS中`uart0`节点未正确使能（`status = "okay"`缺失或拼写错误）；② `pinctrl-0`引用的PIN组未在`sunxi-pinctrl.dtsi`中正确定义或复用模式配置错误（如将UART0_RX/TX误配为GPIO）；③ 内核配置未启用`CONFIG_SERIAL_SUNXI=y`及`CONFIG_SERIAL_SUNXI_CONSOLE=y`；④ udev规则或mdev未触发设备节点创建（尤其在精简根文件系统中缺少`/etc/init.d/S10udev`或`/proc/sys/kernel/hotplug`未指向`/sbin/mdev`）。验证步骤：检查`dmesg | grep uart`是否打印“sunxi-uart 1c28000.serial: ttyS0 at MMIO…”；确认`/sys/class/tty/`下是否存在`ttyS0`；若DTS和内核配置均无误，需排查设备树overlay加载顺序或initramfs中设备节点预生成缺失。

Answer 1

```html

一、现象层：UART0设备节点缺失的直观表现

在Tina5系统启动后执行 ls -l /dev/ttyS*，发现 /dev/ttyS0 完全不存在；stty -F /dev/ttyS0 报错 No such file or directory；串口调试器无法连接目标板的UART0物理引脚。该现象是整个问题链的终端表征，但绝非孤立故障——它必然由底层驱动、硬件描述或用户空间机制任一环节断裂导致。

二、日志验证层：通过内核消息定位根因起点

执行 dmesg | grep -i "uart\|serial"，重点关注以下三类输出：

• ✅ 正常路径：sunxi-uart 1c28000.serial: ttyS0 at MMIO 0x1c28000 (irq = 32) is a sun8i-uart
• ❌ 驱动未加载：serial: no console for device 1c28000.serial 或完全无任何 uart 相关 log
• ⚠️ PIN冲突警告：pinctrl core: could not find pin group uart0_pins

此阶段无需修改代码，仅靠日志即可快速分流至「DTS使能」「PIN复用」「内核配置」或「用户空间设备管理」四大方向。

三、设备树（DTS）深度核查层

检查项	正确写法	典型错误
status 属性	status = "okay";	status = "ok";、status = "disable";（应为"disabled"）、或整行缺失
pinctrl-0 引用	pinctrl-0 = <&uart0_pins>;	拼写成 &uart0_pin（少 s）、引用不存在的 label、或未在 sunxi-pinctrl.dtsi 中定义 uart0_pins

特别注意：T113-S3 的 UART0 默认复用在 PA0/PA1（TX/RX），需确认 uart0_pins 在 arch/arm/boot/dts/sunxi-pinctrl.dtsi 中明确定义为 function = "uart0"，而非 "gpio_in" 或空值。

四、内核配置与驱动编译层

Tina5 使用 make kernel_menuconfig 进入配置界面，必须确保以下选项被显式启用（=y，非 =m）：

CONFIG_SERIAL_SUNXI=y
CONFIG_SERIAL_SUNXI_CONSOLE=y
CONFIG_SERIAL_SUNXI_NR_UARTS=4   # 确保覆盖 UART0

若启用了 CONFIG_OF（默认开启），则驱动必须通过设备树匹配；若误设为 =m，将导致模块未自动加载且无 dmesg 输出——这是高级工程师也易忽略的“静默失败”场景。

五、用户空间设备节点生成机制层

Tina5 默认使用 mdev（BusyBox 实现）替代 udev。关键验证点：

1. 检查 /proc/sys/kernel/hotplug 是否为 /sbin/mdev（非空或指向其他程序）
2. 确认 /etc/init.d/S10mdev 存在且可执行（Tina5 中已弃用 S10udev）
3. 手动触发：echo add > /sys/class/tty/ttyS0/uevent（需先确保 ttyS0 在 /sys/class/tty/ 下可见）

若 /sys/class/tty/ttyS0 存在但 /dev/ttyS0 不生成，90% 概率是 mdev 规则缺失或 /etc/mdev.conf 未包含 ttyS[0-9]+ [0-9]:[0-9] 0660 条目。

六、进阶诊断：设备树 overlay 与 initramfs 干扰分析

当上述均无误仍失败时，需排查更隐蔽的加载时序问题：

graph LR
A[Bootloader 加载 dtb] --> B{dtb 是否含 overlay?}
B -->|是| C[overlay 覆盖 uart0 status=disabled]
B -->|否| D[主 dts 是否被 build 过程意外裁剪?]
C --> E[检查 scripts/Makefile.build 中 overlay 合并逻辑]
D --> F[运行 make V=1 | grep -i uart 查看 dtc 编译参数]

此外，若使用自定义 initramfs，需确认其 /dev/ 目录下未预置静态节点（如 mknod /dev/ttyS0 c 4 64），否则会屏蔽动态生成机制——这在量产固件中尤为常见。

七、交叉验证黄金组合命令

一次性执行以下命令，输出结果可形成闭环证据链：

dmesg | grep -E "(uart|serial|pinctrl)" | head -20
ls -l /sys/class/tty/ | grep ttyS
cat /sys/firmware/devicetree/base/serial@1c28000/status 2>/dev/null || echo "node missing"
grep -r "uart0" arch/arm/boot/dts/sun50iw9p1-t113-s3*.dts*
zcat /proc/config.gz | grep -E "SERIAL_SUNXI|OF"

该组合覆盖内核态、设备树态、用户态三层，5 分钟内完成全栈快照，避免“盲改-重启-再失败”的低效循环。

```