Merge pull request #355 from antmicro/umarcor/getting-steps

docs/getting: use tabs to export F4PGA_PACKAGES

.github/latest.patch

@@ -1,7 +1,7 @@
 --- a/docs/getting.rst
 +++ b/docs/getting.rst
-@@ -135,7 +135,7 @@ Next, setup Conda and your system's environment, and download architecture defin
-    esac
+@@ -146,7 +146,7 @@ Next, setup Conda and your system's environment, and download architecture defin
+    F4PGA_HASH='df6d9e5'
 
     for PKG in $F4PGA_PACKAGES; do
 -     wget -qO- https://storage.googleapis.com/symbiflow-arch-defs/artifacts/prod/foss-fpga-tools/symbiflow-arch-defs/continuous/install/${F4PGA_TIMESTAMP}/symbiflow-arch-defs-${PKG}-${F4PGA_HASH}.tar.xz | tar -xJC $F4PGA_INSTALL_DIR/${FPGA_FAM}
@@ -9,3 +9,4 @@
     done
 
  If the above commands exited without errors, you have successfully installed and configured your working environment.
+--

.github/scripts/install-toolchain.sh

@@ -45,4 +45,4 @@ fi
 fpga_family=$1
 os=$2
 
-tuttest_exec docs/getting.rst:install-reqs-$os,wget-conda,conda-install-dir,fpga-fam-$fpga_family,env-setup
+tuttest_exec docs/getting.rst:install-reqs-$os,wget-conda,conda-install-dir,fpga-fam-$fpga_family,env-setup,packages-$fpga_family,get-packages

docs/getting.rst

@@ -120,20 +120,31 @@ Next, setup Conda and your system's environment, and download architecture defin
    bash conda_installer.sh -u -b -p $F4PGA_INSTALL_DIR/$FPGA_FAM/conda;
    source "$F4PGA_INSTALL_DIR/$FPGA_FAM/conda/etc/profile.d/conda.sh";
    conda env create -f $FPGA_FAM/environment.yml
+
+.. tabs::
+
+   .. group-tab:: Artix-7
+
+      .. code-block:: bash
+         :name: packages-xc7
+
+         export F4PGA_PACKAGES='install-xc7 xc7a50t_test xc7a100t_test xc7a200t_test xc7z010_test'
+
+   .. group-tab:: EOS S3
+
+      .. code-block:: bash
+         :name: packages-eos-s3
+
+         export F4PGA_PACKAGES='install-ql ql-eos-s3_wlcsp'
+
+.. code-block:: bash
+   :name: get-packages
+
    mkdir -p $F4PGA_INSTALL_DIR/$FPGA_FAM
 
    F4PGA_TIMESTAMP='20220803-160711'
    F4PGA_HASH='df6d9e5'
 
-   case $FPGA_FAM in
-     xc7)
-       F4PGA_PACKAGES='install-xc7 xc7a50t_test xc7a100t_test xc7a200t_test xc7z010_test'
-     ;;
-     eos-s3)
-       F4PGA_PACKAGES='install-ql ql-eos-s3_wlcsp'
-     ;;
-   esac
-
    for PKG in $F4PGA_PACKAGES; do
      wget -qO- https://storage.googleapis.com/symbiflow-arch-defs/artifacts/prod/foss-fpga-tools/symbiflow-arch-defs/continuous/install/${F4PGA_TIMESTAMP}/symbiflow-arch-defs-${PKG}-${F4PGA_HASH}.tar.xz | tar -xJC $F4PGA_INSTALL_DIR/${FPGA_FAM}
    done