Simulator Options - 2021.2 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
Release Date
2021.2 English

The complete set of the AI Engine simulator (aiesimulator) options are described in this section. In most cases, just pointing to pkg-dir is sufficient.

Table 1. AI Engine Simulator Options
Options Description
-h, --help Show this help message and exit.
--dump-vcd FILE Dump VCD waveform information into FILE. Because the tool appends .vcd to the specified file name, it is not necessary to include the file suffix.
--gm-init-file <file> Read global memory image from file. This loads the memory initialization file as described in Simulating Global Memory.
--pkg-dir <PKG_DIR> Specify the package directory, for example, ./Work.
--profile Generates profiling data for all used cores. Allows generation of printf trace messages on the stdout and collects profiling statistics during simulation. This can slightly slow down the simulator.

Optionally, can specify the profile of specific cores by using --profile=(col,row)(col,row)....

--simulation-cycle-timeout CYCLES Run the application for a given number of cycles after it is loaded.
Tip: Specify the --simulation-cycle-timeout option to end the simulation session after the specified number of timeouts. However, when specifying simulation timeout during the debug process, be sure to specify a large number of cycles because the debug will terminate when the timeout cycle is reached.
--online [-ctf] [-wdb]

Call vcdanalyze to parse VCD data on-the-fly, to optionally produce common trace format (CTF), or waveform database (WDB) output.

Tip: The --online option and --dump-vcd option cannot be used together. If both options are specified, only --online option takes effect.
--enable-memory-check Enables run-time program and data memory boundary access - checks. Any access violation will be reported as an [WARNING] message. By default this option is disabled.
--output-time-stamp When this option is set to no, timestamps in the simulation output text files are no longer generated. Default value for this option is yes.