1. 调试串口波特率这件事为什么值得单独拎出来讲刚拿到RK3588板子的那几天最容易让人产生挫败感的不是内核编译报错也不是设备树写错而是串口终端里那一屏乱码。你明明接好了USB转TTL模块线序也反复确认过minicom或者串口调试助手也打开了结果上电之后屏幕上跳出来的全是“烫烫烫”或者一堆问号。这种情况十有八九不是硬件坏了而是波特率对不上。RK3588这类高性能SoC在出厂固件或者默认配置里调试串口的波特率经常被设成1500000也就是1.5M。这个速率在板子端跑起来毫无压力但对于很多常见的USB转串口芯片来说能不能稳住1.5M就是另一回事了。CH340系列在1.5M下丢包率相当感人CP2102勉强能跑但长时间传输容易出错FT232系列相对靠谱但价格摆在那里。更麻烦的是很多串口调试助手默认只给到115200或者921600的选项你连1.5M这个档位都找不到自然就陷入了“板子有输出但我看不懂”的僵局。这篇内容就是围绕这个具体场景展开的把RK3588的调试串口从1.5M改到115200让手头普通的USB转TTL模块也能正常抓取启动日志。涉及的范围包括U-Boot阶段的波特率配置、内核启动参数的传递、设备树里的串口节点修改以及最终在文件系统里确认终端服务是否正常。适合正在折腾RK3588开发板、需要看启动日志排查问题的朋友也适合刚接触Rockchip平台、对U-Boot和内核启动流程还不太熟悉的嵌入式新手。我自己的板子是正点原子的RK3588开发板跑的是Rockchip官方SDK加Ubuntu 22.04根文件系统过程中踩过的坑包括U-Boot改了但内核没改导致后半段日志依然乱码、设备树里改了但忘了同步更新bootargs、以及串口调试助手那边流控没关导致偶尔丢字符。下面把这些东西拆开揉碎讲清楚。2. 先搞清楚RK3588的调试串口到底走哪条路2.1 硬件连接与串口控制器确认RK3588的调试串口通常挂在UART2上这是Rockchip平台多年来的惯例。但也不是绝对的具体得看板子原理图。以正点原子RK3588为例调试串口用的是UART2_M0引脚对应GPIO3_B6和GPIO3_B7经过板载的CH340或者外接USB转TTL模块接到电脑上。你在设备管理器或者ls /dev/ttyUSB*里看到的那个节点就是它。这里有个容易混淆的点RK3588的UART控制器编号和引脚复用组是两回事。UART2可以映射到不同的引脚组M0、M1、M2各有不同的物理引脚。设备树里配置的时候pinctrl节点要选对否则会出现“串口有设备但收不到数据”的情况。我一般习惯先用万用表量一下TX引脚在上电瞬间有没有电平跳动确认硬件通路没问题再动软件。2.2 为什么默认是1.5M而不是115200Rockchip把调试串口默认设成1.5M核心原因是启动日志量太大。RK3588这种八核处理器从U-Boot SPL到ATF到U-Boot proper再到内核整个启动流程打印的信息非常密集尤其是开了DEBUG级别日志之后115200的速率会让启动时间明显拉长。1.5M能在几秒内把几百KB的日志全部吐出来开发阶段效率高很多。但问题在于1.5M对USB转串口芯片的兼容性太差。CH340的官方手册里写的最高速率是2M但实际在1.5M下误码率很高尤其是线材质量一般或者USB口供电不稳的时候。CP2102标称1M超频到1.5M勉强能用但丢包。FT232H能稳跑3M但价格是CH340的十倍不止。所以对于大多数开发者来说把板子端降到115200用最便宜的CH340就能稳定抓日志是更务实的选择。2.3 需要改动的三个层面把1.5M改成115200不是改一个地方就完事的。RK3588的启动流程分三个阶段每个阶段都有自己的波特率设置U-Boot SPL阶段这是最开始的引导阶段波特率在rk3588_spl_defconfig或者rk3588_defconfig里定义具体是CONFIG_BAUDRATE这个宏。U-Boot proper阶段SPL加载完U-Boot proper之后波特率由U-Boot的环境变量baudrate控制默认值也在defconfig里。内核阶段内核启动时bootargs里的consolettyS2,1500000决定了内核和根文件系统阶段的串口波特率。这三个地方必须全部改成115200否则就会出现“U-Boot阶段正常内核阶段乱码”或者“前面乱码后面正常”的割裂现象。我见过有人只改了U-Boot的defconfig结果内核启动到一半突然变乱码排查了半天才发现是bootargs没同步。注意改波特率之前先把串口调试助手那边的流控关掉。RTS/CTS流控在115200下一般用不到开着反而容易因为握手信号问题丢字符。3. 动手改U-Boot从defconfig到环境变量3.1 定位并修改defconfig中的波特率宏RK3588的U-Boot源码里跟波特率相关的配置通常在configs/rk3588_defconfig和configs/rk3588_spl_defconfig这两个文件里。用grep搜一下grep -rn BAUDRATE configs/rk3588*你会看到类似这样的输出configs/rk3588_defconfig:CONFIG_BAUDRATE1500000 configs/rk3588_spl_defconfig:CONFIG_BAUDRATE1500000把这两个文件里的1500000都改成115200。改完之后U-Boot编译时会把这个值写进默认环境变量里。但这里有个细节U-Boot的环境变量如果之前已经保存过改defconfig不会覆盖已有的环境变量。也就是说如果你的板子之前启动过并且保存了环境变量到eMMC或者SPI Flash里那baudrate这个变量可能还是1500000。解决办法有两个一是编译时把环境变量分区擦掉让U-Boot重新加载默认值二是在U-Boot命令行里手动执行setenv baudrate 115200 saveenv但手动改有个风险改完baudrate之后当前串口会话会立刻失效因为U-Boot会重新初始化串口。你得把串口调试助手也改成115200然后重新连接才能继续操作。我一般建议直接擦环境变量分区省得来回折腾。3.2 编译与烧录U-Boot的注意事项改完defconfig之后重新编译U-Boot./make.sh rk3588编译完成后生成的uboot.img和rk3588_spl_loader_v*.bin需要烧录到板子上。烧录方式取决于你的板子启动介质eMMC、SPI Flash还是SD卡。正点原子的板子一般用瑞芯微的upgrade_tool或者rkdeveloptool来烧。这里有个坑SPL和U-Boot proper的波特率必须一致。如果你只改了rk3588_defconfig没改rk3588_spl_defconfig那SPL阶段还是1.5MU-Boot proper阶段变成115200串口终端上就会看到前半段乱码后半段正常。所以两个defconfig都要改。烧录完之后上电看串口输出。如果一切正常你应该能看到从SPL开始就是清晰的115200波特率日志。如果还是乱码先检查串口调试助手那边的波特率是不是也改成了115200再检查线序有没有接反。3.3 验证U-Boot阶段波特率是否生效一个简单的验证方法在U-Boot启动倒计时的时候按回车如果能进入U-Boot命令行说明U-Boot阶段的波特率已经对了。然后在命令行里执行printenv baudrate如果输出是baudrate115200那就没问题。如果还是1500000说明环境变量没更新需要执行setenv baudrate 115200然后saveenv。实操心得改完U-Boot波特率之后第一次上电最好把串口调试助手的“自动重连”功能关掉手动点连接。因为U-Boot重新初始化串口的时候USB转TTL模块可能会短暂断开自动重连有时候会卡住。4. 内核与设备树让bootargs和串口节点同步更新4.1 修改bootargs中的console参数U-Boot阶段改完之后接下来是内核阶段。内核启动时U-Boot会把bootargs环境变量传递给内核其中consolettyS2,1500000这一项决定了内核和根文件系统阶段的串口波特率。这个参数通常在U-Boot的include/configs/rk3588_common.h或者板级配置头文件里定义也可能在设备树的chosen节点里。用grep搜一下grep -rn consolettyS2 include/configs/ arch/arm/dts/找到之后把1500000改成115200。如果是在设备树的chosen节点里格式是这样的chosen { bootargs consolettyS2,115200 earlyconuart8250,mmio32,0xfeb50000; };注意earlycon后面的参数也要同步改否则内核早期启动阶段的日志还是按1.5M输出会乱码。earlycon的地址0xfeb50000是UART2的寄存器基地址这个不用改只改波特率就行。4.2 设备树中串口节点的配置检查设备树里UART2的节点本身不需要改波特率因为波特率是运行时由驱动设置的不是设备树的静态属性。但你需要确认status是okay并且pinctrl引用了正确的引脚组uart2 { status okay; pinctrl-names default; pinctrl-0 uart2m0_xfer; };如果pinctrl写错了串口根本收不到数据那就不是波特率的问题了。我遇到过有人把uart2m0_xfer写成了uart2m1_xfer结果串口完全没输出排查了半天才发现是引脚复用组选错了。4.3 内核config中的串口驱动确认内核配置里需要确保UART2的驱动是编译进去的。RK3588用的是8250系列驱动相关配置项CONFIG_SERIAL_8250y CONFIG_SERIAL_8250_CONSOLEy CONFIG_SERIAL_8250_DWyCONFIG_SERIAL_8250_CONSOLE必须为y否则内核不会把串口注册为consolebootargs里的consolettyS2就不会生效。这个一般在rockchip_linux_defconfig里已经配好了但如果你自己裁剪过内核最好确认一下。改完这些之后重新编译内核和设备树./make.sh kernel然后把boot.img和resource.img烧进去。上电之后从SPL到内核再到根文件系统整个启动日志应该都是清晰的115200波特率输出。5. 根文件系统里的终端服务与串口调试助手设置5.1 getty服务与串口终端配置内核启动到根文件系统之后串口终端是由getty或者agetty服务提供的。在Ubuntu根文件系统里通常有一个serial-gettyttyS2.service的服务。你需要确认这个服务的波特率设置和前面一致。查看服务文件systemctl status serial-gettyttyS2.service如果服务没起来可以手动启用systemctl enable serial-gettyttyS2.service systemctl start serial-gettyttyS2.service有些根文件系统里/etc/inittab或者/etc/systemd/system/serial-gettyttyS2.service.d/目录下会有波特率的覆盖配置。检查一下有没有1500000的字样有的话改成115200。5.2 串口调试助手的关键参数设置板子端改完之后电脑端的串口调试助手也要对应设置。以常用的SSCOM为例关键参数如下参数项推荐值说明波特率115200与板子端一致数据位8标准配置停止位1标准配置校验位None标准配置流控None务必关闭RTS/CTS接收区编码UTF-8或GBK根据日志内容选择流控这一项特别容易出问题。有些串口调试助手默认开着RTS/CTS而USB转TTL模块的RTS/CTS引脚可能根本没接导致握手失败表现为“能收到数据但偶尔丢字符”或者“完全收不到数据”。我一般建议直接把流控设成None除非你确实需要硬件流控。5.3 验证全链路波特率一致性改完所有地方之后做一次完整的验证板子断电串口调试助手打开波特率设115200流控None。板子上电观察从SPL开始的第一行日志。如果第一行就是清晰的U-Boot SPL字样说明SPL阶段波特率对了。继续观察如果U-Boot proper和内核阶段的日志都清晰说明全链路一致。最后在串口终端里按回车如果能看到登录提示符说明getty服务也正常。如果中间某一段乱码就回到对应的章节检查那个阶段的配置。这种分段排查的方法比盲目改一堆参数高效得多。6. 常见问题与排查技巧实录6.1 改了defconfig但U-Boot阶段依然乱码这种情况最常见的原因是环境变量没有更新。U-Boot在启动时会先加载默认环境变量然后如果存储介质里有保存过的环境变量会用保存的覆盖默认值。所以即使你改了defconfig如果之前saveenv过baudrate还是旧值。解决办法在U-Boot命令行里执行env default -a恢复默认环境变量然后saveenv保存。或者直接擦除环境变量分区让U-Boot重新加载默认值。6.2 内核阶段乱码但U-Boot阶段正常这说明U-Boot的波特率改了但bootargs里的consolettyS2,1500000没改。检查U-Boot的环境变量bootargsprintenv bootargs如果里面还是1500000就手动改setenv bootargs consolettyS2,115200 earlyconuart8250,mmio32,0xfeb50000 ... saveenv注意bootargs通常很长包含根文件系统路径、内存大小等信息改的时候只改console那一项别把其他参数弄丢了。6.3 串口调试助手收不到任何数据先排除硬件问题TX和RX有没有接反GND有没有共地USB转TTL模块的供电是否正常用万用表量一下板子TX引脚在上电瞬间有没有电压跳动。如果硬件没问题再检查软件串口调试助手有没有选对COM口波特率是不是115200流控是不是None还有一个容易被忽略的点有些USB转TTL模块的驱动在Linux下需要手动加载。比如CH340在较新的内核里需要ch341模块CP2102需要cp210x模块。用lsmod看一下模块有没有加载没有的话modprobe ch341或者modprobe cp210x。6.4 波特率改了之后启动时间变长这是正常现象。1.5M降到115200波特率差了13倍启动日志的打印时间自然会变长。如果觉得启动太慢可以在U-Boot里把loglevel调低减少不必要的日志输出。或者在内核bootargs里加quiet参数只打印关键信息。6.5 常见问题速查表现象可能原因排查方法SPL阶段乱码SPL defconfig未改检查rk3588_spl_defconfig中的CONFIG_BAUDRATEU-Boot阶段乱码环境变量未更新执行env default -a后saveenv内核阶段乱码bootargs未改检查printenv bootargs中的console参数登录终端乱码getty服务波特率不对检查serial-gettyttyS2.service配置完全无输出硬件连接或驱动问题检查线序、共地、USB转TTL驱动偶尔丢字符流控未关闭串口调试助手流控设为None改完启动变慢波特率降低的正常现象调低loglevel或加quiet参数7. 一些实操后的个人体会整个流程走下来最深的感受是RK3588的波特率修改不是一个点而是一条链。SPL、U-Boot proper、内核、根文件系统四个环节环环相扣漏掉任何一个都会导致日志割裂。我自己的习惯是改完之后从SPL开始逐段确认每确认一段就在串口调试助手里做个标记这样出问题的时候能快速定位到是哪一段没改。另外如果你手头的USB转TTL模块确实能稳跑1.5M其实没必要降到115200。FT232H或者CP2108这类芯片在1.5M下表现很好保留高波特率能节省不少启动等待时间。但如果你用的是几块钱的CH340模块那115200就是最稳妥的选择牺牲一点启动时间换取稳定的日志输出这笔账怎么算都划算。最后分享一个小技巧改完波特率之后把串口调试助手的配置保存成一个会话文件下次直接加载省得每次都要手动设一遍参数。SSCOM和XCOM都支持会话保存这个功能在频繁调试的时候能省不少事。
