Ubuntu での XRT および運用プラットフォームのインストール手順

次の手順に従って、.deb インストールパッケージを使用し、XRT および運用プラットフォームをダウンロードしてインストールします。

新しいバージョンまたは古いバージョンの XRT および運用プラットフォームをインストールする方法は、XRT およびターゲットプラットフォームバージョンの変更を参照してください。

ラウンジからAMD ランタイム (XRT) および運用プラットフォームインストールパッケージをダウンロードします。
表示されたパッケージをクリックしてダウンロードします。

重要: このユーザーガイドでは、2022.1 Gen4x8 XDMA ベース 2 または 2022.2 Gen4x8 QDMA ベース 2 プラットフォームはサポートされていません。これらプラットフォームのメモリパーティションの移行は、「VCK5000 移行ガイド」で説明されている 2 段階のプロセスに従って実行してください。2022.2 Gen4x8 QDMA ベース 2 プラットフォームを正常に実行するには、まずカードを 2022.1 Gen4x8 XDMA ベース 2 プラットフォームに移行してから、2022.2 Gen4x8 QDMA ベース 2 プラットフォームのフラッシュメモリに書き込む必要があります。
インストールパッケージが配置されているディレクトリから次のコマンドを実行し、XRT インストールパッケージをインストールします。<version> は、インストールパッケージファイル名の最後の部分です。
```
$ sudo apt install ./xrt_<version>.deb
```
これで、XRT が必要な依存ファイルと共にインストールされます。表示される指示に従ってインストールします。
運用ターゲットプラットフォーム tar.gz ファイルを 1 つのディレクトリに解凍します。ディレクトリの場所はどこでもかまいませんが、ほかにファイルが含まれていないディレクトリを使用してください。
運用パッケージをインストールします。インストールパッケージを解凍したディレクトリから次のコマンドを実行します。これにより、すべての運用パッケージがインストールされます。
```
sudo apt install ./*.deb
```
プラットフォームファームウェアをカードのフラッシュメモリに書き込みます。前の手順で運用パッケージをインストールすると、次のメッセージが表示されます。
```
Partition package installed successfully.
Please flash card manually by running below command:
sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <bdf> --image xilinx_vck5000_gen3x16_xdma_base_1
To find <bdf>, run this command:
sudo /opt/xilinx/xrt/bin/xbmgmt examine
```
次のコマンドを使用して、プラットフォームファームウェアをカードのフラッシュメモリに書き込みます。
```
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF> --image xilinx_vck5000_gen3x16_xdma_base_1
```
ここで、<management BDF> はプログラムするカードです。デバイス管理 BDF の取得方法は、カードの BDF 値の取得を参照してください。
フラッシュメモリへの書き込みには数分かかります。

重要: ファームウェアのフラッシュメモリに書き込み中に、ターミナルで Ctrl + c キーを押さないでください。カードが動作不能になる可能性があります。

重要: システムに複数のカードを設置している場合は、各カードに対して上記の xbmgmt program コマンドを個別に実行する必要があります。

カードのフラッシュメモリが正常に書き込まれると、次のようなメッセージが表示されます。
```
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
```
カードのフラッシュメモリに現在のプラットフォームファームウェアが書き込まれると、次のようなメッセージが表示されます。
```
Device(s) up-to-date and do not need to be flashed.
```
マシンをコールドブートし、新しいファームウェアイメージを FPGA に読み込みます。
重要: マシンの電源を完全に切ってから入れ直してください。マシンを再起動しただけの場合は、イメージがフラッシュメモリからブートしません。
カードの SC ファームウェアをアップデートします。次のコマンドを使用して、カード上の SC ファームウェアをアップデートします。これは、カード上のプラットフォームファームウェアをカードのフラッシュメモリに書き込むコマンドと同じです。
```
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF> --image xilinx_vck5000_gen3x16_xdma_base_1
```
ここで、<management BDF> は SC ファームウェアアップデートを必要とするカードです。デバイス管理 BDF の取得方法は、カードの BDF 値の取得を参照してください。
SC ファームウェアのアップデートには数分かかります。

重要: システムに複数のカードを設置している場合は、各カードに対して上記の xbmgmt programxbmgmt programコマンドを個別に実行する必要があります。
SC ファームウェアが正常にアップデートされると、次のようなメッセージが表示されます。デバイスの管理 BDF は角かっこの中に示されます。
```
Report
		[0000:af:00.0] : Successfully flashed

1 device(s) flashed successfully.
******************************************************************
Warm reboot is required to recognize new SC image on the device.
****************************************************************** 
```
カードに既に現在のファームウェアが書き込まれており、次に示すようなメッセージが表示された場合は、追加のインストール手順は不要です。
```
Device(s) up-to-date and do not need to be flashed.
```
システムを再起動し、XRT で新しい SC イメージが認識されるようにします。

これで運用のインストールは終了です。カードが正しく設置されているかを確認する手順は、カードの立ち上げおよび検証を参照してください。