xref: /OK3568_Linux_fs/rkbin/README (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunRockchip loader binaries naming rule
2*4882a593Smuzhiyun
3*4882a593Smuzhiyun总则:
4*4882a593Smuzhiyun不管单个模块,还是合并后的loader,命名都采用
5*4882a593Smuzhiyun[chip]_[module]_[feature]_[version].[postfix]
6*4882a593Smuzhiyun
7*4882a593Smuzhiyunchip: 芯片或芯片系列名称, 必选项, 与所有kernel/uboot driver中的名称保持一致, 具体命名方式不在此讨论, 小写
8*4882a593Smuzhiyunmodule: 模块名称, 必选项, 如loader, ddr, miniloader,usbplug,bl3x,tee,tee_ta,小写
9*4882a593Smuzhiyunfeature: 模块特征, 可选项, 可多个, 如ddr使用的频率, 或者只支持某个特定的ddr, miniloader的特别选项等, 小写
10*4882a593Smuzhiyunversion: 版本信息, 必选项, 格式采用[v1.00,], 正式发布之前为0.xx, 正式发布后为1.00以后,小写
11*4882a593Smuzhiyunpostfix: 后缀名, 必选项, 代码编译出来的默认为.bin, 也有可能为.elf, 合并后为.img,小写
12*4882a593Smuzhiyun连接符号采用下划线“_”
13*4882a593Smuzhiyun例如:
14*4882a593Smuzhiyunddr模块提供的文件
15*4882a593Smuzhiyunrk3228_ddr3_800MHz_v1.06.bin
16*4882a593Smuzhiyun
17*4882a593Smuzhiyun特殊规则:
18*4882a593Smuzhiyun1. 合并后的loader命名:
19*4882a593Smuzhiyun    loader: 由ddrbin, usbplug, miniloader合并而成可用于Windows RK升级工具使用的loader;
20*4882a593Smuzhiyun    ubootloader: 由ddrbin, usbplug, U-Boot合并而成可用于Windows RK升级工具使用的loader;
21*4882a593Smuzhiyun    idbloader: 由ddrbin, 一级loader(miniloader或uboot)按IDB格式合并直接用于烧写到IDB区的binary;
22*4882a593Smuzhiyun    注: miniloader的命名, 仅表示miniloader工程编译输出的bin, 不再延续到合并后的loader中使用;
23*4882a593Smuzhiyun2. 合并后的loader的version定义:
24*4882a593Smuzhiyun    vx.yy.zzz
25*4882a593Smuzhiyunv:  version的意思,一直采用这个字符,小写
26*4882a593Smuzhiyunx.yy: ddr所提供文件的版本号,小写
27*4882a593Smuzhiyunzzz: [1]是miniloader所提供文件的版本号,去掉点号的,小写
28*4882a593Smuzhiyun     [2]uboot提供的版本号
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun3. 命名小写会引起歧义的,就用大写
31*4882a593Smuzhiyun如ddr的GB,不能写成gb
32*4882a593Smuzhiyun举例:
33*4882a593Smuzhiyun合并好的loader命名:
34*4882a593Smuzhiyunrk3328_loader_v1.03.106.bin
35*4882a593Smuzhiyun其中的1.03是ddr的版本号v1.03
36*4882a593Smuzhiyun106是miniloader的版本号v1.06去掉点号的
37