SDAccel_Examples

SDAccel 範例儲存庫

注意：請勿將此儲存庫用於 Xilinx 最新 Vitis 工具鏈。這裡為 Xilinx 新 Vitis 工具鏈建立了一個全新的儲存庫：https://github.com/Xilinx/Vitis_​​Accel_Examples。使用 Xilinx 之前發布的產品 SDAccel 或 SDx 的 SDAccel 範例儲存庫。

歡迎來到 SDAccel 範例儲存庫。此儲存庫包含最新範例，可協助您開始針對 Xilinx PCIe FPGA 加速板進行應用程式最佳化。所有範例都可以在 SDAccel 支援的主機板和加速雲端服務合作夥伴上編譯和執行。該存儲庫的組織方式如下：

1. 先決條件
2. 支援的平台
3. 編譯與執行
4. 目錄結構
5. 雲端環境中的執行
6. 支援

1. 先決條件

SDAccel Git 範例 假設使用者熟悉基本 SDAccel 環境、設定、程式設計和偵錯流程。如果沒有，建議涵蓋 SDAccel 使用者指南中的以下主題：

• UG1238 - SDAccel 開發環境
• UG1277 - SDAccel 程式設計指南
• UG1281 - SDAccel 調試指南

2. 支援的平台

木板	軟體版本
賽靈思 Alveo U200	SDx 2019.1
賽靈思 Alveo U250	SDx 2019.1
賽靈思 Alveo U280	SDx 2019.1

3. 編譯與執行

主要建議從 Hello World 範例開始，這使新用戶了解基於 SDAccel 的應用程式的基本結構。

編譯應用程式仿真

作為應用程式開發人員可用的功能的一部分，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

如果應用程式之前尚未編譯過，則檢查 makefile 規則將以使用者選擇的模擬模式編譯並執行應用程式。

編譯以在 FPGA 加速卡中執行應用程式

編譯應用程式以在 FPGA 加速板上執行的命令是

    cd <PATH TO SAMPLE APPLICATION>
    make all DEVICE=<FPGA Platform>

產生檔案的預設目標是針對硬體進行編譯。因此，不需要設定 TARGETS 選項。注意：在硬體中執行應用程式的編譯會產生自訂邏輯來實現應用程式中核心的功能。硬體編譯時間通常為 30 分鐘到幾個小時。

4. 目錄結構

• 入門

範例集合，旨在教導使用者如何使用 SDAccel 的不同功能並啟動自己的應用程式的最佳實踐。

• 加速

將處理器卸載到基於 FPGA 的計算單元的範例集合。

• 想像

影像和視訊處理範例集合。

• LIBS

所有範例中使用的公共庫的集合，以協助快速開發應用程式主機程式碼。

• 公用事業

在所有範例中用作 Makefile 一部分的實用函數集合。該集包括 Makefile 規則和腳本，用於直接從開發人員終端機 shell 將 SDAccel 編譯的應用程式啟動到 Nimbix 託管的板上。

5. 雲端環境中的執行

FPGA加速板已部署到雲端。有關如何在特定雲端中執行範例的信息，請查看以下指南。

• Xilinx 裝置上的 AWS F1 應用程式執行
• Xilinx 裝置上的 Nimbix 應用程式執行

6. 支持

如果對此儲存庫中的任何項目或您自己的專案有疑問並獲得協助，請造訪 SDAccel 論壇。

若要使用 SDAccel GUI 執行這些範例，請依照 SDAccel GUI 自述文件中的設定說明進行操作