Installation (Windows)

Configuration du système

TaskMapper est développé en Java, et requiert le java runtime (version 5 ou plus). TaskMapper peut être utilisé sur un système Unix ou Windows.

Ce système doit être équipé de la suite de développement Altera c'est à dire Quartus II, SoPC Builder, Nios2 IDE (utilisés dans la version 6.1 lors de la conception), avec les licences nécessaires.

Afin d'accéder à la carte Altera DE2, il faut préalablement spécifier l'accès aux outils Altera, et les configurer correctement.

Le fichier run.bat

Le fichier run.bat permet de configurer l'environnement, en particulier la variable PATH, avant de lancer TaskMapper. En effet, il faut que l'ensemble des exécutables de la suite Altera soit accessible. Pour y parvenir, il faut modifier la variable PATH et y ajouter les chemins d'accès des exécutables. Le fichier run.bat est dans la racine du répertoire d'installation de TaskMapper. Il faut le modifier si les chemins de correspondent pas (et c'est très certainement le cas).

NB : Il est aussi possible de modifier le chemin d'accès à Java.

Liste des variables :

• QUARTUS_ROOTDIR : chemin d'accès au répertoire quartus
• SOPC_KIT_NIOS2 : chemin d'accès au répertoire nios2
• SOPC_BUILDER_PATH : chemin d'accès vers les composants (%SOPC_KIT_NIOS2% pour le nios2)
• LM_LICENSE_FILE : fichier de licence quartus (%QUARTUS_ROOTDIR%\License.dat)
• QUARTUS_CYGWIN_BASH_DIR : chemin d'accès vers le bash cygwin (%QUARTUS_ROOTDIR%\bin\cygwin\bin)

Liste des exécutables utilisés :

• quartus_cmd : %QUARTUS_ROOTDIR%\bin
• sopc_builder : %SOPC_BUILDER_PATH%\bin
• nios2-create-application-project : %SOPC_KIT_NIOS2%\bin
  (Ainsi que 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 Configure java 
set java=java

rem Run TaskMapper
%java% -jar TaskMapper.jar

run.bat_irisa

Le fichier commands.bat

Le fichier commands.bat permet d'exécuter des commandes Unix sur un système Windows en utilisant le bash cygwin fournit par quartus. Ce dernier a besoin d'un fichier de configuration pour pouvoir utiliser correctement les outils Altera. C'est le fichier nios2_sdk_shell_bashrc situé dans le répertoire nios2.

@echo off

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

exit

commands.bat_irisa

Configuration JTAG

Il faut ensuite configurer l'accès à la carte Altera DE2. L'accès se fait via un serveur JTAG. L'état du client est consultable via la commande jtagconfig du bash cygwin.

Les paramètres JTAG sont accessibles via le bouton "Hardware Setup" du programmer.

jtagconfig

Dans l'exemple suivant, la carte est branchée sur le port USB de la machine PORQUEROLLES. Elle est en première position dans la liste. Il faudra donc mettre la valeur 1 dans le champ Card Number de l'application TaskMapper.

Utilisation à distance de la carte DE2

Il est possible d'accéder à distance à une carte DE2 (pour la configurer, et exécuter un programme). Pour y accéder il faut lancer Quartus II, puis le "programmer", ensuite :

• Cliquer sur Hardware Setup.
• Sélectionner l'onglet JTAG settings.
• Cliquer sur add server.
• Dans la champs "server name" et "password" entrez l'adresse du serveur JTAG, et le mot de passe.
• Vérifiez que la liste des JTAG server contient la nouvelle ligne avec un statut de connexion à OK.

Installation de TaskMapper

Une fois le système préparé, il faut installer TaskMapper ...

TaskMapper est fournit en .jar, dans une archive .zip, accompagé des fichiers génériques. Tout d'abord il faut décompresser le fichier .zip grâce à un décompresseur (il y en a un fournit de base avec Windows XP, ici sont visibles Winrar et Winzip) :

Ensuite, il faut lancer TaskMapper grâce à Java (après avoir modifié le fichier run.bat, ou configuré l'environnement) en double cliquant sur le fichier run.bat :