Go to file
Tim Edwards 55836db2d2 Added a reference to the new file "gl/mgmt_defines.v" in the
caravel_pico repository.  The issue is that each SoC implementation
defines its own modules and therefore needs its own includes.  The
implication is that this file now needs to exist in every SoC
implementation's verilog/gl/ directory.
2021-12-24 11:46:34 -05:00
.github/workflows add documentation 2021-12-17 11:55:08 -08:00
.travisCI add documentation 2021-12-17 11:55:08 -08:00
def [DATA] Update sdf for chip_io to include pad delays 2021-12-16 15:58:58 +02:00
docs Added more documentation, fully documenting the GPIO, and various 2021-12-23 11:54:36 -05:00
gds adding user_project_wrapper empty files -- gds & lef 2021-12-16 13:56:36 -08:00
lef adding user_project_wrapper empty files -- gds & lef 2021-12-16 12:29:35 -08:00
mag Corrected a statement in the LVS scripts in the mag/ directory that 2021-12-17 22:27:32 -05:00
maglef [DATA] Update caravel_clocking 2021-12-07 13:36:56 +02:00
openlane Apply automatic changes to Manifest and README.rst 2021-12-17 01:51:53 +00:00
scripts Correction to the gen_gpio_defaults.py file, which was accidentally 2021-12-04 12:41:06 -05:00
sdc Update sdf file divider 2021-12-14 14:30:00 +02:00
sdf [DATA] Update sdf for chip_io to include pad delays 2021-12-16 15:58:58 +02:00
signoff [DATA] Update caravel_clocking 2021-12-07 13:36:56 +02:00
spef [DATA] Update sdf for chip_io to include pad delays 2021-12-16 15:58:58 +02:00
spi/lvs Update spice netlists to include power routing 2021-12-21 19:34:43 +02:00
verilog Added a reference to the new file "gl/mgmt_defines.v" in the 2021-12-24 11:46:34 -05:00
xschem Added the files for the simple_por block design, and placed the latest 2021-11-15 10:34:52 -05:00
.gitignore added install_mcw make target 2021-11-24 09:23:58 -08:00
.readthedocs.yml add documentation 2021-12-17 11:55:08 -08:00
.travis.yml add documentation 2021-12-17 11:55:08 -08:00
LICENSE Create LICENSE 2021-12-15 23:53:39 -08:00
Makefile Update Makefile 2021-12-22 12:05:09 -08:00
README.rst Apply automatic changes to Manifest and README.rst 2021-12-17 19:58:20 +00:00
README.src.rst add documentation 2021-12-17 11:55:08 -08:00
manifest add manifest 2021-12-16 14:26:20 -08:00

README.src.rst

.. raw:: html

   <!---
   # SPDX-FileCopyrightText: 2020 Efabless Corporation
   #
   # Licensed under the Apache License, Version 2.0 (the "License");
   # you may not use this file except in compliance with the License.
   # You may obtain a copy of the License at
   #
   #      http://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS,
   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   # See the License for the specific language governing permissions and
   # limitations under the License.
   #
   # SPDX-License-Identifier: Apache-2.0
   -->

Caravel Harness
===============

|License| |Documentation Status| |Build Status|

.. note::

   Documentation for this project is being updated to reflect the changes
   for the new redesigned version of Caravel.

Table of contents
=================

-  `Overview <#overview>`__
-  `Caravel Architecture <#caravel-architecture>`__
-  `Quick Start for User Projects  <#quick-start-for-user-projects>`__

   - `Digital User Project <#digital-user-project>`__
   - `Analog User Project <#analog-user-project>`__

-  `Required Directory Structure <#required-directory-structure>`__
-  `Additional Material <#additional-material>`__

Overview
========

Caravel is a template SoC for Efabless Open MPW and chipIgnite shuttles based on the Sky130 node from SkyWater Technologies. The
current SoC architecture is given below.

.. image:: docs/source/_static/caravel_block_diagram.jpg
    :align: center

Datasheet and detailed documentation exist `here <https://caravel-harness.readthedocs.io/>`__

.. include:: docs/source/getting-started.rst

.. |License| image:: https://img.shields.io/github/license/efabless/caravel
   :alt: GitHub license - Apache 2.0
   :target: https://github.com/efabless/caravel
.. |Documentation Status| image:: https://readthedocs.org/projects/caravel-harness/badge/?version=latest
   :alt: ReadTheDocs Badge - https://caravel-harness.rtfd.io
   :target: https://caravel-harness.readthedocs.io/en/latest/?badge=latest
.. |Build Status| image:: https://travis-ci.com/efabless/caravel.svg?branch=master
   :alt: Travis Badge - https://travis-ci.org/efabless/caravel
   :target: https://travis-ci.com/efabless/caravel