
Simulateur de jeu d'instructions RISC-V fonctionnel supportant de multiples extensions (RV32/64, V, cryptographie) avec mode de débogage interactif, intégration GDB et modélisation au niveau des instructions pour le co-développement matériel-logiciel et l'exploration d'architecture.
Spike, le simulateur d'ISA RISC-V, implémente un modèle fonctionnel d'un ou plusieurs harts RISC-V. Il est nommé d'après le golden spike utilisé pour célébrer l'achèvement du chemin de fer transcontinental américain.
Spike prend en charge les fonctionnalités d'ISA RISC-V suivantes :
Les projets sont versionnés principalement pour indiquer quand l'API a été étendue ou rendue incompatible. Dans cet esprit, Spike vise à suivre le schéma de versionnage SemVer, dans lequel les numéros de version majeure sont incrémentés lorsque des changements d'API rétro-incompatibles sont effectués ; les numéros de version mineure sont incrémentés lorsque de nouvelles API sont ajoutées ; et les numéros de version de correctif sont incrémentés lorsque des bogues sont corrigés de manière rétro-compatible.
L'API publique principale de Spike est l'ISA RISC-V. L'interface C++ vers les internes de Spike n'est pas considérée comme une API publique pour le moment, et des changements rétro-incompatibles à cette interface seront effectués sans incrémenter le numéro de version majeure.
Nous supposons que la variable d'environnement RISCV est définie sur le chemin d'installation des outils RISC-V.
$ git submodule update --init --recursive
$ apt-get install device-tree-compiler
$ apt-get install libboost-regex-dev libboost-system-dev
$ mkdir build
$ cd build
$ ../configure --prefix=$RISCV
$ make
$ [sudo] make install
Si votre système utilise le gestionnaire de paquets yum, vous pouvez remplacer
la première étape par yum install dtc.
Vous pouvez ignorer la deuxième étape si vous n'avez pas besoin d'utiliser l'I/O de commande via socket pour le mode de débogage interactif.
Installez bash, gmake, dtc et utilisez clang.
$ git submodule update --init --recursive
$ pkg_add bash gmake dtc
$ exec bash
$ export CC=cc; export CXX=c++
$ mkdir build
$ cd build
$ ../configure --prefix=$RISCV
$ gmake
$ [doas] make install
Installez spike (voir Build Steps), riscv-gnu-toolchain et riscv-pk.
Écrivez un court programme C et nommez-le hello.c. Ensuite, compilez-le en un binaire ELF RISC-V nommé hello :
$ riscv64-unknown-elf-gcc -o hello hello.c
Vous pouvez maintenant simuler le programme au-dessus du proxy kernel :
$ spike pk hello
L'ajout d'une instruction au simulateur nécessite deux étapes :
Décrivez le comportement fonctionnel de l'instruction dans le fichier riscv/insns/<new_instruction_name>.h. Examinez d'autres instructions dans ce répertoire comme point de départ.
Ajoutez l'opcode et le masque d'opcode à riscv/opcodes.h. Vous pouvez également l'ajouter au paquet riscv-opcodes, et il le fera pour vous :
$ cd ../riscv-opcodes
$ vi opcodes // add a line for the new instruction
$ make install
Ajoutez l'instruction à riscv/riscv.mk.in. Sinon, l'instruction ne sera pas incluse dans la compilation et sera traitée comme une instruction illégale.
Recompilez le simulateur.
Pour invoquer le mode de débogage interactif, lancez spike avec -d :
$ spike -d pk hello
Pour voir le contenu d'un registre entier (0 correspond au cœur 0) :
: reg 0 a0
Pour voir le contenu d'un registre à virgule flottante :
: fregs 0 ft0
ou :
: fregd 0 ft0
selon que vous souhaitez afficher le registre en simple ou double précision.
Pour voir le contenu d'un emplacement mémoire (adresse physique en hexadécimal) :
: mem 2020
Pour voir le contenu de la mémoire avec une adresse virtuelle (0 correspond au cœur 0) :
: mem 0 2020
Vous pouvez avancer d'une instruction en appuyant sur la touche entrée. Vous pouvez également exécuter jusqu'à atteindre une égalité souhaitée :
: until pc 0 2020 (stop when pc=2020)
: until reg 0 mie a (stop when register mie=0xa)
: until mem 2020 50a9907311096993 (stop when mem[2020]=50a9907311096993)
Alternativement, vous pouvez exécuter tant qu'une égalité est vraie :
: while mem 2020 50a9907311096993
Vous pouvez poursuivre l'exécution indéfiniment avec :
: r
À tout moment pendant l'exécution (même sans -d), vous pouvez entrer dans le
mode de débogage interactif avec <control>-<c>.
Pour terminer la simulation depuis l'invite de débogage, appuyez sur <control>-<c> ou :
: q
Une alternative au mode de débogage interactif consiste à s'attacher avec gdb. Comme spike tente de se comporter comme du matériel réel, vous avez également besoin d'OpenOCD pour cela. Nous utiliserons le programme de test suivant :
$ cat rot13.c
#include <stdio.h>
char text[] = "Vafgehpgvba frgf jnag gb or serr!";
// Don't use the stack, because sp isn't set up.
volatile int wait = 1;