Add some initial FPGA synthesis instructions

Signed-off-by: Anton Blanchard <anton@linux.ibm.com>

diff --git a/README.md b/README.md
index 04be1185b9923ee6b3060a0c5f4d1469caac3ff3..06a3bc0fee1abdb66a908c3b763e18168ef0e769 100644 (file)
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 A tiny Open POWER ISA softcore written in VHDL 2008. It aims to be simple and easy
 to understand.
 
-## Simulation
+## Simulation using ghdl
 
 - Build micropython. If you aren't building on a ppc64le box you
   will need a cross compiler. If it isn't available on your distro
@@ -39,6 +39,42 @@ ln -s ../micropython/ports/powerpc/build/firmware.bin simple_ram_behavioural.bin
 ./core_tb > /dev/null
 ```
 
+## Synthesis on Xilinx FPGAs using Vivado
+
+- Install Vivado (I'm using the free 2019.1 webpack edition).
+
+- Setup Vivado paths:
+
+```
+source /opt/Xilinx/Vivado/2019.1/settings64.sh
+```
+
+- Install FuseSoC:
+
+```
+pip3 install --user -U fusesoc
+```
+
+- Create a working directory and point FuseSoC at microwatt:
+
+```
+mkdir microwatt-fusesoc
+cd microwatt-fusesoc
+fusesoc library add microwatt /path/to/microwatt/
+```
+
+- Build using FuseSoC. For hello world (Replace nexys_video with your FPGA board):
+
+```
+fusesoc run --target=nexys_video microwatt --memory_size=8192 --ram_init_file=/path/to/microwatt/fpga/hello_world.hex
+```
+
+- To build micropython (currently requires 1MB of BRAM eg an Artix-7 A200):
+
+```
+fusesoc run --target=nexys_video microwatt
+```
+
 ## Testing
 
 - A simple test suite containing random execution test cases and a couple of