The following table shows the revision history for this document.
| Section | Revision Summary |
|---|---|
| 11/28/2024 Version 2024.2 | |
| AI Engine-ML Data Types | Updated supported data types. |
| Load and Store From Buffer Interface | Added note to clarify that buffer streams can be used in place of iterators, if iterator usage is not suitable due to semantic or performance issues. |
| Load and Store Using Buffer Streams | Added topic to explain how to load and store operations using buffer streams. |
| Vector Arithmetic Operations | Added note with general instruction to increase the stack size to avoid stack overflow. |
| Bitwise Operations | Added note to clarify that bitwise operators are only supported for integer data types |
| AI Engine-ML External Memory Access | Added description and examples of dma_channel constraint which is used to constrain the location of
external buffers.Updated the example code using XRT API in the host code for Linux. |
| Synchronous Buffer Port Access | Clarified the behavior of locks on a synchronous output buffer, during multiple iterations of a kernel. |
| Circular Output Buffer | Clarified buffer addressing limitations when multiple kernels are mapped to the same tile. |
| Explicit Packet Switching | Clarified that packet stream can be created from one or more AI Engine kernels to one or more multiple destination AI Engine kernels. |
| Packet Switching Graph Constructs | Clarified that data read data from a packet stream is read as an integer value by default, but that can then can be cast to a different data type if desired. |
| Example of Packet Switching between PL and AI Engine, Example of Packet Switching from an AI Engine to Multiple AI Engines, and Example on Packet Switching from Multiple AI Engines to an AI Engine | Added examples of how to set up packet switching connections between PL and AI Engine. |
| Logical I/O Ports | Added topic that explains the usage of the graph port objects. |
| 06/06/2024 Version 2024.1 | |
| General | Changed output_stream to output_cascade, and
changed input_stream to input_cascade. |
| Introduction to Scalar and Vector Programming | Changed int32
to int16, and changed vector<8> to vector<16>. |
| Floating-Point Accuracy | Added new section. |
| Casting and Datatype Conversion | Added details regarding the API support of vector conversions between data types. |
| Stream and Cascade Data Types | Updated the supported stream and data types. |
| Stream Switch FIFO | Added the --swfifo-threshold option to increase the default maximum FIFO
depth. |
| AI Engine-ML External Memory Access | Added note to clarify that external buffers are not supported by the XRT API. |
| Tiling Parameters and Buffer Descriptors | Removed repetition and phase from the
structure tiling_parameters. |
| Examples on Memory and DMA Programming | Added new section with examples. |
| Graph Programming Comparison Between AI Engine and AI Engine-ML | New section to compare the graph programming constructs supported in different devices. |
| Graph Objects for Packet Processing | Added pktorderedmerge. |
| Event API | Moved section to UG1076. |
| 12/07/2023 Version 2023.2 | |
| General | Updated to reflect the usage of the new unified AMD Vitis™ IDE. |
| Inline Keywords | Added inline keyword
explanation. |
| Multi-dimensional Addressing in AI Engine Kernels | Introduced aie::make_tensor_buffer_stream which supports multi-dimensional
addressing inside a kernel. |
| Sparse Matrix Multiplication | Introduced APIs that support sparse matrix multiplication. |
| Linear Approximation | Updated the steps for a floating point based approximation information, and updated example. |
| Tiling Parameters and Buffer Descriptors | Added important note on address alignment and its impact on data access. |
| Tiling Parameters Examples | Updated the example in 2D Matrix Transferring to 4x2 Sub Matrices. |
| 10/18/2023 Version 2023.2 | |
| Initial release | N/A |