From: Luke Kenneth Casson Leighton <lkcl@lkcl.net>
Date: Thu, 26 Mar 2020 11:08:29 +0000 (+0000)
Subject: add README describing build process for simulator (gdb ppc)
X-Git-Tag: div_pipeline~1628
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=0d9b740df49113bf2bfe18331c35763e68b7178d;p=soc.git

add README describing build process for simulator (gdb ppc)
---

diff --git a/README.md b/README.md
index e69de29b..beb32519 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,21 @@
+# Installation
+
+python3 setup.py develop
+
+# Running Simulator tests
+
+qemu and gdb for Power 64 are required.  qemu can be installed with
+"apt-get install qemu-system-ppc64", however gdb needs compiling from
+source.  Obtain the latest tarball, unpack it, then:
+
+    cd gdb-9.1 (or other location)
+    mkdir build
+     ../configure --srcdir=.. --host=x86_64-linux --target=powerpc64-linux-gnu
+    make -j16
+    make install
+
+You will need to have installed the powerpc gnu gcc cross-compiler for
+this to work:
+
+    apt-get install gcc-9-powerpc64-linux-gnu
+