
Функциональный симулятор ISA RISC-V, поддерживающий множество расширений (RV32/64, V, криптография) с интерактивным режимом отладки, интеграцией GDB и моделированием на уровне инструкций для совместной разработки аппаратного и программного обеспечения и исследования архитектуры.
Spike, симулятор RISC-V ISA, реализует функциональную модель одного или нескольких RISC-V hart. Он назван в честь золотого костыля, использовавшегося для празднования завершения строительства трансконтинентальной железной дороги США.
Spike поддерживает следующие возможности RISC-V ISA:
Проекты версионируются в первую очередь для того, чтобы указать, когда API был расширен или стал несовместимым. В этом духе Spike стремится следовать схеме версионирования SemVer, в которой номера мажорных версий увеличиваются при внесении обратно несовместимых изменений API; номера минорных версий увеличиваются при добавлении новых API; а номера патч-версий увеличиваются при исправлении ошибок обратно совместимым образом.
Основным публичным API Spike является RISC-V ISA. C++-интерфейс к внутренностям Spike в настоящее время не считается публичным API, и обратно несовместимые изменения этого интерфейса будут вноситься без увеличения номера мажорной версии.
Мы предполагаем, что переменная окружения RISCV установлена в путь установки инструментов 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
Если в вашей системе используется менеджер пакетов yum, вы можете заменить
первый шаг на yum install dtc.
Вы можете пропустить второй шаг, если вам не нужно использовать командный ввод-вывод через сокет для интерактивного режима отладки.
Установите bash, gmake, dtc и используйте 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
Установите spike (см. раздел «Шаги сборки»), riscv-gnu-toolchain и riscv-pk.
Напишите короткую программу на C и назовите её hello.c. Затем скомпилируйте её в ELF-бинарник RISC-V с именем hello:
$ riscv64-unknown-elf-gcc -o hello hello.c
Теперь вы можете симулировать программу поверх прокси-ядра:
$ spike pk hello
Добавление инструкции в симулятор требует двух шагов:
Опишите функциональное поведение инструкции в файле riscv/insns/<new_instruction_name>.h. Изучите другие инструкции в этом каталоге в качестве отправной точки.
Добавьте код операции и маску кода операции в riscv/opcodes.h. В качестве альтернативы добавьте её в пакет riscv-opcodes, и он сделает это за вас:
$ cd ../riscv-opcodes
$ vi opcodes // add a line for the new instruction
$ make install
Добавьте инструкцию в riscv/riscv.mk.in. В противном случае инструкция не будет включена в сборку и будет рассматриваться как недопустимая инструкция.
Пересоберите симулятор.
Чтобы вызвать интерактивный режим отладки, запустите spike с параметром -d:
$ spike -d pk hello
Чтобы увидеть содержимое целочисленного регистра (0 — для ядра 0):
: reg 0 a0
Чтобы увидеть содержимое регистра с плавающей точкой:
: fregs 0 ft0
или:
: fregd 0 ft0
в зависимости от того, хотите ли вы вывести регистр в одинарной или двойной точности.
Чтобы увидеть содержимое ячейки памяти (физический адрес в шестнадцатеричном виде):
: mem 2020
Чтобы увидеть содержимое памяти по виртуальному адресу (0 — для ядра 0):
: mem 0 2020
Вы можете продвинуться на одну инструкцию, нажав клавишу Enter. Вы также можете выполнять до достижения нужного равенства:
: 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)
В качестве альтернативы вы можете выполнять, пока равенство истинно:
: while mem 2020 50a9907311096993
Вы можете продолжать выполнение бесконечно с помощью:
: r
В любой момент во время выполнения (даже без -d) вы можете войти в
интерактивный режим отладки с помощью <control>-<c>.
Чтобы завершить симуляцию из приглашения отладчика, нажмите <control>-<c> или:
: q
Альтернативой интерактивному режиму отладки является подключение с помощью gdb. Поскольку spike старается вести себя как реальное оборудование, для этого вам также нужен OpenOCD. Мы будем использовать следующую тестовую программу:
$ 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