Eclipse is an excellent package for code development, especially for Java based projects. For this reason, we have added the capability to develop for the EDIF project from within the Eclipse environment. This document explains the process for checking out the project from CVS and setting it up appropriately for Eclipse development.

Prerequisites

• You must, of course, have the Eclipse project installed. (This document was written using version 3.0.1 of Eclipse, but may work for other versions as well.)
• You must have access to the BYU Configurable Computing Lab CVS repository.

Getting Started

• Open Eclipse.
• Switch the perspective to Java ( Window -> Open Perspective -> Java ).

Create a new project for EDIF

• Create a new project ( File -> New -> Project ).
• From within the project wizard, select Java Project, then Next.
• Enter whatever you want for the project name (e.g. EDIF), then select Finish.
• Create a folder within this new project and name it byucc. To do this, select File -> New -> Folder. Name the folder byucc and set the parent folder to the name of the new project (e.g. EDIF). Select Finish.
• Before doing anything else, highlight the new project from within the Navigator menu, then uncheck Project -> Build Automatically to turn off automatic building. We will turn this back on after we have prepared the EDIF project for building within Eclipse.

Check out EDIF code from CVS

• Select File -> New -> Other...
• From the wizard menu select CVS -> Checkout Projects from CVS and then Next.
• On the next page, select the repository location and select Next. If you do not have this information, please contact a professor of the FPGA Reliability Lab.
• When prompted for the module name, use fpga/byucc/edif. Select Next.
• On the next page, choose Check out into an existing project and then Next.
• Select the byucc folder within the new EDIF project that you have created and select Finish. You should see the EDIF project checking out into the Eclipse workspace.

Prepare EDIF package for building in Eclipse

• Open a terminal window (in Windows, you must use Cygwin).
• Change directories to the location of the eclipse project that you've created.

$ cd ~/workspace/EDIF/byucc/edif

• Set the EDIF environment variable. This should point to [eclipsehome]/EDIF.

$ export EDIF=~/workspace/EDIF

• Ensure that the configure script in byucc/edif is executable.

$ chmod +x configure

• Run the configure script in byucc/edif, being sure to specify the location of the following:
  • javacc
  • jhdl .jar file
  • jsap .jar file
  It will probably look something like this:

$ ./configure --with-javacc=/opt/javacc-4.0/ --with-jhdl=/fpga2/jhdl/release/latest/JHDL.jar --with-jsap=/fpga2/jars/JSAP-2.1.jar

• Run make eclipse. This will prepare the EDIF package for building in Eclipse. Once this has completed, we are done with the terminal.

$ make eclipse

Build project in Eclipse

• In the Eclipse workspace, highlight the newly created project (e.g. EDIF), and then select File -> Refresh.
• Select Project -> Build Automatically. This will turn automatic building back on.
• Everything should build correctly, and you should be set to begin development from within Eclipse.