Generating a VCD File in the IDE - 2025.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2025-11-20
Version
2025.2 English

Follow these steps to generate a VCD file from the Vitis IDE:

  1. From the Flow Navigator, click the AI Engine Run Settings button, as shown in the following image.

  2. Click the launch.json file of the aiesimulator, and set the fields as follows:
    • Select the Enable Trace check box.
    • Set Trace Type to VCD.
    • Enter a file name in the VCD File Name field.
  3. Right-click your AI Engine graph project from the Explorer view and select Run As > Run Configurations. The Run Configurations dialog box for the current project opens.
  4. Select the AI Engine Emulator option and double-click it to open a new configuration.
  5. Select the Generate Trace check box to enable trace capture, and select the VCD Trace button. By default, this produces a VCD dump in a file called foo.vcd in the current directory. You can rename the file. CLK and STREAM_SWITCH signals are disabled by default from full VCD trace.

You can generate the VCD file by invoking the AI Engine simulator with the --dump-vcd <filename> option on the command line. The simulator saves the VCD file is in the same directory as you run the simulation. If you compile the program using the AI Engine compiler, you can invoke the simulator in a shell with the VCD option.

$ aiesimulator –-pkg-dir=./Work --dump-vcd=foo

This command writes a VCD file (foo.vcd) to the current directory.