New Features and Changes - 2022.1 English

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

XRT API

• 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.

Embedded

• The xbutil command is now able to load SOM images.

Other Changes

• The following ctypes Python bindings have been deprecated:
  • xclbin_bindings.py
  • ert_bindings.py
  • xrt_bindings.py
  • utils_binding.py
  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.