Milk-V DuoはCV1800Bをベースにした超小型の組み込みプラットフォームです。LinuxとRTOSが実行可能で、プロフェッショナル、産業用ODM、AIoT、DIY、クリエイターに、高信頼で高費用対効果なプラットフォームを提供します。
- CPU: CVITEK CV1800B (C906@1GHz + C906@700MHz)
- デュアルコアRV64 最大1GHz
- 64MB RAM
- アドオンボード経由での10/100Mbpsイーサネット
- CPU: SOPHGO SG2002 (C906@1GHz + C906@700MHz + ARM Cortex-A53@1GHz)
- 256MB RAM
- GPIO経由でのオーディオ出力
- 1TOPSのNPU
- CPU: SOPHGO SG2000 (C906@1GHz + C906@700MHz + ARM Cortex-A53@1GHz)
- 256MB RAM
- GPIO経由でのオーディオ出力
- 2系統のMIPI CSI
├── build // コンパイルスクリプトとボード設定
├── build.sh // 自動コンパイルスクリプト
├── buildroot-2021.05 // Buildrootのソースコード
├── freertos // FreeRTOSのシステム
├── fsbl // 完成済みfsblファームウェア
├── install // 一時イメージの仮置き場
├── isp_tuning // カメラ効果パラメータ
├── linux_5.10 // Linuxカーネル
├── middleware // 自家製マルチメディアフレームワーク
├── device // Milk-Vのコンフィグレーションファイル
├── opensbi // opensbiライブラリ
├── out // 完成したSDカード用イメージはここに出てきます
├── ramdisk // 完成済みramsidk
└── u-boot-2021.10 // u-bootのソースコード
[ヒント]
このSDKのコンパイル方法や使用法については、公式ドキュメントも参照してください。また、私達の公式ドキュメントのサイトはオープンソースです。もし内容の充実や多言語への翻訳に興味があるなら、ぜひこのリポジトリにPRを飛ばしてください。
コンパイル環境を準備する前に、ローカルのubuntuを使用する際にサポートされているのは「Ubuntu Jammy 22.04.x amd64」のみです。
他のLinuxディストロを使用している場合、問題を回避するためにDocker環境を使用することを強くお勧めします。
2つの環境でのコンパイル方法について解説します。
コンパイルに必要なパッケージをインストールします。
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 expectgit clone https://github.com/milkv-duo/duo-buildroot-sdk.git --depth=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
milkv-duo256m下に表示されるのは現在サポートされているターゲットです。
プロンプトにあるように、ターゲット向けにコンパイルするには2つ方法があります。
1つ目の方法は、build.sh lunchでインタラクティブメニューを立ち上げて、ターゲットのバージョンの番号を選択し、Enterを押すだけです。
# ./build.sh lunch
Select a target to build:
1. milkv-duo
2. milkv-duo256m
Which would you like:２つ目の方法はスクリプトの引数に直にターゲットのバージョンを渡す方法です。例えば、milkv-duo向けにコンパイルするにはこうします。
# ./build.sh milkv-duo正常にコンパイルされるとSDカード用イメージmilkv-duo-*-*.imgがoutディレクトリの中に出てきます。
注意：最初のコンパイル時に必要なツールチェーン(およそ840MB)が自動でダウンロードされます。一度ダウンロードされるとhost-tools内に自動で展開されます。以後のコンパイルではhost-toolsディレクトリがある場合再びダウンロードはされません。
もし自動コンパイルスクリプトを実行していない場合、ツールチェーンを手動でダウンロードする必要があります。 host-toolsをダウンロードして、SDKのディレクトリに展開してください。
tar -xf host-tools.tar.gz -C /your/sdk/path/手動コンパイルするには以下のコマンドを順を追って実行してください。コマンド中の[board]と[config]はターゲットとするハードウェアに置き換えてください。
現在サポートされている[board]と[config]は以下のとおりです。
milkv-duo cv1800b_milkv_duo_sd
milkv-duo256m cv1812cp_milkv_duo256m_sd
source device/[board]/boardconfig.sh
source build/milkvsetup.sh
defconfig [config]
clean_all
build_all
pack_sd_imageたとえば、milkv-duo向けにイメージをコンパイルするコマンドは以下のとおりですs。
source device/milkv-duo/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の使い方については公式ドキュメントとか他の使い方を見てください。
SDKのソースコードをLinuxホストシステムに置いて、Milk-Vから提供されているコンパイル用イメージをDockerで呼び出してコンパイルします。
git clone https://github.com/milkv-duo/duo-buildroot-sdk.git --depth=1cd duo-buildroot-sdkdocker run -itd --name duodocker -v $(pwd):/home/work milkvtech/milkv-duo:latest /bin/bashコマンド中のパラメータについて:
duodockerDockerの名前です。好きな名前を使えます。$(pwd)カレントディレクトリです。ここでは先程cdしたduo-buildroot-sdkを指しています。-v $(pwd):/home/work現在のコードディレクトリをDockerイメージの/home/workに結びつけます。milkvtech/milkv-duo:latestMilk-VによるDockerイメージです。最初にhub.docker.comから自動でダウンロードされます。
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 duodockerdocker exec -it duodocker /bin/bash -c "cd /home/work && cat /etc/issue && ./build.sh [board]"./build.sh [board]のコマンドの終端についてはUbuntu 20.04での自動コンパイルスクリプトでの使い方と同じです。./build.shで使い方が表示され、./build.sh lunchで選択画面を表示できます。./build.sh [board]で直接ターゲット向けにコンパイルできます。[board]の部分は以下に置き換えられます。ターゲットに合わせてください。
milkv-duo
milkv-duo256m
コマンド中のパラメータについて:
duodocker実行中のDockerの名前です。先程設定したものと同じである必要があります。"*"クオートの中にDockerイメージ中で実行したいコマンドが入ります。cd /home/work/home/workディレクトリに移動します。このディレクトリは実行時にホストのコードディレクトリに紐付けられているため、Docker中の/home/workディレクトリはSDKのコードディレクトリになります。cat /etc/issueDockerで実行されているイメージのバージョンを表示します。これはいまのところ「Ubuntu 22.04.3 LTS」で、デバッグに使われます。./build.sh [board]自動コンパイルスクリプトを実行します。
たとえば、milkv-duo向けにコンパイルする場合には以下のようにします。
docker exec -it duodocker /bin/bash -c "cd /home/work && cat /etc/issue && ./build.sh milkv-duo"コンパイルが成功すると、outディレクトリの中にmilkv-duo-*-*.imgが出てきます。
もし自動コンパイルスクリプトを実行していない場合、手動でツールチェインhost-toolsをダウンロードする必要があります。そしてそれをSDKのディレクトリに展開してください。
tar -xf host-tools.tar.gz -C /your/sdk/path/手動コンパイルをする場合はDockerにログインする必要があります。docker ps -aコマンドを使用して8edea33c2239みたいな形式のコンテナのIDを表示します。
Dockerに入る:
docker exec -it 8edea33c2239 /bin/bashDockerに紐付けられたコードディレクトリに入る：
root@8edea33c2239:/# cd /home/work/そして、手動コンパイルを実行するためのコマンドを実行していきます。コマンド中の[board]と[config]はコンパイルするターゲットに合わせてください。
今のところサポートされているboardと対応するconfigは以下のとおりです:
milkv-duo cv1800b_milkv_duo_sd
milkv-duo256m cv1812cp_milkv_duo256m_sd
source device/[board]/boardconfig.sh
source build/milkvsetup.sh
defconfig [config]
clean_all
build_all
pack_sd_imageたとえば、milkv-duo向けにイメージをコンパイルする場合のコンパイル手順は以下のとおりです。
source device/milkv-duo/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
コンパイルが完了したらexitコマンドでDockerから抜けれます:
root@8edea33c2239:/home/work# exit生成されたイメージはホストのコードディレクトリからも見れます。
コンパイルが完了して、もし上のDocker環境がもう必要ないなら止めて削除できます:
docker stop 8edea33c2239
docker rm 8edea33c2239もしこのSDKを上の2つの環境以外で行いたいなら、参考までに以下のことに注意してください。
注意：cmakeは最低でもバージョン3.16.5以降が必要です。
システムのcmakeバージョンの確認
cmake --version例として、Ubuntu 20.04のaptでインストールされるcmakeのバージョンは
cmake version 3.16.3
です。条件を満たしていないので手動で最新のcmakeをインストールしてください
wget https://github.com/Kitware/CMake/releases/download/v3.27.6/cmake-3.27.6-linux-x86_64.sh
chmod +x cmake-3.27.6-linux-x86_64.sh
sudo sh cmake-3.27.6-linux-x86_64.sh --skip-license --prefix=/usr/local/手動でインストールしたcmakeは/usr/local/binに配置されます。cmake --versionすると以下のように出力されるはずです。
cmake version 3.27.6
WSLでコンパイルするには少し問題があります。 Windowsとの互換性のために環境変数$PATHにいくつかのスペース文字を含むWindows用の環境変数が入っていて、一部でパスが通りません。
解決するには/etc/wsl.confファイルに以下を追記します。
[interop]
appendWindowsPath = false
その後、wsl.exe --rebootでWSLを再起動する必要があります。そうすれば手動コンパイルを行うことができます。
変更を元に戻すには、/etc/wsl.confのappendWindowsPathをtrueに設定します。WSLを再起動すれば、また$PATHからWindowsの環境変数が使えるようになります。
注意：書き込むとmicroSDカード内のデータはすべて削除されます。重要なデータはバックアップしてください！！！
-
Windows上で生成したイメージを書き込む場合
balenaEtcherやRufus、Win32 Disk Imagerなどのツールを使えます。 -
Linux上で生成したイメージを書き込む場合ddコマンドを使えます。 ddコマンドで書き込む場合指定するデバイスが書き込むmicroSDカードであることを十二分に確認してください
sudo dd if=milkv-duo-*-*.img of=/dev/sdX
- Milk-V DuoのmicroSDカードスロットにmicroSDカードを挿入します。
- シリアルケーブルを接続します。(必ずしも必要ではありません)
- 電源に接続するとシステムが立ち上がります。
- シリアルケーブルが接続されている場合、ブートログをシリアルコンソールから見ることができます(
mobarXterm、Xshell、Tera Termなど)。システムが立ち上がればコンソールからログインしてLinuxコマンドを実行できます。
- シリアルケーブルを使う
- USBネットワークを使う(CDC-NCM)
- イーサネットインターフェースを使う(アドオンボードが必要)
Duoのターミナルに入る際に必要なユーザー名とパスワードは以下の通りです。
root
milkv
もしDuoに載っているLEDの点滅を無効にしたいならDuoのターミナルで以下のコマンドを実行してください。
mv /mnt/system/blink.sh /mnt/system/blink.sh_backup && sync以上のコマンドはLEDの点滅スクリプトをリネームしています。そしてDuoを再起動するとLEDは点滅しなくなります。
DuoのLEDをまた点滅させたい場合、スクリプトのファイル名を元に戻します。
mv /mnt/system/blink.sh_backup /mnt/system/blink.sh && syncIO-Boardを使用する場合、USBネットワーク(CDC-NCM)は使用できないので、IO-Boardのイーサネットインターフェースを使用してください。 IO-BoardのEthernetポートに固定MACアドレスを割り当てる必要がある場合は、以下のコマンドを実行してください(コマンド中のMACアドレスは設定したいMACアドレスに置き換えてください。また、同一ネットワークセグメント内の異なるデバイスのMACアドレスは重複してはいけません)。
echo "pre-up ifconfig eth0 hw ether 78:01:B3:FC:E8:55" >> /etc/network/interfaces"- それからボードを再起動してください。
IO-Board上の4発のUSBポートを有効化する：
ln -sf /mnt/system/usb-host.sh /mnt/system/usb.sh
sync- それからボードを再起動してください。
たとえば、USBフラッシュドライブがIO-Board上のUSBポートに接続されている場合ls /dev/sd*で認識していることを確認できます。
USBフラッシュドライブをマウントしてその内容を見る(/dev/sda1を例に)。
mkdir /mnt/udisk
mount /dev/sda1 /mnt/udisk/mnt/udiskディレクトリの内容が予想と一致するか確認する。
ls /mnt/udiskUSBフラッシュドライブをアンマウントするコマンド。
umount /mnt/udiskUSBネットワーク(CDC-NCM)の機能をIO-Board不使用時に使う。
ln -sf /mnt/system/usb-ncm.sh /mnt/system/usb.sh
sync- それからボードを再起動してください。
-
なぜ1つのコアしか表示されないのですか。
CV1800Bチップはデュアルコアですが、現在、Linuxシステムは1つのコアで実行され、もう1つのコアはリアルタイムシステムの実行に使用されています。このコアの使用については公式ドキュメントをお読みください。
-
なぜ28MBしかRAMが使えないのですか。
RAMの一部がION(カメラを使ってアルゴリズムを実行するときに使用するメモリ)に割り当てられているからです。カメラを使用しない場合は、このION_SIZEの値を0に変更し、再コンパイルしてください(Duo 256M: ION_SIZE)。
- CV181x/CV180x MMF SDK開発ドキュメント (英語と中国語): MultiMedia Framework Software Development Document
- CVシリーズのTPU SDK開発ドキュメント (中国語): CV series chip TPU SDK development data summary