文档 下面链接文档包含《产品介绍》、《数据手册》和《用户手册》。 芯片产品文档 编译 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 -supported # Check if solution is supported make -config # Apply solution defconfig make -menuconfig # Configure buildroot for solution make -linux-menuconfig # Configure Linux kernel for solution make -uboot- menuconfig # Configure U-Boot for solution make -busybox-menuconfig # Configure BusyBox for solution make -build # Build specified solution make -pkg PKG= # Build specified package for solution make -shell # Enter build container for solution make -source # Download all source packages for solution make -clean # Clean solution build artifacts make -cleanbuild # Clean and rebuild solution make build-docker-image # Build Docker image make update-docker-image # Update Docker image Quick Start: Run 'make -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"查看指南。 常用命令： 删除的编译目录：make -dirclean 编译：make 重新编译: make -rebuild u-boot #编译 make uboot #清理 make uboot-dirclean #重新编译 make uboot-rebuild Linux 内核默认配置为"k3_bianbu_defconfig" #编译 make linux #清理 make linux-dirclean #重新编译 make linux-rebuild opensbi #编译 make opensbi #清理 make opensbi-dirclean #重新编译 make opensbi-rebuild 编译指定包之后，可以单独下载到设备验证，或者编进固件： make