README

Generic OpenRISC board, suitable for use with Qemu, for example.

Contents

o STATUS o Pre-built or1k-elf Toolchain (newlib) o OpenRISC GNU tool chain from source o OpenOCD o Qemu

STATUS

2018-04-23: I have been trying to retrace all of Matt Thompson's steps to get or1k building running on Qemu. I am stuck at the moment because it looks like there is some problem with my Kubuntu package manager. The Qemu configuration gives:

  ERROR:  glib-2.22 gthread-2.0 is required to compile QEMU.

But it looks like to do have a later version of gthread-2.0 installed.

Pre-built or1k-elf Toolchain (newlib)

Ref: https://openrisc.io/newlib/

Download and Install the Toolchain

You can install pre-compiled toolchains and install them on your Linux system. We have prebuilt-toolchains for releases of the different components that are preferably installed to /opt/toolchains/or1k-elf. You can find all releases here. Those are current releases:

GCC 4.9.2, Binutils 2.26, Newlib 2.3.0 (+or1k backports), GDB 7.11 https://github.com/openrisc/newlib/releases/download/v2.3.0-1/or1k-elf\_gcc4.9.3\_binutils2.26\_newlib2.3.0-1\_gdb7.11.tgz

GCC 5.2.0, Binutils 2.26, Newlib 2.3.0 (+or1k backports), GDB 7.11 https://github.com/openrisc/newlib/releases/download/v2.3.0-1/or1k-elf\_gcc5.2.0\_binutils2.26\_newlib2.3.0-1\_gdb7.11.tgz

After downloading a release you can extract it anywhere in your filesystem, we recommend to /opt/toolchains/or1k-elf/. You need to add the toolchain to your path:

export PATH=/opt/toolchains/or1k-elf/bin:$

OpenRISC GNU tool chain from source

ref: https://github.com/juliusbaxter/mor1kx-dev-env/wiki/OpenRISC-tool-chain-installation-guide

These instructions are as per the project's GNU tool chain page on [OpenCores] (http://opencores.org/or1k).

What is required first is a copy of the tool chain source. There are two repositories - one for GCC (called or1k-gcc) and one for the rest of the GNU tools and libraries (binutils, GDB, newlib, called or1k-src). We must get the entirety of both.

You will need to download the repositories as a zip file OR use git. Download zip files (save into $HOME/or1k):

or1k-src - https://github.com/openrisc/or1k-src/archive/or1k.zip or1k-gcc - https://github.com/openrisc/or1k-gcc/archive/or1k.zip

and unzip into the $HOME/or1k directory, making 2 directories or1k-src-or1k/ and or1k-gcc-or1k/

Rename those directories to be without the trailing -or1k so

mv or1k-src-or1k or1k-src mv or1k-gcc-or1k or1k-gcc

or with git clone:

mkdir $HOME/or1k && cd $HOME/or1k git clone git://github.com/openrisc/or1k-src.git git clone git://github.com/openrisc/or1k-gcc.git

Once the source trees are in place, we will build.

We will install the tool chain into /opt/or1k-toolchain. Make sure that directory is writeable eg.:

sudo mkdir /opt/or1k-toolchain sudo chown $USER /opt/or1k-toolchain

The following commands will build the tool chain (starting in the $HOME/or1k directory):

# Build the first set of tools, binutils etc. # NOTE: on 32-bit machines --disable-werror is needed due to an enum acting as bit mask is considered signed

mkdir bld-or1k-src bld-or1k-gcc cd bld-or1k-src ../or1k-src/configure --target=or1k-elf --prefix=/opt/or1k-toolchain --enable-shared --disable-itcl --disable-tk --disable-tcl --disable-winsup --disable-libgui --disable-rda --disable-sid --disable-sim --disable-gdb --with-sysroot --disable-newlib --disable-libgloss --disable-werror make make install

# Build gcc

cd ../bld-or1k-gcc ../or1k-gcc/configure --target=or1k-elf --prefix=/opt/or1k-toolchain --enable-languages=c --disable-shared --disable-libssp make make install

# build newlib and gdb (without or1ksim in this case) cd ../bld-or1k-src ../or1k-src/configure --target=or1k-elf --prefix=/opt/or1k-toolchain --enable-shared --disable-itcl --disable-tk --disable-tcl --disable-winsup --disable-libgui --disable-rda --disable-sid --enable-sim --disable-or1ksim --enable-gdb --with-sysroot --enable-newlib --enable-libgloss --disable-werror make make install

# build gcc again, this time with newlib cd ../bld-or1k-gcc ../or1k-gcc/configure --target=or1k-elf --prefix=/opt/or1k-toolchain --enable-languages=c,c++ --disable-shared --disable-libssp --with-newlib make make install

Finally, we will want to run the following to put this path in our .bashrc file:

echo "# OpenRISC tool chain path" >> ~/.bashrc echo "export PATH=$PATH:/opt/or1k-toolchain/bin"

OpenOCD

ref: https://github.com/juliusbaxter/mor1kx-dev-env/wiki/OpenRISC-tool-chain-installation-guide

OpenOCD is the debug proxy we'll use to talk to the board over JTAG.

Download the source to $HOME/or1k with

git clone https://github.com/openrisc/openOCD.git

Go into the OpenOCD directory and, the very first time, you must bootstrap it:

./bootstrap

Once that is finished, configure and compile it:

./configure --enable-usb_blaster_libftdi --enable-adv_debug_sys --enable-altera_vjtag --enable-maintainer-mode make

You can run make install if you like, too.

Qemu

The compiled ELF that works in or1ksim (https://github.com/openrisc/or1ksim).

Ref: https://github.com/openrisc/or1ksim

Or1ksim is a generic OpenRISC 1000 architecture simulator capable of emulating OpenRISC based computer systems at the instruction level. It includes models of a range of peripherals, allowing complete systems to be modeled. For full details see http://opencores.org/or1k/Or1ksim

This is a variant of the standard Or1ksim, which uses or1k as the architecture name, rather than or32. At some stage in the future this will be merged in, so that either architecture name is supported.

Or1k Build

Or1ksim uses a standard GNU autoconf/automake installation and is designed to be built in a separate build directory. So from the main directory, a minimal install can be done with

cd or1ksim mkdir bd cd bd ../configure make sudo make install

This will install the executables 'sim', 'profile', and 'mprofile' at /user/local/bin and libraries at /usr/local/lib.

The UART must be enabled in sim.cfg BEFORE the build in order for the NSH configuration to work:

section uart - enabled = 0 + enabled = 1

Qemu Build

Download:

https://www.qemu.org/download/\#source

Configure and build

Ref: https://wiki.qemu.org/Documentation/Platforms/OpenRISC

./configure --target-list=or1k-softmmu make

Then this command will get it running:

qemu-system-or1k -kernel nuttx-or1k-sim.elf -serial stdio -nographic -monitor none