New Features and Changes - 2021.2 English

Xilinx Runtime (XRT) Release Notes (UG1451)

Document ID
Release Date
2021.2 English

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

  • The XRT native API supports user managed kernel control with xrt::ip.
  • The xclExecBufWithWaitList() API is deprecated and will be removed in a future release. See Versal ACAP AI Engine Kernel Coding User Guide (UG1079) for more details.
Note: For detailed info about XRT API changes and experimental features, refer to the changelog.
AI Engine Support
  • The XRT native API adds multiple process support for AI Engine.
  • C++ support has been added for xrt::aie APIs.
  • The AI Engine API in xrt_aie.h and xrt_graph.h is now stable. These files are moved from the include/experimental/ to the include/xrt/ directory.
XRT Utilities
  • A new utility, xball, has been added to apply xbutil or xbmgmt commands to all or a filtered part of the installed data center cards. Check xball --help for details.
  • The next generation xbutil and xbmgmt tools are now default utilities and recommended to use. To use the legacy utilities, use xbutil --legacy or xbmgmt --legacy with legacy sub-commands, but be aware that the legacy version of the tool is likely to be obsoleted in future releases.
  • A new command, xbutil configure, has been added to allow you to enable, disable, or configure the PCIe Host Memory and PCIe Peer to Peer features. See the XRT documentation for more details.
  • All XRT utilities now globally support the --force option to skip user interactive confirmation.
  • A profile summary report is generated when any profiling option is enabled. All applicable summary tables and guidance are generated based on the profiling options enabled in the xrt.ini file.
  • A new data transfer summary table provides aggregate information on a memory resource when monitors are added to memory resources in the design.
  • New AI Engine profiling metric sets count different AI Engine events, including floating point exceptions in AI Engine, tile execution counts, and stream puts and gets.
  • zocl memory manager improvements to support any sptag.
Other Changes
  • Register read and write in hardware emulation now use CU index ordering as the rest of XRT does.
  • The following bugs relating to kernel address range size have been fixed:
    • Support custom address range size
    • Tap error when writing outside the kernel address range