
محاكي مجموعة تعليمات RISC-V وظيفي يدعم امتدادات متعددة (RV32/64، V، التشفير) مع وضع تصحيح تفاعلي، وتكامل GDB، ونمذجة على مستوى التعليمات للتطوير المشترك بين العتاد والبرمجيات واستكشاف المعمارية.
Spike، محاكي مجموعة تعليمات RISC-V، ينفّذ نموذجًا وظيفيًا لواحد أو أكثر من harts RISC-V. سُمّي على اسم المسمار الذهبي المستخدم للاحتفال بإتمام السكة الحديدية العابرة للقارات في الولايات المتحدة.
يدعم Spike ميزات مجموعة تعليمات RISC-V التالية:
تُنشأ إصدارات المشاريع بشكل أساسي للإشارة إلى وقت توسيع واجهة برمجة التطبيقات أو جعلها غير متوافقة. وبهذه الروح، يهدف Spike إلى اتباع مخطط الإصدارات SemVer، حيث تُزاد أرقام الإصدار الرئيسية عند إجراء تغييرات غير متوافقة مع الإصدارات السابقة على واجهة برمجة التطبيقات؛ وتُزاد أرقام الإصدار الفرعية عند إضافة واجهات برمجة تطبيقات جديدة؛ وتُزاد أرقام إصدار التصحيح عند إصلاح الأخطاء بطريقة متوافقة مع الإصدارات السابقة.
واجهة برمجة التطبيقات العامة الرئيسية لـ Spike هي مجموعة تعليمات RISC-V. لا تُعتبر واجهة C++ الخاصة بالبنية الداخلية لـ Spike واجهة برمجة تطبيقات عامة في الوقت الحالي، و ستُجرى تغييرات غير متوافقة مع الإصدارات السابقة على هذه الواجهة دون زيادة رقم الإصدار الرئيسي.
نفترض أن متغير البيئة 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. ثم جمّعه إلى ملف ثنائي RISC-V ELF باسم hello:
$ riscv64-unknown-elf-gcc -o hello hello.c
الآن يمكنك محاكاة البرنامج فوق proxy kernel:
$ spike pk hello
تتطلب إضافة تعليمة إلى المحاكي خطوتين:
صِف السلوك الوظيفي للتعليمة في الملف riscv/insns/<new_instruction_name>.h. افحص تعليمات أخرى في ذلك الدليل كنقطة انطلاق.
أضف رمز العملية (opcode) وقناع رمز العملية إلى 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
يمكنك التقدم بتعليمة واحدة بالضغط على مفتاح الإدخال. يمكنك أيضًا التنفيذ حتى الوصول إلى تساوٍ مرغوب:
: 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
لتشخيص هذا البرنامج، شغّل أولًا spike وأخبره بالاستماع إلى 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