
Simulador funcional de ISA RISC-V com suporte a múltiplas extensões (RV32/64, V, criptografia) com modo de depuração interativo, integração com GDB e modelagem em nível de instrução para codesenvolvimento hardware-software e exploração de arquitetura.
Spike, o Simulador de ISA RISC-V, implementa um modelo funcional de um ou mais harts RISC-V. Recebe o nome do prego dourado usado para celebrar a conclusão da ferrovia transcontinental dos EUA.
O Spike suporta as seguintes funcionalidades da ISA RISC-V:
Os projetos são versionados principalmente para indicar quando a API foi estendida ou tornada incompatível. Nesse espírito, o Spike procura seguir o esquema de versionamento SemVer, no qual os números de versão principal são incrementados quando mudanças de API incompatíveis com versões anteriores são feitas; os números de versão menor são incrementados quando novas APIs são adicionadas; e os números de versão de correção são incrementados quando bugs são corrigidos de forma compatível com versões anteriores.
A principal API pública do Spike é a ISA RISC-V. A interface C++ para os internos do Spike não é considerada uma API pública neste momento, e mudanças incompatíveis com versões anteriores nessa interface serão feitas sem incrementar o número de versão principal.
Assumimos que a variável de ambiente RISCV está definida para o caminho de instalação das ferramentas 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
Se o seu sistema usa o gerenciador de pacotes yum, você pode substituir
yum install dtc pelo primeiro passo.
Você pode pular o segundo passo se não precisar usar a E/S de comando via socket para o modo de depuração interativo.
Instale bash, gmake, dtc e use 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
Instale o spike (veja Build Steps), riscv-gnu-toolchain e riscv-pk.
Escreva um pequeno programa C e nomeie-o hello.c. Em seguida, compile-o em um binário ELF RISC-V chamado hello:
$ riscv64-unknown-elf-gcc -o hello hello.c
Agora você pode simular o programa sobre o proxy kernel:
$ spike pk hello
Adicionar uma instrução ao simulador requer duas etapas:
Descreva o comportamento funcional da instrução no arquivo riscv/insns/<new_instruction_name>.h. Examine outras instruções nesse diretório como ponto de partida.
Adicione o opcode e a máscara de opcode a riscv/opcodes.h. Alternativamente, adicione-a ao pacote riscv-opcodes, e ele fará isso por você:
$ cd ../riscv-opcodes
$ vi opcodes // add a line for the new instruction
$ make install
Adicione a instrução a riscv/riscv.mk.in. Caso contrário, a instrução não será incluída na compilação e será tratada como uma instrução ilegal.
Recompile o simulador.
Para invocar o modo de depuração interativo, inicie o spike com -d:
$ spike -d pk hello
Para ver o conteúdo de um registrador inteiro (0 é para o núcleo 0):
: reg 0 a0
Para ver o conteúdo de um registrador de ponto flutuante:
: fregs 0 ft0
ou:
: fregd 0 ft0
dependendo se você deseja imprimir o registrador como precisão simples ou dupla.
Para ver o conteúdo de um local de memória (endereço físico em hex):
: mem 2020
Para ver o conteúdo da memória com um endereço virtual (0 para o núcleo 0):
: mem 0 2020
Você pode avançar uma instrução pressionando a tecla enter. Você também pode executar até que uma igualdade desejada seja alcançada:
: 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)
Alternativamente, você pode executar enquanto uma igualdade for verdadeira:
: while mem 2020 50a9907311096993
Você pode continuar a execução indefinidamente com:
: r
A qualquer momento durante a execução (mesmo sem -d), você pode entrar no
modo de depuração interativo com <control>-<c>.
Para encerrar a simulação a partir do prompt de depuração, pressione <control>-<c> ou:
: q
Uma alternativa ao modo de depuração interativo é anexar usando gdb. Como o spike tenta ser como hardware real, você também precisa do OpenOCD para fazer isso. Usaremos o seguinte programa de teste:
$ 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;
int main()
{
int i = 0;
while (text[i]) {
char lower = text[i] | 32;
if (lower >= 'a' && lower <= 'm')
text[i] += 13;
else if (lower > 'm' && lower <= 'z')
text[i] -= 13;
i++;
}
done:
printf("decoded text: %s\n", text);
}
$ riscv64-unknown-elf-gcc -g -Og --specs=semihost.specs -o rot13 rot13.c
Para depurar este programa, primeiro execute spike informando-o para escutar o OpenOCD:
$ spike --rbb-port=9824 -m0x10000:0x20000 rot13
Listening for remote bitbang connection on port 9824.
...