le-gh / rkbin Goto Github PK

Rockchip loader binaries naming rule

总则：
不管单个模块，还是合并后的loader，命名都采用
[chip]_[module]_[feature]_[version].[postfix]

chip: 芯片或芯片系列名称, 必选项, 与所有kernel/uboot driver中的名称保持一致, 具体命名方式不在此讨论, 小写
module: 模块名称, 必选项, 如loader, ddr, miniloader，usbplug,bl3x,tee,tee_ta，小写
feature: 模块特征, 可选项, 可多个, 如ddr使用的频率, 或者只支持某个特定的ddr, miniloader的特别选项等, 小写
version: 版本信息, 必选项, 格式采用[v1.00,], 正式发布之前为0.xx, 正式发布后为1.00以后，小写
postfix: 后缀名, 必选项, 代码编译出来的默认为.bin, 也有可能为.elf, 合并后为.img，小写
连接符号采用下划线“_”
例如：
ddr模块提供的文件
rk3228_ddr3_800MHz_v1.06.bin

特殊规则：
1. 合并后的loader命名:
    loader: 由ddrbin, usbplug, miniloader合并而成可用于Windows RK升级工具使用的loader;
    ubootloader: 由ddrbin, usbplug, U-Boot合并而成可用于Windows RK升级工具使用的loader;
    idbloader: 由ddrbin, 一级loader(miniloader或uboot)按IDB格式合并直接用于烧写到IDB区的binary;
    注: miniloader的命名, 仅表示miniloader工程编译输出的bin, 不再延续到合并后的loader中使用;
2. 合并后的loader的version定义:
    vx.yy.zzz
v:  version的意思，一直采用这个字符，小写
x.yy: ddr所提供文件的版本号，小写
zzz: [1]是miniloader所提供文件的版本号，去掉点号的，小写
     [2]uboot提供的版本号

3. 命名小写会引起歧义的，就用大写
如ddr的GB，不能写成gb
举例：
合并好的loader命名：
rk3328_loader_v1.03.106.bin
其中的1.03是ddr的版本号v1.03
106是miniloader的版本号v1.06去掉点号的