![[RK356x] [Firefly-Ubuntu] 10min带你了解Ubuntu固件各个分区_芯片](https://file.cfanz.cn/uploads/png/2023/01/17/10/412a53R8Y4.png)
瑞芯微为了方便开发与产品定制,自己定义了一套固件的分区,这些分区信息存放在parameter.txt文件中,Firefly参考这个文件定义了自己的Ubuntu分区,文件为parameter-ubuntu.txt,存放于Linux_SDK的device/rockchip/rk356x目录下;另外在Ubuntu固件打包的时候也会用到一个package-file文件,文件名为rk356x-ubuntu-package-file,存放于Linux_SDK的tools/linux/Linux_Pack_Firmware/rockdev目录下。下面我带领大家简要分析一下这两个文件!
一、parameter-ubuntu.txt
进入device/rockchip/rk356x目录,cat parameter-ubuntu.txt:
FIRMWARE_VER: 1.0
MACHINE_MODEL: RK3568
MACHINE_ID: 007
MANUFACTURER: RK3568
MAGIC: 0x5041524B
ATAG: 0x00200800
MACHINE: 0xffffffff
CHECK_MASK: 0x80
PWR_HLD: 0,0,A,0,1
TYPE: GPT
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00010000@0x00008000(boot),0x00010000@0x00018000(recovery),0x00010000@0x00028000(backup),0x00c00000@0x00038000(rootfs),-@0x00c38000(userdata:grow)
uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
以下是摘自瑞芯微文档中的概述:
-
Rockchip android系统平台使用parameter文件来配置一些系统参数,比如固件版本,存储器分区信息等。(其实android系统平台与linux系统平台都一样) -
Parameter文件是非常重要的系统配置文件,最好在能了解清楚各个配置功能时再做修改,避免出现parameter文件配置异常造成系统不能正常工作的问题。 -
Parameter文件大小有限制,最大不能超过64KB。
parameter-ubuntu.txt文件内容的说明:
内容 | 说明 |
| 固件版本,打包 |
| 机器型号,打包 |
| 产品开发 |
| 厂商信息,打包 |
| |
| |
| 内核识别用,不能修改,这个定义和内核匹配。 |
| 保留,不能修改。 |
| 指定该文件 |
| 内核识别用,不能修改,这个定义和内核匹配。 |
| (稍后说明) |
| 保留,不能修改。 |
列表中的这些除了CMDLINE,其他我们几乎很少需要修改!
CMDLINE属性是我们关注的地方:
CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00010000@0x00008000(boot),0x00010000@0x00018000(recovery),0x00010000@0x00028000(backup),0x00c00000@0x00038000(rootfs),-@0x00c38000(userdata:grow)
以下是摘自瑞芯微文档的说明:
- 为了兼容性,目前
RK所有AP都是用rk29xxnand做标识。 - 单个分区说明:
例如:0x00010000@0x00008000(boot),@符号之前的数值是分区大小,@符号之后的数值是分区的起始位置,括号里面的字符是分区的名字。所有数值的单位是sector,1个sector为512Bytes。上例中,boot分区起始位置为0x8000 sectors位置,大小为0x10000 sectors(32MB)。 - 为了性能,每个分区起始地址需要
32KB(64 sectors)对齐,大小也需要32KB的整数倍。 - 如果使用
sparse格式的镜像,升级时会擦除数据,为了兼容性更好,对应的分区最好按4MB对齐,大小也按4MB整数倍配置。 - 使用
GPT分区时,parameter里面定义的地址,都是真实的逻辑地址(LBA),例如uboot定义在0x4000,那么烧录到EMMC和NAND里面时,逻辑地址也是0x4000。最后一个分区需要指定grow参数,工具会把剩余的空间都分配给最后一个分区。
![[RK356x] [Firefly-Ubuntu] 10min带你了解Ubuntu固件各个分区_服务器_02](https://file.cfanz.cn/uploads/png/2023/01/17/10/RF0QB7DfNf.png)
下面是Ubuntu固件各个分区作用的说明:
-
uboot分区:烧写uboot编译出来的uboot.img。 -
misc分区:烧写misc.img。开机检测进入recovery模式。 -
boot 分区:烧写kernel编译出来的boot.img包含kernel和设备树信息。 -
recovery分区:烧写recovery.img。 -
backup分区:预留,暂时没有用。后续跟android一样作为recovery的 backup使用。 -
rootfs分区:存放ubuntu文件系统,只读。 -
userdata分区:存放app临时生成的文件或者是给最终用户使用。可读写,挂载在/userdata目录下。
![[RK356x] [Firefly-Ubuntu] 10min带你了解Ubuntu固件各个分区_芯片_03](https://file.cfanz.cn/uploads/png/2023/01/17/10/7bCN4VXGeQ.png)
二、rk356x-ubuntu-package-file
进入tools/linux/Linux_Pack_Firmware/rockdev目录,cat rk356x-ubuntu-package-file:
# NAME Relative path
#
#HWDEF HWDEF
package-file package-file
bootloader Image/MiniLoaderAll.bin
parameter Image/parameter.txt
uboot Image/uboot.img
misc Image/misc.img
boot Image/boot.img
recovery Image/recovery.img
rootfs Image/rootfs.img
userdata RESERVED
backup RESERVED
不难看出该文件用于指定分区与打包镜像的对应关系!以下是打包RK格式的Ubuntu固件日志:
neutionwei@32b7b9ddcaab:~/project/rk356x_linux_release_20211019$ ./build.sh updateimg
processing option: updateimg
File name is ROC-RK3568-PC-UBUNTU20.04-GPT
Rename the file? [N|y]n
Make update.img
start to make update.img...
Resize rootfs partition size
dumpe2fs 1.44.1 (24-Mar-2018)
Android Firmware Package Tool v1.66
------ PACKAGE ------
Add file: ./package-file
Add file: ./package-file done,offset=0x800,size=0x11a,userspace=0x1
Add file: ./Image/MiniLoaderAll.bin
Add file: ./Image/MiniLoaderAll.bin done,offset=0x1000,size=0x719c0,userspace=0xe4
Add file: ./Image/parameter.txt
Add file: ./Image/parameter.txt done,offset=0x73000,size=0x1d5,userspace=0x1
Add file: ./Image/uboot.img
Add file: ./Image/uboot.img done,offset=0x73800,size=0x400000,userspace=0x800
Add file: ./Image/misc.img
Add file: ./Image/misc.img done,offset=0x473800,size=0xc000,userspace=0x18
Add file: ./Image/boot.img
Add file: ./Image/boot.img done,offset=0x47f800,size=0x1ff4800,userspace=0x3fe9
Add file: ./Image/recovery.img
Add file: ./Image/recovery.img done,offset=0x2474000,size=0x1e23800,userspace=0x3c47
Add file: ./Image/rootfs.img
Add file: ./Image/rootfs.img done,offset=0x4297800,size=0xa744fc00,userspace=0x14e8a0
Add CRC...
Make firmware OK!
------ OK ------
********RKImageMaker ver 1.66********
Generating new image, please wait...
Writing head info...
Writing boot file...
Writing firmware...
Generating MD5 data...
MD5 data generated successfully!
New image generated successfully!
Making ./Image/update.img OK.
Make update image ok!
/home/neutionwei/project/rk356x_linux_release_20211019/rockdev/pack/ROC-RK3568-PC-UBUNTU20.04-GPT-20211203-2103.img
Running build_updateimg succeeded.
三、注意点
Firefly发布的Linux_SDK在打包固件的时候,对于rootfs分区的大小,会根据rootfs的实际文件大小进行动态变化,换句话说,parameter-ubuntu.txt文件中的0x00c00000@0x00038000(rootfs),-@0x00c38000(userdata:grow)内容的rootfs分区大小指定与userdata分区起始地址会动态发生修改!这是因为不同的文件系统占用分区的大小差异很大,这样操作可避免造成分区浪费!








