workshops/freechips
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

update portability documentation

Browse source
This commit is contained in:
Pierre Guillod 2023-04-27 00:39:00 +02:00
parent bf6fe88811
commit f84ef005bb
Signed by: pierre
GPG key ID: B00B454469924EDF
4 changed files with 26 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
README.md
View file

@ -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.

7
fullcustom/README.md
View file

@ -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
```

7
semicustom/README.md
View file

@ -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
```

17
slides/index.html
View file

@ -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>