78 lines
2.4 KiB
Markdown
78 lines
2.4 KiB
Markdown
---
|
|
gitea: none
|
|
title: hello
|
|
include_toc: true
|
|
---
|
|
[](https://opensource.org/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.
|
|
```pwsh
|
|
& ([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](https://github.com/microsoft/wslg/blob/main/samples/container/Containers.md).
|
|
|
|
#### Linux
|
|
Execute the next script in your terminal replacing `<container_name>` and `<git.1159.cl/mario1159/image>`.
|
|
```sh
|
|
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.
|
|
```sh
|
|
docker exec -it <container_name> bash
|
|
```
|
|
|
|
### 3. Configure Volare
|
|
|
|
List the available PDKs and choose one to install.
|
|
|
|
```sh
|
|
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.
|
|
|
|
```sh
|
|
docker build -t <tag> -f <arch/jammy>.Dockerfile <path>
|
|
```
|
|
|
|
## Custom Images |