はじめに

筆者は Ultra96/Ultra96-V2(ZynqMP) 向けに Debian GNU/Linux を提供しています1。また、XRT(Xilinx Runtime) はXilinx社が提供する開発環境(Vitis)で開発したプログラムをプラットフォームで動かすための環境です2。

本来なら MPSoC Edge Device 用の XRT は Xilinx が提供する Linux 環境(Petalinux) でしか動きませんが、この記事では XRT を Ultra96/Ultra96-V2 向け Debian GNU/Linux で動かすための手順を幾つかのパートに分けて説明します。

概要編
ビルド編
インストール編
実践編
Vitis編(この記事)

この記事では、XRT をインストールした Ultra96/Ultra96-V2 をターゲットにして、ホストPC上の Vitis IDE からプログラムの実行＆デバッグする手法について説明します。

注意

この記事で紹介している Debian Package は Xilinx 社の公式なものではありません。

ターゲットの準備

ターゲットには XRT をインストールした Ultra96/Ultra96-V2 を使用します。Ultra96/Ultra96-V2 に XRT をインストールする方法に関してはインストール編を参照してください。

Vitis IDE からターゲット上のプログラムの実行＆デバッグをするためには、ターゲットに XRT がインストールされているだけは不十分です。追加で次に示すものがターゲット側に必要です。

TCF(Target Communication Framework) Agent
/opt/xilinx/xrt から /usr への各種ファイルのシンボリックリンク
zocl (MPSoC Edge Device 用のカーネルモジュール) の準備

TCF-Agent の準備

TCF(Target Communication Framework)3 は組み込みシステム(ターゲット)を駆動するための軽量で拡張可能なネットワークプロトコルです。Vitis IDE は eclipse をベースにしていて、ターゲットとは TCF で通信します。そのため、Vitis IDE からターゲットの制御を行うために、ターゲットに TCF-Agent というサーバー・プログラムを動かしておく必要があります。

TCF-Agent のビルド

TCF-Agent のソースコードは以下のURL にあります。

git://git.eclipse.org/gitroot/tcf/org.eclipse.tcf.agent.git

ここのリポジトリをダウンロードして Ultra96/Ultra96-V2 上でビルドできます。なお、この記事では、すでにビルド済みで Debian Package 化したものを用意しているので、そちらを使ってインストールします。

TCF-Agent のインストール

ビルド済みで Debian Package化した TCF-Agent を以下のURLに用意しています。ダウンロードしてインストールします。

https://github.com/ikwzm/tcf-agent-dpkg

shell$ git clone --recursive --depth=1 -b 1.7.0-1 git://github.com/ikwzm/tcf-agent-dpkg
shell$ cd tcf-agent-dpkg
shell$ sudo apt install ./tcf-agent_1.7.0-1_arm64.deb 
Reading package lists... Done
Building dependency tree       
Reading state information... Done
Note, selecting 'tcf-agent' instead of './tcf-agent_1.7.0-1_arm64.deb'
The following NEW packages will be installed:
  tcf-agent
0 upgraded, 1 newly installed, 0 to remove and 69 not upgraded.
After this operation, 3,298 kB of additional disk space will be used.
Get:1 /home/fpga/work/tcf-agent-dpkg/tcf-agent_1.7.0-1_arm64.deb tcf-agent arm64 1.7.0-1 [689 kB]
debconf: unable to initialize frontend: Dialog
debconf: (Dialog frontend will not work on a dumb terminal, an emacs shell buffer, or without a controlling terminal.)
debconf: falling back to frontend: Readline
Selecting previously unselected package tcf-agent.
(Reading database ... 114950 files and directories currently installed.)
Preparing to unpack .../tcf-agent_1.7.0-1_arm64.deb ...
Processing triggers for systemd (237-3ubuntu10.39) ...

TCF-Agent のスタート

上記の Debian Package には systemd 用のプログラムも含まれています。TCF-Agent をスタートするためには以下のように systemd のコマンドを使用します。

shell$ sudo systemctl start tcf-agent.service

また、Linux のブート時に自動的に TCF-Agent をスタートする際には、以下のようにしてください。

shell$ sudo systemctl enable tcf-agent.service

TCF-Agent のストップ

TCF-Agent をストップする時は以下のようにしてください。なお、現時点では何故かTCF-Agent のストップに数分ほど時間がかかります。原因は不明です。

shell$ sudo systemctl stop tcf-agent.service

/opt/xilinx/xrt から /usr への各種ファイルのシンボリックリンク

インストール編でインストールした XRT の実行プログラムやライブラリはターゲット上の /opt/xilinx/xrt にインストールされます。ターゲット上で XRT 用のプログラムを実行する際には、/opt/xilinx/xrt/setup.sh などのスクリプトを実行して環境変数を設定しておかなくてはなりません。

しかし、Vitis IDE から TCF を通じて XRT 用のプログラムを実行する場合、何故かライブラリが見つからないとかデバイスが見つからないとか言われて、この方法では動きませんでした。

試行錯誤した結果、/opt/xilinx/xrt/lib 下のライブラリおよび /opt/xilinx/xrt/bin 下の実行プログラムを、それぞれ /usr/lib、/usr/bin にシンボリックリンクすることで動くようになりました。

いちいち手でリンクを張るのは面倒なので、それようの Debian Package を用意しています。この Debian Package をインストールしてください。

shell$ git clone https://github.com/ikwzm/ZynqMP-FPGA-XRT.git

shell$ sudo apt install ./ZynqMP-FPGA-XRT/xrt-setup_2.6.0-1_arm64.deb
Reading package lists... Done
Building dependency tree
Reading state information... Done
Note, selecting 'xrt-setup' instead of './xrt-setup_2.6.0-1_arm64.deb'
The following NEW packages will be installed:
  xrt-setup
0 upgraded, 1 newly installed, 0 to remove and 71 not upgraded.
After this operation, 30.7 kB of additional disk space will be used.
Get:1 /home/fpga/work/ZynqMP-FPGA-XRT/xrt-setup_2.6.0-1_arm64.deb xrt-setup arm64 2.6.0-1 [1,276 B]
debconf: unable to initialize frontend: Dialog
debconf: (Dialog frontend will not work on a dumb terminal, an emacs shell buff\\
er, or without a controlling terminal.)
debconf: falling back to frontend: Readline
Selecting previously unselected package xrt-setup.
(Reading database ... 115056 files and directories currently installed.)
Preparing to unpack .../xrt-setup_2.6.0-1_arm64.deb ...