mention page number of vgbbd

[libreriscv.git] / HDL_workflow / nextpnr-xilinx.mdwn

diff --git a/HDL_workflow/nextpnr-xilinx.mdwn b/HDL_workflow/nextpnr-xilinx.mdwn
index 854caa1dbc10d7b73ba756f562818048725a0d5c..fbe86a6bcc91f1d320d95a1b052c5ec7d5ef1a54 100644 (file)
--- a/HDL_workflow/nextpnr-xilinx.mdwn
+++ b/HDL_workflow/nextpnr-xilinx.mdwn
@@ -1,9 +1,109 @@
-# Installation instructions for Nextpnr-xilinx with Xilinx Artix7 100T Board
+# nextpnr-xilinx
 
-* <https://github.com/gatecat/nextpnr-xilinx>
+Installation instructions for Nextpnr-xilinx with Digilent Arty A7-100t
+with Xilinx Artix7 100T
 
-## Bugzilla page
+Use of the automated install scripts recommended
 
-* <https://bugs.libre-soc.org/show_bug.cgi?id=790>
+* Source code: <https://github.com/gatecat/nextpnr-xilinx>
+* Bugzilla page <https://bugs.libre-soc.org/show_bug.cgi?id=790>
+* Auto-install script: <https://git.libre-soc.org/?p=dev-env-setup.git;a=blob;f=nextpnr-xilinx-install;hb=HEAD>
+* Prerequisites: yosys <https://git.libre-soc.org/?p=dev-env-setup.git;a=blob;f=hdl-tools-yosys;hb=HEAD>
 
-## Page under work
+# 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://github.com/f4pga/prjxray.git
+    git clone https://github.com/SymbiFlow/prjxray-db.git
+    git clone https://github.com/gatecat/nextpnr-xilinx.git
+
+# Steps to compile prjxray
+
+## Necessary software to install
+
+    apt-get install -y build-essential make cmake python3 python3-dev \
+     python3-setuptools python3-numpy cython3 python3-pip
+
+    pip3 install textx fasm
+
+## Build prjxray
+
+    cd prjxray
+    git checkout 18b92012afe2b03f3f975a78c4372c74b60dca0c
+    git submodule update --init --recursive
+    mkdir build; cd build
+    cmake -DCMAKE_INSTALL_PREFIX=/usr/local/nextpnr-xilinx ..
+    make -j$(nproc)
+    make install
+    install -d -m 0755 /usr/local/nextpnr-xilinx/build/tools
+    install -m 0755 tools/{bitread,bittool,frame_address_decoder,gen_part_base_yaml,segmatch,xc7frames2bit,xc7patch} \
+     /usr/local/nextpnr-xilinx/build/tools
+    cd ..
+    cp -dpr utils /usr/local/nextpnr-xilinx
+    sed -i -e '/^# Vivado /,$d' \
+     /usr/local/nextpnr-xilinx/utils/environment.sh
+    python3 setup.py develop
+    export PATH=/usr/local/nextpnr-xilinx/bin:$PATH
+    cd ..
+
+# Steps to compile prjxray-db
+
+## Install prjxray-db
+
+    cd prjxray-db
+    git archive --format=tar --prefix=database/ \
+      0a0addedd73e7e4139d52a6d8db4258763e0f1f3 | \
+      tar -C /usr/local/nextpnr-xilinx -xf -
+    cd ..
+
+# Steps to compile nextpnr-xilinx
+
+## Necessary software to install
+
+    apt-get install -y libboost-thread-dev libboost-iostreams-dev \
+     libboost-program-options-dev libeigen3-dev libboost-python-dev \
+     libboost-filesystem-dev
+
+## Build nextpnr-xilinx
+
+    cd nextpnr-xilinx
+    git checkout 565588a69ea95a52f7c7592f4ed81d9bef6cfb60
+    cmake -DARCH=xilinx -DBUILD_GUI=OFF -DCMAKE_INSTALL_PREFIX=/usr/local/nextpnr-xilinx .
+    make -j$(nproc)
+    make install
+    python3 xilinx/python/bbaexport.py --device xc7a100tcsg324-1 \
+     --bba xilinx/xc7a100t.bba
+    ./bbasm --l xilinx/xc7a100t.bba xilinx/xc7a100t.bin
+    install -d -m 0755 /usr/local/nextpnr-xilinx/share/xilinx
+    install -m 0755 xilinx/xc7a100t.bin \
+     /usr/local/nextpnr-xilinx/share/xilinx
+    export XRAY_DIR=/usr/local/nextpnr-xilinx
+
+    # build attosoc example; it should build attosoc.bit as final bitstream
+
+    cd xilinx/examples
+    cp -dpr arty-a35 arty-a100
+    cd arty-a100
+    sed -i -e 's@xc7a35tcsg324-1@xc7a100tcsg324-1@g' \
+     -e 's@../../../nextpnr-xilinx@nextpnr-xilinx@g' \
+     -e 's@../../xc7a35t.bin@/usr/local/nextpnr-xilinx/share/xilinx/xc7a100t.bin@g' \
+     attosoc.sh
+    ./attosoc.sh
+
+    # see file attosoc.bit; it is the bitstream file and if built then success