U-Boot mkimage 工具分析文档
1. 概述
本文档针对瑞芯微 RK3588 平台，深入分析 U-Boot 中mkimage工具的作用、原理和实现机制。通过源码分析，解答"为什么要使用 mkimage 工具生成 u-boot.bin 文件"这一问题。
硬件平台: 瑞芯微 RK3588
U-Boot 源码路径:./u-boot
分析日期: 2026-01-04
2. mkimage 工具简介
2.1 什么是 mkimage？
mkimage是 U-Boot 提供的一个镜像打包工具，用于在裸机二进制文件前添加特定格式的头部信息（header），使其能够被 Boot ROM 或 U-Boot 自身识别和加载。
源码位置:tools/mkimage.c
2.2 为什么需要 mkimage？
通过分析源码，我们可以总结出以下几个关键原因：
┌─────────────────────────────────────────────────────────────┐ │ mkimage 的核心作用 │ ├─────────────────────────────────────────────────────────────┤ │ 1. 添加标准化头部信息 - 描述镜像属性 │ │ 2. 完整性校验 - 通过 CRC/SHA 校验确保数据完整 │ │ 3. 多镜像支持 - 支持打包多个组件（内核/设备树/根文件系统） │ │ 4. 平台适配 - 为不同芯片平台添加特定的启动头 │ │ 5. 验证启动 - 支持签名和加密，确保镜像来源可信 │ └─────────────────────────────────────────────────────────────┘3. mkimage 支持的镜像格式
3.1 两种主要格式
mkimage 支持两种镜像格式，定义在doc/mkimage.1中：
| 格式类型 | 说明 | 特点 |
|---|---|---|
| Legacy 格式 | 传统格式，64字节固定头部 | 结构简单、向后兼容 |
| FIT 格式 | Flattened Image Tree，新型格式 | 灵活性强、支持多组件、支持签名验证 |
3.2 镜像类型定义
在include/image.h中定义了所有支持的镜像类型：
/* 关键镜像类型枚举 */enum{IH_TYPE_INVALID=0,// 无效镜像IH_TYPE_STANDALONE,// 独立程序IH_TYPE_KERNEL,// OS 内核镜像IH_TYPE_RAMDISK,// RAMDisk 镜像IH_TYPE_MULTI,// 多文件镜像IH_TYPE_FIRMWARE,// 固件镜像IH_TYPE_SCRIPT,// 脚本文件IH_TYPE_FLATDT,// 扁平设备树 BlobIH_TYPE_RKIMAGE,// Rockchip Boot ImageIH_TYPE_RKSD,// Rockchip SD 卡镜像IH_TYPE_RKSPI,// Rockchip SPI 镜像IH_TYPE_RKNAND,// Rockchip NAND 镜像// ... 更多类型};4. Legacy 格式详解
4.1 头部结构
Legacy 格式的头部结构定义在include/image.h:311-324：
typedefstructimage_header{__be32 ih_magic;/* 镜像魔数: 0x27051956 */__be32 ih_hcrc;/* 头部 CRC 校验 */__be32 ih_time;/* 创建时间戳 */__be32 ih_size;/* 镜像数据大小 */__be32 ih_load;/* 数据加载地址 */__be32 ih_ep;/* 入口点地址 */__be32 ih_dcrc;/* 数据 CRC 校验 */uint8_tih_os;/* 操作系统类型 */uint8_tih_arch;/* CPU 架构 */uint8_tih_type;/* 镜像类型 */uint8_tih_comp;/* 压缩类型 */uint8_tih_name[IH_NMLEN];/* 镜像名称（32字节） */}image_header_t;总大小: 64 字节
4.2 头部字段含义
| 字段 | 大小 | 说明 |
|---|---|---|
ih_magic | 4字节 | 固定值0x27051956，用于识别镜像格式 |
ih_hcrc | 4字节 | 头部自身的CRC32校验值 |
ih_time | 4字节 | 镜像创建的时间戳 |
ih_size | 4字节 | 镜像数据的大小（不含头部） |
ih_load | 4字节 | 镜像应加载到内存的地址 |
ih_ep | 4字节 | 程序入口点地址 |
ih_dcrc | 4字节 | 镜像数据的CRC32校验值 |
ih_os | 1字节 | 操作系统类型（如Linux、VxWorks等） |
ih_arch | 1字节 | CPU架构（如ARM、x86等） |
ih_type | 1字节 | 镜像类型（内核、固件等） |
ih_comp | 1字节 | 压缩类型（gzip、bzip2等） |
ih_name | 32字节 | 镜像名称字符串 |
4.3 Legacy 格式生成流程
源码实现在tools/default_image.c：
// 设置头部信息的核心函数staticvoidimage_set_header(void*ptr,structstat*sbuf,intifd,structimage_tool_params*params){image_header_t*hdr=(image_header_t*)ptr;// 1. 计算数据的CRC校验值checksum=crc32(0,(constunsignedchar*)(ptr+sizeof(image_header_t)),sbuf->st_size-sizeof(image_header_t));// 2. 设置各项字段image_set_magic(hdr,IH_MAGIC);// 设置魔数image_set_time(hdr,time);// 设置时间戳image_set_size(hdr,imagesize);// 设置数据大小image_set_load(hdr,params->addr);// 设置加载地址image_set_ep
