Google Git
Sign in
foss-eda-tools / third_party / shuttle / sky130 / mpw-001 / slot-015 / 29e74e3d7be4ffaae6c05d09118dcd1f149d214e
commit29e74e3d7be4ffaae6c05d09118dcd1f149d214e[log] [tgz]
authoragorararmard <aagouhar@efabless.com>Thu Nov 26 22:43:46 2020 +0200
committeragorararmard <aagouhar@efabless.com>Thu Nov 26 22:44:25 2020 +0200
tree40335f3e00939a0d21c968f1ffe93da9acf6048f
parent3243208a59239336b0e88f1d8ed88c2981e9502a [diff]
[Docs]: update openlane documentation to include openlane installation and basic macro powering considerations
1 file changed
tree: 40335f3e00939a0d21c968f1ffe93da9acf6048f
  1. .travisCI/
  2. def/
  3. doc/
  4. gds/
  5. lef/
  6. macros/
  7. mag/
  8. ngspice/
  9. openlane/
  10. qflow/
  11. scripts/
  12. spi/
  13. verilog/
  14. .travis.yml
  15. info.yaml
  16. LICENSE
  17. Makefile
  18. README.md
README.md

CIIC Harness

A template SoC for Google SKY130 free shuttles. It is still WIP. The current SoC architecture is given below.

Getting Started:

Start by cloning the repo and uncompressing the files.

git clone https://github.com/efabless/caravel.git
cd caravel
make uncompress

Install the required version of the PDK by running the following commands:

export PDK_ROOT=<The place where you want to install the pdk>
make pdk

Then, you can learn more about the caravel chip by watching these video:

Aboard Caravel:

Your area is the full user_project_wrapper, so feel free to add your project there or create a differnt macro and harden it seperately then insert it into the user_project_wrapper.

If you will use OpenLANE to harden your design, go through the instructions in this README.md.

Then, you will need to put your design aboard the Caravel chip. In the Caravel directory, make sure you have the following:

  • Magic installed on your machine. We may provide a Dockerized version later.
  • You have your user_project_wrapper.gds under ./gds/ directory.

Run the following command:

export PDK_ROOT=<The place where the installed pdk resides. The same PDK_ROOT used in the pdk installation step>
make

This should merge the GDSes using magic and you'll end up with your version of ./gds/caravel.gds.

Managment SoC

The managment SoC runs firmware that can be used to:

  • Configure User Project I/O pads
  • Observe and control User Project signals (through on-chip logic analyzer probes)
  • Control the User Project power supply

The memory map of the management SoC can be found here

User Project Area

This is the user space. It has limited silicon area (TBD, about 3.1mm x 3.8mm) as well as a fixed number of I/O pads (37) and power pads (10). See the Caravel premliminary datasheet for details. The repository contains a sample user project that contains a binary 32-bit up counter.

The firmware running on the Management Area SoC, configures the I/O pads used by the counter and uses the logic probes to observe/control the counter. Three firmware examples are provided:

  1. Configure the User Project I/O pads as o/p. Observe the counter value in the testbench: IO_Ports Test.
  2. Configure the User Project I/O pads as o/p. Use the Chip LA to load the counter and observe the o/p till it reaches 500: LA_Test1.
  3. Configure the User Project I/O pads as o/p. Use the Chip LA to control the clock source and reset signals and observe the counter value for five clock cylcles: LA_Test2.