Organization - 2023.2 English

Vitis Libraries

Release Date
2023-12-20
Version
2023.2 English

The following figure shows the DSPLib organization.

X24061-Page-1 Sheet.20 Sheet.21 Sheet.22 dsp dsp Sheet.50 Sheet.51 Sheet.52 docs docs Sheet.53 Sheet.54 Sheet.55 ext ext Sheet.56 Sheet.57 Sheet.58 L1 L1 Sheet.59 Sheet.60 Sheet.61 examples examples Sheet.62 Sheet.63 Sheet.64 include include Sheet.66 Sheet.67 aie aie Sheet.69 Sheet.70 hw hw Sheet.71 Sheet.72 Sheet.73 src src Sheet.74 Sheet.75 aie aie Sheet.76 Sheet.77 Sheet.78 test test Sheet.79 Sheet.80 aie aie Sheet.81 Sheet.82 hw hw Sheet.83 Sheet.84 Sheet.85 Sheet.86 Sheet.87 examples examples Sheet.88 Sheet.89 Sheet.90 include include Sheet.91 Sheet.92 aie aie Sheet.93 Sheet.94 hw hw Sheet.100 Sheet.101 Sheet.102 test test Sheet.103 Sheet.104 aie aie Sheet.105 Sheet.106 hw hw Sheet.107 L2 L2 Sheet.108 Sheet.109 Sheet.110 benchmarks benchmarks Sheet.112 Sheet.113 Sheet.114 Sheet.115 Sheet.116 Sheet.117 Sheet.40 X24061-060321 X24061-060321

Figure 25 DSPLib Organization

The directories L1, and L2 correspond to AI Engine kernels and AI Engine graphs for each function, respectively. Inclusion of an L2 graph rather than an L1 element is recommended in your design. L3 is reserved for future software drivers.

Note

The L3 directory is not yet available.

Graph class declarations and constants that allow you to include the library element in your design are located in the L2/include/aie/. Kernel class definitions, the .cpp files and corresponding .hpp files are located in the L1/src/aie and L1/include/aie subdirectories respectively.

The L2/tests/aie/<library_element> subdirectory contains a test bench for the library element. Additional testbench files, like stimulus, monitor, and other utility modules are located in the L1/tests/aie/inc/ folder.

Reference models graph class for each library element are contained in L2/tests/aie/common/inc. Reference models kernel class for each library element are contained in L1/tests/aie/inc/ and L1/tests/aie/src.

The L2/examples subdirectory holds example wrapper designs to demonstrate the use of the library elements.