
機能的なRISC-V ISAシミュレータで、複数の拡張機能(RV32/64、V、暗号)をサポートし、インタラクティブデバッグモード、GDB統合、命令レベルのモデリングを備え、ハードウェア・ソフトウェアの共同開発やアーキテクチャ探索に利用できます。
SpikeはRISC-V ISAシミュレータであり、1つ以上のRISC-Vハートの機能モデルを実装しています。その名前は、アメリカ大陸横断鉄道の完成を祝うために打ち込まれたゴールデンスパイクに由来しています。
Spikeは以下のRISC-V ISA機能をサポートしています:
プロジェクトのバージョン管理は主に、APIが拡張されたとき、または互換性がなくなったときを示すために行われます。その趣旨に基づき、SpikeはSemVerバージョニングスキームに従うことを目指しています。このスキームでは、後方互換性のないAPI変更が行われたときにメジャーバージョン番号がインクリメントされ、新しいAPIが追加されたときにマイナーバージョン番号がインクリメントされ、後方互換性のある方法でバグが修正されたときにパッチバージョン番号がインクリメントされます。
Spikeの主要な公開APIはRISC-V ISAです。Spikeの内部に対するC++インターフェースは、現時点では公開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に置き換えることができます。
対話型デバッグモードでソケット経由のコマンドI/Oを使用する必要がない場合は、2番目の手順をスキップできます。
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 という名前を付けます。次に、それを hello という名前の RISC-V ELF バイナリにコンパイルします:
$ riscv64-unknown-elf-gcc -o hello hello.c
これで、プロキシカーネルの上でプログラムをシミュレートできます:
$ spike pk hello
シミュレータに命令を追加するには、2 つの手順が必要です:
命令の機能的な動作をファイル riscv/insns/<new_instruction_name>.h に記述します。そのディレクトリ内の他の命令を 出発点として参照してください。
オペコードとオペコードマスクを riscv/opcodes.h に追加します。あるいは、 riscv-opcodes パッケージに追加すれば、それが自動的に行ってくれます:
$ cd ../riscv-opcodes
$ vi opcodes // 新しい命令の行を追加
$ make install
命令を riscv/riscv.mk.in に追加します。そうしないと、その命令は ビルドに含まれず、不正命令として扱われます。
シミュレータを再ビルドします。
対話型デバッグモードを起動するには、-d を付けて spike を起動します:
$ spike -d pk hello
整数レジスタの内容を表示するには(0 はコア 0 を表します):
: reg 0 a0
浮動小数点レジスタの内容を表示するには:
: fregs 0 ft0
または:
: fregd 0 ft0
レジスタを単精度と倍精度のどちらで表示するかによって使い分けます。
メモリ位置の内容を表示するには(物理アドレスを 16 進数で指定):
: mem 2020
仮想アドレスでメモリの内容を表示するには(0 はコア 0 を表します):
: mem 0 2020
Enter キーを押すと、1 命令ずつ進めることができます。また、 目的の等値条件に達するまで実行することもできます:
: until pc 0 2020 (pc=2020 になったら停止)
: until reg 0 mie a (レジスタ mie=0xa になったら停止)
: until mem 2020 50a9907311096993 (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
To debug this program, first run spike telling it to listen for OpenOCD:
$ spike --rbb-port=9824 -m0x10000:0x20000 rot13
Listening for remote bitbang connection on port 9824.
...
別のシェルで、適切な設定ファイルを指定して OpenOCD を実行します:
$ cat spike.cfg
adapter driver remote_bitbang
remote_bitbang host localhost
remote_bitbang port 9824
set _CHIPNAME riscv
jtag newtap $_CHIPNAME cpu -irlen 5 -expected-id 0xdeadbeef
set _TARGETNAME $_CHIPNAME.cpu
target create $_TARGETNAME riscv -chain-position $_TARGETNAME
gdb report_data_abort enable
init
arm semihosting enable
halt
$ openocd -f spike.cfg
Open On-Chip Debugger 0.12.0
...
Info : starting gdb server for riscv.cpu on 3333
Info : Listening on port 3333 for gdb connections
riscv.cpu halted due to debug-request. Semihosting is active.
...
riscv.cpu: target state: halted
別のシェルで、gdb デバッグセッションを開始します:
$ riscv64-unknown-elf-gdb rot13
...
Reading symbols from rot13...
(gdb) target extended-remote localhost:3333
...
(gdb) load
...
(gdb) set $sp=0x2fff0
(gdb) b main
Breakpoint 1 at 0x10202: file rot13.c, line 5.
(gdb) c
Continuing.
Disabling abstract command writes to CSRs.
Breakpoint 1, main () at rot13.c:5
5 {
(gdb) print text
$1 = "Vafgehpgvba frgf jnag gb or serr!"
(gdb) until done
[riscv.cpu] Found 4 triggers
main () at rot13.c:16
16 printf("decoded text: %s\n", text);
(gdb) c
Continuing.
Program received signal SIGTRAP, Trace/breakpoint trap.
0x00019ff8 in _exit ()
(gdb)
...
OpenOCD ターミナルでは次のように表示されます:
...
decoded text: Instruction sets want to be free!
semihosting: *** application exited with 0 ***
riscv.cpu halted due to breakpoint. Semihosting is active.