Running the Vector Adder Example Application: Difference between revisions

From Cpre584
Jump to navigation Jump to search
Tyler07 (talk | contribs)
m It wasn't clear to me which makefile to edit, so I specifically noted which one to edit for the USER_SIM_OPTIONS = -gui
 
(19 intermediate revisions by one other user not shown)
Line 2: Line 2:


== Compiling the Project ==
== Compiling the Project ==
The rev version installed on the Convey machine is from 2011-11-22; to copy the sample app's source code run:
The rev version installed on the Convey machine is from 2012-03-19; to copy the sample app's source code run:
  cd ~
  cd ~
  mkdir pdk_sample
  mkdir pdk_sample
Line 26: Line 26:
   ./runcp
   ./runcp


The '''run''' script located in the SampleAppVadd can be used to run the application in SW.
The '''run''' script located in the SampleAppVadd can be used to run the application using the software simulation of the FPGA design.


Either script can be used to run the application on Simulator using the "-vsim" option which sets the environment variable CNY_CAE_EMULATOR to ./run_simulation:
  ./run
 
Using the "-vsim" option, either script can be used to run the application using the hardware simulation (ModelSim).  The "-vsim" option sets the environment variable CNY_CAE_EMULATOR to ./run_simulation:


   ./runcp -vsim
   ./runcp -vsim
Line 44: Line 46:
|CNY_CAE_EMULATOR || <location for CaeSimPers> || ./run_simulation || ''unset''
|CNY_CAE_EMULATOR || <location for CaeSimPers> || ./run_simulation || ''unset''
|}
|}
=== Interactive Mode for ModelSim Simulation ===
Source: http://www.conveysupport.com/help/?p=215
You can save the waveforms every time you run the hardware simulator to make debugging easier.
Add the $wlfdumpvars line to the sim/tb_user.v file:
// To trace everything (slow)
$wlfdumpvars(0, testbench);
// To trace cae_pers module and 5 levels below
`ifdef AE0_PRESENT
  $wlfdumpvars(5,testbench.cae_fpga0.ae_top.core.cae_pers);
Then include that file in the sim/Makefile by adding this line this line:
CNY_PDK_TB_USER_VLOG += ./tb_user.v
This will create a vsim.wlf file in the sim directory.  You can view the waveform using any of the following terminal commands:
vsim ../sim/vsim.wlf
vsim -view ../sim/vsim.wlf
Alternatively, you may instead run the simulation in interactive mode by adding the following line to the makefile in the sim directory:
USER_SIM_OPTIONS = -gui
Then run the app (./run -vsim) to start the simulation.  When the Modelsim GUI opens and the design is loaded, type “run -all” at the Modelsim command line.

Latest revision as of 19:08, 21 January 2013

Section 10.5 of the Convey PDK Reference Manual (.pdf) explains how to run the sample software application. It has been reproduced below in brief.

Compiling the Project

The rev version installed on the Convey machine is from 2012-03-19; to copy the sample app's source code run:

cd ~
mkdir pdk_sample
cp -r /opt/convey/pdk/latest/hc-1/examples/* pdk_sample

To make the sample project, first make sure you have setup your environment variables, then run:

cd ~/pdk_sample/cae_pers_vadd/SampleAppVadd/
make

This compiles both an emulator (CaeSimPers) and a C program that makes a coprocessor call to use the vector adder (UserApp.exe).

Run the Project

There are three ways to run your project:

  1. A software simulation of the FPGA design
  2. A hardware simulation (ModelSim) of the FPGA design
  3. The actual implementation (C code, Verilog code). The bitfile was previously compiled, nicknamed, and added to a known file location (/opt/convey/personalties/...).

There are some scripts that can be used to run the various projects.

The runcp (i.e. run coprocessor) script located in the SampleAppVadd can be used to run the application in HW which sets the appropriate environment variables and runs the UserApp.exe:

  ./runcp

The run script located in the SampleAppVadd can be used to run the application using the software simulation of the FPGA design.

  ./run

Using the "-vsim" option, either script can be used to run the application using the hardware simulation (ModelSim). The "-vsim" option sets the environment variable CNY_CAE_EMULATOR to ./run_simulation:

  ./runcp -vsim
      or
  ./run -vsim

To summarize the important environment variables:

Environment Variables Software ModelSim Hardware
CNY_SIM_THREAD libcpSimLib2.so libcpSimLib2.so unset
CNY_CAE_EMULATOR <location for CaeSimPers> ./run_simulation unset

Interactive Mode for ModelSim Simulation

Source: http://www.conveysupport.com/help/?p=215

You can save the waveforms every time you run the hardware simulator to make debugging easier.

Add the $wlfdumpvars line to the sim/tb_user.v file:

// To trace everything (slow)
$wlfdumpvars(0, testbench);
// To trace cae_pers module and 5 levels below
`ifdef AE0_PRESENT
  $wlfdumpvars(5,testbench.cae_fpga0.ae_top.core.cae_pers);

Then include that file in the sim/Makefile by adding this line this line: CNY_PDK_TB_USER_VLOG += ./tb_user.v

This will create a vsim.wlf file in the sim directory. You can view the waveform using any of the following terminal commands:

vsim ../sim/vsim.wlf
vsim -view ../sim/vsim.wlf

Alternatively, you may instead run the simulation in interactive mode by adding the following line to the makefile in the sim directory:

USER_SIM_OPTIONS = -gui

Then run the app (./run -vsim) to start the simulation. When the Modelsim GUI opens and the design is loaded, type “run -all” at the Modelsim command line.