install f4pga through pip and use envvars to support deprecated wrappers

Signed-off-by: Unai Martinez-Corral <umartinezcorral@antmicro.com>

.github/scripts/build-examples.sh

@@ -52,8 +52,9 @@ elif [ "$fpga_family" == "eos-s3" -a -z "$examples" ]; then
     examples="counter"
 fi
 
+
 # activate conda and enter example dir
-activate_env="docs/building-examples.rst:export-install-dir,fpga-fam-$fpga_family,conda-prep-env-$fpga_family,conda-act-env"
+activate_env="docs/building-examples.rst:export-install-dir,fpga-fam-$fpga_family,conda-prep-env-$fpga_family,f4pga-env-bin,f4pga-env-share-$fpga_family,conda-act-env"
 snippets="${activate_env},enter-dir-$fpga_family"
 additionalDesigns="${activate_env},enter-dir-$fpga_family"
 

docs/building-examples.rst

@@ -31,6 +31,7 @@ Select your FPGA family:
 
 Next, prepare the environment:
 
+
 .. tabs::
 
    .. group-tab:: Artix-7
@@ -49,6 +50,30 @@ Next, prepare the environment:
          export PATH="$INSTALL_DIR/$FPGA_FAM/quicklogic-arch-defs/bin:$PATH";
          source "$INSTALL_DIR/$FPGA_FAM/conda/etc/profile.d/conda.sh"
 
+
+.. code-block:: bash
+   :name: f4pga-env-bin
+
+   export F4PGA_ENV_BIN="$INSTALL_DIR/$FPGA_FAM/conda/bin"
+
+
+.. tabs::
+
+   .. group-tab:: AMD/Xilinx Series 7
+
+      .. code-block:: bash
+         :name: f4pga-env-share-xc7
+
+         export F4PGA_ENV_SHARE="$INSTALL_DIR/$FPGA_FAM/install/share/symbiflow"
+
+   .. group-tab:: EOS S3
+
+      .. code-block:: bash
+         :name: f4pga-env-share-ql
+
+         export F4PGA_ENV_SHARE="$INSTALL_DIR/$FPGA_FAM/share"
+
+
 Finally, enter your working Conda environment:
 
 .. code-block:: bash

docs/getting.rst

@@ -143,7 +143,7 @@ Download architecture definitions:
       .. code-block:: bash
          :name: download-arch-def-eos-s3
 
-         wget -qO- https://storage.googleapis.com/symbiflow-arch-defs-install/quicklogic-arch-defs-d6d05185.tar.gz | tar -xzC $INSTALL_DIR/eos-s3/
+         wget -qO- https://storage.googleapis.com/symbiflow-arch-defs-install/quicklogic-arch-defs-d6d05185.tar.gz | tar -xzC $INSTALL_DIR/$FPGA_FAM/
 
 If the above commands exited without errors, you have successfully installed and configured your working environment.
 

xc7/requirements.txt

@@ -14,6 +14,7 @@ sympy
 textx
 yapf==0.24.0
 python-constraint
+https://github.com/chipsalliance/f4pga/archive/main.zip#subdirectory=f4pga
 fasm
 git+https://github.com/SymbiFlow/prjxray.git@e25c20a8f158cc5e94eb62e3b74e16fc9d6c1d26#egg=prjxray
 git+https://github.com/symbiflow/xc-fasm.git@14afc2bae24cbf6ee5e7d057a58b4cbd776358d0#egg=xc-fasm