CMOS standard-cell generator and characterization suite. https://codeberg.org/librecell
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Thomas Kramer e6d7f29740 Link to new location. 7 months ago
LICENCES Issue #25: Add licence text in top-directory. 1 year ago
librecell-common Bump version. 1 year ago
librecell-layout Bump version. 1 year ago
librecell-lib Add FreePDK45 license notice. 7 months ago
librecell-meta Bump version. 1 year ago
.gitignore CI: Add woodpecker CI pipeline (checks install only). 1 year ago
.woodpecker.yml CI: Comment on how to run container locally. 1 year ago
LICENCE Issue #25: Add licence text in top-directory. 1 year ago
README.md Link to new location. 7 months ago
install.sh Issue #21: Use pip to install librecell. 1 year ago
install_develop.sh Issue #21: Use pip to install librecell. 1 year ago
run_tests.sh Tests: include simple sp2bool tests. 1 year ago

README.md

ARCHIVED REPO

This project has been moved to https://codeberg.org/librecell. Further, the layout generator and the characterization tool are now separate projects.

LibreCell

LibreCell aims to be a toolbox for automated synthesis of CMOS logic cells.

LibreCell is structured in multiple sub-projects:

  • librecell-layout: Automated layout generator for CMOS standard cells.
  • librecell-lib: Characterization kit for CMOS cells and tool for handling liberty files.
  • librecell-common: Code that is used across different LibreCell projects such as a netlist parser.
  • librecell-meta: Convinience Python package for easier installation.

The project is in a very early stage and might not yet be ready for productive use. Project structure and API might change heavily in near future.

Getting started

LibreCell can be installed using the Python package manager pip or directly from the git repository.

Dependencies

The following dependencies must be installed manually:

Optional dependencies (not required for default configuration):

Depending on your linux distribution this packages can be installed using the package manager.

Example for Arch Linux:

sudo pacman -S python ngspice z3

Installing from git

It is recommended to use a Python 'virtual environment' for installing all Python dependencies:

# Create a new virtual environment
python3 -m venv my-librecell-env
# Activate the virtual environment
source ./my-librecell-env/bin/activate

Install from git:

git clone https://codeberg.org/tok/librecell.git
cd librecell
./install.sh

# Alternatively use ./install_develop.sh to install symlinks.
# This allows to edit the code with immediate effect on the installed program.

Now, check if the command-line scripts are in the current search path:

lclayout --help

If this shows the documentation of the lclayout command, then things are fine. Otherwise, the PATH environment variable needs to be updated to include $HOME/.local/bin.

# Instead of executing this line each time it can be added to ~/.bashrc
export PATH=$PATH:$HOME/.local/bin

Installing with pip

Note: The version PyPI is often not the most recent one. Consider installing from git to get the most recent version.

It is recommended to use a Python 'virtual environment' for installing all Python dependencies:

# Create a new virtual environment
python3 -m venv my-librecell-env
# Activate the virtual environment
source ./my-librecell-env/bin/activate

pip3 install librecell

Generate a layout

Generate a layout from a SPICE netlist which includes the transistor sizes.

cd librecell-layout
mkdir /tmp/mylibrary
lclayout --output-dir /tmp/mylibrary --tech examples/dummy_tech.py --netlist examples/cells.sp --cell AND2X1
# Use a GDS viewer such as KLayout to inspect the generated layout file `/tmp/mylibrary/*.gds`

Known issues

Reproducibility

You may want to generate standard cells in a fully reproducable manner. Right now there is some non-determinism in LibreCell that has not been investigated yet. The current workaround is to set the PYTHONHASHSEED environment variable.

export PYTHONHASHSEED=42
lclayout ...

Contact

"codextkramerych".replace("x", "@").replace("y", ".")