ringtailsoftware / zig-minirv32

Zig RISC-V32 emulator with Linux and baremetal examples

zig-minirv32ima

Toby Jaffey https://mastodon.me.uk/@tobyjaffey

A pure zig port of https://github.com/cnlohr/mini-rv32ima

Tested with zig 0.11.0-dev.1507+6f13a725a on linux/aarch64.

Build emulator

zig build && ./zig-out/bin/zigrv32ima linux.bin

Type ctrl-a then x to exit.

Samples

samples/hello

Minimal "Hello world" in zig

cd samples/hello
zig build
../../zig-out/bin/zigrv32ima zig-out/bin/hello.bin

samples/shell

Interactive shell (https://github.com/ringtailsoftware/zig-embshell/)

cd samples/shell
zig build
../../zig-out/bin/zigrv32ima zig-out/bin/shell.bin

samples/mandelbrot

ASCII mandelbrot set

cd samples/mandelbrot
zig build
../../zig-out/bin/zigrv32ima zig-out/bin/mandelbrot.bin

Notes

Testing with qemu

qemu-system-riscv32 -machine virt -nographic -bios foo.bin

Libc usage

libc is linked for access to the raw terminal. To remove, comment out lib.linkSystemLibraryName("c"); in build.zig. The term struct could be replaced by this minimal stub:

const term = struct {
    pub fn init() void {
    }
    pub fn getch() ?u8 {
        return null;
    }
};