update portability documentation

README.md

@@ -2,7 +2,12 @@
 
 Assets of the workshop about free/libre integrated circuits design.
 
-## Using Anaconda (GNU/Linux + MacOS)
+## Using Anaconda (GNU/Linux, MacOS, Windows Subsystem for Linux)
+
+The toolchain was tested on the following distributions:
+
+* Fedora 37
+* Ubuntu 2022.04.2 LTS
 
 The repository can be cloned using the following command:
 
@@ -18,13 +23,13 @@ It contains:
 
 A `README.md` file containing instructions for using the assets is available in each directory.
 
-## Using Docker (Windows, no graphical support)
+## Using Docker (limited graphical support)
 
 A container can be prepared an run using:
 
 ```
 docker build --tag freechips https://forge.slowte.ch/workshops/freechips.git
-docker run --interactive --tty --network=host freechips
+docker run --interactive --publish 1853:1853 --tty --network=host freechips
 ```
 
 A `README.md` file containing instructions for using the assets is available in each directory.

fullcustom/README.md

@@ -1,11 +1,11 @@
-# Fullcustom analog design
+# Fullcustom design
 
 ## Environment
 
 Make sure Anaconda is installed and that you are in the `fullcustom` directory. The fullcustom environment can be created, updated and activated using:
 
 ```sh
-conda env create # Fulfilled with docker build
+conda env create # Already fulfilled under the docker build
 conda activate fullcustom
 ```
 
@@ -14,5 +14,6 @@ conda activate fullcustom
 The notebook can be openend as follows:
 
 ```sh
-jupyter-notebook # Add `--allow-root` under docker build
+jupyter-notebook # When using GNU/Linux, MacOS, WSL
+jupyter-notebook --ip 0.0.0.0 --port 1853 --no-browser --allow-root
 ```

semicustom/README.md

@@ -1,11 +1,11 @@
-# Semicustom digital design
+# Semicustom design
 
 ## Environment
 
 Make sure Anaconda is installed and that you are in the `semicustom` directory. The semicustom environment can be created, updated and activated using:
 
 ```sh
-conda env create # Fulfilled under docker build
+conda env create # Already fulfilled under the docker build
 conda activate semicustom
 ```
 
@@ -14,5 +14,6 @@ conda activate semicustom
 The notebook can be openend as follows:
 
 ```sh
-jupyter-notebook # Add `--allow-root` under docker build
+jupyter-notebook # When using GNU/Linux, MacOS, WSL
+jupyter-notebook --ip 0.0.0.0 --port 1853 --no-browser --allow-root
 ```

slides/index.html

@@ -166,11 +166,12 @@
            # Practical work
            
            ```sh
-           # 🐂/🐧 + 🍏 users
+           # 🐂/🐧 + 🍏 + 🪟  (Ubuntu 22.04.2 LTS under WSL)
            git clone https://forge.slowte.ch/workshops/freechips.git
            
-           # 🪟 users
+           # 🐋
-           # Use "IC-CO-IN-SC-*" VMs on https://vdi.epfl.ch
+           docker build --tag freechips https://forge.slowte.ch/workshops/freechips.git#main
+           docker run --interactive --publish 1853:1853 --tty --network=host freechips
            ```
 
         </section>
@@ -180,11 +181,12 @@
            ```sh
            # Prepare the conda environment
            cd semicustom
-           conda env create
+           conda env create # Already fulfilled under the docker build
            conda activate semicustom
            
            # Launch the jupyter notebook
-           jupyter-notebook
+           jupyter-notebook # When using GNU/Linux, MacOS, WSL
+           jupyter-notebook --ip 0.0.0.0 --port 1853 --no-browser --allow-root
            ```
 
         </section>
@@ -194,11 +196,12 @@
            ```sh
            # Prepare the conda environment
            cd fullcustom
-           conda env create
+           conda env create # Already fulfilled under the docker build
            conda activate fullcustom
            
            # Launch the jupyter notebook
-           jupyter-notebook
+           jupyter-notebook # When using GNU/Linux, MacOS, WSL
+           jupyter-notebook --ip 0.0.0.0 --port 1853 --no-browser --allow-root
            ```
 
         </section>