SDAccel サンプル リポジトリへようこそ。このリポジトリには、ザイリンクス PCIe FPGA アクセラレーション ボードを対象としたアプリケーションの最適化を開始するための最新の例が含まれています。すべてのサンプルは、SDAccel 対応ボードおよび高速化されたクラウド サービス パートナー上でコンパイルおよび実行する準備ができています。リポジトリは次のように構成されています。
SDAccel Git の例 ユーザーが基本的な SDAccel 環境、セットアップ、プログラミング、およびデバッグ フローに精通していることを前提としています。そうでない場合は、SDAccel ユーザー ガイドの次のトピックを取り上げることをお勧めします。
ボード | ソフトウェアバージョン |
---|---|
ザイリンクス Alveo U200 | SDx 2019.1 |
ザイリンクス Alveo U250 | SDx 2019.1 |
ザイリンクス Alveo U280 | SDx 2019.1 |
新しいユーザーに SDAccel ベースのアプリケーションの基本構造を理解させるため、Hello World の例から始めることを主に推奨します。
アプリケーション開発者が利用できる機能の一部として、SDAccel には、ソフトウェア機能レベルとハードウェア エミュレート レベルの両方でアプリケーションの正確性をテストする環境が含まれています。
sw_emu および hw_emu という名前のこれらのモードを使用すると、開発者はボード実行用にコンパイルする前にデザインのパフォーマンスをプロファイリングおよび評価できます。すべてのアプリケーションは、FPGA ボード上でコンパイルして実行する前に、少なくとも sw_emu モードで実行することをお勧めします。
cd <PATH TO SAMPLE APPLICATION>
make all TARGET=<sw_emu|hw_emu> DEVICE=<FPGA Platform>
どこ
sw_emu = software emulation
hw_emu = hardware emulation
注:ソフトウェア エミュレーション フローは、機能の正確性チェックのみを目的としています。ハードウェアにおけるアプリケーションのパフォーマンスを評価するものではありません。
ハードウェア エミュレーション フローは、アプリケーション用に生成されたハードウェアのサイクル精度の高いシミュレーションです。そのため、このシミュレーションには長時間かかることが予想されます。この例では、ハードウェア エミュレーションの実行をスキップするか、縮小されたデータ セットで作業するように例を変更することをお勧めします。
エミュレーションにおけるアプリケーション例の推奨実行フロー
アプリケーションの Makefile は、次のコマンドを使用してアプリケーションを直接実行できます。
cd <PATH TO SAMPLE APPLICATION>
make check TARGET=<sw_emu|hw_emu> DEVICE=<FPGA Platform>
どこ
sw_emu = software emulation
hw_emu = hardware emulation
アプリケーションが事前にコンパイルされていない場合、チェック メイクファイル ルールは、ユーザーが選択したエミュレーション モードでアプリケーションをコンパイルし、実行します。
FPGA アクセラレーション ボード上で実行できるようにアプリケーションをコンパイルするコマンドは次のとおりです。
cd <PATH TO SAMPLE APPLICATION>
make all DEVICE=<FPGA Platform>
Makefile のデフォルトのターゲットは、ハードウェア用にコンパイルすることです。したがって、TARGETS オプションを設定する必要はありません。注:ハードウェアでアプリケーションを実行するためのコンパイルでは、アプリケーションにカーネルの機能を実装するためのカスタム ロジックが生成されます。ハードウェアのコンパイル時間は、通常 30 分から数時間の範囲です。
SDAccel のさまざまな機能を使用し、独自のアプリケーションを開始する方法に関するベスト プラクティスをユーザーに教えることを目的としたサンプルのコレクション。
FPGA ベースのコンピューティング ユニットへのプロセッサ オフロードの例のコレクション。
画像およびビデオ処理の例のコレクション。
アプリケーション ホスト コードの迅速な開発を支援するために、すべての例で使用される共通ライブラリのコレクション。
すべての例で Makefile の一部として使用されるユーティリティ関数のコレクション。このセットには、SDAccel でコンパイルされたアプリケーションを開発者のターミナル シェルから Nimbix によってホストされるボード上で直接起動するための Makefile ルールとスクリプトが含まれています。
FPGA アクセラレーション ボードはクラウドに展開されています。特定のクラウド内でサンプルを実行する方法については、次のガイドを参照してください。
このリポジトリ内のプロジェクトまたは独自のプロジェクトに関する質問やヘルプが必要な場合は、SDAccel フォーラムにアクセスしてください。
SDAccel GUI を使用してこれらの例を実行するには、SDAccel GUI README のセットアップ手順に従ってください。