New Features and Changes - 2022.1 English

Xilinx Runtime (XRT) Release Notes (UG1451)

Document ID
Release Date
2022.1 English

This version of Xilinx® Runtime (XRT) includes the following new features.

  • The xrt::system API, for probing the number of devices, has been added.
  • The xrt::message API, for logging messages, has been added.
  • The Xilinx Runtime native API host code now requires -std=c++17 or above.
  • Experimental xrt::queue APIs have been added for asynchronous execution of synchronous operations.
  • Deprecated streaming APIs with QDMA PCIe DMA engines have been removed from OpenCL.
Note: For detailed info about XRT API changes and experimental features, refer to the changelog.
XRT Utilities
  • The xbutil utility can show AI Engine FIFO counters, which can help with debugging AI Engine deadlock scenarios.
  • The xbutil --legacy option is now removed.
  • The xclbinutil --info utility provides clock information for embedded platforms.
  • The xbtop standalone utility shows Linux top-like output, replacing the legacy xbutil -top utility.
  • Early access for xbflash has been added, to allow programming of the QSPI flash on Alveo™ accelerator cards.
Emulation and Profiling
  • The xrt.ini profiling flags device_counter and device_trace have been added.
  • The xrt.ini flags profile, timeline_trace, and xrt_profile no longer load the XDP profiling functionality and no longer issue a deprecation warning.
  • The xrt.ini profiling flags opencl_summary, data_transfer_trace, and opencl_device_counter have been deprecated and will be removed in a future release.
  • The xbutil command is now able to load SOM images.
Other Changes
  • The following ctypes Python bindings have been deprecated:
    Python code should be written against the imported pyxrt module only. This module supports both hardware and emulation in the same way as compiled binaries.