summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPanagiotis Peristerakis <perister@ics.forth.gr>2019-06-27 18:28:50 +0300
committerAnup Patel <anup@brainfault.org>2019-06-29 14:34:06 +0300
commit3048f979cab3d0f42461bd4d96a4bdecf1791f62 (patch)
treef534aacb23313280277aa1c3cc5cba0d4525e868 /docs
parentb44e844880d05c14ea90604c8d2f4d07878a18b9 (diff)
downloadopensbi-3048f979cab3d0f42461bd4d96a4bdecf1791f62.tar.xz
Add documentation for Ariane FPGA platform
Signed-off-by: Panagiotis Peristerakis <perister@ics.forth.gr>
Diffstat (limited to 'docs')
-rw-r--r--docs/platform/ariane-fpga.md37
-rw-r--r--docs/platform/platform.md4
2 files changed, 41 insertions, 0 deletions
diff --git a/docs/platform/ariane-fpga.md b/docs/platform/ariane-fpga.md
new file mode 100644
index 0000000..e8e4600
--- /dev/null
+++ b/docs/platform/ariane-fpga.md
@@ -0,0 +1,37 @@
+Ariane FPGA SoC Platform
+==========================
+Ariane is a 6-stage, single issue, in-order CPU which implements the 64-bit RISC-V instruction set.
+The Ariane FPGA development platform is based on FPGA FPGA SoC(which currently supports only Genesys 2 board) and is capable
+of running Linux.
+ The FPGA SoC currently contains the following peripherals:
+- DDR3 memory controller
+- SPI controller to conncet to an SDCard
+- Ethernet controller
+- JTAG port (see debugging section below)
+- Bootrom containing zero stage bootloader and device tree.
+
+To build platform specific library and firmwares, provide the
+*PLATFORM=ariane-fpga* parameter to the top level `make` command.
+
+Platform Options
+----------------
+
+The *Ariane FPGA* platform does not have any platform-specific
+options.
+
+Building Ariane FPGA Platform
+-----------------------------
+**Linux Kernel Payload**
+
+
+```
+make PLATFORM=ariane-fpga FW_PAYLOAD_PATH=<linux_build_directory>/arch/riscv/boot/Image
+```
+
+Booting Ariane FPGA Platform
+-----------------------------
+
+**Linux Kernel Payload**
+
+As Linux kernel image is embedded in the OpenSBI firmware binary, Ariane will directly
+boot into Linux directly after powered on.
diff --git a/docs/platform/platform.md b/docs/platform/platform.md
index 2235b6a..49fa3e9 100644
--- a/docs/platform/platform.md
+++ b/docs/platform/platform.md
@@ -21,6 +21,9 @@ OpenSBI currently supports the following virtual and hardware platforms:
* **Kendryte K210 SoC**: Platform support for the Kendryte K210 SoC used on
boards such as the Kendryte KD233 or the Sipeed MAIX Dock.
+* **Ariane FPGA SoC**: Platform support for the Ariane FPGA SoC used on
+ Genesys 2 board.
+
The code for these supported platforms can be used as example to implement
support for other platforms. The *platform/template* directory also provides
template files for implementing support for a new platform. The *object.mk*,
@@ -30,3 +33,4 @@ facilitate the implementation.
[qemu_virt.md]: qemu_virt.md
[qemu_sifive_u.md]: qemu_sifive_u.md
[sifive_fu540.md]: sifive_fu540.md
+[ariane-fpga.md]: ariane-fpga.md