Code structures enhancement - Code structures enhancement - 2025.2 English

Vitis Libraries

Release Date
2026-02-09
Version
2025.2 English
  • L1: all L1 BLAS kernel APIs (toolbox) files locate in separated directories with their orinal name.
  • L1: all L1 algorithm kernel APIs (all-in-AIE) files locate in separated directories beginning with “kernel_.”
  • L1: all L1 AIE-ML APIs located in “Vitis_Libraries/Ultrasound/L1/include/l1-libraries_aieml/”
  • L2: all L2 ultrasound toolbox graph APIs are shareing global settings from “L1/include/kernels.hpp.”
  • L2: all L2 ultrasound all-in-AIE graph APIs beginning with “graph_” are shareing global settings from “L1/include/kernel_*.hpp.”
  • L2: all L2 AIE-ML APIs located in “Vitis_Libraries/Ultrasound/L2/include/l2-libraries_aieml/”
  • L1 & L2: all AIE-ML APIs tests are in “Vitis_Libraries/Ultrasound/L2/tests/tests_aieml/”, including the tests for both L1 and L2 APIs and the combinations of various datatypes.
  • L1 & L2: AIE-ML tests with differenct datatypes may share same source code files, which locate in “Vitis_Libraries/Ultrasound/L2/src”.
  • L3: all 4 L3 example (Scanline_AllinAIE/PW/SA/Scanline) are located in separated directory under “L3/tests”, each contains self contain data and source code.
  • L3: the scanline algorithm C-models are located in separated directory under “L3/models.”

For L2/L3 test cases for VCK190, the code structure for tests is showed as bellow:

aie_graph:     aie graph
PL_kernels:    HLS C/C++ code for PL kernels
PS_host:       XRT based host code for VCK190
data:          input data & output golden data
system.cfg:    hw platform descriptions

For L2 test cases for VEK280, the structure is showed as bellow:

src/<api>/aiengin:              aie graph
src/<api>/pl:                   HLS C/C++ code for PL kernels
src/<api>/ps:                   XRT based host code for VEK280
tests_aieml/<api>/data:         input data & output golden data
tests_aieml/<api>/system.cfg:   hw platform descriptions
tests_aieml/<api>/aie.cfg:      aie compilation parameters