摘要介绍/dev/ttyUSB0的识别、LubanCat 常用串口参数、picocom 快捷键和网络失效时的串口排障方法。适用对象需要通过 USB-TTL 串口维护 LubanCat 的开发者。串口电平、接线和设备名必须按实际硬件确认。文章目录本篇要解决什么问题串口调试链路为什么需要串口一、识别串口设备二、使用 1500000、8N1 打开串口三、正确退出 picocom四、权限问题五、乱码、无输出和设备忙怎么排查1. 能打开串口但全是乱码2. 串口完全没有输出3. Device or resource busy六、建议把启动日志作为“升级证据”保存七、本文验收清单小结工作流实测截图专栏导航参考资料本篇要解决什么问题在嵌入式 Linux 内核升级中SSH 是“方便的通道”串口才是“兜底的通道”。如果新内核启动失败、网卡驱动没有加载、IP 地址改变SSH 往往最先失效而调试串口仍然可以看到 U-Boot、Kernel、initramfs 和 systemd 的原始日志。本文重点解决四个实际问题如何确认 USB-TTL 在 Linux 主机上对应哪个设备节点为什么 LubanCat 常用1500000 8N1以及乱码时先查什么picocom 如何正确退出、查看参数和保存日志串口被占用或权限不足时如何定位。串口调试链路层级典型现象串口能看到什么U-Boot启动介质、DTB、kernel image 选择错误U-Boot 命令与加载日志Kernel内核崩溃、驱动 probe 失败earlycon、内核日志initramfs找不到 rootfsBusyBox/initramfs 提示systemd服务失败、网络未就绪服务启动日志与 login 提示为什么需要串口SSH 只能在网络和 sshd 正常时使用。修改启动参数、网卡配置或内核后设备可能已经启动但网络尚未配置如果内核或 initramfs 出错SSH 更无法提供线索。串口可以直接观察 U-Boot、内核、initramfs 和 systemd 日志是嵌入式 Linux 的“最后通道”。一、识别串口设备开发主机执行sudoaptinstallpicocomls/dev/ttyUSB*ls/dev/ttyACM* picocom--help|head常见结果是/dev/ttyUSB0。picocom --help开头应显示HIGH_BAUD is enabled否则当前构建可能不支持 1500000 波特率。拔插设备后编号可能变为/dev/ttyUSB1不要把编号永久写死在脚本中生产环境可以根据 USB 设备属性建立 udev 规则。二、使用 1500000、8N1 打开串口LubanCat 调试串口常用参数为 1500000 波特率、8 数据位、无校验、1 停止位、关闭流控sudopicocom\--baud1500000\--flown\--parityn\--databits8\--stopbits1\/dev/ttyUSB0这里保留 picocom 默认的串口锁避免两个程序同时读取同一个设备。只有明确知道锁文件机制不可用时才考虑--nolock。如果终端出现乱码优先检查波特率、TX/RX/GND 接线和串口电平而不是马上修改内核。三、正确退出 picocompicocom 使用“前缀键 命令键”Ctrl-A然后 Ctrl-X屏幕出现Terminating... Thanks for using picocom即表示已经退出。直接按Ctrl-C通常只是把中断字符发送给目标设备上的前台程序不会关闭 picocom。常用快捷键操作按键显示帮助Ctrl-A、Ctrl-H也可用Ctrl-K退出Ctrl-A、Ctrl-X不恢复串口设置直接退出Ctrl-A、Ctrl-Q显示当前串口参数Ctrl-A、Ctrl-V发送普通Ctrl-A连按两次Ctrl-A不要把Ctrl-A、Ctrl-U当成帮助键它会把波特率提高一档可能立即产生乱码。参数被误改后可退出并使用完整启动命令重新打开。四、权限问题临时解决sudopicocom /dev/ttyUSB0-b1500000长期解决sudousermod-aGdialout$USER重新登录后用户通常即可直接访问串口。若提示设备忙检查是否已有 picocom、minicom 或 ModemManager 占用sudofuser-v/dev/ttyUSB0ps-ef|grep-E[p]icocom|[m]inicom不要同时运行两个串口工具。需要保存启动日志时可以增加picocom--baud1500000--flown--parityn\--databits8--stopbits1\--logfileserial-boot.log /dev/ttyUSB0五、乱码、无输出和设备忙怎么排查1. 能打开串口但全是乱码优先检查下面四项而不是先改内核波特率是否为目标板实际使用值TX/RX 是否交叉连接GND 是否共地USB-TTL 电平是否与板卡调试口匹配。如果刚刚误按了 picocom 的波特率切换快捷键退出后使用完整参数重新打开通常比继续在会话里试更可靠。2. 串口完全没有输出可以先确认 USB 设备节点是否存在再执行ls-l/dev/ttyUSB* /dev/ttyACM*2/dev/nullsudofuser-v/dev/ttyUSB0如果设备节点存在但没有任何启动日志还要确认自己连接的是板卡的调试 UART而不是普通业务串口。3.Device or resource busy不要直接加--nolock绕过。先找出占用程序sudofuser-v/dev/ttyUSB0ps-ef|grep-E[p]icocom|[m]inicom|[s]creen如果系统启用了 ModemManager它也可能探测 USB 串口需要结合实际环境判断是否影响当前设备。六、建议把启动日志作为“升级证据”保存一次内核升级至少应保留一份从上电开始的完整串口日志。日志中最好能同时看到U-Boot 选择了哪个启动项加载了哪个 kernel、initrd 和 DTBLinux kernel releaserootfs 挂载过程最终是否出现 login 提示。这样即使 SSH 失败也可以通过日志区分“系统没起来”和“系统已经起来但网络没通”。七、本文验收清单能识别/dev/ttyUSBx或/dev/ttyACMx能用正确波特率看到可读启动日志知道Ctrl-ACtrl-X正确退出能定位串口占用进程能使用--logfile保存完整启动日志。小结串口调试的价值在于“网络失效时仍能看到真相”。建议每次升级内核都保留一份完整串口日志并在日志中标注上电、重启和执行命令的时间点。工作流实测截图图1实际使用的 /dev/ttyUSB0、1500000、8N1 和无流控参数。图2调试串口捕获的 DDR 与内核重启信息串口日志是 SSH 不可用时的第一现场。专栏导航专栏LubanCat RK3588 实时 Linux 开发实战第 2/13 篇上一篇LubanCat RK3588 实时 Linux 开发一移植前先确认硬件、系统与内核版本下一篇LubanCat RK3588 实时 Linux 开发三SDK 环境准备与 flex、bison、LZ4 依赖排查参考资料picocom 官方 READMEpicocom 手册页文中的版本号、接口名、设备地址和测试数据均应以自己的板卡实测为准引用命令前请先确认当前 SDK、内核和启动布局。标签picocom串口调试LinuxLubanCat嵌入式开发