Skip to content

Commit a7e5e8f

Browse files
authored
Merge pull request #1024 from vijayank88/readme_update
Readme update
2 parents 3d98c18 + e362295 commit a7e5e8f

File tree

4 files changed

+91
-11
lines changed

4 files changed

+91
-11
lines changed

README.md

Lines changed: 42 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,51 @@
33
[![Build Status](https://jenkins.openroad.tools/buildStatus/icon?job=OpenROAD-flow-scripts-Public%2Fpublic_tests_all%2Fmaster)](https://jenkins.openroad.tools/view/Public/job/OpenROAD-flow-scripts-Public/job/public_tests_all/job/master/)
44
[![Docs](https://readthedocs.org/projects/openroad-flow-scripts/badge/?version=latest)](https://openroad-flow-scripts.readthedocs.io/en/latest/?badge=latest)
55

6-
OpenROAD Flow is a full RTL-to-GDS flow built entirely on open-source tools.
7-
The project aims for automated, no-human-in-the-loop digital circuit design
8-
with 24-hour turnaround time.
6+
OpenROAD-flow-scripts (ORFS) is a fully autonomous, RTL-GDSII flow
7+
for rapid architecture and design space exploration, early prediction
8+
of QoR and detailed physical design implementation. However, ORFS
9+
also enables manual intervention for finer user control of individual
10+
flow stages through Tcl commands and Python APIs.
11+
12+
![ORFS_Flow](./docs/images/ORFS_Flow.svg)
13+
14+
## Tool Installation
15+
16+
### Local Installation
17+
18+
Document for detailed local installation steps found [here](./docs/user/BuildLocally.md).
19+
20+
### Docker Based Installation
21+
22+
To ease dependency installation issues, ORFS uses docker images.
23+
Docker image includes ORFS binaries, applications as well as all
24+
required dependencies. All of the flow tools are encapsulated
25+
inside the container image.
26+
27+
If `Docker` is not installed already, install latest docker tool
28+
based on OS from [here](https://docs.docker.com/engine/install/).
29+
30+
To manage docker as non-root user and verify that you can run
31+
`docker` commands without `sudo` must complete steps from
32+
[here](https://docs.docker.com/engine/install/linux-postinstall/).
33+
34+
#### Build ORFS with Docker
35+
36+
Document for detailed steps on docker based installation found
37+
[here](./docs/user/BuildWithDocker.md).
938

1039
## Using the Flow
1140

12-
- See the OpenROAD [documentation here](https://openroad.readthedocs.io/en/latest/).
13-
- How to [start using OpenROAD flow here](https://openroad-flow-scripts.readthedocs.io/en/latest/user/GettingStarted.html).
14-
- Our [user guide here](https://openroad-flow-scripts.readthedocs.io/en/latest/user/UserGuide.html).
15-
- Our [Flow Tutorial here](https://openroad-flow-scripts.readthedocs.io/en/latest/tutorials/FlowTutorial.html).
41+
- For details about the OpenROAD and the available features and
42+
individual flows commands, see the documentation
43+
[here](https://openroad.readthedocs.io/en/latest/).
44+
- For details about automated flow setup, see ORFS docs
45+
[here](https://openroad-flow-scripts.readthedocs.io/en/latest/user/GettingStarted.html).
46+
- Flow tutorial to run the complete OpenROAD based flow from
47+
RTL-GDSII, see the tutorial
48+
[here](https://openroad-flow-scripts.readthedocs.io/en/latest/tutorials/FlowTutorial.html).
49+
- To watch ORFS flow tutorial videos, check
50+
[here](https://theopenroadproject.org/video).
1651

1752
## Citing this Work
1853

docs/images/ORFS_Flow.svg

Lines changed: 4 additions & 0 deletions
Loading

docs/images/gcd_final.webp

78.8 KB
Loading

docs/user/BuildLocally.md

Lines changed: 45 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,20 +18,61 @@ sudo ./setup.sh
1818
``` shell
1919
./build_openroad.sh --local
2020
```
21-
> **Note:** There is a `build_openroad.log` file that is generated with every build in the main directory. In case of filing issues, it can be uploaded in the "Relevant log output" section of OpenROAD-flow-scripts repo [issue form](https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts/issues/new?assignees=&labels=&template=bug_report_with_orfs.yml).
21+
> **Note:** There is a `build_openroad.log` file that is generated with every
22+
> build in the main directory. In case of filing issues, it can be uploaded
23+
> in the "Relevant log output" section of OpenROAD-flow-scripts repo
24+
> [issue form](https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts/issues/new?assignees=&labels=&template=bug_report_with_orfs.yml).
2225
2326
## Verify Installation
2427

25-
The binaries should be available on your `$PATH` after setting up the
26-
environment.
28+
The binaries should be available on your `$PATH` after setting
29+
up the environment.
2730

2831
``` shell
2932
source ./env.sh
3033
yosys -help
3134
openroad -help
32-
exit
35+
cd flow
36+
make
3337
```
3438

39+
Above `make` command run from RTL-GDSII generation for default
40+
design `gcd` with `nangate45` pdk. You can view final layout with
41+
OpenROAD GUI as,
42+
43+
```
44+
make gui_final
45+
```
46+
47+
![gcd_final.webp](../images/gcd_final.webp)
48+
49+
## Using Pre-built Binaries
50+
51+
You can download pre-built binaries with self contained dependencies
52+
included from the Precision Innovations github repository
53+
[here](https://github.com/Precision-Innovations/OpenROAD/actions/workflows/github-actions-build-deb-package.yml).
54+
55+
The following platform are supported currently:
56+
- Ubuntu 20.04/22.04
57+
- Debian 10/11
58+
59+
Use following steps to download:
60+
61+
Step 1: Click on the [link](https://github.com/Precision-Innovations/OpenROAD/releases).
62+
63+
Step 2: Download the artifacts for your distribution.
64+
65+
Step 3: Run the install command based on platform use package installer.
66+
For example Ubuntu 20.04 use:
67+
```shell
68+
sudo apt install ./openroad_2.0_amd64-ubuntu20.04.deb
69+
```
70+
71+
You can install these binaries within docker as well.
72+
73+
> **Thanks** to Precision Innovations (www.precisioninno.com) for providing
74+
> and supporting this daily release of pre built installers to the community.
75+
3576
## Compiling and debugging in Visual Studio Code
3677

3778
Set up environment variables to point to tools that CMake from within

0 commit comments

Comments
 (0)