Simulation Input and Output Data Streams - 2025.2 English - UG1076

The AI Engine simulator supports both a CSV and TXT file format as inputs and outputs to the simulator.

To generate the CSV based file format from an existing TXT file, AMD provides a utility script.

The command example below shows the options available with the script:

$XILINX_VITIS/data/emulation/scripts/aiesim_convert_plio_txt2csv.py -txt <input.txt> --datawidth <n> --buswidth <n> --complex (optional)

• -txt: Specifies the input txt file
• --datawidth: Specifies AIE kernel data type width 32, 64, etc.
• --buswidth: Specifies the PLIO width 32, 64, 128, etc.
• --complex: Specifies that the AI Engine data type is complex.

For more details on the options available in the script, use the --help option.

The following list describes the generated CSV file's columns and rows.

• DATA:<n>: The command to represent the data values. The argument n is the value to indicate the number of times to repeat data. The default value of n is 1.
  • The number of D columns is PLIO width / Data width of the AIE kernel.
• TLAST and TKEEP: Optional columns to indicate the values to be driven with the data beat. Default value of TKEEP is -1 and TLAST is 0.
• STALL:<n> represents empty cycle(s). The argument n indicates the number of empty cycles from the PL domain. Default value of n is 1.
• COMMENT: To add notes for better readability of the input file.

The following section describes the CSV and TXT formats.