无风扇主机 UART 16550A 串口 ttyS4（COM3）失效修复

01故障现象

客户在某无风扇工业主机上部署 Ubuntu 16.04，需通过板载 COM3 串口与下游 RS-232 设备通信。现场反馈：应用程序打开 /dev/ttyS4 不报错，但收发数据全无响应，串口形同"死口"。

使用如下命令排查时可观察到典型异常：

关键症状归纳如下：

• UART 类型为 unknown：说明内核未识别到 16550A 串口控制器。
• Port 与 IRQ 全为 0：设备节点虽然存在，但未绑定真实硬件资源。
• 应用层无报错：open/read/write 系统调用可成功，但物理层无电信号收发。
• 其它串口正常：COM1（ttyS0）、COM2（ttyS1）工作正常，问题集中在 COM3。

02问题背景 · 硬件映射

该无风扇主机板载 4 个串口，BIOS 中的串口资源分配与本主板的 ttyS 映射关系如下表所示。需要特别注意的是：BIOS 中的 COM 编号与 Linux 下的 ttyS 编号并非一一对应，本主板 COM3 实际映射到 /dev/ttyS4。

BIOS 中 COM3 的端口配置如下图所示，IO 地址为 0x210、IRQ 为 10，与标准 PC AT 串口默认值（0x3E8 / IRQ4）完全不同：

BIOS · COM3

03根因分析

Linux 8250 串口驱动在启动时会按标准 PC AT 端口地址（0x3F8、0x2F8、0x3E8、0x2E8 等）枚举串口。本主板 COM3 使用的 IO=0x210、IRQ=10 属于非标准端口，驱动在默认地址列表中找不到该串口，因此 ttyS4 虽被预留节点，却未绑定真实硬件资源，最终表现为 UART: unknown、Port: 0x0000、IRQ: 0。

解决思路有两个层面，缺一不可：

04解决方案

综合上述分析，采用 "GRUB 内核参数 + setserial systemd 服务" 的双层修复方案：

• 第一层 · 内核参数：向 GRUB_CMDLINE_LINUX_DEFAULT 追加 8250.map=0x210,10，执行 update-grub 后重启，让 8250 驱动在 0x210 地址正确识别 COM3 为 16550A。
• 第二层 · 持久化服务：创建 setserial-ttys4.service oneshot 服务，开机后等待 /dev/ttyS4 出现，自动执行 setserial /dev/ttyS4 port 0x210 irq 10 uart 16550A。
• 安全策略：自动备份 GRUB 与服务文件、日志写入 /var/log/ubuntu_config.log、enable 与 start 失败时自动收集 systemd-analyze 与 journalctl 诊断信息。

修复后验证

05一键配置脚本

下方为完整修复脚本 ubuntu_com3_setup.sh，封装了上述全部逻辑：GRUB 内核参数追加、systemd 服务创建、enable/start、状态校验与诊断信息收集。脚本可重复执行（幂等）、自动备份、完整日志记录，可直接复制或下载后部署到目标无风扇主机。

06操作与验证

脚本执行与重启后的验证步骤如下：

1. 上传并执行脚本

脚本会自动完成 GRUB 参数追加、systemd 服务创建与 enable。首次运行若 /dev/ttyS4 尚未出现，脚本会提示"请重启"，这是正常现象。

2. 重启使内核参数生效

3. 重启后验证

当 setserial -g /dev/ttyS4 输出 UART: 16550A, Port: 0x0210, IRQ: 10 时（如上图所示），即表明 COM3 已被正确识别并绑定真实硬件资源，串口可正常收发数据。

4. 故障排查

• 查看完整日志：cat /var/log/ubuntu_config.log，内含 GRUB、服务、诊断全部输出。
• 服务未启动：journalctl -u setserial-ttys4.service -n 50 查看详细错误。
• setserial 未安装：Ubuntu 16.04 源已失效时，可从其他主机下载 .deb 离线安装，或更换为可用源后重跑脚本。
• 端口仍为 0：确认 BIOS 中 COM3 已启用且 IO/IRQ 与脚本一致，必要时调整脚本顶部的 SERIAL_PORT、SERIAL_IRQ 变量。

07方案价值与适用范围

• 1根治而非绕开：从内核驱动层（8250.map）与用户态层（setserial）双管齐下，让 COM3 真正绑定 0x210/IRQ10 硬件资源，而非依赖临时 setserial 命令。
• 2开机自愈：systemd oneshot 服务每次开机自动配置，ExecStartPre 等待设备就绪，杜绝"重启即失效"问题。
• 3安全可重复：GRUB 参数只追加不覆盖、关键文件自动备份、设备不存在时不强行 start，脚本可安全反复执行。
• 4易于移植：修改脚本顶部的 SERIAL_DEV/SERIAL_PORT/SERIAL_IRQ/KERNEL_PARAM 四个变量即可适配其它非标准端口的板载串口（如 COM4、ttyS5 等）。
• 5完整可观测：全流程写入 /var/log/ubuntu_config.log，enable/start 失败时自动收集 systemd-analyze 与 journalctl 诊断信息，便于现场快速定位。