Simulator Options for Hardware Emulation - 2020.2 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
UG1076
Release Date
2020-11-24
Version
2020.2 English

The AI Engine simulator generates an options file that lists the options used for simulating the AI Engine graph application. The options file is automatically generated when the AI Engine simulator is run. This allows reuse of the AI Engine simulator options from the initial graph-level simulation to later in the system-level emulation. You can also manually edit the options file to specify other options as required. The following table lists the options that can be specified in the aiesim_options.txt file, which is located in the aiesimulator_output directory and will only be created if the option, --dump-vcd is used with the aiesimulator command. This file can be specified as part of the command line option to launch the emulator using the launch_hw_emu.sh script as described in Running the System. An example command line follows:

./launch_hw_emu.sh \
-add-env VITIS_LAUNCH_WAVEFORM_BATCH=1 ENABLE_AIE_VCD_TRACE=true \
-aie-sim-options Work/aiesimulator_output/aiesim_options.txt 

Additionally, you can add more advanced options to log waveform data without having to launch emulation with the Vivado logic simulator (XSIM) GUI. An example command line follows:

./launch_hw_emu.sh \
-user-pre-sim-script pre-sim.tcl

The pre-sim.tcl contains Tcl commands to add waveforms or log design waveforms. For an example see Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393) and for Tcl commands see Vivado Design Suite User Guide: Logic Simulation (UG900).

Table 1. Hardware Emulation Options
Command Arguments Description
AIE_DUMP_VCD <filename> When AIE_DUMP_VCD is specified, the simulation will generate VCD data and write it to the specified <filename>.vcd.