When upgrading a design to run with the this version of the AMD tools, the design should be recompiled to have all metadata in sync with the tool release. To upgrade the design, follow the checklist in the following table.
| Item | Action |
|---|---|
| Upgrade Base Hardware Platform | Download and reference to compatible Base HW Platform. |
| Upgrade Custom Hardware Platform | Upgrade Vivado version check and IP versions in block design using Vivado IP integrator and regenerate the extensible hw platform. Upgrading Vivado designs is described in Updating Designs for New Release in the Vivado Design Suite User Guide: Designing IP Subsystems Using IP Integrator (UG994) . |
| Optional: Migrate from classic Vitis IDE | Projects from the deprecated Vitis Classic IDE need to be migrated to the Vitis 2024.2 release before upgrading to this release. |
| Copy or create a new workspace | If the workspace is in version control, use the SCM tool to create a new branch for the upgraded design. Otherwise make a copy/new workspace for the upgraded design so you can compare build results between the versions. |
| Rebuild targets | Rebuild the design and compare results with design version in previous tools. |
Designs using command line or Makefile build flow with custom hardware platform can run rebuild after upgrading the custom hardware platform using the guide in preceding table. This should be done in a new folder so the build can be compared with the previous design version.
Once rebuilt, verify and compare the results with the previous design to ensure functionality and performance meets expectations.