Bar
SpaceWire UK
Specialist providers of VHDL Intellectual Property & Design Services
BarBarBarBar
Tutorial
Missing Image!
Part 30 - Install 2025.2 Vitis, Vivado & Petalinux

Introduction

This tutorial details the steps required to install the 2025.2 versions of Vitis, Vivado & PetaLinux on Xubuntu 20.04.3.

Note: This version of the Operating System is not officially supported for this version of the Xilinx tools.

Aims

The aims of this tutorial are as follows :-

    Part 1 - Setup environment

    1. Pre-requisites

    Part 2 - Download, install & setup design tools

    1. Download tools
    2. Install Vitis, Vivado & Model Composer
    3. Install PetaLinux

    Part 3 - Check everything is working as expected

    1. Source the tool settings
    #### Part 1 - Setup environment ####

    1. Pre-requisites

    Starting from this point is possible but requires a few pre-requisites.
    #### Part 2 - Download, install & setup design tools ####

    2. Download tools

    Download the following files from Xilinx & Avnet into ~/Downloads.
    1. AMD Unified Installer for FPGAs & Adaptive SoCs 2025.2 SFD (95.69 GB)
    2. PetaLinux Installer (3.09 GB)

    3. Install Vitis, Vivado & Model Composer

    Unzip the tarball & kick off the installation process.

    Unzip option 1 - Unzip the tarball (verbose output)
    steve@Desktop:~$ tar -xvf ~/Downloads/FPGAs_AdaptiveSoCs_Unified_SDI_2025.2_1114_2157.tar -C /tmp
    Unzip option 2 - Unzip the tarball (quiet with progress bar)
    steve@Desktop:~$ pv ~/Downloads/FPGAs_AdaptiveSoCs_Unified_SDI_2025.2_1114_2157.tar | tar -xf - -C /tmp
    Install - Using the command line

    Generate a default configuration file (select option 1) :-
    steve@Desktop:~$ /tmp/FPGAs_AdaptiveSoCs_Unified_SDI_2025.2_1114_2157/xsetup -b ConfigGen
    This is a fresh install.
    Running in batch mode...
    +---------------------------------------------------------------------------+
    |                  AMD Installer for FPGAs & Adaptive SoCs                  |
    |---------------------------------------------------------------------------|
    |                    Build Date:  2025-10-29 07:17:12 MDT                   |
    |                    Branch:      2025.2                                    |
    |                    Version:     35ec23c                                   |
    |                                                                           |
    | Copyright (c) 1986-2022 Xilinx, Inc. All rights reserved.                 |
    | Copyright (c) 2022-2025 Advanced Micro Devices, Inc. All rights reserved. |
    +---------------------------------------------------------------------------+


    Select a Product from the list:
    1. Vitis
    2. Vivado
    3. Vitis Embedded Development
    4. BootGen
    5. Lab Edition
    6. Hardware Server
    7. Power Design Manager (PDM)
    8. On-Premises Install for Cloud Deployments
    9. Documentation Navigator (Standalone)

    Please choose: 1
    INFO  - Config file available at /home/steve/.Xilinx/install_config.txt. Please use -c to point to this install configuration.
    Edit the default configuration file to customize the following :-
    steve@Desktop:~$ subl ~/.Xilinx/install_config.txt
    Install using the updated configuration file.
    steve@Desktop:~$ /tmp/FPGAs_AdaptiveSoCs_Unified_SDI_2025.2_1114_2157/xsetup --agree XilinxEULA,3rdPartyEULA --batch Install --config ~/.Xilinx/install_config.txt
    This is a fresh install.
    Running in batch mode...
    +---------------------------------------------------------------------------+
    |                  AMD Installer for FPGAs & Adaptive SoCs                  |
    |---------------------------------------------------------------------------|
    |                    Build Date:  2025-10-29 07:17:12 MDT                   |
    |                    Branch:      2025.2                                    |
    |                    Version:     35ec23c                                   |
    |                                                                           |
    | Copyright (c) 1986-2022 Xilinx, Inc. All rights reserved.                 |
    | Copyright (c) 2022-2025 Advanced Micro Devices, Inc. All rights reserved. |
    +---------------------------------------------------------------------------+

    INFO  - User has accepted the EULAs.
    WARN  - Warning: you are running on an OS version that is not officially supported. AMD does not recommend installing on unsupported OSes.
    INFO  - Installing Edition: Vitis Unified Software Platform
    INFO  - Installation directory is /opt/Xilinx


    Installing files, 99% completed. (Done)
    It took 5 minutes to install files.
    WARN  -
    ######## Execution of Pre/Post Installation Tasks Failed ########
    Warning: AMD software was installed successfully, but an unexpected status was returned from the following post installation task(s) Generating installed device list for Model Composer: GenerateDeviceFileListLin_Model_Composer script failed. Please check Install log file for more information.
    INFO  - Applying patch: /tmp/FPGAs_AdaptiveSoCs_Unified_SDI_2025.2_1114_2157/payload/installer_patch_2025.2_2025.2_1114_2157.zip to /opt/Xilinx/2025.2
    INFO  - Found /tmp/TMP_LD_LIB_PATH2026-03-19-09-08-06-1773911286/installer_patchs_2025.2_2025.2_1114_21573271639274552002497/patch.sh, executing it.
    INFO  - Patch script done: CmdResult [stdout=, stderr=, exitCode=0]
    INFO  - Log file is copied to : /opt/Xilinx/.xinstall/2025.2/xinstall.log
    INFO  - Tool installation completed.To run the tool successfully, please run the script "installLibs.sh" under /opt/Xilinx/2025.2/Vitis/scripts to install the necessary OS packages, which requires the root privilege.
    Install the suggested libraries.
    steve@Desktop:~$ sudo /opt/Xilinx/2025.2/Vitis/scripts/installLibs.sh
    Create symbolic links to make the new install apear in the same location as the previous ones.
    steve@Desktop:~$ ln -s /opt/Xilinx/2025.2/Vivado /opt/Xilinx/Vivado/2025.2
    steve@Desktop:~$ ln -s /opt/Xilinx/2025.2/Vitis /opt/Xilinx/Vitis/2025.2
    steve@Desktop:~$ ln -s /opt/Xilinx/2025.2/Model_Composer /opt/Xilinx/Model_Composer/2025.2

    4. Install PetaLinux

    Install pre-requisites

    Consult the 2025.1_petalinux_OS_Package_latest_list.xlsx to see what Linux pre-requisites are required.

    Install the suggested packages.
    steve@Desktop:~$ sudo apt install iproute2 gawk python3 python build-essential gcc git make net-tools libncurses5-dev tftpd zlib1g-dev libssl-dev flex bison libselinux1 gnupg wget git-core diffstat chrpath socat xterm autoconf libtool tar unzip texinfo zlib1g-dev gcc-multilib automake zlib1g:i386 screen pax gzip cpio python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev pylint3
    Install tool - Using the command line
    steve@Desktop:~$ mkdir /opt/Xilinx/PetaLinux/2025.2/tool
    steve@Desktop:~$ chmod +x ~/Downloads/petalinux-v2025.2-11160223-installer.run
    steve@Desktop:~$ ~/Downloads/petalinux-v2025.2-11160223-installer.run -y -p arm -d /opt/Xilinx/PetaLinux/2025.2/tool
    #### Part 3 - Check everything is working as expected ####

    5. Source the tool settings

    Setup the tools.
    steve@Desktop:~$ swuk_xilinx 2025.2

    Tools are as follows :-

    Vivado @ /opt/Xilinx/Vivado/2025.2/bin/vivado
    SDK @ Not available!
    Vitis @ /opt/Xilinx/Vitis/2025.2/bin/vitis
    PetaLinux @ /opt/Xilinx/PetaLinux/2025.2/tool/tools/common/petalinux/bin/petalinux-build