GitHub - lalitshankarch/rvcore: RISC-V emulator that runs DOOM

1 min read Original article ↗

Output

rvcore is a single-core RISC-V emulator that implements the RV32IM ISA, except for the FENCE and EBREAK instructions, which are currently NOP.

Build instructions

  1. To build, CMake and a compiler that supports C++20 is required (for Windows, Cygwin is required)

  2. Dependencies: libsdl3-dev / sdl3-devel

  3. Run

        mkdir build
    cmake -B build -DCMAKE_BUILD_TYPE=Release
    cd build
    cmake --build .

Build instructions for doomgeneric

  1. Clone https://github.com/lalitshankarch/doomgeneric
  2. riscv64-unknown-elf-gcc or the riscv64-gnu-toolchain configured with ./configure --with-multilib-generator="rv32im-ilp32--" must be installed
  3. Navigate to doomgeneric and run make

Milestones

  • Run flat binaries written in assembly language

  • Run flat binaries written in C language

  • Run ELF binaries (binaries with a single PT_LOAD segment work)

  • Implement the newlib stubs needed to run DOOM

  • Get DOOM to boot

  • Make DOOM playable

  • Implement the M extension