Skip to content

Latest commit

 

History

History
executable file
·
80 lines (66 loc) · 3.05 KB

README.md

File metadata and controls

executable file
·
80 lines (66 loc) · 3.05 KB

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

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