Using Xilinx ISE WebPack IDE With Digilent Basys2

Prologue:
Presently the bulk of our focus has laid in configuring a Linux machine to have the capacity to act as a development environment for the Digilent Basys2 Development board. In this document we will walk through the process of loading the basic default program into the Basys2 board.

This document assumes that you’ve erased your Basys2’s Electrically Erasable Programmable Read Only Memory (EEPROM) data or is running some design other than the design shipped with the Basys2. If this is not the case, to ensure that the Basys2 is erased you may execute the following while your Basys2 is connected via USB and is TURNED ON (make sure the power switch is in the ON position):

djtgcfg erase -d Basys2 -i 1

Instructions:
First and foremost we must start the Xilinx ISE WebPack Integrated Development Environment (IDE). To do so, assuming you have used the default installation path, you may execute (similar for different versions) the following:

cd /opt/Xilinx/13.3/ISE_DS/ISE/bin/lin/
./ise &

Minimizing the IDE and opening a web browser, we may goto the following location: http://www.digilentinc.com/Products/Detail.cfm?NavPath=2,400,790&Prod=BASYS2

Locate the “Basys2 User Demo project” and download it.

In a terminal you may unzip the downloaded file using the unzip program:

unzip Basys2UserDemo.zip

This creates a pdf and a folder “Basys2UserDemo”. Let’s give focus back to the ISE WebPack IDE (Maximize it) and then select:

1. File -> Open Project
1. Browse to the unzipped folder location / “UncompiledBasys2UserDemo”
2. Change “Files of Type” from “ISE Project Files (*.xise)” to “Old ISE Project Files (*.ise)”
3. Select “Basys2UserDemo.ise” and Click “Open”
4. When prompted to to mirgate the project, Click “Migrate Only”
2. On the left there is a “Panel” called “Design” this may be toggled using “View -> Panels -> Design” though we will ensure this is checked and visible.
3. Identify the Basys2UserDemo - Stuctural node in the Design Panel “Hierarchy,” select it and then right click on it.
4. Select “Design Properties...”
5. Ensure the following:
1. Top-Level Source type: “HDL”
2. Evaluation Development Board: “None Specified”
3. Product Category: “All”
4. Family: “Spartan 3E”
5. Select “Device” to match if you have a 100K die or 250K die, 100K dies use XC3S100E and 250K dies use XC3S250E
6. Package: “CP132”
7. Speed: “-5”
8. Click “OK”
6. Identify the Basys2UserDemo - Stuctural node in the Design Panel “Hierarchy,” select it and then right click on it.
7. Select “Implement Top-Module”
8. Wait until all processing is complete...
9. Identify “Generate Programming File” in the Design Panel under “Processes: Basys2UserDemo”, right click and select “Process Properties”
1. Select “Startup Options” Category
2. Ensure:
1. FPGA Start-Up Clock: “JTAG Clock”
2. Click “OK”
10. Identify “Generate Programming File” in the Design Panel under “Processes: Basys2UserDemo”, right click and select “Run”
1. This Generates a .BIT file which can be used to program the FPGA.
11. From a terminal enter into the location enter the Basys2UserDemo/UncompiledBasys2UserDemo” folder and execute the following
1. djtgcfg prog -d Basys2 -i 0 -f Basys2UserDemo.bit
2. -i 0 : is the FPGA’s Random Access memory (RAM), this will not permanently load the User Demo to the Board.
3. (Read the “Linux: Getting Started, Using Digilent Adept 2“ for more information if necessary)

Congratulations you should now have the user demo running on your Basys2! To Confirm this the 7-Segment displays on the bottom of the Basys2 will be counting from 0 to F in Hexadecimal and repeat.

Installing Digilent Adept 2 on Linux Workstations

So in my previous post I walk through the somewhat long, boring, but important steps, for installing the Xilinx ISE WebPack software. This is the software used for creating hardware designs, compiling them, optimizing them, routing them, and eventually it spits out a '.bit' file.


So in theory, once you've compiled a design, or have a .bit file for your particular Field Programmable Gate Array (FPGA) or Complex Programmable Logic Device (CPLD), you'll be ready to load it onto your device of choice! To do these we use Digilent Adept 2.


Digilent Adept 2: The Adept Runtime & Utilities consists of the shared libraries, firmware images, and configuration files necessary to communicate with Digilent's devices.

1. Goto: http://www.digilentinc.com/Products/Detail.cfm?Prod=ADEPT2 and download the Run time software for your Linux architecture (32 or 64 bit)
2. Decompress the downloaded file, this requires gzip
1. eg. “gzip -d digilent.adept.runtime_2.8.2-i686.tar.gz”
3. Untar the the decompressed file, this requires tar
1. eg. “tar -xvf digilent.adept.runtime_2.8.2-i686.tar”
4. Enter the directory which contains the run time installer
5. *Execute the install.sh script, this will require superuser privileges (speak with your system administrator)
1. eg. “sudo ./install.sh”
2. Press [enter], press [Enter]

*As of this writing the Digilent Adept 2 runtime install.sh encounters an error on 3.x.x kernels that use udev. It should be fixed soon.

1. Goto: http://www.digilentinc.com/Products/Detail.cfm?Prod=ADEPT2 and downlaod the Utilities software for your Linux architecture(32 or 64 bit)
2. Decompress the downloaded file, this requires gzip
1. eg. “gzip -d digilent.adept.utilities_2.1.1-i686.tar.gz”
3. Untar the decompressed file, this requires tar
1. eg. “tar -xvf digilent.adept.utilities_2.1.1-i686.tar”
4. Enter the directory which contains the utilities installer
5. Execute the install.sh script, this will require superuser privileges (speak with your system administrator)
1. eg. “sudo ./install.sh”
2. Press [enter], press [Enter]

I use a Digilent Basys 2 Development Board because it's cheap enough for me to afford, I also have a C-MOD which I have not used yet but will likely utilize at sometime this year. If you've done both the ISE WebPack install and the Adept 2 installation you should now have the necessary software to load new designs to devices of your choice!