Changed Behavior - 2022.1 English - UG1393

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)
Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 English

The following table specifies differences between this release and prior releases that impact behavior or flow when migrating.

Table 1. Changed Behavior Summary
Area Behavior
Vitis compiler (v++) For Versal platforms, the v++ --link command generates an intermediate XSA file rather than an XCLBIN file. The final XCLBIN file is generated during the packaging step, as defined by the v++ --package command.
Vitis embedded platform The default SD card FAT32 partition mount point is changed from /mnt to /run/media/mmcblk0p1 in PetaLinux and common images.
Vitis HLS

You can no longer inherit from hls::stream class with side-channel struct types (hls::axis/ap_axis/ap_axiu). This specialization from hls::stream for hls::axis/ap_axis/ap_axiu is used to handle AXIS with side-channel specifically, and the struct level cannot be extended. This results in the following error:

error: base 'stream' is marked 'final'
 class stream : public hls::stream<DT, 0>
                       ^
<install_dir>/Vitis_HLS/2022.1/common/technology/autopilot/ap_axi_sdata.h:245:7: note: 'stream' declared here
class stream<axis<T, WUser, WId, WDest>> final {
The config_export -deadlock_detection command has been relocated to config_rtl. The command is otherwise the same.
The config_interface -m_axi_conservative_mode option has changed the default value from false to true. Set the option to false to restore the old behavior.
There are changes to the interfaces for the Vitis HLS FFT and FIR that might affect user code. Streaming interfaces are now used where array interfaces were used.
Vitis IDE Auto-restarting kernels can now be triggered from the host code by setting the restart register counter to all 1s. Previously, auto-restarting kernels was triggered by setting bit 7 of the control register to 1.
Images generated in the Hardware/package directory can now run freely. The image with the enable_aie_debug property is moved to the Hardware/package_aie_debug directory.
Xilinx Runtime The XRT native API required standard has been changed from -std=c++14 to -std=c++17.
The xbutil/xbmgnt --legacy option is removed. Refer to the XRT documentation on github.io for how to migrate legacy commands to new commands.