FOSS-ASIC-TOOLS

FOSS-ASIC-TOOLS is all in one container for SKY130 based design both Analog and Digital. Below is a list of the current tools already installed and ready to use. See here for a list of Tools included in the container

Quick Launch for Designers

Download and install Docker for your operating system

• Linux || Windows || Mac with Intel Chip || Mac with Apple Chip

  cd $HOME
  mkdir my-local-design-files
  export DESIGNS=$HOME/my-local-design-files
  docker pull efabless/foss-asic-tools:latest
  docker run -it -p 80:80 --user $(id -u):$(id -g) -v $DESIGNS:/foss/designs efabless/foss-asic-tools:latest bash

• Open your browser of choice and go to https://localhost when asked for a password use "abc123" (default)
• Watch this 5min video to kickstart your analog project (Draft - more detailed on is coming)

Details for Developers and Contributor

Prerequisites

• Docker
• Python3
• Python virtualenv
  • pip3 install virtualenv
  • Setup the venv:

    virtualenv -p python3 venv
    source venv/bin/activate
    pip3 install -r requirements.txt

Installation and Update

• Using a recipe csv file

  python3 run.py recipe --csv recipe.csv

• Buidling an individual image

  python3 run.py build openlane

• Updating an individual image
  • Run:

    python3 run.py update open_pdks

  • You will be prompted with:

    A new commit for (open_pdks) is available:
    44c13e2256d5907090d6a2a62d9b9f8ddf23758d
    Would you like to update? (y/N)

• Updating all images in a given recipe file

  python3 run.py recipe --csv ./recipes/recipe.csv --update-reference

Setting Screen Resolution and Custom Password:

docker run -it -p 80:80 --user $(id -u):$(id -g) -v $DESIGNS:/foss/designs -e VNC_PW=<your password> -e VNC_RESOLUTION=1920x1080 efabless/foss-asic-tools:beta bash

Notes

• Images are under images directory
• Versions in recipe file overwrite the image version
• The images are tagged <name>:<version>
• The final image is called foss-tools:<tag>, so if you want to run multiple recipes modify the tag of foss-tools

Todo

• Dependancies handling
• Differentiate between git and non git based packages
• Add guidance how-to add tools to the build
• Compressed PDK
• Add examples