Skip to content

Latest commit

 

History

History
140 lines (104 loc) · 4.4 KB

README.md

File metadata and controls

140 lines (104 loc) · 4.4 KB
Raw

Trace Tool

本项目实现了一个基于 NEMU 的 Trace 工具，用于抓取指令级别的分支指令 Trace。

构建方法

  1. 克隆本项目
git clone https://github.com/yaozhicheng/NEMU.git
  1. 设置 $NEMU_HOME

具体地，你需要将环境变量 $NEMU_HOME 设置为本项目的根目录。

  1. 初始化本项目
make riscv64-brt-tool_defconfig
  1. 修复 softfloat.a 链接问题

进入 resource/softfloat/repo/build/Linux-x86_64-GCC/ 编辑 Makefile，在COMPILE_C中添加 -fPIC，之后重新编译，具体过程如下：

cd resource/softfloat/repo/build/Linux-x86_64-GCC/
vim Makefile

# 在 COMPILE_C 中添加 -fPIC
# COMPILE_C = \
#  gcc -c -Werror-implicit-function-declaration -fPIC -DSOFTFLOAT_FAST_INT64 \
#    $(SOFTFLOAT_OPTS) $(C_INCLUDES) -O2 -o $@

# 重新编译
make clean && make
  1. 编译本项目

回到仓库根目录之后，运行 make。

make

编译结果位于 build/NemuBR。

NEMU

NEMU(NJU Emulator) is a simple but complete full-system emulator designed for teaching purpose. Currently it supports x86, mips32, and riscv32. To build programs run above NEMU, refer to the AM project.

The main features of NEMU include

  • a small monitor with a simple debugger
    • single step
    • register/memory examination
    • expression evaluation without the support of symbols
    • watch point
    • differential testing with reference design (e.g. QEMU)
    • snapshot
  • CPU core with support of most common used instructions
    • x86
      • real mode is not supported
      • x87 floating point instructions are not supported
    • mips32
      • CP1 floating point instructions are not supported
    • riscv32
      • only RV32IM
  • memory
  • paging
    • TLB is optional (but necessary for mips32)
    • protection is not supported
  • interrupt and exception
    • protection is not supported
  • 5 devices
    • serial, timer, keyboard, VGA, audio
    • most of them are simplified and unprogrammable
  • 2 types of I/O
    • port-mapped I/O and memory-mapped I/O

Howto

Run OpenSBI and Linux

Steps below to run OpenSBI and Linux use source code in OpenXiangShan

  1. Compile a Linux kernel, with proper SD card driver integrated if you want to run Debian or Fedora. Currently Kernel v4.18 is verified to work.
  2. Convert vmlinux to binary format using objcopy.
  3. Compile OpenSBI using build_linux.sh where vmlinux and dtb path may need a modification. dtb can be compiled with dts files located in dts subdirectory of OpenSBI.
  4. Compile NEMU intepreter. You may want to change default sdcard image path in src/devices/sdcard.c to boot Debian or Fedora.
  5. launch NEMU intepreter and load fw_payload.bin generated by OpenSBI. e.g. ./build/riscv64-nemu-interpreter ~/Xiangshan_Linux/opensbi/build/platform/generic/firmware/fw_payload.bin
  6. If you are using a vmlinux with initramfs, you will likely be greeted with a Hello, otherwise you may see startup logs and finally a login prompt from Debian or Fedora if SD card is configured properly.

Run baremetal app

git submodule update --init ready-to-run
./build/riscv64-nemu-interpreter -b ./ready-to-run/coremark-2-iteration.bin

Prepare workloads

Link your bbl or baremetal app to 0x800a0000

We use gcpt restorer to restore architectural checkpoints, which is a piece of assembly code. We put gcpt restorer at 0x80000000 and put bbl or baremetal app at 0x800a0000. So users should link bbl or baremetal app to 0x800a0000 instead of 0x80000000. Users can build the bbl here which has been linked to 0x0x800a0000. A prebuilt bbl linked to 0x800a0000 is also shipped in ready-to-run.

Take uniform checkpoints and restore checkpoints

Take uniform checkpoints (checkpointing every N instructions).

./build/riscv64-nemu-interpreter \
    --cpt-interval 10000000 -u -b \
    -D output_top \
    -C test \
    -w linux \
    -r ./resource/gcpt_restore/build/gcpt.bin \
    --dont-skip-boot\
    -I 11000000 ./ready-to-run/linux-0xa0000.bin

Restore checkpoints (example):

./build/riscv64-nemu-interpreter -b\
    --restore \
    ./output_top/test/linux/0/_10000003_.gz

Generate BBV and take simpoint-directed checkpoints

This feature has NOT been tested yet, and might be broken.