SDAccel_Examples

Репозиторий примеров SDAccel

Примечание. Не используйте этот репозиторий для последней версии Xilinx Vitis Tool Chain. Здесь создается совершенно новый репозиторий: https://github.com/Xilinx/Vitis_Accel_Examples для новой цепочки инструментов Xilinx Vitis. Используйте репозиторий примеров SDAccel для ранее выпущенных продуктов Xilinx SDAccel или SDx.

Добро пожаловать в репозиторий примеров SDAccel. В этом репозитории содержатся новейшие примеры, которые помогут вам начать работу с оптимизацией приложений для плат ускорения Xilinx PCIe FPGA. Все примеры готовы к компиляции и выполнению на платах, поддерживаемых SDAccel, и партнерах по ускоренным облачным сервисам. Репозиторий организован следующим образом:

1. ПРЕДВАРИТЕЛЬНЫЕ ТРЕБОВАНИЯ
2. ПОДДЕРЖИВАЕМЫЕ ПЛАТФОРМЫ
3. КОМПИЛЯЦИЯ И ИСПОЛНЕНИЕ
4. СТРУКТУРА СПРАВОЧНИКА
5. ВЫПОЛНЕНИЕ В ОБЛАЧНЫХ СРЕДАХ
6. ПОДДЕРЖИВАТЬ

1. ПРЕДПОСЫЛКИ

Примеры SDAccel Git Предполагается, что пользователь знаком с базовой средой SDAccel, порядком настройки, программирования и отладки. Если нет, рекомендуется охватить следующие темы из руководств пользователя SDAccel:

• UG1238 — Среда разработки SDAccel
• UG1277 — Руководство по программированию SDAccel
• UG1281 — Руководство по отладке SDAccel

2. ПОДДЕРЖИВАЕМЫЕ ПЛАТФОРМЫ

Доска	Версия программного обеспечения
Ксилинкс Альвео U200	СДкс 2019.1
Ксилинкс Альвео U250	СДкс 2019.1
Ксилинкс Альвео U280	СДкс 2019.1

3. СОСТАВЛЕНИЕ И ИСПОЛНЕНИЕ

В первую очередь рекомендуется начать с примера Hello World, который знакомит новых пользователей с базовой структурой приложения на основе SDAccel.

Компиляция для эмуляции приложения

В рамках возможностей, доступных разработчику приложений, SDAccel включает среды для проверки правильности приложения как на функциональном уровне программного обеспечения, так и на уровне аппаратной эмуляции.

Эти режимы, получившие названия sw_emu и hw_emu, позволяют разработчику профилировать и оценивать производительность проекта перед его компиляцией для исполнения на плате. Рекомендуется, чтобы все приложения выполнялись как минимум в режиме sw_emu перед компиляцией и выполнением на плате FPGA.

    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

Если приложение не было ранее скомпилировано, правило check makefile скомпилирует и выполнит приложение в выбранном пользователем режиме эмуляции.

Компиляция для выполнения приложения на плате ускорителя FPGA

Команда компиляции приложения для выполнения на плате ускорения FPGA:

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

Целью make-файла по умолчанию является компиляция для аппаратного обеспечения. Поэтому установка опции TARGETS не требуется. ПРИМЕЧАНИЕ. Компиляция для выполнения приложения на аппаратном уровне генерирует специальную логику для реализации функциональности ядер в приложении. Обычно время аппаратной компиляции составляет от 30 минут до пары часов.

4. СТРУКТУРА СПРАВОЧНИКА

• НАЧИНАЯ

Коллекция примеров, направленных на обучение пользователей передовому опыту использования различных функций SDAccel и запуска собственного приложения.

• УСКОРЕНИЕ

Сборник примеров по разгрузке процессора на вычислительные блоки на базе FPGA.

• ЗРЕНИЕ

Коллекция примеров по обработке изображений и видео.

• Либс

Коллекция общих библиотек, используемых во всех примерах для помощи в быстрой разработке основного кода приложения.

• ПОЛЕЗНОСТЬ

Коллекция служебных функций, используемых как часть Makefiles во всех примерах. Этот набор включает в себя правила и сценарии Makefile для запуска скомпилированных SDAccel приложений на платах, размещенных на Nimbix, непосредственно из оболочки терминала разработчика.

5. Выполнение в облачных средах

Платы ускорения FPGA были развернуты в облаке. Для получения информации о том, как выполнить пример в конкретном облаке, ознакомьтесь со следующими руководствами.

• Выполнение приложений AWS F1 на устройствах Xilinx
• Выполнение приложений Nimbix на устройствах Xilinx

6. ПОДДЕРЖКА

Если у вас есть вопросы и вы можете получить помощь по любому проекту из этого репозитория или по вашим собственным проектам, посетите форумы SDAccel.

Чтобы выполнить этот пример с использованием графического интерфейса SDAccel, следуйте инструкциям по настройке в README GUI SDAccel.