A RISC-V to x86-64 dynamic binary translator written in pure x86-64 assembly.

Named after Lynn Conway, who invented dynamic instruction scheduling. This project makes instructions flow between architectures. She figured out how to make them flow efficiently in the first place.

Conway loads a RISC-V ELF binary, translates it to native x86-64 machine code at runtime, and executes it. No interpreter loop. No LLVM. No compiler in the middle making decisions you didn't ask for.

It passes 100% of the official RISC-V compliance tests. Which is quite nifty really.

x86-64. Windows (MinGW) and Linux. The translator core is NASM assembly. The CLI and file I/O are a thin C wrapper that calls into the assembly.

You need NASM and GCC (MinGW on Windows).

Linux:

make clean && make

Windows:

build-mingw.bat

conway [options] <riscv_elf>

Options:

Example:

$ ./bin/conway examples/hello.elf
Conway - RISC-V to x86-64 Binary Translator
Hello from RISC-V!

That's a real RISC-V ELF binary running on your x86-64 machine.

docker run --rm -v "$(pwd):/src" dockcross/linux-riscv64 bash -c \
  "riscv64-unknown-linux-gnu-gcc -static -nostdlib -march=rv64i -mabi=lp64 \
   -Wl,-Ttext=0x1000,--build-id=none -o /src/output.elf /src/input.S"

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ ELF Loader  │────>│ Translator  │────>│ Block Cache │
└─────────────┘     └─────────────┘     └─────────────┘
                          │                    │
                          v                    v
                   ┌─────────────┐     ┌─────────────┐
                   │   Decode    │     │   Execute   │
                   │   & Emit    │     │    Loop     │
                   └─────────────┘     └─────────────┘

RV64IMAFDC. The full general-purpose set. See include/rv_opcodes.inc for the complete list.

See ROADMAP.md.

Apache 2.0. See LICENSE for the full text.