Przewodnik po używaniu Git z Unified Vitis IDE

Automatyzacja konfiguracji projektu Vitis za pomocą języka Python

Skrypt Pythona do obsługi konfiguracji projektu Vitis i integracji z 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()

Zarządzanie kontrolą źródła w projektach Vitis

Skrypt powłoki usprawniający inicjalizację projektu Vitis i kontrolę źródła

#!/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

Często zadawane pytania i rozwiązania dotyczące używania Git z Vitis IDE

1. Jak zainicjować repozytorium Git dla projektu Vitis?
2. Możesz zainicjować repozytorium Git, przechodząc do katalogu głównego projektu i uruchamiając go git init. Dodaj niezbędne pliki do .gitignore aby wykluczyć niechciane pliki.
3. Jakie pliki powinny znaleźć się w .gitignore dla projektu Vitis?
4. Dołącz foldery specyficzne dla IDE, takie jak build-vitis/ I build-vivado/ aby uniknąć kontroli wersji automatycznie generowanych plików.
5. Jak mogę zautomatyzować konfigurację projektu Vitis?
6. Użyj skryptu Python, aby zautomatyzować zadania, takie jak tworzenie komponentów platformy i importowanie niezbędnych plików. Uruchom skrypt za pomocą vitis -s tools/build_app.py.
7. Dlaczego muszę ręcznie kopiować pliki konfiguracyjne?
8. Vitis oczekuje, że określone pliki konfiguracyjne będą znajdować się w określonych lokalizacjach. Kopiowanie tych plików ręcznie lub za pomocą skryptu gwarantuje, że IDE odnajdzie je poprawnie.
9. Jak obsługiwać foldery platformy i aplikacji w Vitis?
10. Wyklucz te foldery z kontroli wersji i użyj skryptów do zarządzania niezbędnymi plikami, zapewniając spójność i unikając konfliktów ścieżek.
11. Czy mogę edytować pliki źródłowe bezpośrednio w Vitis podczas korzystania z Git?
12. Tak, ale upewnij się, że konfiguracja CMake wskazuje prawidłowe katalogi źródłowe. Vitis może nie rozpoznać poprawnie dołączeń i nazw przy podświetlaniu składni.
13. Jakie są zalety używania skryptów do konfiguracji projektu?
14. Skrypty zapewniają spójną i powtarzalną konfigurację projektu, redukując błędy ręczne i upraszczając współpracę w różnych środowiskach.
15. Jak mogę zaktualizować konfigurację projektu, jeśli zostaną wprowadzone zmiany?
16. Zmodyfikuj skrypty automatyzacji, aby odzwierciedlić zmiany i uruchom je ponownie. Dzięki temu wszystkie niezbędne aktualizacje zostaną poprawnie zastosowane.
17. Co powinienem zrobić, jeśli napotkam błędy kompilacji spowodowane problemami ze ścieżką?
18. Sprawdź skrypty konfiguracyjne projektu i upewnij się, że wszystkie ścieżki zostały poprawnie określone. Jeśli to możliwe, używaj ścieżek względnych, aby uniknąć konfliktów.

Podsumowanie przepływu pracy dla Vitis i Git

Integracja Gita z Unified Vitis IDE wymaga strategicznego podejścia do skutecznego zarządzania kontrolą wersji. Wykluczając foldery zarządzane przez Vitis i skupiając się na niezbędnych plikach konfiguracyjnych, programiści mogą uniknąć typowych pułapek związanych ze ścieżkami bezwzględnymi i metadanymi specyficznymi dla IDE. Skrypty automatyzacji dodatkowo usprawniają ten proces, zapewniając powtarzalną i spójną konfigurację projektu. Strategie te zapewniają, że projekty Vitis będą łatwe w zarządzaniu i oparte na współpracy, nawet w złożonych środowiskach programistycznych.