Broccoli/broccoli-cli
3
0
Fork 1
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity

updating readme with new configuration steps

Browse Source
This commit is contained in:
Edward Arthur Bingham 2023-06-05 12:31:46 -04:00
parent 0f5d5950d9
commit 8419241267
1 changed files with 26 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -1,60 +1,63 @@
# Broccoli Development Environment # Broccoli Development Environment
First time use: The following tools are available:
go - architectural and behavioral simulation
haystack - formal synthesis of self-timed circuits
act - circuit design and digital simulation
prspice - configure digital/analog circuit co-simulation
Xyce - analog circuit simulation
gaw - analog waveform viewer
magic - circuit layout
Download the Skywater 130nm PDK and Configuration Files: Semiconductor PDKs are in /opt/cad/conf
Packages may be installed with 'sudo apt install <package>'
Other usages of sudo are disabled
https://broccoli-hosting.s3.us-east-2.amazonaws.com/sky130.tar.gz ## Setup
Extract to your home directory: Download the Skywater 130nm PDK and configuration files, and extract them to your home directory:
``` ```
wget https://broccoli-hosting.s3.us-east-2.amazonaws.com/sky130.tar.gz
mkdir ~/tech; tar -xzvf sky130.tar.gz -C ~/tech mkdir ~/tech; tar -xzvf sky130.tar.gz -C ~/tech
``` ```
Pull the docker image for the broccoli command line interface, and configure it.
First and subsequent use:
Pull the docker image for the broccoli command line interface.
``` ```
docker pull public.ecr.aws/l5h5o6z4/broccoli-cli:latest docker pull public.ecr.aws/l5h5o6z4/broccoli-cli:latest
git clone https://git.broccolimicro.io/Broccoli/broccoli-cli.git
source broccoli-cli/bcli-develop.sh
export BCLI_TECH="$HOME/tech"
``` ```
Setup the broccoli command line interface with the following command. ## Runtime
```
source bcli-develop.sh
```
Download the developement environment and boot it up in docker Boot up the development environment in docker
``` ```
bcli up bcli up
``` ```
Open up a shell inside the development environment. Here you will have access to all of the necessary tools. Open up a shell inside the development environment. Here you will have access to all of the necessary tools.
``` ```
bcli bcli
``` ```
If graphical tools (such as magic and gaw) fail to launch, you may need to install ```xhost``` on your local machine, and grant docker permission to access your X server.
```
xhost +local:docker
```
Your home directory will be mounted at Your home directory will be mounted at
``` ```
/host /host
``` ```
Many of the installed tools may be found at Many of the installed tools may be found at
``` ```
/opt /opt
``` ```
Finally, vim is fully set up for both golang and act. Finally, vim is fully set up for both golang and act.
``` ```
vim file.act vim file.act
``` ```
When you are done, you can shut down the development environment. When you are done, you can shut down the development environment.
``` ```
bcli down bcli down
``` ```
## Troubleshooting
If graphical tools (such as magic and gaw) fail to launch, you may need to install ```xhost``` on your local machine, and grant docker permission to access your X server.
```
xhost +local:docker
```