Updating the XSA - 2025.1 English - XD260

Vitis Tutorials: Embedded Software (XD260)

Document ID
XD260
Release Date
2025-07-31
Version
2025.1 English

Below I have a trivial Block Design for the Zynq Ultrascale+ MPSoC which was created using Vivado 2023.2 tools. I have exported the hardware and used the .xsa file within Vitis Classic to create a platform and build applications on top of it. However, now I am in this situation were I want to migrate to the latest version of Vitis Unified. Here we will look at how we can upgrade our vivado deisgn in the latest vivado tools before exporting it to vitis.

../../../_images/2023.2_block_design.PNG

  1. Load Vivado 2025.1 tools

  2. Select ‘Open Project’ and choose the 2023.2 project to be migrated

../../../_images/open_project.PNG

  1. When you select your older project you will receive the below pop up message asking you if you would like to automaitcally upgrade or open the project in read only mode. Select ‘Automatically Upgrade to the current version’.

../../../_images/upgrade_pop_up_message.PNG

  1. Next after the project has loaded in vivado you may see the below warning message explaining that some of the IP used in your project have been upgraded.

../../../_images/upgrade_warning_message.PNG

To upgrade the IP select ‘Report IP Status’ and then scroll to the bottom of the screen and select the ‘IP Status’ tab which will display all avaliable IP in your design. Then Select all of the IP’s that require upgrades and click ‘Upgrade Selected’.

../../../_images/upgradable_ip.PNG

  1. Export the hardware (XSA) and use it to recreate your platform in Vitis Unified 2025.1