diff --git a/README.md b/README.md index 0e7959f..5fa1544 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,62 @@ -# GF180_Tour +# (Quick and short) Virtual Roundtrip through the GF180 Open-Source Chips +This document is a list of Open-Source Links to understand and examine the GF180 Open-Soruce Mikrochips. These chips were fabricated in 2023 and were payed by Google. +Author: Thorsten Knoll +Date: 07.12.2023 +Licence: Copyleft, GPL v3.0, https://www.gnu.org/licenses/gpl-3.0.html + +## CMOS +Task: +Make yourself comfortable with the layers of a CMOS transistor. Later on you will try to match the layers and their names in different documents (GF180 PDK) and tools (Klayout). +https://en.wikipedia.org/wiki/CMOS + +## GlobalFoundry 180 (GF180) Open-Source PDK +Task: +This is the documentation of the GF180 Open-Source PDK. It is the base for understanding the inside of the chips. Try to get a hang of the structure of the documentation. +GF180 PDK Read the docs: +https://gf180mcu-pdk.readthedocs.io/en/latest/ + +Task: +You remember the layers (like nwell, polysilicon, metal1?). Try to make a match with the names and numbers in this layerlist. The numbers will appear later on in the tool KLayout. +GF180 PDK, Layer List: +https://gf180mcu-pdk.readthedocs.io/en/latest/physical_verification/design_manual/drm_04_1.html + +## Find the GDS in the TapeOut resources +TapeOut resources for all Google payed open-source shuttleruns: +https://foss-eda-tools.googlesource.com/ + +Task: +Download and unpack the GDS of the chip you have. On the chip-package is a Projectnumber engraved (like C5, D5, B3). + +Step 1: +GF180 Foundries list of projects. Take the Projectnumber and look up the Project-ID in the manifest csv. Make sure the name of the project matches with what you expect (example: C5, 023, tiny_user_project_74181_alu) +https://foss-eda-tools.googlesource.com/third_party/shuttle/gf180mcu/mpw-000/foundry/ + +Step 2: +Walk around in the Repo of the Design (Project-ID is the slotnumber). Try to find the folder ```/tapeout/outputs/gds/```. Download the tarball of the gds and unpack. +https://foss-eda-tools.googlesource.com/third_party/shuttle/gf180mcu/mpw-000/ + +## Inspect and examine the GDS with KLayout +Task: +Use the Open-Source tool KLayout to view the GDS file. Disable and enable single layers in the GDS, matching with the layerlist from the PDK docs. Zoom in and focus on a single standard cell. Zoom out to identify different areas of the chip. Identify (some of) these areas. + +Step 1: +Install KLayout. Get it here: https://www.klayout.de/build.html + +Step 2: +Open the unpacked GDS from the chip in KLayout. Make empty layers invisible. Match the non-empty layers with the docs of the PDK and the CMOS transistor layers. Try to find "The build order of the chip", according to the CMOS wiki. + +Step 3: +ToDo: +- Zoom In: Pick a single cell +- Zoom out: Caravel Risc-V parts (Next chapter?) +- User Wrapper and user area. + +## Efabless Caravel Risc-V +ToDo. +https://caravel-harness.readthedocs.io/en/latest/ +https://github.com/efabless/caravel + +Problems: +The caravel Risc-V development is fast, confusing and kinda mostly unstructured. There is a lot of deprecated information in the interwebs. I am not sure if i want to deal with that, as it feels like useless work to do. And the caravel on the GF180 chips did not get used for long. + -A quick tour around the GF180 chips. \ No newline at end of file