简介
Duo 默认的 SDK 是基于 buildroot 构建的,用来生成 Duo 的固件,SDK 主要包含如下几个部分:
Buildroot SDK V1
- u-boot: 2021.10
- linux kernel: 5.10.4
- buildroot: 2021.05
- opensbi: 89182b2
源码地址: https://github.com/milkv-duo/duo-buildroot-sdk
SDK目录结构
├── build // 编译目录,存放编译脚本以及各board差异化配置
├── build.sh // Milk-V Duo 一键编译脚本
├── buildroot-2021.05 // buildroot 开源工具
├── freertos // freertos 系统
├── fsbl // fsbl启动固件,prebuilt 形式存在
├── install // 执行一次完整编译后,临时存放各 image 路径
├── isp_tuning // 图像效果调试参数存放路径
├── linux_5.10 // 开源 linux 内核
├── middleware // 自研多媒体框架,包含 so 与 ko
├── device // 存放 Milk-V Duo 相关配置及脚本文件的目录
├── opensbi // 开源 opensbi 库
├── out // Milk-V Duo 最终生成的 SD 卡烧录镜像所在目录
├── ramdisk // 存放最小文件系统的 prebuilt 目录
└── u-boot-2021.10 // 开源 uboot 代码
V1 版本 SDK 不支持 Duo256M 和 DuoS 的 ARM 核,如果需要使用 ARM 核,请使用 V2 版本的SDK。
Buildroot SDK V2
V2 版本 SDK 加入了对 Duo256M 和 DuoS 的 ARM 核的支持,编译方法与 V1 版本 SDK 基本一致。
源码地址: https://github.com/milkv-duo/duo-buildroot-sdk-v2
编译镜像
准备编译环境,使用本地的 Ubuntu 系统,官方支持的编译环境为 Ubuntu Jammy 22.04.x amd64
。
如果您使用的是其他的 Linux 发行版,我们强烈建议您使用 Docker 环境来编译,以降低编译出错的概率。
以下分别介绍两种环境下的编译方法。
一、使用 Ubuntu 22.04 编译
安装编译依赖的工具包
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tcl openssh-client cmake expect python-is-python3
对于 duo-buildroot-sdk-v2,还需要安装以下工具包:
sudo pip install jinja2
获取 SDK
git clone https://github.com/milkv-duo/duo-buildroot-sdk.git --depth=1
1、一键编译
执行一键编译脚本 build.sh
:
cd duo-buildroot-sdk/
./build.sh
会看到编 译脚本的使用方法提示:
# ./build.sh
Usage:
./build.sh - Show this menu
./build.sh lunch - Select a board to build
./build.sh [board] - Build [board] directly, supported boards asfollows:
milkv-duo-sd
milkv-duo-spinand
milkv-duo-spinor
milkv-duo256m-sd
milkv-duo256m-spinand
milkv-duo256m-spinor
milkv-duos-emmc
milkv-duos-sd
最下边列出的是当前支持的目标版本列表。
如提示中所示,有两种方法来编译目录版本。
第一种方法是执行 ./build.sh lunch
调出交互菜单,选择要编译的版本序号,回车:
# ./build.sh lunch
Select a target to build:
1. milkv-duo-sd
2. milkv-duo-spinand
3. milkv-duo-spinor
4. milkv-duo256m-sd
5. milkv-duo256m-spinand
6. milkv-duo256m-spinor
7. milkv-duos-emmc
8. milkv-duos-sd
Which would you like:
第二种方法是脚本后面带上目标版本的名字,比如要编译 milkv-duo-sd
的镜像:
# ./build.sh milkv-duo-sd
编译成功后可以在 out
目录下看到生成的SD卡烧录镜像 milkv-duo-sd-*-*.img
注: 第一次编译会自动下载所需的工具链,大小为 840M 左右,下载完会自动解压到 SDK 目录下的 host-tools
目录,下次编译时检测到已存在 host-tools
目录,就不会再次下载了
2、分步编译
如果未执行过一键编译脚本,需要先手动下载工具链 host-tools,并解压到 SDK 根目录:
tar -xf host-tools.tar.gz -C /your/sdk/path/
再依次输入如下命令完成分步编译,命令中的 [board]
和 [config]
替换为需要编译的版本,当前支持的 board
和对 应的 config
如下:
milkv-duo-sd cv1800b_milkv_duo_sd
milkv-duo-spinand cv1800b_milkv_duo_spinand
milkv-duo-spinor cv1800b_milkv_duo_spinor
milkv-duo256m-sd cv1812cp_milkv_duo256m_sd
milkv-duo256m-spinand cv1812cp_milkv_duo256m_spinand
milkv-duo256m-spinor cv1812cp_milkv_duo256m_spinor
milkv-duos-emmc cv1813h_milkv_duos_emmc
milkv-duos-sd cv1813h_milkv_duos_sd
source device/[board]/boardconfig.sh
source build/milkvsetup.sh
defconfig [config]
clean_all
build_all
pack_sd_image
比如需要编译 milkv-duo-sd
的镜像,分步编译命令如下:
source device/milkv-duo-sd/boardconfig.sh
source build/milkvsetup.sh
defconfig cv1800b_milkv_duo_sd
clean_all
build_all
pack_sd_image
生成的固件位置:
Duo: install/soc_cv1800b_milkv_duo_sd/[board].img
Duo256M: install/soc_cv1812cp_milkv_duo256m_sd/[board].img
二、使用 Docker 编译
需要在运行 Linux 系统的主机上支持 Docker。 Docker 的使用方法请参考官方文档或其他教程。
我们将 SDK 代码放在 Linux 主机系统上,调用 Milk-V 提供的 Docker 镜像环境来编译。
在 Linux 主机上拉 SDK 代码
git clone https://github.com/milkv-duo/duo-buildroot-sdk.git --depth=1
进入 SDK 代码目录
cd duo-buildroot-sdk