From: R Veera Kumar <vklr@vkten.in>
Date: Thu, 7 Apr 2022 02:04:19 +0000 (+0530)
Subject: Add new installation page for FPGA/Boards Boot-Loaders Programmers
X-Git-Tag: opf_rfc_ls005_v1~2865
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=21918cc2473549cb4d9d369621aef533ff829eac;p=libreriscv.git

Add new installation page for FPGA/Boards Boot-Loaders Programmers
---

diff --git a/HDL_workflow/fpga-boot-loaders-progs.mdwn b/HDL_workflow/fpga-boot-loaders-progs.mdwn
new file mode 100644
index 000000000..b064aef08
--- /dev/null
+++ b/HDL_workflow/fpga-boot-loaders-progs.mdwn
@@ -0,0 +1,48 @@
+# FPGA/Board Boot-Loaders-Programmers
+
+Page: Work in Progress
+
+Installation instructions for dfu-util, openFPGALoader, ujprog, fujprog, xc3sprog and ecpprog for boards ULX3S, ECP5 and OrangeCrab.
+
+Use of the automated install scripts recommended
+
+* Source code: <https://git.code.sf.net/p/dfu-util/dfu-util>
+* Source code: <https://github.com/trabucayre/openFPGALoader.git>
+* Source code: <https://github.com/f32c/tools.git>
+* Source code: <https://github.com/kost/fujprog.git>
+* Source code: <https://github.com/xtrx-sdr/xc3sprog/>
+* Source code: <https://github.com/gregdavill/ecpprog/>
+* Bugzilla page <https://bugs.libre-soc.org/show_bug.cgi?id=791>
+
+# Setting up new debootstrap and chroot into it
+
+Run the following if you wish to isolate the nextpnr-xilinx build
+from other software (reproducible builds) or use the schroot
+auto-preparation script here:
+<https://git.libre-soc.org/?p=dev-env-setup.git;a=blob;f=mk-deb-chroot;hb=HEAD>
+
+    export MY_CHROOT=/stable-chroot
+    mkdir $MY_CHROOT
+    debootstrap buster $MY_CHROOT http://deb.debian.org/debian/
+    mount -t proc proc $MY_CHROOT/proc
+    mount -t sysfs sysfs $MY_CHROOT/sys
+    mount -t devpts devpts $MY_CHROOT/dev/pts/
+    chroot $MY_CHROOT /bin/bash
+
+# Download neccessary softwares
+
+    apt-get install -y libcurl3-gnutls/buster git/buster
+
+    git clone https://git.code.sf.net/p/dfu-util/dfu-util
+    git clone https://github.com/trabucayre/openFPGALoader.git
+    git clone https://github.com/f32c/tools.git
+    git clone https://github.com/kost/fujprog.git
+    git clone https://github.com/xtrx-sdr/xc3sprog.git
+    git clone https://github.com/gregdavill/ecpprog.git
+
+# Steps to compile dfu-util
+
+## Necessary software to install
+
+## Build dfu-util
+