wiki:Howto-TP

Version 41 (modified by franck, 3 years ago) (diff)

--

  1. Étape 1. Création de l'environnement de travail Linux pour les TPs
  2. Étape 2. Installation du simulateur almo1 et de la chaîne de …
    1. Étape 2.1. Vous êtes sur votre ordinateur
    2. Étape 2.2. Vous êtes sur un des ordinateurs de la fac
  3. Étape 3. Test : compilation et exécution d'un test
  4. Remarques générales

Configuration de l'environnement des TP

En TP, vous allez compiler vos programmes pour le MIPS et les exécuter le prototype virtuel du SoC nommé almo1 présenté en cours. almo1 est composé d'un MIPS (il peut en avoir plusieurs mais ici nous n'en utiliserons qu'un seul) et de plusieurs contrôleurs de périphériques (terminal TTY, fenêtre graphique, disques, etc. Le simulateur d'almo1 se présente sous la forme d'un exécutable qui simule son comportement. Le (ou les) MIPS présents exécutent les programmes se trouvant dans les bancs de mémoire d'almo1. La simulation est complète depuis le signal reset et précise au cycle et au bit (cela signifie que si c'était une vraie machine, vous auriez exactement le même comportement de vos programmes).
Pour exécuter le simulateur d'almo1, vous devez disposer d'un ordinateur réel ou virtuel sur Linux. Cette page décrit comment installer votre environnement de travail.

Il y a plusieurs cas de figure:

  1. Si vous travaillez dans les salles de TP de la PPTI ⟶ faites les étapes 2.2 et 3.
  2. Vous êtes sur votre ordinateur personnel sur Windows ou macOS ⟶ faites les étapes 1, 2.1 et 3.
  3. Vous êtes sur une distribution Linux ou si vous avez déjà une VM Linux ⟶ faites les étapes 2.1 et 3.
    Notez que si vous suivez l'UE réseau, vous devriez déjà avoir l'application ​VirtualBox et une VM installée en état de marche, cette VM fonctionne pour l'UE d'Archi. Sinon, nous vous avons préparé une machine virtuelle utilisant VirtualBox et une distribution LinuxMint.

Étape 1. Création de l'environnement de travail Linux pour les TPs

Installation d'une machine virtuelle

Configurations utiles

  • Loguez-vous sur votre Linux (soit en natif, soit sur votre VM habituelle, soit sur celle que vous venez juste d'installer)
  • Si c'est la VM que vous venez d'installer, vous devez sans doute changer le configuration par défaut :
    • Configuration du Clavier :
      La VM a été paramétrée pour un clavier PC-AZERTY. Si ce n'est pas votre clavier, vous devez changer.
      • Cliquez sur l'icône Keyboard présente sur le Bureau de la VM → Une fenêtre apparaît
      • Cliquez l'onglet Layout → par défaut Keyboard Model = Generic 105-key (PC) et Keyboard Layout = French AZERTY
        • Keyboard Model devrait convenir au plus grand nombre, sinon sélectionner le vôtre.
        • Keyboard Layout est une liste de claviers et c'est le premier de cette liste qui est utilisé.
          Si votre clavier n'est pas dans cette liste :
          • Cliquez sur Add, sélectionner votre clavier et cliquez sur ok
          • Le nouveau clavier apparaît en fin de liste.
          • Utilisez les flèches à droite de cette liste pour mettre votre clavier en tête de liste.
      • Cliquez sur Close pour fermer l'application Keyboard et tester que cela fonctionne, sinon recommencez.
    • Configuration du presse papier partagé :
      Vous pouvez autoriser le partage du presse papier (crtl-C/ctrl-V) entre la machine hôte (Windows ou macOS) et la VM
      • Allez sur la fenêtre du gestionnaire de VM (d'où vous avez lancé votre VM)
        • Cliquez sur Général → la fenêtre de configuration de la VM apparaît
        • Cliquez sur l'onglet Avancé → Une fenêtre apparaît avec deux menus déroulants
          • Sur le menu déroulant : Presse-papier partagé sélectionnez Bidirectionnel
            → vous pourrez faire un ctrl-C (ou cmd-C) sur la machine hôte et un ctrl-V (ou cmd-V) sur la machine invitée et inversement.
          • Sur le menu déroulant : Glisser-Déposer sélectionnez Bidirectionnel
            → vous pourrez faire un « Drag & Drop » entre la machine hôte et la VM (dans les deux sens).

Étape 2. Installation du simulateur almo1 et de la chaîne de compilation pour MIPS

Étape 2.1. Vous êtes sur votre ordinateur

  • Démarrez la machine virtuelle (ou réelle si vous êtes nativement sur Linux)
  • Dans le cas où vous êtes sur votre propre VM ou distribution (et non celle que nous vous proposons), vous devez commencez par vérifier que vous avez l'application xterm sur votre distribution Linux. xterm est le terminal de commande que va utiliser almo1 pour les TTY et xterm n'est pas toujours installé par défaut.
    • Si vous ne l'avez pas vous devez l'installer avec sudo apt-get install xterm
      (si vous êtes sur une distribution debian ou ses dérivés : ubuntu, linux-mint, etc.)
  • Démarrez un navigateur web sur votre Linux et chargez la page de l'UE : https://frama.link/AS5 (c'est un raccourci de l'​URL de la page que vous êtes en train de lire https://www-soc.lip6.fr/trac/archi-l3s5/wiki/Howto-TP)
  • Récupérez l'archive contenant le simulateur `almo1` et la chaîne de compilation pour MIPS (en cliquant sur ce lien)
  • Placez l'archive à la racine de votre compte et ouvrez un terminal
  • Décompressez l'archive avec la commande : tar xvf K6bin.tgz à la racine de votre compte. K6 est le nom que nous avons donné au petit système d'exploitation s'exécutant sur almo1
  • Si vous avez bien placé l'archive à la racine de votre compte, déplacez-vous dans le répertoire K6 : cd $HOME/K6
  • Éditez le fichier $HOME/.bashrc et ajoutez au début source $HOME/K6/bin/Source-me.sh. Ce script modifie quelques variables d'environnement telle que PATH qui permet de définir les répertoires dans lesquels le shell bash trouve ses exécutables (ici la chaîne de compilation pour le MIPS et le simulateur almo1.
  • Exécutez pour cette fois le .bashrc (parce que vous venez juste de le modifier) en tapant source $HOME/.bashrc. Vous pouvez aussi ouvrir un nouveau terminal, celui-ci exécutera le script .bashrc avant d'afficher le prompt (l'invite de commande en français).
  • Vous pouvez placer le répertoire K6 ailleurs qu'à la racine, voire le renommer, mais pour que cela fonctionne vous devez éditer la première ligne du fichier K6/bin/Source-me.sh, toutefois dans les textes des TP, nous ferons l'hypothèse que le répertoire K6 est la racine du compte.

Étape 2.2. Vous êtes sur un des ordinateurs de la fac

  • Éditez votre fichier $HOME/.bashrc et ajoutez au début:
    source /Infos/lmd/2021/licence/ue/LU3IN029-2021oct/K6/bin/Source-me.sh
    Ce script modifie quelques variables d'environnement telle que PATH qui permet de définir les répertoires dans lesquels le shell bash trouve ses exécutables (ici la chaîne de compilation pour le MIPS et le simulateur almo1.
  • Exécutez pour cette fois le .bashrc (parce que vous venez juste de le modifier)
    source $HOME/.bashrc
    Vous pouvez aussi ouvrir un nouveau terminal, celui-ci exécutera le script .bashrc avant d'afficher le prompt (l'invite de commande en français).

Étape 3. Test : compilation et exécution d'un test

  • Si vous
  • cette partie doit être changé pour le cas où on est sur une machine de l'ARI
    Allez dans le répertoire test du répertoire bin:
    cd $HOME/AS5/bin/test; make exec
  • Si cela fonctionne, vous devez voir :
    • dans le terminal où vous avez lancé la commande précédente la bannière du simulateur du prototype SystemCASS puis des informations sans importance. Vous devez aussi voir un compteur d'horloge qui s'incrémente tous les millions de cycles.
    • vous devez voir une fenêtre en haut à gauche avec marqué "Hello World!"
      Ce message est écrit par le programme qui s'exécute sur le MIPS.
    • Pour arrêter la simulation, tapez ctrl-C sur le terminal de lancement du simulateur.
  • Si cela ne fonctionne pas :
    • peut-être n'avez-vous pas placé le répertoire AS5 à la racine de votre compte.
      Vous avez le droit, mais vous devez modifier la première ligne du fichier AS5/bin/Source-me.sh et indiquer le bon répertoire.
    • peut-être n'avez-vous pas sourcer le fichier AS5/bin/Source-me.sh.
      Vous pouvez le vérifier en tapant la commande cd;almo1.x
      Si le shell vous répond command not found ou commande inconnue, c'est que vous n'avez pas sourcé le fichier bin/Source-me.sh.

Remarques générales

  • Utilisez un vrai éditeur de code moderne, tel que code (Visual Studio Code) (ou [g]vim, [x]emacs ou sublime-text) afin de profiter d'une aide à la programmation avec, par exemple, des fenêtres popup pour les prototypes. code est installé sur la VM LinuxMint. Si vous utilisez votre propre VM, je vous conseille de l'installer.
  • Vous allez devoir utiliser l'interpréteur de commande shell de Linux et quelques commandes. Si vous avez l'habitude d'utiliser la souris, il va falloir vous faire un peu violence, mais dîtes-vous que c'est pour votre bien! Vous devrez parfois utiliser des commandes que vous ne connaissez pas, soyez curieux et tentez un man sur la commande (ou une recherche sur le web, c'est bien aussi).