(no commit message)

diff --git a/HDL_workflow/ls2.mdwn b/HDL_workflow/ls2.mdwn
index 6df549162930b24208298fc6563f03663b244529..68e61ccf0f18c3396b2a0277bbbfc6e69f8394bf 100644 (file)
--- a/HDL_workflow/ls2.mdwn
+++ b/HDL_workflow/ls2.mdwn
@@ -5,13 +5,19 @@
 
 # Install Instructions
 
+    # devscripts
     git clone https://git.libre-soc.org/git/dev-env-setup.git
     cd dev-env-setup
     sudo bash
     ./mk-deb-chroot ls2-hello-world
     ./cp-scripts-to-chroot ls2-hello-world
+    exit # back to user
+
     schroot -c ls2-hello-world
+    sudo bash # helps define SUDO_USER in new chroot
     cd ~/dev-env-setup
+
+    # install dependencies in new chroot
     ./install-hdl-apt-reqs
     ./hdl-dev-repos
     ./hdl-tools-yosys
@@ -20,19 +26,20 @@
     export XRAY_DIR=/usr/local/nextpnr-xilinx
     ./hdl-dev-ls2
     cd ~/src
+
+    # make hello_world.bin from microwatt
     cd tercel-qspi/
     cd hello_world/
     make
     cp hello_world.bin ../../ls2
     cd ../..
 
-    # pip3 may install newer nmigen from repo which may cause error
-    # in next step. If so you can run "python3 setup.py develop"
-    # in nmigen source directory.
-
+    # make the Libre-SOC core (for external use)
     cd soc
     make microwatt_external_core
     cp external_core_top.v ../ls2
+
+    # check out ls2 peripheral framework
     cd ../ls2
     git checkout 426e2d9585cd4b1fb96a38987f97878285ee5ba7