update readme
diff --git a/README.md b/README.md index 3077244..098848c 100644 --- a/README.md +++ b/README.md
@@ -1,12 +1,61 @@ -# Caravel User Project +# Kasırga K0 RISC-V SoC [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/efabless/caravel_project_example/actions/workflows/user_project_ci.yml) [](https://github.com/efabless/caravel_project_example/actions/workflows/caravel_build.yml) -| :exclamation: Important Note | -|-----------------------------------------| -## Please fill in your project documentation in this README.md file +Table of contents +================= -Refer to [README](docs/source/quickstart.rst) for a quick start of how to use caravel_user_project +- [Overview](#overview) +- [K0 Block Diagram](#k0-block-diagram) +- [Key Features](#key-features) +- [Prerequisites](#prerequisites) +- [Running Full Chip Simulation](#tests) +- [Hardening the Kasirga K0 using Openlane](#hardening) +- [Checklist for Open-MPW Submission](#checklist) -Refer to [README](docs/source/index.rst) for this sample project documentation. + +Overview +======== + +This repo contains the RISC-V based K0 SoC that utilizes ``caravel`` chip user space. +K0 is an silicon-proven SoC that has a RISC-V core (RV32-IM ISA) and AN UART module @ 115200 baudrate. +The repo also contains all required files to run all RV32-IM ISA tests. + +# K0 Block Diagram + +TBA + + +# Key Features + +TBA + + +# Prerequisites + +TBA + +# Running Full Chip Simulation + +TBA + +# Hardening the Kasirga K0 using Openlane + +TBA + +# Checklist for Open-MPW Submission + +- ✔️ The project repo adheres to the same directory structure in this + repo. +- ✔️ The project repo contain info.yaml at the project root. +- ✔️ Top level macro is named ``user_project_wrapper``. +- ✔️ Full Chip Simulation passes for RTL and GL (gate-level) +- ✔️ The hardened Macros are LVS and DRC clean +- ✔️ The project contains a gate-level netlist for ``user_project_wrapper`` at verilog/gl/user_project_wrapper.v +- ✔️ The hardened ``user_project_wrapper`` adheres to the same pin order specified at ``pin\_order`` +- ✔️ The hardened ``user_project_wrapper`` adheres to the fixed wrapper configuration specified at ``fixed_wrapper_cfgs`` +- ✔️ XOR check passes with zero total difference. +- ✔️ Openlane summary reports are retained under ./signoff/ +- ✔️ The design passes the ``mpw-precheck`` +