Source Control for Platform BSP - 2025.2 English - UG1400

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 English

To customize and version-control the platform BSP, you can keep a local copy of the BSP source repository. Modify the BSP source as needed, then create or regenerate your platform BSP based on the updated local source. Follow the steps below.

  1. Download the embedded BSP repository.
    git clone https://github.com/Xilinx/embeddedsw.git
  2. Switch the version.
    cd embeddedsw & git checkout xilinx_v2025.2 # select the version you need accordingly.
  3. Launch the Vitis Unified IDE and go to the Vitis menu and select Embedded SW Repositories.

  4. Click + to add a local repository, then browse to and select the downloaded embedded BSP repositories.

  5. Click Rescan Repositories to ensure the repository is detected by IDE.
  6. Click OK.
  7. Select the BSP you need to use when creating the platform
    1. Open the Platform Component JSON file and select Board Support Package in the left panel.
    2. Click the drop-down arrow beside the Location box and select the option which reflect the local BSP repositories.
    3. Click Regenerate BSP.

In this case, you can create the platform BSP from your local repositories, allowing you to update and manage it under source control easily. There’s no need to maintain or version-control the BSP within the platform directory itself.