1. 从开机到亮屏RK3399启动流程中的“总设计师”大家好我是老张一个在嵌入式圈子里摸爬滚打了十多年的老码农。今天咱们不聊那些虚头巴脑的概念就来掰扯掰扯一个在RK3399平台上玩Android 10时你绝对绕不开、但又可能一直没完全搞明白的文件——parameter.txt。你可以把它想象成你家装修时的“总设计图”。房子RK3399开发板的硬件结构是固定的但具体怎么隔断分区、水电走线启动参数、每个房间放什么家具系统镜像都得靠这张设计图来安排。没有它你的系统要么根本起不来要么就是一团乱麻。我刚开始接触瑞芯微平台时也在这个文件上栽过跟头明明镜像刷进去了板子就是“黑着脸”不理你折腾半天才发现是parameter.txt里的分区地址写飞了。那么这个文件到底在启动流程的哪个环节起作用呢简单捋一下RK3399的启动链芯片上电后内置的ROM代码会从存储设备比如eMMC或SD卡的固定位置加载第一级引导程序通常是idbloader.img然后交给U-Boot。U-Boot在初始化硬件后最关键的一步就是去读取parameter.txt文件。它从这里获取两样核心信息一是整个存储设备的分区表告诉U-Boot“boot”分区在哪“system”分区在哪二是要传递给Linux内核的启动参数cmdline。拿到这些“地图和指令”后U-Boot才能准确地加载内核镜像、设备树并把启动参数告诉内核内核再挂载根文件系统最终启动Android的init进程。所以你看parameter.txt是连接硬件固件U-Boot和软件系统Android的核心桥梁它的正确性直接决定了后续所有环节能否顺利进行。这篇文章我就带你把这个文件里里外外、掰开揉碎了讲清楚。无论你是刚入门的新手想理解系统启动的基本原理还是正在调试启动问题的开发者需要定制自己的分区布局相信这篇深度解析都能给你实实在在的帮助。咱们就从最直观的文件内容开始。2. 逐行解码parameter.txt的每个字段都在说什么拿到一个标准的parameter.txt文件你可能会被里面一堆冒号和十六进制数搞得有点懵。别急咱们一行一行来看其实每行都有明确的职责。下面我结合一个典型实例并补充一些原始文章里没细说的“坑点”。FIRMWARE_VER:10.0 MACHINE_MODEL:RK3399 MACHINE_ID:007 MANUFACTURER:RK3399 MAGIC:0x5041524B ATAG:0x00200800 MACHINE:3399 CHECK_MASK:0x80 PWR_HLD:0,0,A,0,1 TYPE:GPT CMDLINE:consolettyFIQ0 androidboot.basebandN/A androidboot.selinuxpermissive androidboot.hardwarerk30board androidboot.consolettyFIQ0 init/init mtdpartsrk29xxnand:0x000020000x00002000(uboot),0x000020000x00004000(trust),0x000020000x00006000(misc),0x000020000x00008000(dtbo),0x000008000x0000a000(vbmeta),0x000200000x0000a800(boot),0x000300000x0002a800(recovery),0x000380000x0005a800(backup),0x000020000x00092800(security),0x000c00000x00094800(cache),0x000080000x00154800(metadata),0x000004000x0015c800(frp),0x007140000x0015cc00(super),0x001000000x00870c00(oem),-0x00970c00(userdata:grow)FIRMWARE_VER:10.0固件版本号。这个主要是给瑞芯微自家的升级工具如AndroidTool看的。当你打包生成update.img升级镜像时工具会读取这个版本号。我遇到过因为版本号没更新导致OTA升级时被误判为旧版本而升级失败的情况。实用建议每次发布新固件记得根据实际情况递增这个版本号。MACHINE_MODEL 与 MACHINE_ID这两个是“好兄弟”一起用于标识设备型号。MACHINE_MODEL是给人看的字符串比如“ROC-RK3399-PC-PLUS”MACHINE_ID则更像一个内部编码。系统在启动时可能会检查这些信息以确保加载的固件与硬件匹配。自定义设备时这里可以改成你自己的产品型号。MANUFACTURER制造商信息。这个字段比较自由可以填写公司或品牌名在一些系统属性中会体现出来。MAGIC:0x5041524B魔数Magic Number。这是瑞芯微定义的固定标识千万不要修改。它的ASCII码其实是“PARK”可以理解为瑞芯微固件的“防伪标记”U-Boot会校验这个值来判断这是不是一个合法的参数文件。ATAG:0x00200800这是一个非常重要的内存地址。它告诉U-Boot应该把为Linux内核准备的参数信息ATAG结构体放在物理内存的什么位置。0x00200800这个地址是瑞芯微平台约定俗成的。除非你非常清楚内核的内存布局并做了特殊修改否则不要动它。MACHINE 与 CHECK_MASK这两个也是给内核识别的固定值对于RK3399就是3399和0x80。它们属于底层硬件标识普通开发者无需关心保持原样即可。PWR_HLD:0,0,A,0,1这是一个硬件控制参数。它的格式通常是bank, pin, function, value, enable。以这个为例它表示控制GPIO0组的A0引脚即GPIO0_A0在启动早期将其输出高电平value1并使能这个控制enable1。这常用于控制板子上某个电源芯片的使能脚确保系统核心供电稳定。如果你需要控制其他GPIO来实现特定硬件初始化比如复位一个外设可以在这里修改但务必查准芯片的GPIO编号规则。TYPE:GPT指定分区表类型为GPTGUID Partition Table。这是现代的标准比老旧的MBR更强大支持更多分区和更大的磁盘。RK3399 Android默认都用GPT。最重头戏的就是CMDLINE这一行了它包含了内核启动参数和分区表信息我们单独拿出来详细讲。3. 内核的“启动指令”CMDLINE参数深度剖析CMDLINE里的内容会被U-Boot原封不动地传递给Linux内核成为内核启动时的命令行参数。这些参数直接影响内核的行为和系统初始化。我们来拆解其中关键的几个consolettyFIQ0指定内核的调试控制台为ttyFIQ0。这是瑞芯微平台使用FIQ快速中断机制实现的串口控制台。如果你的调试串口接的是这个那么内核的打印信息就会从这里输出。这是抓取内核启动日志的关键。androidboot.selinuxpermissive设置SELinux的初始模式为“宽容”permissive。在这个模式下SELinux会记录违反策略的行为但不会阻止它。这对于开发调试阶段极其重要如果你刷完机发现卡在开机动画或者init进程崩溃首先就该怀疑是不是SELinux策略问题。改成permissive模式查看内核日志dmesg里有没有SELinux的avc拒绝avc: denied信息能快速定位问题。生产版本则应改为enforcing强制。androidboot.hardwarerk30board告诉Android系统硬件平台是rk30board。这个值会决定系统加载哪个硬件抽象层HAL配置和资源文件。例如init进程会根据这个值去/vendor/etc/init/hw/目录下找init.rk30board.rc这样的文件来执行硬件相关的初始化。init/init指定系统的第一个用户空间进程pid1为/init。这个不能改Android的初始化流程就是从它开始的。除了这些Android相关的最核心的是mtdparts参数它定义了整个存储设备的分区表。这个语法是Linux内核MTD子系统定义的格式看起来复杂但掌握了规律就很简单。4. 存储空间的“城市规划图”MTD分区表详解mtdpartsrk29xxnand:0x000020000x00002000(uboot),0x000020000x00004000(trust)...这串看起来像“天书”的字符串就是你的eMMC或NAND Flash的“城市规划图”。我们来翻译一下mtdparts声明分区表的开始。rk29xxnand:这是mtd-id标识具体的存储设备驱动。对于RK3399无论是NAND还是eMMC工作在兼容模式下通常都用rk29xxnand这个标识。这是一个容易混淆的点即使你的板子用的是eMMC这里也可能这么写它更多是一个逻辑标识。0x000020000x00002000(uboot)这是一个分区定义partdef。0x00002000分区大小单位是扇区Sector1个扇区512字节。所以0x2000个扇区 0x2000 * 512 4MB。0x00002000分区起始偏移地址单位也是扇区。0x2000扇区 4MB。(uboot)分区的名称。所以这一整段的意思就是从存储设备的4MB位置开始划出4MB的空间命名为uboot分区用来存放U-Boot镜像注意不是最开始的idbloader。这里有几个实战中必须注意的细节4MB对齐瑞芯微的NAND Flash控制器通常有4MB擦除块Block大小的限制。因此每个分区的起始地址和大小都必须是4MB0x2000扇区的整数倍。如果你计算出一个分区大小是5MB那你也得把它调整为8MB0x4000扇区否则在烧写或擦除时可能会出错。这是新手定制分区时最容易踩的坑。地址连续性分区的地址必须一个接一个不能重叠中间也尽量不要留空洞除非你故意预留。计算下一个分区起始地址的公式是上一个起始地址 上一个分区大小。比如uboot结束在0x00004000那么trust分区就从0x00004000开始。特殊分区super和动态分区userdata在Android 10及以后为了支持动态分区我们看到了super分区。它本身是一个逻辑容器里面包含了system、vendor、product等动态子分区。而userdata分区后面的:grow标识意味着这个分区将占据剩余的所有空间-表示剩余所有这在适配不同容量存储芯片时非常有用。如何验证你的分区表在Linux系统下将烧好统一镜像的SD卡或通过USB连接到开发板你可以用fdisk -l /dev/sdX命令查看实际的分区情况。你会发现fdisk显示的分区起始扇区Start和结束扇区与parameter.txt中定义的地址是能对应上的注意fdisk的起始扇区可能包含了GPT头等信息会有固定偏移。你也可以通过cat /proc/mtd在运行的系统里查看MTD分区信息。理解并能修改这个分区表是进行系统定制的基础。比如你想扩大system分区来容纳更多的系统应用或者增加一个专门存放自己数据的persist分区都需要在这里动刀。5. 参数如何传递从U-Boot到内核的旅程知道了parameter.txt里有什么我们再来看看这些参数是怎么“活”起来的即它们是如何被U-Boot读取并传递给内核的。这个过程对于调试启动问题至关重要。U-Boot在启动过程中会有一个专门的函数通常是board_late_init或类似阶段来解析parameter.txt。它并不是直接去读一个叫parameter.txt的文件而是从存储设备的固定偏移处这个偏移在编译U-Boot时就确定了通常紧挨着U-Boot镜像本身读取一段RAW数据这段数据的格式就是parameter.txt的文本内容。U-Boot会逐行解析这段文本识别出CMDLINE这一行提取出整个字符串。将CMDLINE字符串保存到U-Boot的环境变量bootargs中。你可以通过在U-Boot命令行下输入printenv bootargs来验证。根据ATAG地址准备ATAG列表对于旧内核或者更常见的使用设备树DTB的chosen节点来传递bootargs。现代RK3399内核都使用设备树。当执行bootm或booti命令启动内核时U-Boot会将包含bootargs的设备树或者ATAG以及内核镜像地址一起告诉CPU然后跳转到内核入口点。一个实用的调试技巧如果你怀疑是启动参数导致的问题可以在U-Boot启动倒数时打断它按任意键进入U-Boot命令行。先用printenv bootargs看看解析出来的参数对不对然后可以直接用setenv bootargs ...修改参数再用boot命令启动。这样可以快速测试而无需反复刷写整个镜像。6. 实战定制你的parameter.txt理论说了这么多不来点实战就是纸上谈兵。假设我们现在有一个需求为一块RK3399板子定制分区需要增加一个256MB的persist分区用于存放持久化数据并且把cache分区从384MB缩小到128MB。第一步备份与分析原版首先备份原始的parameter.txt。然后拿出笔和纸或者文本编辑器把现有的分区列表整理出来计算每个分区的起始地址和结束地址单位扇区。这是避免出错的基础。第二步规划新布局我们的目标是插入persist分区。查看原列表假设我们决定在cache分区之后、metadata分区之前插入。原cache分区是0x000c00000x00094800即从地址0x00094800开始大小0x000c0000。所以它的结束地址是0x00094800 0x000c0000 0x00154800这正好是metadata分区的起始地址。现在我们要把cache大小改为0x00020000128MB / (512B/扇区) 262144 扇区 0x40000等等这里要小心计算。1MB 2048扇区。128MB 128 * 2048 262144扇区 0x40000扇区。核对一下原0x000c0000是多大0xC0000扇区 12 * 65536更简单的办法用计算器0xC0000 (十六进制) 786432 (十进制) 扇区。786432 * 512 / 1024 / 1024 384 MB。正确。所以新cache大小应为 128MB 128 * 2048 262144 扇区 0x40000 (十六进制)。第三步计算新地址新cache分区起始地址不变0x00094800大小改为0x00040000。新cache分区结束地址0x00094800 0x00040000 0x000D4800。persist分区我们打算给它256MB。256MB 256 * 2048 524288 扇区 0x80000 扇区。起始地址 新cache结束地址 0x000D4800。大小 0x00080000。结束地址 0x000D4800 0x00080000 0x00154800。惊喜地发现persist分区的结束地址正好是原来metadata分区的起始地址0x00154800完美衔接。第四步处理后续分区由于我们在中间插入了一个分区后面所有分区的起始地址都向后偏移了persist分区的大小0x00080000。所以我们需要更新metadata及之后所有分区的offset。metadata新起始地址 原起始地址0x001548000x000800000x001D4800。frp新起始地址 原0x0015c8000x000800000x001DC800。super新起始地址 原0x0015cc000x000800000x001DCC00。oem新起始地址 原0x00870c000x000800000x008F0C00。userdata新起始地址 原0x00970c000x000800000x009F0C00。第五步编写新的parameter.txt将修改后的分区定义字符串替换原来的mtdparts部分。务必检查所有地址都是0x20004MB的整数倍。最后使用瑞芯微的打包工具如rkbin里的工具将新的parameter.txt打包进你的固件或者直接替换SD卡镜像中的对应部分进行测试。7. 避坑指南与高级技巧在我多年的调试经历里parameter.txt相关的问题层出不穷这里分享几个典型的“坑”和解决办法坑一刷机后设备无法启动串口无输出。可能原因CMDLINE中的console参数指定的串口与控制台实际硬件连接不符或者分区地址错误导致U-Boot无法正确加载内核。排查首先确认硬件串口连接是否正确通常是UART2。其次检查parameter.txt的分区地址特别是boot分区的地址是否与实际烧写boot.img的位置一致。可以用瑞芯微的升级工具查看镜像烧写地址。坑二系统启动后找不到某个分区比如vendor。可能原因动态分区super的大小没有包含足够的空间给子分区。或者fstab文件中的分区名与parameter.txt中定义的super不匹配。排查确保super分区足够大。使用lpdump工具在编译环境中可以找到检查super.img内部的实际分区布局。同时检查device/rockchip/rk3399/目录下的fstab文件确认挂载点是否正确。坑三修改parameter.txt后烧录工具报错。可能原因文件格式错误例如多了空格、少了逗号、括号不匹配或者地址/大小不是十六进制。排查使用简单的文本编辑器检查语法。特别注意最后一个分区后面不能有逗号。可以使用在线的RK参数文件校验工具如果有进行初步检查。高级技巧使用多个CMDLINE参数。实际上parameter.txt的CMDLINE内容可以和U-Boot环境变量中的bootargs合并。你可以在U-Boot中通过setenv bootargs ${bootargs} extra_paramvalue来追加参数这对于临时开启内核调试功能如initcall_debug、earlycon非常方便无需重新刷写parameter.txt。理解parameter.txt就像是拿到了RK3399 Android系统的“钥匙”。它不仅仅是启动的必要配置更是你深入掌控系统分区、调试启动问题、进行深度定制的基石。希望这篇结合了大量实战经验的解析能帮你把这把钥匙用得更加得心应手。下次当你再面对启动黑屏或者分区 mount 失败的问题时不妨第一个就想想是不是parameter.txt在“捣鬼”