Mario1159/osic-stacks
1
1
Fork 1
Code Issues 11 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
Docker development environments for integrated circuits design.
35 Commits 6 Branches 0 Tags 2.9 MiB
Shell 36.5%
PowerShell 19.7%
Dockerfile 16.6%
Batchfile 16.4%
Python 10.8%
6858e3f0da
Go to file
Mario1159 6858e3f0da Fix dash in option
2023-09-12 22:07:14 -03:00
base Solve pcell parameter problem 2023-09-12 16:04:44 -03:00
scripts Fix script recursion 2023-09-12 17:16:11 -03:00
stacks Solve pcell parameter problem 2023-09-12 16:04:44 -03:00
LICENSE Initial commit 2023-08-07 06:36:35 +00:00
README.md Add PDK variable 2023-09-12 17:16:32 -03:00
run.ps1 Fix dash in option 2023-09-12 22:07:14 -03:00

README.md

Table of Contents

License: MIT

OSIC Stacks

Open Source Integrated Circuits Docker Stacks

Stacks

  • analog-xk: Analog workflow using XSchem & KLayout
  • analog-xm: Analog workflow using XSchem & Magic
  • analog-heavy: Workflow with all the analog tools
  • digital-ator: Digital workflow using Verilator & Yosys
  • digital-icarus: Digital workflow using Icarus & Yosys
  • digital-heavy: Workflow with all the digital tools
  • heavy: Workflow with all the previous tools

Usage

Follow these 3 steps to get your container ready.

1. Starting a container with graphics output

Scripts are provided for creating the containers in both Windows and Linux. These scripts automate the binding of graphics environment variables to the container in order to enable graphics inside the docker container.

Windows

Execute the next script in powershell.

& ([scriptblock]::Create((irm https://git.1159.cl/Mario1159/osic-stacks/raw/branch/main/run.ps1))) -remote

This script will run the container inside wsl and bind the enviroments variables for wslg.

Linux

Execute the next script in your terminal replacing <container_name> and <git.1159.cl/mario1159/image>.

docker run -it --name <container_name> -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix <git.1159.cl/mario1159/image>

For Wayland compositors make sure you have XWayland installed

macOS / OS X

Install Xquartz and run the linux previous command.

2. Connecting to the container

After creating and starting the container, enter to it executing a shell with docker.

docker exec -it <container_name> bash

3. Configure Volare

List the available PDKs and choose one to install.

export PDK=<sky130A/sky130B/gf180mcuA/gf180mcuB/gf180mcuC>
volare ls-remote --pdk <sky130/gf180mcu>
volare enable --pdk <sky130/gf180mcu> <version_id>

After you have set up the PDK, you can finally start developing your own designs!

Build

A singular stack image can be builded using docker in the following way.

Note: Each stack image requires their correspondent base image installed.

docker build -t <tag> -f <arch/jammy>.Dockerfile <path>

Custom Images