Installation (Windows)

System Configuration

TaskMapper is developed in Java, and needs the java runtime (version 5 or above). TaskMapper can be used with Unix or Windows system.

The design software suite from altera, has to be installed, ie Quartus II, SoPC Builder and Nios2 IDE (version 6.1 was used while designing TaskMapper), with the correct licences.

In order to communicate with the Altera DE2 card, the softwares have to be configured.

The file run.bat

The file run.bat allows to configure the environment, particulary the PATH variable, before running TaskMapper. Indeed, the whole Altera suite has to be accessible. So the paths to the binaries has to be added in the PATH variable. The file run.bat can be found in the root directory of TaskMapper. It has to be edited if the paths are not correct.

NB : it is possible to change the java's path.

List of variables :

• QUARTUS_ROOTDIR : quartus path
• SOPC_KIT_NIOS2 : nios2 path
• SOPC_BUILDER_PATH : components path (default : %SOPC_KIT_NIOS2%)
• LM_LICENSE_FILE : quartus licence file (%QUARTUS_ROOTDIR%\License.dat)
• QUARTUS_CYGWIN_BASH_DIR : cygwin's bash path (%QUARTUS_ROOTDIR%\bin\cygwin\bin)

List of binaries :

• quartus_cmd : %QUARTUS_ROOTDIR%\bin
• sopc_builder : %SOPC_BUILDER_PATH%\bin
• nios2-create-application-project : %SOPC_KIT_NIOS2%\bin
  (and nios2-build-project, nios2-delete-project, nios2-configure-sof, nios2-download, nios2-terminal)
• nios2-elf-objcopy : %SOPC_KIT_NIOS2%\bin\nios2-gnutools\H-i686-pc-cygwin\bin
• bash : %QUARTUS_CYGWIN_BASH_DIR%
• nios2_sdk_shell_bashrc : %SOPC_KIT_NIOS2%

@echo off

rem Configures environment
set QUARTUS_ROOTDIR=C:\altera\61\quartus
set SOPC_KIT_NIOS2=C:\altera\61\nios2eds
set LM_LICENSE_FILE=%QUARTUS_ROOTDIR%\license.dat
set SOPC_BUILDER_PATH=%SOPC_KIT_NIOS2%
set QUARTUS_CYGWIN_BASH_DIR=%QUARTUS_ROOTDIR%\bin\cygwin\bin

rem Configures path
PATH=%PATH%:%QUARTUS_ROOTDIR%\bin
PATH=%PATH%:%QUARTUS_ROOTDIR%\sopc_builder\bin
PATH=%PATH%:%SOPC_KIT_NIOS2%\bin
PATH=%PATH%:%SOPC_KIT_NIOS2%\bin\nios2-gnutools\H-i686-pc-cygwin\bin

rem Configures java 
set java=java

rem Run TaskMapper
%java% -jar TaskMapper.jar

run.bat_irisa

The file commands.bat

The file commands.bat allows the execution of Unix commands on Windows system, using the cygwin's bash from quartus installation. This bash needs a configuration file to use correctly the Altera suite. It is the file nios2_sdk_shell_bashrc in the nios2 root path.

@echo off

%QUARTUS_CYGWIN_BASH_DIR%\bash.exe --rcfile %SOPC_KIT_NIOS2%\nios2_sdk_shell_bashrc -i -c "./commands.bash"

exit

commands.bat_irisa

JTAG Configuration

Then the access to the Altera DE2 card has to be configured. The card is accessed using a JTAG serveur. The client status is consultable with the jtagconfig command from cygwin bash.

The JTAG parameters can be found by clicking on the "Hardware Setup" button in the programmer.

jtagconfig

In this example, the card is on the PORQUEROLLES' USB port. It is in the first position, so the Card Number value in TaskMapper has to be set to 1.

Remote access to DE2 card

It is possible to remote access to a DE2 card (to configure it and run applications). To get there you have to start Quartus II, then the "program", then:

• Click on Hardware Setup
• Select JTAG settings tab
• Click on Add Server...
• Enter the server address and password
• The list show the new line with status OK

Setup TaskMapper

Once the system is OK, then TaskMapper can be installed.

Taskmapper can be downloaded in a .zip archive. The first step is to decompress the archive, using Winrar, Winzip, or whatever...

Then, TaskMapper can be ran by double clicking on the file run.bat (make sure it has been correctly edited) :