From 14b7b2da32a2f93dedb1772023d0ab71da6bcd0b Mon Sep 17 00:00:00 2001
From: lkcl <lkcl@web>
Date: Fri, 15 Apr 2022 16:01:49 +0100
Subject: [PATCH]

---
 HDL_workflow/ls2.mdwn | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/HDL_workflow/ls2.mdwn b/HDL_workflow/ls2.mdwn
index 6df549162..68e61ccf0 100644
--- 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
 
-- 
2.30.2