index.md

Ibex SoC emulation

Requirements

1. A native toolchain for C and Rust
2. Ninja build tool

Note: never tested on Windows hosts.

Building

mkdir build
cd build
../configure --target-list=riscv32-softmmu --without-default-features --enable-tcg \
    --enable-tools --enable-trace-backends=log \
    [--enable-gtk --enable-pixman | --enable-cocoa]
ninja
ninja qemu-img

• --enable-gtk --enable-pixman and --enable-cocoa are only useful when using a graphical display, such as the IbexDemo platform. It is mosly useless with the OpenTitan platform.

  • --enable-gtk --enable-pixman should be used on Linux hosts
  • --enable-cocoa should be used on macOS hosts

• --extra-cflags=-Wno-deprecated-declarations and --extra-ldflags=-Wl,-no_warn_duplicate_libraries may be required to build on recent relases of macOS (QEMU issues which are not related to the OpenTitan port)

Useful build options

• --enable-debug
• --enable-sanitizers

Supported platforms

• IbexDemo built for Digilent Arty7 board
• Darjeeling build for CW310 "Bergen" board
• EarlGrey build for CW310 "Bergen" board