build-mainline-linux.sh - 主线Linux内核构建脚本

脚本概述

build-mainline-linux.sh 是 IMX-Forge 项目中用于编译主线 Linux 内核的构建脚本。它与 build-linux.sh 类似，但专门针对主线内核进行配置。

核心功能

依赖自动检查：检测并提示缺失的主机构建工具
工具链验证：确保交叉编译工具链正确安装且可用
配置管理：基于 defconfig 模板生成内核配置
固件准备：自动获取和准备无线固件数据库
并行编译：自动利用多核 CPU 加速编译
产物验证：验证编译产物的架构、大小等关键指标
快速构建模式：支持跳过 distclean 的增量编译

与 build-linux.sh 的区别

特性	build-linux.sh	build-mainline-linux.sh
内核源码	`linux-imx`	`linux_mainline`
配置文件	`imx_aes_defconfig`	`imx_aes_mainline_defconfig`
输出目录	`out/linux`	`out/mainline/linux`
固件准备	无	自动获取 wireless-regdb

依赖关系

build-mainline-linux.sh
    ├─ scripts/lib/logging.sh (日志工具库)
    ├─ third_party/linux_mainline (主线内核源码)
    └─ arm-none-linux-gnueabihf-gcc (交叉编译工具链)

参数说明

命令行参数

bash

./scripts/build_helper/build-mainline-linux.sh [OPTIONS]

参数	说明	默认值
`--fast-build`	跳过 distclean，使用现有配置快速编译	禁用

环境变量

变量	说明	默认值
`ARCH`	目标架构	`arm`
`CROSS_COMPILE`	交叉编译器前缀	`arm-none-linux-gnueabihf-`
`DEFCONFIG`	内核配置文件	`imx_aes_mainline_defconfig`
`OUTPUT_DIR`	编译输出目录	`out/mainline/linux`
`FIRMWARE_DIR`	固件目录	`driver/firmwares`
`DEBUG`	启用调试输出	`0`

执行流程

总体架构

┌─────────────────────────────────────────────────────────────┐
│  1. 初始化阶段                                               │
│     - 获取脚本路径                                           │
│     - 设置项目根目录                                         │
│     - 加载日志库                                             │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  2. 预检查阶段                                               │
│     - check_host_dependencies()                              │
│     - check_toolchain()                                      │
│     - check_defconfig()                                      │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  3. 构建阶段                                                 │
│     - do_distclean() [可选]                                 │
│     - prepare_defconfig()                                    │
│     - do_configure()                                         │
│     - do_build()                                             │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  4. 验证阶段                                                 │
│     - verify_build_artifacts()                               │
└─────────────────────────────────────────────────────────────┘

函数详解

prepare_defconfig()

作用：从模板生成 defconfig 并准备固件。

执行步骤：

从模板文件复制并替换固件目录变量
克隆 wireless-regdb 仓库
复制 regulatory.db 文件到固件目录

模板路径：

driver/device_tree/alpha-board/linux/imx6ull_mainline_defconfig.template

目标路径：

third_party/linux_mainline/arch/arm/configs/imx_aes_mainline_defconfig

固件准备：

bash

# 克隆无线法规数据库
git clone https://git.kernel.org/pub/scm/linux/kernel/git/sforshee/wireless-regdb.git

# 复制到固件目录
cp regulatory.db driver/firmwares/
cp regulatory.db.p7s driver/firmwares/

verify_build_artifacts()

作用：验证编译产物是否正确。

验证项目：

产物	验证方法	期望结果
`vmlinux`	`readelf -h	grep Machine`
`vmlinux`	`readelf -h	grep Entry point`
`zImage`	文件存在性检查	存在
`.config`	文件存在性检查	存在
`System.map`	文件存在性检查	存在（可选）
`modules/`	目录存在性检查	存在（可选）

配置选项

硬编码配置

bash

ARCH=arm
CROSS_COMPILE=arm-none-linux-gnueabihf-
DEFCONFIG=imx_aes_mainline_defconfig
FAST_BUILD=0

LINUX_SRC_DIR="${PROJECT_ROOT}/third_party/linux_mainline"
OUTPUT_DIR="${PROJECT_ROOT}/out/mainline/linux"

目录结构

PROJECT_ROOT/
├── third_party/
│   └── linux_mainline/       # 主线内核源码
├── out/
│   └── mainline/
│       └── linux/            # 编译产物
│           ├── vmlinux       # ELF 内核
│           ├── System.map    # 符号表
│           ├── .config       # 配置文件
│           └── arch/arm/boot/
│               ├── Image     # 未压缩镜像
│               └── zImage    # 压缩镜像
├── driver/
│   └── firmwares/            # 固件文件
│       ├── regulatory.db
│       └── regulatory.db.p7s
└── scripts/
    └── build_helper/
        └── build-mainline-linux.sh

使用示例

基本用法

bash

# 完整编译（清理 + 配置 + 编译）
./scripts/build_helper/build-mainline-linux.sh

快速编译

bash

# 跳过 distclean，保留现有配置
./scripts/build_helper/build-mainline-linux.sh --fast-build

自定义固件目录

bash

FIRMWARE_DIR=/path/to/firmwares ./scripts/build_helper/build-mainline-linux.sh

输出示例

[INFO] Starting Linux kernel build for imx_aes_mainline_defconfig
[INFO] ========================================
[INFO] Checking host dependencies...
[INFO]   ✓ build-essential
[INFO]   ✓ bc
[INFO]   ✓ bison
[INFO]   ✓ flex
[INFO]   ✓ device-tree-compiler
[INFO]   ✓ python3
[INFO]   ✓ libssl-dev
[INFO]   ✓ libgnutls28-dev
[INFO]   ✓ libncurses-dev
[INFO] All host dependencies found
[INFO] Checking toolchain...
[INFO] Toolchain found: arm-none-linux-gnueabihf-gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0
[INFO] All required toolchain components found
[INFO] Checking defconfig...
[INFO] Defconfig found: third_party/linux_mainline/arch/arm/configs/imx_aes_mainline_defconfig
[INFO] ========================================
[INFO] All checks passed, starting build...
[INFO] ========================================
[INFO] Preparing defconfig from template...
[INFO]   Template: driver/device_tree/alpha-board/linux/imx6ull_mainline_defconfig.template
[INFO]   Target:   third_party/linux_mainline/arch/arm/configs/imx_aes_mainline_defconfig
[INFO]   Firmware Dir: /home/user/imx-forge/driver/firmwares
[INFO] Preparing wireless regulatory database...
[INFO]   Cloning wireless-regdb repository...
[INFO]   Copied regulatory.db to driver/firmwares/
[INFO]   Copied regulatory.db.p7s to driver/firmwares/
[INFO] Configuring Linux kernel with imx_aes_mainline_defconfig...
[CMD] make -C third_party/linux_mainline ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- O=out/mainline/linux imx_aes_mainline_defconfig
[INFO] Building Linux kernel...
[CMD] make -C third_party/linux_mainline ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabihf- O=out/mainline/linux -j8
[INFO] ========================================
[INFO] Verifying build artifacts in out/mainline/linux...
[INFO]   ✓ vmlinux: ARM
[INFO]     Entry: 0xc0008000
[INFO]   ✓ zImage: 3245152 bytes
[INFO]   ✓ .config: present
[INFO]   ✓ System.map: present
[INFO] All build artifacts verified successfully
[INFO] ========================================
[INFO] Build completed successfully!

故障排除

常见错误

错误 1：主线内核源码不存在

[ERROR] 内核源码目录不存在: third_party/linux_mainline

解决方法：

确保主线内核子模块已初始化：

bash

git submodule update --init --recursive third_party/linux_mainline

错误 2：defconfig 模板不存在

[ERROR] Defconfig file not found: driver/device_tree/alpha-board/linux/imx6ull_mainline_defconfig.template

解决方法：

检查项目配置文件是否存在：

bash

ls driver/device_tree/alpha-board/linux/imx6ull_mainline_defconfig.template

错误 3：无线固件下载失败

[WARN]  regulatory.db not found in repository

解决方法：

检查网络连接，或手动下载：

bash

git clone https://git.kernel.org/pub/scm/linux/kernel/git/sforshee/wireless-regdb.git
cp wireless-regdb/regulatory.db driver/firmwares/

Qt

build-mainline-linux.sh - 主线Linux内核构建脚本

脚本概述

核心功能

与 build-linux.sh 的区别

依赖关系

参数说明

命令行参数

环境变量

执行流程

总体架构

函数详解

prepare_defconfig()

verify_build_artifacts()

配置选项

硬编码配置

目录结构

使用示例

基本用法

快速编译

自定义固件目录

输出示例

故障排除

常见错误

错误 1：主线内核源码不存在

错误 2：defconfig 模板不存在

错误 3：无线固件下载失败

相关文档

build-mainline-linux.sh - 主线Linux内核构建脚本 ​

脚本概述 ​

核心功能 ​

与 build-linux.sh 的区别 ​

依赖关系 ​

参数说明 ​

命令行参数 ​

环境变量 ​

执行流程 ​

总体架构 ​

函数详解 ​

prepare_defconfig() ​

verify_build_artifacts() ​

配置选项 ​

硬编码配置 ​

目录结构 ​

使用示例 ​

基本用法 ​

快速编译 ​

自定义固件目录 ​

输出示例 ​

故障排除 ​

常见错误 ​

错误 1：主线内核源码不存在 ​

错误 2：defconfig 模板不存在 ​

错误 3：无线固件下载失败 ​

相关文档 ​

build-mainline-linux.sh - 主线Linux内核构建脚本

脚本概述

核心功能

与 build-linux.sh 的区别

依赖关系

参数说明

命令行参数

环境变量

执行流程

总体架构

函数详解

prepare_defconfig()

verify_build_artifacts()

配置选项

硬编码配置

目录结构

使用示例

基本用法

快速编译

自定义固件目录

输出示例

故障排除

常见错误

错误 1：主线内核源码不存在

错误 2：defconfig 模板不存在

错误 3：无线固件下载失败

相关文档