Guide till att använda Git med Unified Vitis IDE

Automatisera Vitis Project Setup med Python

Python-skript för hantering av Vitis-projektinstallation och Git-integration

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()

Hantera källkontroll i Vitis-projekt

Skalskript för att effektivisera Vitis-projektinitiering och källkontroll

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

Vanliga frågor och lösningar för att använda Git med Vitis IDE

1. Hur initierar jag ett Git-förråd för ett Vitis-projekt?
2. Du kan initiera ett Git-förråd genom att navigera till projektets rot och köra git init. Lägg till nödvändiga filer till .gitignore för att utesluta oönskade filer.
3. Vilka filer ska ingå i .gitignore för ett Vitis-projekt?
4. Inkludera IDE-specifika mappar som build-vitis/ och build-vivado/ för att undvika versionskontrollerande autogenererade filer.
5. Hur kan jag automatisera installationen av ett Vitis-projekt?
6. Använd ett Python-skript för att automatisera uppgifter som att skapa plattformskomponenter och importera nödvändiga filer. Kör skriptet med vitis -s tools/build_app.py.
7. Varför måste jag kopiera konfigurationsfiler manuellt?
8. Vitis förväntar sig att vissa konfigurationsfiler finns på specifika platser. Att kopiera dessa filer manuellt eller via skript säkerställer att IDE hittar dem korrekt.
9. Hur hanterar jag plattforms- och applikationsmappar i Vitis?
10. Uteslut dessa mappar från versionskontroll och använd skript för att hantera nödvändiga filer, för att säkerställa konsekvens och undvika sökvägskonflikter.
11. Kan jag redigera källfiler direkt i Vitis när jag använder Git?
12. Ja, men se till att din CMake-installation pekar på rätt källkataloger. Vitis kanske inte känner igen inkluderar och namn korrekt för syntaxmarkering.
13. Vilka är fördelarna med att använda skript för projektinstallation?
14. Skript säkerställer en konsekvent och repeterbar projektuppställning, vilket minskar manuella fel och förenklar samarbete mellan olika miljöer.
15. Hur kan jag uppdatera min projektkonfiguration om ändringar görs?
16. Ändra dina automatiseringsskript för att återspegla ändringarna och kör dem igen. Detta säkerställer att alla nödvändiga uppdateringar tillämpas korrekt.
17. Vad ska jag göra om jag stöter på byggfel på grund av sökvägsproblem?
18. Kontrollera dina projektinstallationsskript och se till att alla sökvägar är korrekt specificerade. Använd relativa vägar där det är möjligt för att undvika konflikter.

Avsluta arbetsflödet för Vitis och Git

Att integrera Git med Unified Vitis IDE kräver ett strategiskt tillvägagångssätt för att hantera versionskontroll effektivt. Genom att utesluta Vitis-hanterade mappar och fokusera på viktiga konfigurationsfiler kan utvecklare undvika vanliga fallgropar i samband med absoluta sökvägar och IDE-specifik metadata. Automatiseringsskript förbättrar denna process ytterligare genom att tillhandahålla en repeterbar och konsekvent projektuppsättning. Dessa strategier säkerställer att Vitis-projekt förblir hanterbara och samarbetsvilliga, även i komplexa utvecklingsmiljöer.