|
|
(56 intermediate revisions by 4 users not shown) |
Line 9: |
Line 9: |
| }} | | }} |
|
| |
|
| === Connecting to the Convey HC-1 Machine === | | == Subversion == |
| # Download and install [http://www.nomachine.com/download.php NX Client].
| | You can checkout the source for our projects using the subversion repository below. Use your ISU NetID as both your username and password: |
| # Connect to convey-1.ece.iastate.edu using your ISU NetID and the password ''yournetid''@123.
| | svn co http://svn.chaddington.com/cpre584 |
| # Change your password by opening a terminal window and running the '''passwd''' command.
| |
|
| |
|
| You can access the shared /home/cpre584_t2 folder by using the '''su cpre584_t2''' command and entering our team password.<br> Alternatively, you can access the two files Jone's created for us on the shared folders here on the wiki:
| | == Updating the UserApp for Sobel == |
| # Setup your Convey environmental variables ([[media:Setconveyenv.txt |Jone's Script]])
| | [[Team Gryffindor - Sobel Source Code]] |
| # Here's a copy of the Xilinx 11.1 src file:
| |
| | |
| source /remote/Xilinx/11.1/settings64.sh<br>
| |
| export PATH=$PATH:/remote/Modelsim/6.4b/modeltech/linux_x86_64/<br>
| |
| export LM_LICENSE_FILE=1717@io.ece.iastate.edu:27006@io.ece.iastate.edu
| |
| | |
| == Assignment #1 ==
| |
| Review Convey System
| |
| * Minimum
| |
| ** Review architecture documentation
| |
| ** Understand how Vector Adder example works
| |
| ** Implement Vector Adder example (SW, Modelsim, HW)
| |
| * Extra 1: Own simple personality (min: simple mod to Adder)
| |
| * Extra 2: Explore other features
| |
| ** e.g: using gdb (Gnu Debugger)
| |
| ** e.g: SPAT (Simulator Performance Analysis Tool)
| |
| | |
| '''REMEMBER:''' There are three steps to running your FPGA design:
| |
| # Run on software
| |
| # Run on the Coprocessor simulator
| |
| # Run on the fabric
| |
| | |
| === Jone's E-mail ===
| |
| Once you log into the convey machine a few documents you will want to start looking through are bellow. Note, there is a lot of detail to learn about the Convey system. I would first suggest browsing through the document below to get a feel for the type of information they contain. I’ve try to highlight some of the sections that will be useful to you and you are getting up to speed with the example application.
| |
|
| |
| * /opt/convey/pdk/2010_08_09/doc/ConveyPDKReferenceManual.pdf
| |
| ** [[Media:ConveyPDKReferenceManual.pdf | Convey PDK Reference Manual (.pdf)]]
| |
| ** This document gives information about how to go about developing your own HW/SW designs on the convey system.
| |
| ** Start with section 10.5 to quickly start playing with the system. Then use the rest of Section 10 to help you understand the example C code.
| |
| ** You will need to read through of other sections of this document to understand how the overall system works.
| |
| | |
| * /opt/convey/doc/ConveyProgrammersGuide.pdf
| |
| ** [[Media:ConveyProgrammersGuide.pdf | Convey Programmers Guide (.pdf)]]
| |
| ** Sections 8.1 and 8.2 gives more details on how to run an application (in SW, Simulation, or Hardware)
| |
| ** Section 10.2, give more details on the assembly portions of the sample application from the PDK manual.
| |
| ** Chapter 1 and 2 give overview info
| |
| ** Chapter 12 talks about Environmental flags
| |
| ** Chapter 14 talks about the Personality naming conventions.
| |
| | |
| * /opt/convey/doc/ConveyReferenceManual.pdf
| |
| ** [[Media:ConveyReferenceManual.pdf | Convey Reference Manual (.pdf)]]
| |
| ** Chapters 1 and 2: Basic Overview
| |
| ** Chapter 11: Details on personality structure.
| |
| | |
| * [[Media:Convey PDK Training.pdf | Convey PDK (.pdf)]]
| |
| * [[Media:Convey Overview.pdf | Convey Overview (.pdf)]]
| |
| | |
| === Running the Software ===
| |
| Section 10.5 of PDK Reference Manual explains how to run the sample software application. It has been reproduced below in brief.
| |
| | |
| The rev version installed on the Convey machine is from 2010-8-9; to copy the sample app run:
| |
| cd ~
| |
| mkdir pdk_sample
| |
| cp -r /opt/convey/pdk/2010_08_09/cae_pers_vadd pdk_sample
| |
| cp -r /opt/convey/pdk/2010_08_09/pdk_apps/SampleAppVadd pdk_sample
| |
| | |
| To make the sample project.
| |
| | |
| cd ~/pdk_sample/cae_pers_vadd/CaeSimPers/
| |
| make
| |
| cd ~/pdk_sample/SampleAppVadd/
| |
| make
| |
| | |
| You'll want to make sure that you haven't set your environmental variables. You can do this by simply using a new terminal window. To run the software version of the app:
| |
| cd ~/pdk_sample/SampleAppVadd/
| |
| ./UserApp.exe
| |
| | |
| You should see the program run and output the following:
| |
| | |
| [[Image:Assignment1.software.PNG]] | |
| | |
| === Running in the Simulator ===
| |
| To run the sample application on the Coprocessor simulator, you'll need to set some environmental variables. Dr. Jone's has included these in a script, but they are reproduced below:
| |
| | |
| # General envs to setup
| |
| export CNY_PDK=/opt/convey/pdk
| |
| export CNY_PDK_REV=2010_08_09
| |
| export CNY_PDK_HDLSIM=Mentor
| |
| export CNY_PDK_SIMMODE=64
| |
| | |
| # Use the Coprocessor Simulator
| |
| export CNY_SIM_THREAD=libcpSimLib2.so
| |
| | |
| # Software Emulation
| |
| export CNY_CAE_EMULATOR=~/pdk_sample/cae_pers_vadd/CaeSimPers/CaeSimPers
| |
| | |
| After setting the environmental variables, rerun the app:
| |
| | |
| cd ~/pdk_sample/SampleAppVadd/
| |
| ./UserApp.exe
| |
| | |
| The program will pause at the following screen for a 10-20 seconds...
| |
| | |
| [[Image:Assignment1.simulator1.PNG]]
| |
| | |
| ...and then finish running the program.
| |
| | |
| [[Image:Assignment1.simulator2.PNG]]
| |
| | |
| TODO (figure out why an error occurs when using the modelsim simulator... ?)
| |
| | |
| === Running in the Fabric ===
| |
| Make sure the CNY_SIM_THREAD env variable is unset (otherwise the thread will run on the simulator):
| |
| | |
| env | grep "CNY"
| |
| export CNY_SIM_THREAD=
| |
| | |
| TODO
| |
Subversion
You can checkout the source for our projects using the subversion repository below. Use your ISU NetID as both your username and password:
svn co http://svn.chaddington.com/cpre584
Updating the UserApp for Sobel
Team Gryffindor - Sobel Source Code