サンプル デザインの概要

Vitis コア開発キットには、サンプル デザインが含まれます。これらのサンプル デザインには、次の特徴があります。

  • Vitis IDE および makefile フローなどのコンパイル フローを習得。
  • 新規アプリケーション プロジェクトを作成する開始点として使用。
  • 便利なコーディング スタイルを表示。
  • 重要な最適化手法を表示。

Vitis IDE で提供される各ターゲット プラットフォームには、ユーザーがすばやく開発を開始できるようにするサンプル デザインが含まれており、アプリケーション プロジェクトの作成で説明されているようにプロジェクトの作成時にアクセスできます。

<vitis_root>/samples に含まれるサンプル デザインには限りがありますが、多くのサンプル デザインはザイリンクス GitHub リポジトリからもダウンロードできます。これらのサンプル デザインには、必要に応じてコマンド ラインのみでコードのビルド、エミュレート、および実行をできるようにする makefile も含まれています。

サンプル デザインのインストール

New Vitis Project ウィザードを使用する場合、新しいプロジェクトのテンプレートを選択します。テンプレート プロジェクトは、Xilinx > Vitis IDE Examples をクリックして、既存のプロジェクトから読み込むこともできます。

1: Vitis IDE サンプル デザインが空の状態


このダイアログ ボックスの左側には [Vitis IDE Examples] が表示され、それぞれに [Download] ボタンがあります。ダイアログ ボックスの右側には、サンプル デザインがダウンロードされるディレクトリとダウンロード元の URL が表示されます。[Vitis IDE Examples] の横の Download をクリックすると、サンプル デザインがダウンロードされ、ダイアログ ボックスにリストされます。

[Vitis IDE Examples] ダイアログ ボックスの左下のコマンド メニューには、サンプル デザインのリポジトリを管理する 2 つのコマンドがあります。
[Refresh]
ダウンロード済みサンプル デザインを GitHub リポジトリからアップデートします。
[Reset]
.Xilinx フォルダーからダウンロードしたサンプル デザインを削除します。
注記: 企業のファイアウォールにより、外部への接続が制限されていることがあります。特定のプロキシ設定が必要なこともあります。

ローカル コピーの使用

新規プロジェクトを作成する際にテンプレートを追加するには、サンプルをダウンロードする必要がありますが、Vitis IDE ではサンプルはローカルの .Xilinx/vitis/<version> フォルダーにダウンロードされます。

  • Windows: C:\Users\<user_name>\.Xilinx\vitis\<version>
  • Linux: ~/.Xilinx/vitis/<version>

ダウンロード ディレクトリは、[Vitis IDE Examples] ダイアログ ボックスからは変更できません。サンプル ファイルを .Xilinx フォルダーとは別のディレクトリにダウンロードするのが望ましい場合もあります。これには、コマンド シェルから git コマンドを使用し、ダウンロード ディレクトリを別のディレクトリに変更します。

git clone https://github.com/Xilinx/Vitis_Examples 
<workspace>/examples

上記に示すように git コマンドでサンプルをクローンすると、サンプル ファイルをアプリケーションおよびカーネル コードのリソースとしてプロジェクトで使用できるようになります。ただし、ほかのサンプル ファイル (さまざまなサンプルの makefile 内で管理) を含めるために、ファイルの多くに include 文が使用されています。これらのインクルード ファイルは、New Vitis Project ウィザードでテンプレートを追加したときにプロジェクトの src フォルダーに自動的に含まれます。ファイルをローカルにするには、ファイルを手動でプロジェクトのローカルにします。

必要なファイルは、クローンされたリポジトリのディレクトリから検索できます。たとえば、次のコマンドを examples フォルダーから実行すると、vadd サンプル デザインに必要な xcl2.hpp ファイルを検索できます。

find -name xcl2.hpp