
कार्यात्मक RISC-V ISA सिम्युलेटर जो एकाधिक एक्सटेंशन (RV32/64, V, cryptography) का समर्थन करता है, जिसमें इंटरैक्टिव डिबग मोड, GDB एकीकरण, और हार्डवेयर-सॉफ्टवेयर सह-विकास और आर्किटेक्चर अन्वेषण के लिए निर्देश-स्तरीय मॉडलिंग शामिल है।
Spike, RISC-V ISA सिम्युलेटर, एक या अधिक 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 का उपयोग करने की आवश्यकता नहीं है, तो आप दूसरा चरण छोड़ सकते हैं।
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 (Build Steps देखें), riscv-gnu-toolchain, और riscv-pk इंस्टॉल करें।
एक छोटा C प्रोग्राम लिखें और उसका नाम hello.c रखें। फिर, इसे hello नामक एक RISC-V ELF बाइनरी में कंपाइल करें:
$ riscv64-unknown-elf-gcc -o hello hello.c
अब आप प्रोग्राम को proxy kernel के ऊपर सिम्युलेट कर सकते हैं:
$ spike pk hello
सिम्युलेटर में एक इंस्ट्रक्शन जोड़ने के लिए दो चरणों की आवश्यकता होती है:
riscv/insns/<new_instruction_name>.h फ़ाइल में इंस्ट्रक्शन के कार्यात्मक व्यवहार का वर्णन करें। शुरुआत के लिए उस डायरेक्टरी में अन्य इंस्ट्रक्शन देखें।
riscv/opcodes.h में opcode और opcode mask जोड़ें। वैकल्पिक रूप से, इसे riscv-opcodes पैकेज में जोड़ें, और यह आपके लिए ऐसा कर देगा:
$ cd ../riscv-opcodes
$ vi opcodes // नई इंस्ट्रक्शन के लिए एक पंक्ति जोड़ें
$ 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
आप एंटर कुंजी दबाकर एक इंस्ट्रक्शन से आगे बढ़ सकते हैं। आप तब तक भी निष्पादित कर सकते हैं जब तक कोई वांछित समानता प्राप्त न हो जाए:
: 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.
...