lk2nd启动内存布局揭秘:50 MiB boot内存是如何分配给内核、initramfs与DTB的
lk2nd启动内存布局揭秘:50 MiB boot内存是如何分配给内核、initramfs与DTB的
lk2nd 是一款面向 Qualcomm MSM8916/MSM8226/MSM8974 等设备的自定义 bootloader,它通过 extlinux.conf 引导 Linux 时,会把内核(kernel)、initramfs 和设备树(DTB)三样东西挤进一块有限的启动内存里——默认只有 50 MiB。这篇文章带你完整看懂 lk2nd 启动内存布局的分配策略、各类引导失败报错的成因,以及如何按需调整这块内存的大小。
为什么启动内存只有 50 MiB?
当你用 extlinux.conf 方式引导 Linux 时,lk2nd 必须为内核、initramfs、DTB 挑选内存地址。但这块"启动内存"并不由你随意指定——它被旁边的保留内存区域(reserved memory)卡住了:
可用的 boot 内存受附近保留内存区域限制,会因平台而异。平台可通过
LK2ND_BOOT_MEM_SIZE调整大小。 —— Documentation/boot.md
各平台的默认值:
| 平台 | 启动内存大小 | 说明 |
|---|---|---|
| msm8960 | 128 MiB(0x07c00000) |
受 framebuffer 等保留区域约束,见 lk2nd/project/msm8960.mk |
| 其余平台 | 50 MiB(0x03200000) |
全局默认值,定义在 lk2nd/boot/rules.mk |
这三样东西共享这块内存,一旦总量超出,引导就会失败——这正是本文要讲的核心问题。
50 MiB 是怎么切给三块内容的?
lk2nd 的内存布局算法全部在 lk2nd/boot/extlinux.c 的 choose_addrs() 中实现。它从 DDR 基地址(DDR_START,运行时从 SMEM 表读出,见 platform/msm_shared/smem_ptable.c)开始,按下面这张图分配:
DDR_START(boot 内存基址)
┌──────────────────────────────────────────────┐
│ 内核 kernel + 自解压空间 │ ← 基址 + kernel_offset(占最大的一块)
├──────────────────────────────────────────────┤
│ DTB(tags,最大 2 MiB) │ ← 紧贴 initramfs 之前
├──────────────────────────────────────────────┤
│ initramfs(4096 字节对齐) │ ← 放在 50 MiB 区域的末尾
└──────────────────────────────────────────────┘
DDR_START + LK2ND_BOOT_MEM_SIZE
具体规则拆解:
- initramfs 先"从后往前"占位:
ramdisk_offset = ROUNDDOWN(50 MiB - ramdisk_size, 4096),即 initramfs 被放到 boot 内存的最末端,并向下对齐到 4 KiB 边界。 - DTB 紧挨 initramfs 下方:
tags_offset = ramdisk_offset - 2 MiB,DTB 最多允许 2 MiB(MAX_TAGS_SIZE),加载时如果文件本身超过 2 MiB,直接报 "DTB is too big"。 - 内核放在最前面:内核起点由架构决定,中间全部留给内核(含自解压膨胀后的空间):
- ARM32 内核:固定
基址 + 0x8000; - ARM64 内核:优先读取内核头里的
text_offset(要求image_size != 0,即 Linux 3.17+ 才可信),老内核退化为基址 + 0x80000; - 防坑设计:如果
text_offset > 2 MiB,lk2nd 判断这是 U-Boot 构建产生的"bogus"偏移,直接丢弃并回退到 0。
- ARM32 内核:固定
- 内核大小校验:
kernel_max_size = tags_offset - kernel_offset,解压后的内核若超过该值,报 "Kernel too big" 并放弃引导。
一个容易忽略的细节:判断内核大小用的是解压之后的尺寸。lk2nd 会先用 zlib_inflate 把压缩内核解压到 scratch 区(见 lk2nd/boot/extlinux.c),再 memmove 到正式地址——所以磁盘上 5 MiB 的 zImage,解压后可能吃掉 20 MiB 以上的空间。
为什么"把 initramfs 和 DTB 放末尾"是关键设计?
ARM 32 位内核和较老的 64 位内核不会声明"我解压后需要多大内存"。lk2nd 的对策很聪明:把 initramfs 和 DTB 钉在 boot 内存的末端,把中间剩余的全部空间都让给内核解压。
- 内核解压空间 = boot 内存总量 − initramfs − 2 MiB(DTB 上限)
- 也就是说,50 MiB 的默认配置下,内核理论上可以用到约 45 MiB 的解压空间,绝大多数内核都够用
这正是 Documentation/boot.md 中强调的"该内存由内核、initramfs、设备树共享,超限即失败"的原因——失败通常不是因为磁盘上的文件大,而是内核解压后的真实体积大。
引导失败时,报错信息怎么读?
lk2nd 的报错信息非常直白,常见三种(均可在 lk2nd/boot/extlinux.c 找到来源):
| 报错 | 含义 | 处理思路 |
|---|---|---|
Kernel too big: %u > %u |
解压后的内核超过了"基址→DTB"之间的空间 | 减小内核、或调大 LK2ND_BOOT_MEM_SIZE |
DTB is too big |
DTB 文件超过 2 MiB | 精简 DTS,去掉用不到的 overlay |
Failed to decompress the kernel |
解压失败 | 确认内核镜像格式受支持 |
排查技巧:开 DEBUGLEVEL 到 SPEW 级别,可以看到 lk2nd/boot/boot.c 打印的完整文件系统树和各文件大小,方便快速定位哪块内容吃掉了内存。
如何按需调整 LK2ND_BOOT_MEM_SIZE
如果你遇到 "Kernel too big",而设备内存布局又允许,可以在项目配置中覆盖默认值:
# 在项目的 .mk 中,例如参考 <a href="https://link.gitcode.com/i/a5e1f81df3478ef0d3b0eda7468de6c0" target="_blank">lk2nd/project/msm8960.mk</a>
LK2ND_BOOT_MEM_SIZE := 0x07c00000 # 128 MiB
构建文档 Documentation/building.md 中对该选项的说明:
LK2ND_BOOT_MEM_SIZE=- 引导可用的最大内存(字节)。默认0x03200000(50 MiB),用于容纳内核、设备树和 initramfs。
⚠️ 注意:不是越大越好。50 MiB 这个默认值本身就是被保留内存区域(framebuffer、SMEM 等)限制后的安全值。调大前请确认该物理地址段后面没有其它保留区域(参考 msm8960 配置中的注释:受 MIPI framebuffer 地址约束),否则会踩坏其它内存使用者。
小结
🔑 回顾 lk2nd 启动内存布局的三个关键点:
- 总量固定:默认 50 MiB(msm8960 为 128 MiB),由
LK2ND_BOOT_MEM_SIZE控制; - 末端优先:initramfs 钉在末尾、DTB(≤2 MiB)紧贴其下、内核占据剩余全部空间,最大化内核自解压余量;
- 按架构对齐:ARM32 从
+0x8000起,ARM64 优先信任内核头中的text_offset,并内置对 U-Boot 构建产物 bogus 偏移的防御。
看懂这套布局,你在定制内核或裁剪 DTB 时就能准确估算"还能再胖多少",而不是靠猜。
