From 49af00313dac04357f537ae563e04985ab8b9669 Mon Sep 17 00:00:00 2001 From: Eren Dogan Date: Sun, 5 Mar 2023 21:22:03 -0800 Subject: [PATCH] Add pip installation to documentation --- docs/source/basic_setup.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/docs/source/basic_setup.md b/docs/source/basic_setup.md index 83f2c544..78edc352 100644 --- a/docs/source/basic_setup.md +++ b/docs/source/basic_setup.md @@ -30,11 +30,9 @@ In general, the OpenRAM compiler has very few dependencies: ## OpenRAM Library OpenRAM is available as a Python library. There are a few ways to install it: -+ Install using Makefile (you need to clone the repo): ++ Install the latest _stable_ version with pip: ``` -git clone git@github.com:VLSIDA/OpenRAM.git -cd OpenRAM -make library +pip3 install openram ``` + Install the latest _dev_ version: @@ -42,6 +40,13 @@ make library pip3 install git+https://git@github.com/VLSIDA/OpenRAM.git@dev ``` ++ Install using Makefile (you need to clone the repo): +``` +git clone git@github.com:VLSIDA/OpenRAM.git +cd OpenRAM +make library +``` + ## Anaconda @@ -52,7 +57,8 @@ worry about updating/installing these tools. OpenRAM installs Anaconda silently OpenRAM uses Anaconda by default, but you can turn this feature off by setting `use_conda = False` in your config file. Then, OpenRAM will use the tools you have installed on your system. -If you want to install Anaconda without running OpenRAM (for example to run unit tests, which do not install Anaconda), you can run: +If you want to install Anaconda without running OpenRAM (for example to run unit tests, which do +not install Anaconda), you can run: ``` cd OpenRAM ./install_conda.sh @@ -87,15 +93,15 @@ needed if you have the library. You can add these environment variables to your `.bashrc`: ``` - export OPENRAM_HOME="$HOME/OpenRAM/compiler" - export OPENRAM_TECH="$HOME/OpenRAM/technology" - export PYTHONPATH=$OPENRAM_HOME +export OPENRAM_HOME="$HOME/OpenRAM/compiler" +export OPENRAM_TECH="$HOME/OpenRAM/technology" +export PYTHONPATH=$OPENRAM_HOME ``` Note that if you want symbols to resolve in your editor, you may also want to add the specific technology directory that you use and any custom technology modules as well. For example: ``` - export PYTHONPATH="$OPENRAM_HOME:$OPENRAM_TECH/sky130:$OPENRAM_TECH/sky130/custom" +export PYTHONPATH="$OPENRAM_HOME:$OPENRAM_TECH/sky130:$OPENRAM_TECH/sky130/custom" ``` We include the tech files necessary for [SCMOS] SCN4M\_SUBM,