Руководство по использованию Git с Unified Vitis IDE

Автоматизация настройки проекта Vitis с помощью Python

Скрипт Python для настройки проекта Vitis и интеграции с Git.

import vitis
import os

ROOT_PATH = os.path.abspath(os.path.dirname(__file__))
VITIS_BUILD_DIR_PATH = os.path.join(ROOT_PATH, "build-vitis")
os.makedirs(VITIS_BUILD_DIR_PATH, exist_ok=True)
EXPECTED_XSA_FILE_PATH = os.path.join(ROOT_PATH, "build-vivado", "mydesign.xsa")
COMPONENT_NAME = "MyComponent"
MAIN_SRC_PATH = os.path.join(ROOT_PATH, "src")

client = vitis.create_client()
client.set_workspace(path=VITIS_BUILD_DIR_PATH)

PLATFORM_NAME = "platform_baremetal"
platform = client.create_platform_component(
    name=PLATFORM_NAME,
    hw=EXPECTED_XSA_FILE_PATH,
    os="standalone",
    cpu="mycpu"
)

platform = client.get_platform_component(name=PLATFORM_NAME)
status = platform.build()

comp = client.create_app_component(
    name=COMPONENT_NAME,
    platform=os.path.join(VITIS_BUILD_DIR_PATH, PLATFORM_NAME, "export", PLATFORM_NAME, f"{PLATFORM_NAME}.xpfm"),
    domain="mydomainname"
)

comp = client.get_component(name=COMPONENT_NAME)
status = comp.import_files(
    from_loc=MAIN_SRC_PATH,
    files=["CMakeLists.txt", "UserConfig.cmake", "lscript.ld", "NOTUSED.cpp"],
    dest_dir_in_cmp="src"
)

comp.build()

Управление системой контроля версий в проектах Vitis

Сценарий оболочки для оптимизации инициализации проекта Vitis и контроля версий

#!/bin/bash

ROOT_PATH=$(pwd)
VITIS_BUILD_DIR_PATH="$ROOT_PATH/build-vitis"
mkdir -p "$VITIS_BUILD_DIR_PATH"
EXPECTED_XSA_FILE_PATH="$ROOT_PATH/build-vivado/mydesign.xsa"
COMPONENT_NAME="MyComponent"
MAIN_SRC_PATH="$ROOT_PATH/src"

vitis -s tools/build_app.py

# After running the Python script, set up Git repository
cd "$ROOT_PATH"
git init
echo "build-vitis/" >> .gitignore
echo "build-vivado/" >> .gitignore
git add src/ tools/ .gitignore
git commit -m "Initial commit with project structure and scripts"

# Script end

Общие вопросы и решения по использованию Git с Vitis IDE

1. Как инициализировать репозиторий Git для проекта Vitis?
2. Вы можете инициализировать репозиторий Git, перейдя в корень проекта и запустив git init. Добавьте необходимые файлы в .gitignore для исключения ненужных файлов.
3. Какие файлы должны быть включены в .gitignore для проекта Витис?
4. Включите папки, специфичные для IDE, например build-vitis/ и build-vivado/ чтобы избежать автоматического создания файлов с контролем версий.
5. Как я могу автоматизировать настройку проекта Vitis?
6. Используйте скрипт Python для автоматизации таких задач, как создание компонентов платформы и импорт необходимых файлов. Запустите скрипт, используя vitis -s tools/build_app.py.
7. Почему мне нужно копировать файлы конфигурации вручную?
8. Vitis ожидает, что определенные файлы конфигурации будут находиться в определенных местах. Копирование этих файлов вручную или с помощью сценария гарантирует, что IDE найдет их правильно.
9. Как обрабатывать папки платформы и приложений в Vitis?
10. Исключите эти папки из контроля версий и используйте сценарии для управления необходимыми файлами, обеспечивая согласованность и избегая конфликтов путей.
11. Могу ли я редактировать исходные файлы непосредственно в Vitis при использовании Git?
12. Да, но убедитесь, что ваша установка CMake указывает на правильные исходные каталоги. Vitis может неправильно распознавать включения и имена для подсветки синтаксиса.
13. Каковы преимущества использования сценариев для настройки проекта?
14. Сценарии обеспечивают согласованную и повторяемую настройку проекта, уменьшая количество ручных ошибок и упрощая совместную работу в различных средах.
15. Как я могу обновить настройки проекта, если в них были внесены изменения?
16. Измените свои сценарии автоматизации, чтобы отразить изменения, и повторно запустите их. Это гарантирует правильное применение всех необходимых обновлений.
17. Что делать, если я столкнулся с ошибками сборки из-за проблем с путями?
18. Проверьте сценарии настройки проекта и убедитесь, что все пути указаны правильно. Используйте относительные пути, где это возможно, чтобы избежать конфликтов.

Завершение рабочего процесса для Vitis и Git

Интеграция Git с Unified Vitis IDE требует стратегического подхода для эффективного управления контролем версий. Исключив папки, управляемые Vitis, и сосредоточив внимание на важных файлах конфигурации, разработчики могут избежать распространенных ошибок, связанных с абсолютными путями и метаданными, специфичными для IDE. Скрипты автоматизации еще больше улучшают этот процесс, обеспечивая повторяемую и последовательную настройку проекта. Эти стратегии гарантируют, что проекты Vitis остаются управляемыми и совместными даже в сложных средах разработки.