u-boot FIT image介绍

关注

转载最新推荐文章于 2026-05-16 12:55:48 发布 5.8k 阅读 AI 写同款· GEO 优化 ›

uboot验签kernel的实现本文介绍uboot启动linux内核时，开启对kernel的签名认证功能，防止kernel和device tree被任意修改。fitimage本质上是dtb类型的结构，可用于打包不同的数据到一个文件中。这样做也是为了方便SecureBoot的实现，方便对kernel,system.dtb,rootfs进行RSA签名和认证。《u-boot FIT image介绍》提供了详细的结构解析，以及如何制作的命令。fitimage格式支持存储镜像的hash值，并且在加载镜像时会校验hash值。阅读详情

1. 前言

Linux kernel在ARM架构中引入device tree（全称是flattened device tree，后续将会以FDT代称）的时候^[1]，其实怀揣了一个Unify Kernel的梦想----同一个Image，可以支持多个不同的平台。随着新的ARM64架构将FDT列为必选项，并将和体系结构有关的代码剥离之后，这个梦想已经接近实现：

在编译linux kernel的时候，不必特意的指定具体的架构和SOC，只需要告诉kernel本次编译需要支持哪些板级的platform即可，最终将会生成一个Kernel image，以及多个和具体的板子（哪个架构、哪个SOC、哪个版型）有关的FDT image（dtb文件）。

bootloader在启动的时候，根据硬件环境，加载不同的dtb文件，即可使linux kernel运行在不同的硬件平台上，从而达到unify kernel的目标。

本文将基于嵌入式产品中普遍使用的u-boot，以其新的uImage格式（FIT image，Flattened uImage Tree）为例，介绍达到此目标的步骤，以及背后的思考和意义。

2. Legacy uImage

从u-boot的角度看，它要boot一个二进制文件（例如kernel Image），需要了解该文件的一些信息，例如：

该文件的类型，如kernel image、dtb文件、ramdisk image等等？

该文件需要放在memory的哪个位置（加载地址）？

该文件需要从memory哪个位置开始执行（执行地址）？

该文件是否有压缩？

该文件是否有一些完整性校验的信息（如CRC）？

等等

结合“X-010-UBOOT-使用booti命令启动kernel(Bubblegum-96平台)”中有关booti的例子，上面信息被隐含在我们的命令行中了，例如：

通过DFU工具，将指定的image文件下载到指定的memory地址，间接的指定了二进制文件加载地址；

booti命令本身，说明加载的文件类型是ARM64平台的Image文件；

通过booti的参数，可以指定Kernel Image、ramdisk、DTB文件的执行位置；

等等。

不过，这种做法缺点很明显（总结来说，就是太啰嗦了）：

需要往memory中搬不同的二进制文件（Kernel、DTB、ramdisk等）；

boot指令（booti等）有比较复杂的参数；

无法灵活地处理二进制文件的校验、解压缩等操作；

等等。

为了解决上述缺点，u-boot自定义了一种Image格式----uImage。最初的时候，uImage的格式比较简单，就是为二进制文件加上一个header（具体可参考“include/image.h”中的定义），标示该文件的特性。然后在boot该类型的Image时，从header中读取所需的信息，按照指示，进行相应的动作即可。这种原始的Image格式，称作Legacy uImage，其特征可总结为：

1）使用mkimage工具（位于u-boot source code的tools/mkimage中）生成。

2）支持OS Kernel Images、RAMDisk Images等多种类型的Image。

3）支持gzip、bzip2等压缩算法。

4）支持CRC32 checksums。

5）等等。

最后，之所以称作Legacy，说明又有新花样了，这种旧的方式，我们就不再过多关注了，拥抱新事物去吧。

3. FIT uImage

3.1 简介

device tree在ARM架构中普及之后，u-boot也马上跟进、大力支持，毕竟，美好的Unify kernel的理想，需要bootloader的成全。为了支持基于device tree的unify kernel，u-boot需要一种新的Image格式，这种格式需要具备如下能力：

1）Image中需要包含多个dtb文件。

2）可以方便的选择使用哪个dtb文件boot kernel。

综合上面的需求，u-boot推出了全新的image格式----FIT uImage，其中FIT是flattened image tree的简称。是不是觉得FIT和FDT（flattened device tree）有点像？没错，它利用了Device Tree Source files（DTS）的语法，生成的image文件也和dtb文件类似（称作itb），下面我们会详细描述。

3.2 思路

为了简单，我们可以直接把FIT uImage类比为device tree的dtb文件，其生成和使用过程为^[2]：

image source file mkimage + dtc transfer to target
+ -----------------------------> image file -----------------------------------> bootm
image data file(s)

其中image source file(.its)和device tree source file(.dts)类似，负责描述要生成的image file的信息（上面第2章描述的信息）。mkimage和dtc工具，可以将.its文件以及对应的image data file，打包成一个image file。我们将这个文件下载到么memory中，使用bootm命令就可以执行了。

3.3 image source file的语法

image source file的语法和device tree source file完全一样（可参考^[3][4][5]中的例子），只不过自定义了一些特有的节点，包括images、configurations等。说明如下：

1）images节点

指定所要包含的二进制文件，可以指定多种类型的多个文件，例如multi.its^[5]中的包含了3个kernel image、2个ramdisk image、2个fdt image。每个文件都是images下的一个子node，例如：

kernel@2 {
    description = "2.6.23-denx";
    data = /incbin/("./2.6.23-denx.bin.gz");
    type = "kernel";
    arch = "ppc";
    os = "linux";
    compression = "gzip";
    load = <00000000>;
    entry = <00000000>;
    hash@1 {
        algo = "sha1";
    };
};

可以包括如下的关键字：

description，描述，可以随便写；

data，二进制文件的路径，格式为----/incbin/("path/to/data/file.bin")；

type，二进制文件的类型，"kernel", "ramdisk", "flat_dt"等，具体可参考中^[6]的介绍；

arch，平台类型，“arm”, “i386”等，具体可参考中^[6]的介绍；

os，操作系统类型，linux、vxworks等，具体可参考中^[6]的介绍；

compression，二进制文件的压缩格式，u-boot会按照执行的格式解压；

load，二进制文件的加载位置，u-boot会把它copy对应的地址上；

entry，二进制文件入口地址，一般kernel Image需要提供，u-boot会跳转到该地址上执行；

hash，使用的数据校验算法。

2）configurations

可以将不同类型的二进制文件，根据不同的场景，组合起来，形成一个个的配置项，u-boot在boot的时候，以配置项为单位加载、执行，这样就可以根据不同的场景，方便的选择不同的配置，实现unify kernel目标。还以multi.its^[5]为例，

configurations {
    default = "config@1";

     config@1 {
         description = "tqm5200 vanilla-2.6.23 configuration";
         kernel = "kernel@1";
         ramdisk = "ramdisk@1";
        fdt = "fdt@1";
     };

     config@2 {
         description = "tqm5200s denx-2.6.23 configuration";
         kernel = "kernel@2";
         ramdisk = "ramdisk@1";
         fdt = "fdt@2";
    };

     config@3 {
         description = "tqm5200s denx-2.4.25 configuration";
        kernel = "kernel@3";
         ramdisk = "ramdisk@2";
     };
};