LoginSignup
8
2

More than 1 year has passed since last update.

@lp6m

Build Vitis platform for Ultra96v2 (Vitis 2020.2)

Posted at

前回のVitis-AI v1.4 on Ultra96v2ではAvnetが用意してくれているスクリプトを使用してVitisプラットフォームを作成し、XilinxのDPU-TRDプロジェクトを使用してDPUの動作環境を生成しました。

前回の作業はコマンドラインベースで楽だったのですが、いくつかの問題がありました。
- avnetのHWプラットフォームには不要なコア（AXI BRAMなど）が含まれている
- VitisのGUIフローを使用していないため、他カーネルの追加作業などがしずらい
前回の作業で生成されたVivadoプロジェクトのブロックデザインは以下のようになっており、自分には不必要なコアなどが含まれているのが気になりました。
Screenshot from 2021-12-06 01-16-49.png

そこで今回は1からUltra96向けのVitisプラットフォームを生成しようと思います。

Environment

  • Host: Ubuntu 18.04
  • Target: Ultra96v2
  • Vitis/Vivado/Petalinux 2020.2

VivadoでUltra96v2のボードファイルを使用するため、Board filesをDownload zipからダウンロードして、/tools/Xilinx/Vivado/2020.2/data/boards/board_files/に配置します。

 ls /tools/Xilinx/Vivado/2020.2/data/boards/board_files/
README.md     adm-pcie3-ku3  au280             kc705   kcu1500         microzed_7010  picozed_7010_fmc2  picozed_7030_fmc2  ultrazed_3eg_iocc    vc707   vcu108  vcu128   vmk180  zc702   zcu104  zcu1275  zcu216
ac701         au200          deprecated        kcu105  li-imx274-mipi  microzed_7020  picozed_7015_fmc2  sp701              ultrazed_3eg_pciecc  vc709   vcu110  vcu129   xbzu1   zc706   zcu106  zcu1285  zed
adm-pcie-7v3  au250          download_zip.png  kcu116  locate_zip.png  minized        picozed_7020_fmc2  ultra96v2          ultrazed_7ev_cc      vck190  vcu118  vcu1525  xm105   zcu102  zcu111  zcu208   zedboard

Build HW Platform

FPGAの部屋 Ultra96-V2 の Vitis 2020.1 アクセラレーション・プラットフォームを作る1（ハードウェア・コンポーネント編）を参考にしながら進めます。

ブロックデザインは参考記事と同じようにしました。
Screenshot from 2021-12-02 23-39-03.png

VitisのProject SettingsからProject is an extensible Vitis platformを有効にします。
Screenshot from 2021-12-02 23-40-52.png

Clocking Wizardの設定は、DPU向けに周波数を参考記事から変更しています。100/150/200/300/400の5種類にしています。DPUは元となるクロックと、元の2倍のクロックをDSPで使用するので、100/200, 150/300, 200/400の3種類の設定ができるようにしました。
Screenshot from 2021-12-06 01-32-44.png

プラットフォームの生成では、使用しているVivadoのバージョンが異なるからか、画面が違ったものになっていました。
AXI Portの設定
Screenshot from 2021-12-02 23-42-41.png
Clockの設定
ちなみに、ID=0のクロックが存在しないとVitisで怒られることになります。
Screenshot from 2021-12-02 23-43-18.png
記事同様、Generate Bitstream, Export XSAを実行します。

Build SW Platform

Ultra96-V2 の Vitis 2020.1 アクセラレーション・プラットフォームを作る2（ソフトウェア・コンポーネント編）を参考にします。しかし、そのままでは残念ながらwifiが使用できませんでした。
Petalinux、デバイスツリーの知識が乏しく、wifi、usb-lan、VARTのインストールが可能なSWプラットフォームの構築にかなり苦労してしまいました。少なくとも以下の方法であれば構築ができることは確認しています。

Download BSP

AvnetのUltra96v2 PortalからPetaLinux Board Support Packages-> Ultra96-V2 – PetaLinux 2020+ BSP (Sharepoint site)のリンクに飛び、Documents->Projects->public_release->2020.2->BSPからu96v2_sbc_base_2020_2.tar.gzをダウンロードして解凍します。解凍するとu96v2_sbc_base_2020_2.bspが得られます。
このBSPを使用すると、Avnetのボード向けのUser Layerが公開されているmeta-avnetがユーザレイヤとして既に組み込まれたpetalinuxプロジェクトを生成することが可能です。このBSPを使用せずに、自分でmeta-avnetをユーザレイヤとして追加してSWプラットフォームを構築したかったのですが、どうもうまくいきませんでした。。詳細については追えていません。

Build Petalinux Project

まずプロジェクトをBSPを基に作成します。

petalinux-create -t project -s ../u96v2_sbc_base_2020_2.bsp --name ultra96v2_min2_201
cd ultra96v2_min2_201

次にベースとなるHWプラットフォームを指定します。SWプラットフォームの構築作業でexportしたxsaファイルを指定します。

petalinux-config --get-hw-description ../../ultra96v2_min2_201/ultra96v2_min2_201.xsa

参考記事ではpetalinux-config -c rootfs, petalinux-config -c kernelなどでコンフィグを変更していますが、確認してみたところ参考記事で適用されている変更は既に変更されていたため変更は不要でした。

次に、./project-spec/meta-avnet/recipes-bsp/device-tree/files/u96v2-sbc/system-bsp.dtsiから不要な部分を削除します。基のBSPが使用しているHWプラットフォームには様々なIPが搭載されているので、それらのIP向けのデバイスツリー定義が記述されていますが、今回は不要かつそのままではビルド・ブート時にエラーになるため変更します。system-bsp.dtsiファイルは以下のようにしました。こちらのデバイスツリー定義は参考記事のものとは少し異なります。

/include/ "system-conf.dtsi"
/ {
    chosen {
        bootargs = "earlycon console=ttyPS0,115200 clk_ignore_unused root=/dev/mmcblk0p2 rw rootwait cma=512M";
    };

   sdio_pwrseq: sdio_pwrseq {  /* This needs to be able to manipulate the chip_en and the resetn properly */
      compatible = "mmc-pwrseq-simple";
      /* post-power-on-delay-ms = <10>; */
      reset-gpios = <&gpio 7 1>; // MIO[7] for WILC3000 RESETN, Active low
      /* reset-gpios = <&gpio 78 1>;  // Some prototype boards only! device pin A3 for RESETN, Active low */
      chip_en-gpios = <&gpio 8 1>; 
   };

   // Remove V1 Power ON/OFF controller from U96 V1 DT
   /delete-node/ ltc2954;

    aliases {
        i2c0 = &i2c1;
   };

   xlnk {
      compatible = "xlnx,xlnk-1.0";
   };

};

&amba {
    zyxclmm_drm {
        compatible = "xlnx,zocl";
        status = "okay";
    };
};

&sdhci1 {
   bus-width= <0x4>;
   /* non-removeable; */
   /* mmc-pwrseq = <&sdio_pwrseq>; */
   max-frequency = <50000000>;
   /delete-property/cap-power-off-card; // This is not compatible with the WILC3000 and means the WILC will always be powered on
   status = "okay";
   #address-cells = <1>;
   #size-cells = <0>;
   wilc_sdio@1 {
      compatible = "microchip,wilc3000", "microchip,wilc3000";
      reg = <0>;
      // interrupt-parent = <&gpio>; // Microchip driver DOES NOT use gpio irq any more!
      // interrupts = <76 2>; /* MIO76 WILC IRQ 1V8 */ // Microchip driver DOES NOT use gpio irq any more!
      // irq-gpios = <&gpio 76 0>; // Microchip driver DOES NOT use gpio irq any more!
      bus-width= <0x4>;
      status = "okay";
   };
   // Remove TI child node from U96 V1 DT
   /delete-node/wifi@2;
};

&sdhci0 {
    disable-wp;
};

ビルド作業を行います。長時間かかるので気長に待ちます。-c avnet-image-fullの部分が肝心な部分で、これを含めないとwifiが使えない環境になってしまいます。
ビルドではchromiumのビルドなども行われますが不要なので本当は必要最小限のモジュールだけの構成にしたかったのですが、今回はそのままにしました。

petalinux-build -c avnet-image-full

完了すれば、参考記事同様、次のVitisプラットフォームのビルドで必要なファイルをimages/linux/pkg以下にコピーします。

mkdir pkg
mkdir pkg/pfm
mkdir pkg/pfm/boot
cp bl31.elf pkg/pfm/boot/
cp image.ub pkg/pfm/boot/
cp pmufw.elf pkg/pfm/boot/
cp u-boot.elf pkg/pfm/boot/
cp system.dtb pkg/pfm/boot/
cp zynqmp_fsbl.elf pkg/pfm/boot/fsbl.elf

SW Platform Check

ビルドしたSWプラットフォームが希望どおりに動作するかを確認します。この時点でwifiやUSB LANが使用できないと、後戻りすることになってしまう為です。
BOOT.BIN生成

petalinux-package --boot --fsbl ./images/linux/zynqmp_fsbl.elf --fpga ./images/linux/system.bit --uboot --force

SDカードの第1パーティションをFAT,第2パーティションをext4でフォーマットしてそれぞれBOOT,rootfsと名前を付けました。
Screenshot from 2021-12-06 02-00-03.png

cd images/linux
cp BOOT.BIN /media/lp6m/BOOT/
cp image.ub /media/lp6m/BOOT/
cp boot.scr /media/lp6m/BOOT/
sudo tar xvf rootfs.tar.gz -C /media/lp6m/rootfs/
sync

wifi, USB-LAN, ssh, VARTのインストールなどが問題なく行えることを確認しています。
パッケージ管理システムが壊れていたり必要なパッケージがないと悲しくなります。


ちなみにUSB-LANはUSBLAN100Rを使用しています。

Build sysroot

次にVitisでアプリケーションをビルドするために使用するsysrootを生成します。
ビルドはpetalinux-build -c avnet-image-fullで行なったのでsysrootの生成はpetalinux-build --sdk -c avnet-image-fullで行うべきだと思ったのですが、前回記事で使用したavnetのvitisプラットフォーム作成におけるsysroot生成スクリプトでは単にpetalinux-build --sdkで実行されていたので、今回はそれに倣いました。

また、avnetのsysroot生成スクリプトではsysrootの生成前にrootfsに必要なパッケージを含めるようにconfigを変更しています。ここで実行されているadd_petalinux_packages.shをコピーしてきて実行してrootfsのconfigを変更してから、sysrootをビルドします。

./add_petalinux_packages.sh
petalinux-build --sdk

ビルドが完了すればimages/linuxの中にsdk.shが生成されています。
参考記事同様に、sysrootをimages/linux/pkg/pfmにインストールします。

./sdk.sh
# install directoryをフルパスで入力する

最後に、これも参考記事同様にpkg/linux.bifを作成します。

/* linux */
 the_ROM_image:
 {
    [pmufw_image] <pmufw.elf>
    [bootloader, destination_cpu=a53-0] <fsbl.elf>
    [destination_device=pl] <bitstream>
    [destination_cpu=a53-0, exception_level=el-3, trustzone] <bl31.elf>
    [destination_cpu=a53-0, exception_level=el-2] <u-boot.elf>
 }

Build Vitis Platform

Ultra96-V2 の Vitis 2020.1 アクセラレーション・プラットフォームを作る3（Vitis 2020.1 でアクセラレーション・プラットフォーム作成）を参考にしながら作業を行います。作業は参考記事と全く同じです。
Screenshot from 2021-11-20 02-53-53.png

作業完了後、このプラットフォームをVitisから参照できるように、Vitisのインストールディレクトリ以下にコピーしておきます。

sudo cp -r ./ultra96v2_min2_201/export/ultra96v2_min2_201/ /tools/Xilinx/Vitis/2020.2/platforms/

まとめ

wifi, USB-LAN, ssh, VARTのインストールが可能なultra96v2向けのVitisプラットフォームを作成することができました。
次回はGUIフローを使用してDPUをこのプラットフォーム上に配置してみようと思います。

参考記事

これらの記事がなければ実現できなかったので、参考記事を公開していただいた方に深く感謝しています。

8
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
8
2