编译 Linux 固件¶
注意：
默认在容器中构建。如需在宿主机上构建，请配置环境变量 export DIRECT_BUILD=1，切换容器中构建和宿主机构建时需要清理output目录。
新增一组命令。与旧命令不兼容，如需使用新命令，需删除项目根目录下旧命令生成的env.mk文件，之后可用make help查看新命令列表，例如可以make k3-build 直接编译指定方案：
$ cd ~/k3-buildroot-sdk-1.0 $ rm -rf env.mk $ make help Buildroot Build System - Help Available solutions: aibox-k3 k3 k3_ci k3_fpga k3_plt Development Commands: make vars # Show project information make <solution>-supported # Check if solution is supported make <solution>-config # Apply solution defconfig make <solution>-menuconfig # Configure buildroot for solution make <solution>-linux-menuconfig # Configure Linux kernel for solution make <solution>-uboot-menuconfig # Configure U-Boot for solution make <solution>-busybox-menuconfig # Configure BusyBox for solution make <solution>-build # Build specified solution make <solution>-pkg PKG=<package> # Build specified package for solution make <solution>-shell # Enter build container for solution make <solution>-source # Download all source packages for solution make <solution>-clean # Clean solution build artifacts make <solution>-cleanbuild # Clean and rebuild solution make build-docker-image # Build Docker image make update-docker-image # Update Docker image Quick Start: Run 'make <solution>-build' to get started, e.g.: make k3-build
编译 Buildroot 固件¶
编译前配置¶
$ cd ~/k3-buildroot-sdk-1.0
$ make envconfig
Available configs in /home2/lvsx/ext/project/k3/buildroot-ext/configs:
1. spacemit_aibox-k3_defconfig
2. spacemit_k3_ci_defconfig
3. spacemit_k3_defconfig
4. spacemit_k3_fpga_defconfig
5. spacemit_k3_plt_defconfig
Your choice (1-5):
这里输入 1 选择 spacemit_aibox-k3_defconfig。
编译过程可能需要下载一些第三方软件包，具体耗时和网络环境相关。如果提前下载 buildroot 依赖的第三方软件包，推荐硬件配置编译耗时约为1小时。
编译产物位于/output/k3/images/目录下，编译打包成功log如下：
Generating sdcard image...................................
INFO: cmd: "mkdir -p "/aibox-k3/build/genimage.tmp"" (stderr):
INFO: cmd: "rm -rf "/aibox-k3/build/genimage.tmp"/*" (stderr):
INFO: cmd: "mkdir -p "/aibox-k3/images"" (stderr):
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'env' from 'env.bin' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'bootinfo' from 'factory/bootinfo_block.bin' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'fsbl' from 'factory/FSBL.bin' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'esos' from 'esos.itb' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'opensbi' from 'fw_dynamic.itb' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'uboot' from 'u-boot.itb' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'bootfs' (in MBR) from 'bootfs.img' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition 'rootfs' (in MBR) from 'rootfs.ext4' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition '[MBR]' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition '[GPT header]' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition '[GPT array]' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): adding primary partition '[GPT backup]' ...
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): writing GPT
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): writing protective MBR
INFO: hdimage(Buildroot-aibox-k3-20260508163419-sdcard.img): writing MBR
INFO: cmd: "rm -rf "/aibox-k3/build/genimage.tmp/"" (stderr):
Successfully generated at /aibox-k3/images/Buildroot-aibox-k3-20260508163419-sdcard.img
其中 Buildroot-K3-xxx.zip适用于Titan Flasher，或者解压后用fastboot刷机；Buildroot-K3-xxx-sdcard.img为sdcard固件，解压后可以用dd命令或者balenaEtcher写入sdcard。
固件默认用户名：root，密码：firefly。
编译 Bianbu 固件¶
准备工作¶
下载根文件系统：Bianbu 根文件系统(64位)
下载后将文件系统解压到 SDK/buildroot-ext/board/spacemit/k3/ 下，并重命名
# 解压
7z x Bianbu-Lxqt_rootfs_xxx.7z
# 将解压后的 rootfs 镜像移动到 sdk 指定目录。名称需指定为 rootfs.ext4
mv Bianbu-Lxqt_rootfs_xxx.ext4 /SDK/buildroot-ext/board/spacemit/k3/rootfs.ext4
编译前配置¶
$ cd ~/k3-buildroot-sdk-1.0
$ make envconfig
Available configs in /home2/lvsx/ext/project/k3/buildroot-ext/configs:
1. spacemit_aibox-k3_defconfig
2. spacemit_k3_ci_defconfig
3. spacemit_k3_defconfig
4. spacemit_k3_fpga_defconfig
5. spacemit_k3_plt_defconfig
Your choice (1-5):
这里输入 1 选择 spacemit_aibox-k3_defconfig。
编译过程会使用 /SDK/buildroot-ext/board/spacemit/k3/rootfs.ext4 文件系统来替换 buildroot 的文件系统。
配置¶
配置需要进入到 docker 编译环境中
make aibox-k3-shell
buildroot¶
配置：
make menuconfig
保存配置，默认保存到buildroot-ext/configs/spacemit_aibox-k3_defconfig：
make savedefconfig
Linux¶
配置：
make linux-menuconfig
保存配置，默认保存到bsp-src/linux-6.18/arch/riscv/configs/k3_bianbu_defconfig：
make linux-update-defconfig
u-boot¶
配置：
make uboot-menuconfig
保存配置，默认保存到bsp-src/uboot-2022.10/configs/k3_defconfig：
make uboot-update-defconfig
再次完整编译¶
如果已经使用make envconfig完整编译，可以直接使用make再次完整编译。
编译指定包¶
buildroot支持编译指定package，可以make help查看指南。
常用命令：
删除
<pkg>的编译目录：make <pkg>-dirclean编译
<pkg>：make <pkg>重新编译
<pkg>:make <pkg>-rebuild
u-boot¶
#编译
make uboot
#清理
make uboot-dirclean
#重新编译
make uboot-rebuild
opensbi¶
#编译
make opensbi
#清理
make opensbi-dirclean
#重新编译
make opensbi-rebuild
编译指定包之后，可以单独下载到设备验证，或者编进固件：
make