はじめに
Duoシリーズボードの標準SDKはBuildrootベースで構築されており、Duoのファームウェア生成に使用されます。現在、SDKにはV1とV2の2つのバージョンがあります。
- SDK V1はRISC-Vコアのみ対応(Duo 64Mに推奨)
- SDK V2はRISC-VとARMコア両方に対応(Duo256MとDuoSに推奨)
Duo 64Mはメモリが少ないため、SDK V1の利用を推奨します。SDK V2のAI関連アプリは現状Duo 64Mでは正常動作しません。
Buildroot SDK V1
SDKの主な構成:
- u-boot: 2021.10
- linux kernel: 5.10.4
- buildroot: 2021.05
- opensbi: 89182b2
ソースコード:https://github.com/milkv-duo/duo-buildroot-sdk
SDKディレクトリ構成:
├── build ビルドスクリプトとボード設定
├── build.sh ワンクリックビルドスクリプト
├── buildroot-2021.05 buildrootソース
├── freertos freertosシステム
├── fsbl プリビルドfsblファームウェア
├── install 一時イメージ保存
├── isp_tuning カメラパラメータ
├── linux_5.10 Linuxカーネル
├── middleware 独自マルチメディアフレームワーク
├── device milkv設定ファイル
├── opensbi opensbiライブラリ
├── out Milk-V生成イメージ
├── ramdisk プリビルドramdisk
└── u-boot-2021.10 u-bootソース
Buildroot SDK V2
SDKの主な構成:
- u-boot: 2021.10
- linux kernel: 5.10.4
- buildroot: 2025.02
- opensbi: 89182b2
ソースコード:https://github.com/milkv-duo/duo-buildroot-sdk-v2
SDKディレクトリ構成:
├── build ビルドスクリプトとボード設定
├── build.sh ワンクリックビルドスクリプト
├── buildroot buildrootソース
├── cvi_mpi sophgoマルチメディアフレームワーク
├── device milkv設定ファイル
├── freertos freertosシステム
├── fsbl プリビルドfsblファームウェア
├── install 一時イメージ保存
├── isp_tuning カメラパラメータ
├── linux_5.10 Linuxカーネル
├── osdrv 周辺ドライバソース
├── opensbi opensbiライブラリ
├── out Milk-V生成イメージ
├── tdl_sdk sophgoディープラーニングSDK
└── u-boot-2021.10 u-bootソース
イメージのビルド
コンパイル環境の準備。公式サポートは Ubuntu Jammy 22.04.x amd64 のみです。
他のLinuxディストリビューションの場合はDocker環境でのコンパイルを推奨します。
以下、2つの環境でのコンパイル方法を説明します。SDK V1/V2の手順はほぼ同じです。以下はV2 SDKの例です。
1. 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-v2.git --depth=1
SDK V2ではネットワーク問題回避のため、dl.tarを事前にダウンロードしbuildrootに展開します:
wget https://github.com/milkv-duo/duo-buildroot-sdk-v2/releases/download/dl/dl.tar
tar xvf ./dl.tar -C ./duo-buildroot-sdk-v2/buildroot/
展開後のdlディレクトリ例:
└── buildroot
└── dl
├── acl
├── alsa-lib
├── alsa-utils
├── attr
├── ...
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 as follows:
milkv-duo-musl-riscv64-sd
milkv-duo256m-glibc-arm64-sd
milkv-duo256m-musl-riscv64-sd
milkv-duos-glibc-arm64-emmc
milkv-duos-glibc-arm64-sd
milkv-duos-musl-riscv64-emmc
milkv-duos-musl-riscv64-sd
2通りのビルド方法があります。
1つ目は ./build.sh lunch で対話メニューを表示し、番号選択:
$ ./build.sh lunch
Select a target to build:
1. milkv-duo-musl-riscv64-sd
2. milkv-duo256m-glibc-arm64-sd
3. milkv-duo256m-musl-riscv64-sd
4. milkv-duos-glibc-arm64-emmc
5. milkv-duos-glibc-arm64-sd
6. milkv-duos-musl-riscv64-emmc
7. milkv-duos-musl-riscv64-sd
Which would you like:
- Duo (64M-DDR)はRISC-Vコアのみ、musl libcベースSDカードイメージ
- Duo256MはRISC-V/ARM両対応(musl/GLIBC)、SDカードイメージのみ
- DuoSはRISC-V/ARM両対応(musl/GLIBC)、SD/eMMCイメージ対応
2つ目はスクリプトにターゲット名を指定して直接ビルド:
$ ./build.sh milkv-duos-musl-riscv64-sd
ビルド成功後、outディレクトリに*.img(SDカード用)、*.zip(eMMC用)イメージが生成されます。
初回ビルド時は約840MBのツールチェーンが自動DL・展開されます。2回目以降はhost-toolsディレクトリがあれば再DL不要です。
2). 手動ステップビルド
ワンクリックスクリプト未使用の場合、ツールチェーンhost-toolsを手動DLしSDKルートに配置:
git clone https://github.com/milkv-duo/host-tools.git
cp -a host-tools duo-buildroot-sdk-v2/
環境変数設定:
source build/envsetup_milkv.sh
初回はターゲット選択が表示されます。
ターゲット選択後、環境変数ロード完了で情報が表示されます。
環境ロード後、deviceディレクトリにtargetリンクが作成されます。ターゲット変更はlunchパラメータ追加で再選択可能:
source build/envsetup_milkv.sh lunch
環境ロード後、以下コマンドでビルド:
clean_all
build_all
SDカードイメージ生成には追加で:
pack_sd_image
例:milkv-duos-musl-riscv64-sdの場合
source build/envsetup_milkv.sh milkv-duos-musl-riscv64-sd
clean_all
build_all
pack_sd_image
生成ファームウェア例:
install/soc_sg2000_milkv_duos_musl_riscv64_sd/milkv-duos-musl-riscv64-sd.img
SDカードイメージは*.img、eMMCはupgrade.zipです。
build_all以外にも個別モジュールビルド可能。clean_xxxで中間ファイル削除後、build_xxxで再ビルド。tabキーで補完可能。例:
- fsbl:
clean_fsbl,build_fsbl - uboot:
clean_uboot,build_uboot - kernel:
clean_kernel,build_kernel - osdrv:
clean_osdrv,build_osdrv - cvi_mpi:
clean_middleware,build_middleware - tdl-sdk:
clean_tdl_sdk,build_tdl_sdk
2. Dockerでのコンパイ ル
LinuxホストでDockerサポートが必要です。Dockerの使い方は公式ドキュメント参照。
SDKソースをLinuxホストに配置し、Milk-V提供のDockerイメージ環境でビルドします。
LinuxホストでSDKコード取得
git clone https://github.com/milkv-duo/duo-buildroot-sdk-v2.git --depth=1
SDK V2ではdl.tarを事前DLしbuildrootに展開:
wget https://github.com/milkv-duo/duo-buildroot-sdk-v2/releases/download/dl/dl.tar
tar xvf ./dl.tar -C ./duo-buildroot-sdk-v2/buildroot/
展開後のdlディレクトリ例:
└── buildroot
└── dl
├── acl
├── alsa-lib
├── alsa-utils
├── attr
├── ...
SDKコードディレクトリへ移動
cd duo-buildroot-sdk-v2
Dockerイメージ取得・起動
docker run --privileged -itd --name duodocker -v "$(pwd)":/home/work milkvtech/milkv-duo:latest /bin/bash
コマンドパラメータ説明:
--privileged:特権モードduodocker:Docker 名$(pwd):現在ディレクトリ-v $(pwd):/home/work:ホストのコードディレクトリをDockerの/home/workにバインドmilkvtech/milkv-duo:latest:Milk-V提供Dockerイメージ
Docker起動後、docker ps -aで状態確認:
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
8edea33c2239 milkvtech/milkv-duo:latest "/bin/bash" 2 hours ago Up 2 hours duodocker
Dockerイメージ更新時はdocker pull milkvtech/milkv-duo:latestで最新取得可能。
1). Dockerでワンクリックビルド
docker exec -it duodocker /bin/bash -c "cd /home/work && cat /etc/issue && export FORCE_UNSAFE_CONFIGURE=1 && ./build.sh [board]"
./build.sh [board]はUbuntuでのワンクリックビルドと同様です。lunchで対話選択も可能。
例:milkv-duos-musl-riscv64-sdの場合
docker exec -it duodocker /bin/bash -c "cd /home/work && cat /etc/issue && export FORCE_UNSAFE_CONFIGURE=1 && ./build.sh milkv-duos-musl-riscv64-sd"
ビルド成功後、outディレクトリにSDカード用*.imgが生成されます。