OpenFASoC: Fully Open-Source Autonomous SoC Synthesis using Customizable Cell-Based Synthesizable Analog Circuits
.. image:: https://readthedocs.org/projects/openfasoc/badge/?version=latest :target: https://openfasoc.readthedocs.io/en/latest/?badge=latest
OpenFASOC is focused on open-source automated analog generation from user specification to GDSII with fully open-sourced tools.
This project is led by a team of researchers at the University of Michigan and is inspired by FASoC, that sits on proprietary tools. (See more about FaSoC at website <https://fasoc.engin.umich.edu/>
_)
Contact: mehdi@umich.edu
Temperature sensor - .. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/tempSense_sky130hd.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/tempSense_sky130hd.yml
.. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/verify_latest_tools_versions.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/verify_latest_tools_versions.yml
.. image:: https://colab.research.google.com/assets/colab-badge.svg :target: https://colab.research.google.com/github/idea-fasoc/OpenFASOC/blob/main/docs/source/notebooks/temp-sense-gen/temp_sense_genCollab.ipynb
LDO - .. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/ldo_sky130hvl.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/ldo_sky130hvl.yml
.. image:: https://colab.research.google.com/assets/colab-badge.svg :target: https://colab.research.google.com/github/idea-fasoc/OpenFASOC/blob/main/docs/source/notebooks/ldo-gen/LDO_notebook.ipynb
Cryogenic - .. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/cryo_gen.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/cryo_gen.yml
Glayout Generators -
Installation and Running <https://github.com/idea-fasoc/OpenFASOC/tree/main/openfasoc/generators/glayout/tapeout/tapeout_and_RL/README.md>
_
.. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/glayout_sky130.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/glayout_sky130.yml
.. image:: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/glayout_opamp_sim.yml/badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/actions/workflows/glayout_opamp_sim.yml
Opamp Notebook
.. image:: https://colab.research.google.com/assets/colab-badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/blob/7dc5eb42cec94c02b74e72483df6fdc2b2603fb9/docs/source/notebooks/glayout/glayout_opamp.ipynb
Via Notebook
.. image:: https://colab.research.google.com/assets/colab-badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/blob/7dc5eb42cec94c02b74e72483df6fdc2b2603fb9/docs/source/notebooks/glayout/GLayout_Via.ipynb
Current Mirror Notebook
.. image:: https://colab.research.google.com/assets/colab-badge.svg :target: https://github.com/idea-fasoc/OpenFASOC/blob/7dc5eb42cec94c02b74e72483df6fdc2b2603fb9/docs/source/notebooks/glayout/GLayout_Cmirror.ipynb
Getting Started
There are two methods to install the prerequisites to use OpenFASOC generators:
Express Installation
Install all the prerequisites using the dependencies.sh
script provided in the home location of this project (where this README.rst file is found). Supports CentOS7, Ubuntu 20.04 LTS and Ubuntu 22.04 LTS.
.. code-block:: bash
$ sudo ./dependencies.sh
For more info on getting-started, please refer to "Getting Started" section's express install section <https://openfasoc.readthedocs.io/en/latest/getting-started.html#express-installation>
_
Containerized Installation
This method uses Docker <https://www.docker.com/#build>
to build a custom image, on top of which a container is created, in which the generators can be run. This allows the user to create a persistent snapshot of an environment where are tools are installed. Note: If you do not have Docker Installed, refer to the instructions here <https://docs.docker.com/engine/install/>
.. code-block:: bash
$ cd docker/conda
$ sudo docker build -t
Where <image_name>
is the name that you want to tag the built image with and <container_name>
is the name of the container that will be run. This container will use the OpenFASOC directory as the working directory and bind mount it to the container's present working directory.
Manual Install
Below are the tool requirements along with their currently support versions that are updated regularly upon testing againsts the generators.
Magic <https://github.com/RTimothyEdwards/magic>
_ (version:8.3.464)
Netgen <https://github.com/RTimothyEdwards/netgen>
_ (version:1.5.272)
Klayout <https://github.com/KLayout/klayout>
_ (version:0.28.17-1)
./build.sh -option '-j8' -noruby -without-qt-multimedia -without-qt-xml -without-qt-svg
Yosys <https://github.com/The-OpenROAD-Project/yosys>
_ (version:0.38+92)
OpenROAD <https://github.com/The-OpenROAD-Project/OpenROAD>
_ (version:2.0_12381)
Open_pdks <https://github.com/RTimothyEdwards/open_pdks>
_ (version:1.0.471)
common/platform_config.json
with the installed path, down to the sky130A folderXyce <https://github.com/Xyce/Xyce>
_ (version: 7.6)
Other notice:
python package <https://pypi.org/project/glayout/>
_ and can be installed using pip install glayout
Generators
.. list-table:: :widths: 30 20 20 30 :header-rows: 1
Temperature Sensor Docs <https://openfasoc.readthedocs.io/en/latest/flow-tempsense.html>
_LDO Voltage Regulator Docs <https://openfasoc.readthedocs.io/en/latest/flow-ldo.html>
_Cryogenic Docs <https://openfasoc.readthedocs.io/en/latest/flow-cryo.html>
_Glayout Docs <https://github.com/idea-fasoc/OpenFASOC/tree/main/openfasoc/generators/glayout/tapeout/tapeout_and_RL/README.md>
_Tapeouts and testing setup
Please refer to our testing setup in our tapeouts and testing setup section <https://github.com/idea-fasoc/openfasoc-tapeouts>
_.
Citation
If you find this tool useful in your research, we kindly request to cite our papers:
Tutu Ajayi et al., "An Open-source Framework for Autonomous SoC Design with Analog Block Generation <https://ieeexplore.ieee.org/document/9344104>
_," 2020 IFIP/IEEE 28th International Conference on Very Large Scale Integration (VLSI-SOC), 2020, pp. 141-146.
Qirui Zhang et al., "An Open-Source and Autonomous Temperature Sensor Generator Verified With 64 Instances in SkyWater 130 nm for Comprehensive Design Space Exploration <https://ieeexplore.ieee.org/abstract/document/9816083>
_," in IEEE Solid-State Circuits Letters, vol. 5, pp. 174-177, 2022.