Skip to contentSkip to conversation

Documentation: Add qemu instructions for OpenRISC

PATCH Applied Stafford Horne 3 participants 4 messages Mar 4, 2021 – Apr 13, 2021 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: Add qemu instructions for OpenRISC

Most developers have qemu and rather not download and install the or1ksim. Also, this adds details on how to get a openrisc toolchain.

---
 Documentation/boards/openrisc.rst | 68 +++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
Documentation/boards/openrisc.rst +68 -0
index f9d67f965..34586b4a7 100644
@@ -1,6 +1,74 @@
 OpenRISC
 ========
 
+Optaining an OpenRISC toolchain
+-------------------------------
+
+Toolchain binaries can be obtained from openrisc.io or our github releases page.
+Instructions for building the different toolchains can be found on openrisc.io
+or Stafford's toolchain build and release scripts.
+
+See:
+
+  * https://github.com/stffrdhrn/gcc/releases
+  * https://github.com/stffrdhrn/or1k-toolchain-build
+  * https://openrisc.io/software
+
+Example of downloading and installing a toolchain::
+
+  $ curl --remote-name --location \
+    https://github.com/stffrdhrn/gcc/releases/download/or1k-10.0.0-20190723/or1k-elf-10.0.0-20190723.tar.xz
+  $ tar -xf or1k-elf-10.0.0-20190723.tar.xz
+  $ export PATH=$PATH:$PWD/or1k-elf/bin
+
+Running OpenRISC barebox on qemu
+------------------------------
+
+Running barebox on qemu is similar to running linux on qemu see more details on
+the qemu wiki site at https://wiki.qemu.org/Documentation/Platforms/OpenRISC
+
+Compile the qemu emulator::
+
+  $ git clone https://gitlab.com/qemu-project/qemu.git
+  $ cd qemu
+  $ mkdir build ; cd build
+  $ ../configure \
+    --target-list="or1k-softmmu" \
+    --enable-fdt \
+    --disable-kvm \
+    --disable-xen \
+    --disable-xkbcommon \
+    --enable-debug \
+    --enable-debug-info
+  $ make
+
+Next compile barebox::
+
+  $ make ARCH=openrisc defconfig
+  ...
+  $ make ARCH=openrisc CROSS_COMPILE=or1k-elf-
+
+Run barebox::
+
+  $ <path to qemu source>/build/or1k-softmmu/qemu-system-or1k \
+    -cpu or1200 \
+    -M or1k-sim \
+    -kernel /home/shorne/work/openrisc/barebox/barebox \
+    -net nic -net tap,ifname=tap0,script=no,downscript=no \
+    -serial mon:stdio -nographic -gdb tcp::10001 \
+    -m 32
+
+
+  barebox 2021.02.0-00120-g763c6fee7-dirty #14 Thu Mar 4 05:13:51 JST 2021
+
+
+  Board: or1ksim
+  mdio_bus: miibus0: probed
+  malloc space: 0x01b80000 -> 0x01f7ffff (size 4 MiB)
+
+  Hit any to stop autoboot:    3
+  barebox at or1ksim:/
+
 or1ksim
 -------
 
Signature · 1 line
2.26.2
#1 lore raw

Hello Sascha,

Quoted 4 lines · Stafford Horne

Most developers have qemu and rather not download and install the or1ksim. Also, this adds details on how to get a openrisc toolchain.

I don't see this in next.

Documentation/boards/openrisc.rst line 4

Quoted 13 lines
---
 Documentation/boards/openrisc.rst | 68 +++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
Documentation/boards/openrisc.rst +1 -0
index f9d67f965..34586b4a7 100644
@@ -1,6 +1,74 @@
 OpenRISC
 ========
 
+Optaining an OpenRISC toolchain

Could you fix up s/Optaining/Obtaining/ while at it?

Cheers,

Ahmad

Signature · 4 lines
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
31137 Hildesheim, Germany                  | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |
#2 lore raw
Quoted 22 lines · Ahmad Fatoum

Hello Sascha,

Quoted 4 lines · Stafford Horne

Most developers have qemu and rather not download and install the or1ksim. Also, this adds details on how to get a openrisc toolchain.

I don't see this in next.

Quoted 12 lines
---
 Documentation/boards/openrisc.rst | 68 +++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
Documentation/boards/openrisc.rst +0 -0
index f9d67f965..34586b4a7 100644
@@ -1,6 +1,74 @@
 OpenRISC
 ========
 
Quoted 3 lines

Documentation/boards/openrisc.rst line 4

Quoted 1 line
Documentation/boards/openrisc.rst +1 -0
+Optaining an OpenRISC toolchain

Could you fix up s/Optaining/Obtaining/ while at it?

It looks like you guys are handling it, but please let me know if there is anything else I can do.

-Stafford

Applied
#3 lore raw
In reply to Stafford Horne
Quoted 7 lines · Stafford Horne

Most developers have qemu and rather not download and install the or1ksim. Also, this adds details on how to get a openrisc toolchain.

---
 Documentation/boards/openrisc.rst | 68 +++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)

Applied, thanks

Sascha

Quoted 84 lines
Documentation/boards/openrisc.rst +68 -0
index f9d67f965..34586b4a7 100644
@@ -1,6 +1,74 @@
 OpenRISC
 ========
 
+Optaining an OpenRISC toolchain
+-------------------------------
+
+Toolchain binaries can be obtained from openrisc.io or our github releases page.
+Instructions for building the different toolchains can be found on openrisc.io
+or Stafford's toolchain build and release scripts.
+
+See:
+
+  * https://github.com/stffrdhrn/gcc/releases
+  * https://github.com/stffrdhrn/or1k-toolchain-build
+  * https://openrisc.io/software
+
+Example of downloading and installing a toolchain::
+
+  $ curl --remote-name --location \
+    https://github.com/stffrdhrn/gcc/releases/download/or1k-10.0.0-20190723/or1k-elf-10.0.0-20190723.tar.xz
+  $ tar -xf or1k-elf-10.0.0-20190723.tar.xz
+  $ export PATH=$PATH:$PWD/or1k-elf/bin
+
+Running OpenRISC barebox on qemu
+------------------------------
+
+Running barebox on qemu is similar to running linux on qemu see more details on
+the qemu wiki site at https://wiki.qemu.org/Documentation/Platforms/OpenRISC
+
+Compile the qemu emulator::
+
+  $ git clone https://gitlab.com/qemu-project/qemu.git
+  $ cd qemu
+  $ mkdir build ; cd build
+  $ ../configure \
+    --target-list="or1k-softmmu" \
+    --enable-fdt \
+    --disable-kvm \
+    --disable-xen \
+    --disable-xkbcommon \
+    --enable-debug \
+    --enable-debug-info
+  $ make
+
+Next compile barebox::
+
+  $ make ARCH=openrisc defconfig
+  ...
+  $ make ARCH=openrisc CROSS_COMPILE=or1k-elf-
+
+Run barebox::
+
+  $ <path to qemu source>/build/or1k-softmmu/qemu-system-or1k \
+    -cpu or1200 \
+    -M or1k-sim \
+    -kernel /home/shorne/work/openrisc/barebox/barebox \
+    -net nic -net tap,ifname=tap0,script=no,downscript=no \
+    -serial mon:stdio -nographic -gdb tcp::10001 \
+    -m 32
+
+
+  barebox 2021.02.0-00120-g763c6fee7-dirty #14 Thu Mar 4 05:13:51 JST 2021
+
+
+  Board: or1ksim
+  mdio_bus: miibus0: probed
+  malloc space: 0x01b80000 -> 0x01f7ffff (size 4 MiB)
+
+  Hit any to stop autoboot:    3
+  barebox at or1ksim:/
+
 or1ksim
 -------
 
Signature · 1 line
2.26.2
Signature · 4 lines
Pengutronix e.K.                           |                             |
Steuerwalder Str. 21                       | http://www.pengutronix.de/  |
31137 Hildesheim, Germany                  | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |