<p align="center">
<a href="https://github.com/The-OpenROAD-Project/OpenLane">
<img src="./docs/_static/support_banner.svg" style="width: 70%;overflow: visible" alt="Banner explaining that OpenLane 2.0 is not the primary supported option for hardening Caravel User Project-based designs targeting chipIgnite"/>
</a>
</p>
<h1 align="center">OpenLane</h1>
<p align="center">
<a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0"/></a>
<a href="https://www.python.org"><img src="https://img.shields.io/badge/Python-3.8-3776AB.svg?style=flat&logo=python&logoColor=white" alt="Python 3.8 or higher" /></a>
<a href="https://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: black"/></a>
<a href="https://mypy-lang.org/"><img src="https://www.mypy-lang.org/static/mypy_badge.svg" alt="Checked with mypy"/></a>
<a href="https://nixos.org/"><img src="https://img.shields.io/static/v1?logo=nixos&logoColor=white&label=&message=Built%20with%20Nix&color=41439a" alt="Built with Nix"/></a>
</p>
<p align="center">
<a href="https://colab.research.google.com/github/efabless/openlane2/blob/main/notebook.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"></a>
<a href="https://openlane2.readthedocs.io/"><img src="https://readthedocs.org/projects/openlane2/badge/?version=latest" alt="Documentation Build Status Badge"/></a>
<a href="https://open-source-silicon.dev"><img src="https://img.shields.io/badge/Community-Open%20Source%20Silicon%20Slack-ff69b4?logo=slack" alt="Invite to the Open Source Silicon Slack"/></a>
</p>
OpenLane is an ASIC infrastructure library based on several components including
OpenROAD, Yosys, Magic, Netgen, CVC, KLayout and a number of custom scripts for
design exploration and optimization.
A reference flow, "Classic", performs all ASIC implementation steps from RTL all
the way down to GDSII.
You can find the documentation
[here](https://openlane2.readthedocs.io/en/latest/getting_started/) to get
started. You can discuss OpenLane 2 in the
[#openlane-2](https://open-source-silicon.slack.com/archives/C05M85Q5GCF)
channel of the
[Efabless Open Source Silicon Slack](https://invite.skywater.tools).
```mermaid
timeline
title The OpenLane Infrastructure
RTL to Netlist
: Linting / Verilator
: Power Distribution Network Hierarchy / Yosys
: Synthesis / Yosys
: Synthesis / Design Compiler (with proprietary plugin)
: Multi-corner Netlist STA / OpenSTA
Floorplanning
: Floorplan Initialization / OpenROAD
: Manual Macro Placement / OpenDB
: Tap/Endcap Insertion / OpenROAD
: PDN Generation / OpenROAD
Placement
: Pin Placement (from config file) / OpenROAD, OpenDB
: Pin Placement (Random/Matching/Annealing) / OpenROAD
: Pin Placement (from template DEF) / OpenDB
: Global Placement / OpenROAD
: Resizer Design Repair (Post-GPL) / OpenROAD
: Detailed Placement / OpenROAD
Clock Tree Synthesis
: Clock-Tree Synthesis / OpenROAD
: Resizer Timing Repair (Post-CTS) / OpenROAD
Routing
: Global Routing / OpenROAD
: Resizer Design Repair (Post-GRT) / OpenROAD
: Diode Insertion on Ports / OpenDB
: Heuristic Diode Insertion / OpenDB
: Antenna Repair / OpenROAD
: Resizer Timing Repair (Post-GRT) / OpenROAD
: Detailed Routing / OpenROAD
: Row Filling / OpenROAD
Signoff (Timing)
: Parasitics Extraction / OpenROAD
: Multi-corner Static Timing Analysis / OpenSTA
: SI-Enabled Multi-corner Static Timing Analysis / PrimeTime (with proprietary plugin)
Signoff (Physical)
: GDSII Stream-Out / Magic
: GDSII Stream-Out / KLayout
: Magic vs. KLayout Stream XOR / KLayout
: Design Rule Checks / Magic
: Design Rule Checks / KLayout
: Spice Extraction / Magic
: Layout vs. Schematic / Netgen
: Equivalence Check (Alpha) / Yosys EQY
```
## Try it out
You can try OpenLane right in your browser, free-of-charge, using Google
Colaboratory by following
[**this link**](https://colab.research.google.com/github/efabless/openlane2/blob/main/notebook.ipynb).
## Installation
You'll need the following:
* Python **3.8** or higher with PIP, Venv and Tkinter
### Nix (Recommended)
Works for macOS and Linux (x86-64 and aarch64). Recommended, as it is more
integrated with your filesystem and overall has less upload and download deltas.
See
[Nix-based installation](https://openlane2.readthedocs.io/en/latest/getting_started/common/nix_installation/index.html)
in the docs for more info.
### Docker
Works for Windows, macOS and Linux (x86-64 and aarch64).
See
[Docker-based installation](https://openlane2.readthedocs.io/en/latest/getting_started/common/docker_installation/index.html)
in the docs for more info.
Do note you'll need to add `--dockerized` right after `openlane` in most CLI
invocations.
### Python-only Installation (Advanced, Not Recommended)
**You'll need to bring your own compiled utilities**, but otherwise, simply
install OpenLane as follows:
```sh
python3 -m pip install --upgrade openlane
```
Python-only installations are presently unsupported and entirely at your own
risk.
## Usage
In the root folder of the repository, you may invoke:
```sh
python3 -m openlane --pdk-root <path/to/pdk> </path/to/config.json>
```
To start with, you can try:
```sh
python3 -m openlane --pdk-root $HOME/.volare ./designs/spm/config.json
```
## Publication
If you use OpenLane in your research, please cite the following paper.
* M. Shalan and T. Edwards, “Building OpenLANE: A 130nm OpenROAD-based
Tapeout-Proven Flow: Invited Paper,” *2020 IEEE/ACM International Conference
On Computer Aided Design (ICCAD)*, San Diego, CA, USA, 2020, pp. 1-6.
[Paper](https://ieeexplore.ieee.org/document/9256623)
```bibtex
@INPROCEEDINGS{9256623,
author={Shalan, Mohamed and Edwards, Tim},
booktitle={2020 IEEE/ACM International Conference On Computer Aided Design (ICCAD)},
title={Building OpenLANE: A 130nm OpenROAD-based Tapeout- Proven Flow : Invited Paper},
year={2020},
volume={},
number={},
pages={1-6},
doi={}}
```
## License and Information
[The Apache License, version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).
Docker images distributed by Efabless Corporation under the same license.
Binaries bundled with OpenLane either via Cachix or Docker are distributed by
Efabless Corporation and may fall under stricter open source licenses.
Raw data
{
"_id": null,
"home_page": "https://efabless.com",
"name": "openlane",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Efabless Corporation and Contributors",
"author_email": "donn@efabless.com",
"download_url": "https://files.pythonhosted.org/packages/1d/dc/29c1417ec5881081afbb6cd3290e700a080cc7d473d3ead9c0eab2cd2f49/openlane-2.3.10.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/The-OpenROAD-Project/OpenLane\">\n <img src=\"./docs/_static/support_banner.svg\" style=\"width: 70%;overflow: visible\" alt=\"Banner explaining that OpenLane 2.0 is not the primary supported option for hardening Caravel User Project-based designs targeting chipIgnite\"/>\n </a>\n</p>\n\n<h1 align=\"center\">OpenLane</h1>\n<p align=\"center\">\n <a href=\"https://opensource.org/licenses/Apache-2.0\"><img src=\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\" alt=\"License: Apache 2.0\"/></a>\n <a href=\"https://www.python.org\"><img src=\"https://img.shields.io/badge/Python-3.8-3776AB.svg?style=flat&logo=python&logoColor=white\" alt=\"Python 3.8 or higher\" /></a>\n <a href=\"https://github.com/psf/black\"><img src=\"https://img.shields.io/badge/code%20style-black-000000.svg\" alt=\"Code Style: black\"/></a>\n <a href=\"https://mypy-lang.org/\"><img src=\"https://www.mypy-lang.org/static/mypy_badge.svg\" alt=\"Checked with mypy\"/></a>\n <a href=\"https://nixos.org/\"><img src=\"https://img.shields.io/static/v1?logo=nixos&logoColor=white&label=&message=Built%20with%20Nix&color=41439a\" alt=\"Built with Nix\"/></a>\n</p>\n<p align=\"center\">\n <a href=\"https://colab.research.google.com/github/efabless/openlane2/blob/main/notebook.ipynb\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open in Colab\"></a>\n <a href=\"https://openlane2.readthedocs.io/\"><img src=\"https://readthedocs.org/projects/openlane2/badge/?version=latest\" alt=\"Documentation Build Status Badge\"/></a>\n <a href=\"https://open-source-silicon.dev\"><img src=\"https://img.shields.io/badge/Community-Open%20Source%20Silicon%20Slack-ff69b4?logo=slack\" alt=\"Invite to the Open Source Silicon Slack\"/></a>\n</p>\n\nOpenLane is an ASIC infrastructure library based on several components including\nOpenROAD, Yosys, Magic, Netgen, CVC, KLayout and a number of custom scripts for\ndesign exploration and optimization.\n\nA reference flow, \"Classic\", performs all ASIC implementation steps from RTL all\nthe way down to GDSII.\n\nYou can find the documentation\n[here](https://openlane2.readthedocs.io/en/latest/getting_started/) to get\nstarted. You can discuss OpenLane 2 in the\n[#openlane-2](https://open-source-silicon.slack.com/archives/C05M85Q5GCF)\nchannel of the\n[Efabless Open Source Silicon Slack](https://invite.skywater.tools).\n\n```mermaid\ntimeline\n title The OpenLane Infrastructure\n RTL to Netlist\n : Linting / Verilator\n : Power Distribution Network Hierarchy / Yosys\n : Synthesis / Yosys\n : Synthesis / Design Compiler (with proprietary plugin)\n : Multi-corner Netlist STA / OpenSTA\n Floorplanning\n : Floorplan Initialization / OpenROAD\n : Manual Macro Placement / OpenDB\n : Tap/Endcap Insertion / OpenROAD\n : PDN Generation / OpenROAD\n Placement\n : Pin Placement (from config file) / OpenROAD, OpenDB\n : Pin Placement (Random/Matching/Annealing) / OpenROAD\n : Pin Placement (from template DEF) / OpenDB\n : Global Placement / OpenROAD\n : Resizer Design Repair (Post-GPL) / OpenROAD\n : Detailed Placement / OpenROAD\n Clock Tree Synthesis\n : Clock-Tree Synthesis / OpenROAD\n : Resizer Timing Repair (Post-CTS) / OpenROAD\n Routing\n : Global Routing / OpenROAD\n : Resizer Design Repair (Post-GRT) / OpenROAD\n : Diode Insertion on Ports / OpenDB\n : Heuristic Diode Insertion / OpenDB\n : Antenna Repair / OpenROAD\n : Resizer Timing Repair (Post-GRT) / OpenROAD\n : Detailed Routing / OpenROAD\n : Row Filling / OpenROAD\n Signoff (Timing)\n : Parasitics Extraction / OpenROAD\n : Multi-corner Static Timing Analysis / OpenSTA\n : SI-Enabled Multi-corner Static Timing Analysis / PrimeTime (with proprietary plugin)\n Signoff (Physical)\n : GDSII Stream-Out / Magic\n : GDSII Stream-Out / KLayout\n : Magic vs. KLayout Stream XOR / KLayout\n : Design Rule Checks / Magic\n : Design Rule Checks / KLayout\n : Spice Extraction / Magic\n : Layout vs. Schematic / Netgen\n : Equivalence Check (Alpha) / Yosys EQY\n```\n\n## Try it out\n\nYou can try OpenLane right in your browser, free-of-charge, using Google\nColaboratory by following\n[**this link**](https://colab.research.google.com/github/efabless/openlane2/blob/main/notebook.ipynb).\n\n## Installation\n\nYou'll need the following:\n\n* Python **3.8** or higher with PIP, Venv and Tkinter\n\n### Nix (Recommended)\n\nWorks for macOS and Linux (x86-64 and aarch64). Recommended, as it is more\nintegrated with your filesystem and overall has less upload and download deltas.\n\nSee\n[Nix-based installation](https://openlane2.readthedocs.io/en/latest/getting_started/common/nix_installation/index.html)\nin the docs for more info.\n\n### Docker\n\nWorks for Windows, macOS and Linux (x86-64 and aarch64).\n\nSee\n[Docker-based installation](https://openlane2.readthedocs.io/en/latest/getting_started/common/docker_installation/index.html)\nin the docs for more info.\n\nDo note you'll need to add `--dockerized` right after `openlane` in most CLI\ninvocations.\n\n### Python-only Installation (Advanced, Not Recommended)\n\n**You'll need to bring your own compiled utilities**, but otherwise, simply\ninstall OpenLane as follows:\n\n```sh\npython3 -m pip install --upgrade openlane\n```\n\nPython-only installations are presently unsupported and entirely at your own\nrisk.\n\n## Usage\n\nIn the root folder of the repository, you may invoke:\n\n```sh\npython3 -m openlane --pdk-root <path/to/pdk> </path/to/config.json>\n```\n\nTo start with, you can try:\n\n```sh\npython3 -m openlane --pdk-root $HOME/.volare ./designs/spm/config.json\n```\n\n## Publication\n\nIf you use OpenLane in your research, please cite the following paper.\n\n* M. Shalan and T. Edwards, \u201cBuilding OpenLANE: A 130nm OpenROAD-based\n Tapeout-Proven Flow: Invited Paper,\u201d *2020 IEEE/ACM International Conference\n On Computer Aided Design (ICCAD)*, San Diego, CA, USA, 2020, pp. 1-6.\n [Paper](https://ieeexplore.ieee.org/document/9256623)\n\n```bibtex\n@INPROCEEDINGS{9256623,\n author={Shalan, Mohamed and Edwards, Tim},\n booktitle={2020 IEEE/ACM International Conference On Computer Aided Design (ICCAD)}, \n title={Building OpenLANE: A 130nm OpenROAD-based Tapeout- Proven Flow : Invited Paper}, \n year={2020},\n volume={},\n number={},\n pages={1-6},\n doi={}}\n```\n\n## License and Information\n\n[The Apache License, version 2.0](https://www.apache.org/licenses/LICENSE-2.0.txt).\n\nDocker images distributed by Efabless Corporation under the same license.\n\nBinaries bundled with OpenLane either via Cachix or Docker are distributed by\nEfabless Corporation and may fall under stricter open source licenses.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An infrastructure for implementing chip design flows",
"version": "2.3.10",
"project_urls": {
"Documentation": "https://openlane.readthedocs.io",
"Homepage": "https://efabless.com",
"Repository": "https://github.com/efabless/openlane"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8d071fc4901f2aab3801d2fc90085e625aa628a2a1b09a497d64fadac92e3215",
"md5": "5fd6025cfb0df51cc5bcba8c3e3addf9",
"sha256": "83d19d7b9b589c10349576701d0cd69bbed7e8f1ad4ee384b7ff9f4dce2a79ee"
},
"downloads": -1,
"filename": "openlane-2.3.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5fd6025cfb0df51cc5bcba8c3e3addf9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.8",
"size": 377387,
"upload_time": "2025-02-21T14:57:50",
"upload_time_iso_8601": "2025-02-21T14:57:50.470009Z",
"url": "https://files.pythonhosted.org/packages/8d/07/1fc4901f2aab3801d2fc90085e625aa628a2a1b09a497d64fadac92e3215/openlane-2.3.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1ddc29c1417ec5881081afbb6cd3290e700a080cc7d473d3ead9c0eab2cd2f49",
"md5": "3efa756190f4a44c47b54221e5c893de",
"sha256": "8293ea36c5df4f599e03979d3b857e6fb6e6c28bf3fee8c4bdfc6956124f8fb9"
},
"downloads": -1,
"filename": "openlane-2.3.10.tar.gz",
"has_sig": false,
"md5_digest": "3efa756190f4a44c47b54221e5c893de",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.8",
"size": 273832,
"upload_time": "2025-02-21T14:57:52",
"upload_time_iso_8601": "2025-02-21T14:57:52.339277Z",
"url": "https://files.pythonhosted.org/packages/1d/dc/29c1417ec5881081afbb6cd3290e700a080cc7d473d3ead9c0eab2cd2f49/openlane-2.3.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-21 14:57:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "efabless",
"github_project": "openlane",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "openlane"
}
JSON
