This Repository contains all Sources for LibreSilicons's Standard Cell Library. Started once as manual work, given slow progress, the focus was shifted to the Standard Cell Generator which was named "Popcorn". Many Sources are now generated by Popcorn and are still Work-In-Progress. Check back regulary for updates.
And please, do not hesitate to contact the authors of Standard Cell Library for patches, feature additions or questions. Any feedback is welcome by Email.
The Standard Cell Library uses LaTeX for documentation. On Debian based systems, LaTeX can be installed (as root) with
apt-get install texlive-latex-extra texlive-extra-utils texlive-latex-recommended
apt-get install texlive-full
which installs the complete (and usefull) LaTeX Environment.
Additionally, we use the great CircDia LaTeX package for drawing circuit diagrams by Dr. Stefan Krause (Saarbrücken/Germany). Please download CircDia, unzip it, and run
mktexlsr in the directory. Many Thanks to Stefan for the excellent work!
Popcorn (as the tool which does the voodoo stuff and generates the Standard Cells) is written in R^7RS Scheme. While this Standard is already a couple of years old, not so many tools are supporting them. Chibi-Scheme as a pre-built package that not available on most systems, so we are using Gauche Scheme (or
gosh) in Version 0.9.6 or higher.
apt-get install gauche
Please check that you have the correct version by
some more "conservative" distributions with Long-Time-Support (LTS) are probably stuck at older versions.
The GPL'd suite and toolkit of Electronic Design Automation tools is re-used for the Standard Cell Library also; especially gschem for Schematic Entry special cells. While not using the PCB tools, a partial installation with
apt-get install geda-gschem geda-gnetlist geda-doc geda-gattrib geda-gsymchek
is sufficient. For simulation Icarus Verilog is used; also sailing under the gEDA flag.
apt-get install iverilog gtkwave
Another software for the Popcorn tool, which should be installed before usage, is Magic. Magic is Open Source, but not part of all Linux distributions (it is missing on OpenSuse, Arch Linux etc). On Debian based systems,
apt-get install magic
The Standard Cells (and the cell generator) are controlled / ruled with GNU Make. On Debian based systems, Make can be installed with
apt-get install make
Please make yourself familiar with the GNUmakefile system - assure your are not root anymore - by typing:
which shows a help screen with available targets.
First prepare all home-tailored tools by typing
This will generate helpfull manual pages about the tools and the formats, the Standard Cell Library is using. Please read them (inside the ./Tool directory).
Generate Cell Descriptions
Once all tools are installed, you might copy and adapt a TOML configuration file from ./Template/TOML directory into your project root directory and run
which re-generates the majority of the Cell Description Catalog, and overwrites older, already generated cells. Doing so, GNU Make sees the new timestamp and redoes the following (time-consuming) steps once again. All manual changes on cells in the catalog will be lost.
Please re-generate the catalog only, if you know what you're doing and have strong reasons for that.
Generate Cell Layouts
Once all cells in all cell representations you need (library files, layout files, simulation models, etc.) are complete, you should run
and build the holistic Standard Cell Library documention under
with all already generated cells.
Hopefully, you did a great job, did not forget a piece of work, and all things went fine. Please check the documentation. Finaly
generates a compressed archive (.tgz) of all important files, named with the current date. If you are sure nothing is missing, this is the file to ditstribute as Standard Cell Library and to store in your repository (and to be tagged as release).
Btw., the tooling should not be part of the distribution.
Congratulations! You generated a Standard Cell Library :-) There aren't many people who can say they've done that.