This is a collection of utilities that help with testing and running Linux, GDB with OpenRISC. Most of these tools used to live in other repo's like openrisc/linux and openrisc/or1k-src, but as we move to upstream things we need a new home for these.

Here you can find:

• TODO - If you are interested in working on OpenRISC check out this list.
• site.exp and boards - dejagnu test files for testing gcc with gdb/sim or QEMU, see usage in or1k-toolchain-build.
• or1ksim.cfg - or1ksim configuration for running or1ksim
• busybox - initramfs structure and scripts for building a busybox linux initramfs, see usage in or1k-rootfs-build.
• buildroot - configs and rootfs overlays for building an OpenRISC rootfs that can run on QEMU or a Litex SoC FGPA board, see usage in or1k-rootfs-build.
• qemu - scripts for building the qemu system simulator.
• toolchains - scripts for building newlib, glibc and musl toolcchains. See usage in or1k-toolchain-build.
• litex - tools and scripts for building and booting litex SoC FPGA boards.
• openocd - custom openocd board files for debugging (JTAG) OpenRISC hardware. Currently can be used with stffrdhrn/openocd mutlicore patches.
• scripts - convenience wrappers for building Linux, running QEMU etc.
• tests - some expect script for building kernel self tests loading them into the initramfs running them on the simulator and verifying they work.

As mentioned above the site.exp and boards files used for dejagnu testing of gnu projects like gdb.

To use this run something like the following, this tells gdb to use or1ksim as the target for running tests:

export DEJAGNU=$HOME/openrisc/or1k-utils/site.exp

cd build-gdb/gdb
# Run tests
make check

# or to just run a single test
make check RUNTESTFLAGS='gdb.xml/tdesc-regs.exp'

# or in GCC run
make check-gcc RUNTESTFLAGS='or1k.exp'

• busybox - UNIX utilities in a single small executable, useful to create a Linux initramfs
• buildroot - for much more advanced initramfs creation
• openadk - support for OpenRISC, uclibc, musl-cross