Certains outils sont nécessaires afin de pouvoir réaliser et tester des designs en Chisel. Les commandes ci-dessous sont valables pour Ubuntu, pour plus d'informations voir la page d'installation de Chisel. Tout d'abord Java:
sudo apt-get install default-jdk
Ensuite l'outil sbt:
echo "deb https://dl.bintray.com/sbt/debian /" | sudo tee -a /etc/apt/sources.list.d/sbt.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 642AC823
sudo apt-get update
sudo apt-get install sbt
Enfin, GtkWave pour visualiser les chronogrammes:
sudo apt-get install gtkwave
- src/main/scala: contient les fichiers source Chisel des designs.
- src/test/scala: contient les fichiers source Chisel des tests.
- build.sbt: fichier de configuration de l'outil sbt.
Un exemple de module nommé Adder est présent dans le fichier src/main/scala/adder/adder.scala. Pour générer le Verilog correspondant, le format de la commande du terminal est le suivant:
sbt "runMain <nom-librairie>.<nom-design> --target-dir <destination>"
--target-dir esy une option permettant de choisir le répertoire où sera généré le module Verilog correspondant. Dans l'exemple Adder, il est possible de générer le module Verilog avec la commande suivante:
sbt "runMain fpu.example.Adder --target-dir output"
Dans le répertoire output/, on trouve alors un fichier Adder.v correspondant au module décrit dans le fichier Chisel.
De la même manière qu'en Verilog ou VHDL, le langage contient des commandes dédiées pour réaliser des testbenchs. Deux exemples existent ici pour le module Adder dans src/test/scala/adder/test0.scala et src/test/scala/adder/test1.scala. Il est possible d'exécuter individuellement un test avec la commande suivante:
sbt "test:runMain <nom-librairie>.<nom-test> --target-dir <destination>"
Dans l'exemple Adder, on a donc le choix entre deux tests différents:
sbt "test:runMain fpu.example.AdderTest0 --target-dir output"
sbt "test:runMain fpu.example.AdderTest1 --target-dir output"
On retrouve alors les résultats dans le répertoire output/. Les chronogrammes correspondants à chaque test se trouvent dans des fichiers .vcd. Pour les visualiser, il est alors nécessaire d'utiliser l'outil GtkWave:
gtkwave <chemin-vcd>/<fichier>.vcd
Le Chisel fournit également une infrastructure pour effectuer des tests unitaires. Cela permet donc de lancer rapidement l'ensemble des tests et de s'assurer que tout fonctionne correctement après une modification. Le format de la commande est le suivant:
testOnly <nom-librairie>.<nom-test-unitaire>"
Dans le cas de l'exemple Adder, la structure est décrite dans src/test/scala/adder/unit.scala. Pour lancer l'exécution des tests, il faut alors utiliser la commande suivante:
testOnly fpu.example.UnitTester"
Ici, le répertoire de destination output est spécifié directement dans le fichier. On retrouve ensuite dans le terminal le résultat des différents tests.
- Langage Chisel :
- FPU et RISC-V:
- Norme IEEE
- Spécification RISC-V
- Livre architecture: Computer Organization and Design RISC-V Edition