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 自述文件中的设置说明进行操作