prep-ic 0.1.2__tar.gz → 0.2.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {prep_ic-0.1.2 → prep_ic-0.2.0}/CITATION.cff +2 -1
- {prep_ic-0.1.2 → prep_ic-0.2.0}/PKG-INFO +49 -36
- {prep_ic-0.1.2 → prep_ic-0.2.0}/README.md +47 -34
- {prep_ic-0.1.2 → prep_ic-0.2.0}/pyproject.toml +1 -1
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/__init__.py +1 -1
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/cli.py +11 -1
- prep_ic-0.2.0/src/prep_ic/data/pdks/gf180mcud.json +154 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/pdks/ihp-sg13cmos5l.json +4 -2
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/pdks/ihp-sg13g2.json +4 -2
- prep_ic-0.2.0/src/prep_ic/data/pdks/sky130a.json +391 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/librelane.py +127 -62
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/project_file.py +3 -2
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/chip_view.py +3 -3
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/main_window.py +7 -4
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/qt.py +4 -2
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/chip.py +34 -6
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/constants.py +1 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/floorplan.py +78 -10
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/layout.py +100 -35
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/parse.py +16 -10
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/pdk.py +51 -13
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/project.py +58 -6
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/PKG-INFO +49 -36
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/SOURCES.txt +3 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_chip.py +31 -1
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_floorplan.py +21 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_formats.py +141 -1
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_gui.py +19 -0
- prep_ic-0.2.0/tests/test_pdk.py +778 -0
- prep_ic-0.2.0/tests/test_pdk_lef.py +72 -0
- prep_ic-0.1.2/tests/test_pdk.py +0 -276
- {prep_ic-0.1.2 → prep_ic-0.2.0}/LICENSE +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/LICENSES/Apache-2.0.txt +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/MANIFEST.in +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/REUSE.toml +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/setup.cfg +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/__main__.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/packages.json +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/__init__.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/lef.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/pinlist.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/svg.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/__init__.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/about_dialog.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/app.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/assets/prep_ic_logo.svg +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/macro_panel.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/scene.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/widgets.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/__init__.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/style.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/dependency_links.txt +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/entry_points.txt +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/requires.txt +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/top_level.txt +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_model.py +0 -0
- {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_qt_essentials.py +0 -0
|
@@ -3,11 +3,12 @@ message: "If you base your work on it, please cite it as below."
|
|
|
3
3
|
authors:
|
|
4
4
|
- family-names: Golser
|
|
5
5
|
given-names: Maximilian
|
|
6
|
+
orcid: https://orcid.org/0009-0000-8591-1505
|
|
6
7
|
- family-names: Dorrer
|
|
7
8
|
given-names: Simon
|
|
8
9
|
orcid: https://orcid.org/0009-0001-5994-5477
|
|
9
10
|
title: "GitHub Repository of PREP-IC: Pinout, Ring and Early floorplan Planner for ICs"
|
|
10
|
-
date-released: 2026-11-
|
|
11
|
+
date-released: 2026-11-13
|
|
11
12
|
url: https://github.com/iic-jku/prep-ic
|
|
12
13
|
license: Apache-2.0
|
|
13
14
|
identifiers:
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: prep-ic
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.2.0
|
|
4
4
|
Summary: PREP-IC (Pinout, Ring and Early floorplan Planner for ICs): plan IC pad ring pinouts with live die sizing, RF/GSG pad groups and exports.
|
|
5
5
|
Author-email: Maximilian Golser <maximilian.golser@jku.at>, Simon Dorrer <simon.dorrer@jku.at>
|
|
6
6
|
License-Expression: Apache-2.0
|
|
7
7
|
Project-URL: Homepage, https://github.com/iic-jku/prep-ic
|
|
8
8
|
Project-URL: Repository, https://github.com/iic-jku/prep-ic
|
|
9
9
|
Project-URL: Issues, https://github.com/iic-jku/prep-ic/issues
|
|
10
|
-
Keywords: EDA,IC design,pad ring,IO ring,pinout,floorplan,bondplan,LibreLane,IHP,SG13G2,SG13CMOS5L
|
|
10
|
+
Keywords: EDA,IC design,pad ring,IO ring,pinout,floorplan,bondplan,LibreLane,IHP,SG13G2,SG13CMOS5L,sky130A,gf180mcuD
|
|
11
11
|
Classifier: Development Status :: 4 - Beta
|
|
12
12
|
Classifier: Environment :: X11 Applications :: Qt
|
|
13
13
|
Classifier: Intended Audience :: Science/Research
|
|
@@ -48,7 +48,7 @@ Institute for Integrated Circuits and Quantum Computing (IICQC), Johannes Kepler
|
|
|
48
48
|
|
|
49
49
|
> [!IMPORTANT]
|
|
50
50
|
> PREP-IC (GUI, CLI and Python API) runs anywhere with **Python ≥ 3.10** and **PySide6-Essentials**, see [Install](https://github.com/iic-jku/prep-ic#install) below. The CLI export and the Python API do not load Qt at all.
|
|
51
|
-
> *Using* the exported files needs a **LibreLane** chip flow and the **IHP
|
|
51
|
+
> *Using* the exported files needs a **LibreLane** chip flow and one of the supported PDKs (**IHP SG13G2**, **IHP SG13CMOS5L**, **sky130A** or **gf180mcuD**). The easiest way to get both is the [IIC-OSIC-TOOLS](https://github.com/iic-jku/IIC-OSIC-TOOLS) container.
|
|
52
52
|
|
|
53
53
|
|
|
54
54
|
|
|
@@ -59,7 +59,7 @@ Institute for Integrated Circuits and Quantum Computing (IICQC), Johannes Kepler
|
|
|
59
59
|
It works in three layers, each optional on top of the one before:
|
|
60
60
|
|
|
61
61
|
- **Pad ring.** Plain-text side editors with tags for the pad type, IO function, drive strength, bond pad size and pitch, RF ground-signal-ground groups (`[gsg]`, and `[gsgsg]` for a differential pair), spacers, and power splits that cut the IO ring into domains.
|
|
62
|
-
- **PDK and package.** With
|
|
62
|
+
- **PDK and package.** With a supported PDK chosen, the ring shows the real IO cells, corner cells, bondpads and seal ring spacing, and every pad gets its IO cell. A package from the EUROPRACTICE library gives every pad its package pin. See [Supported PDKs and Packages](https://github.com/iic-jku/prep-ic#supported-pdks-and-packages).
|
|
63
63
|
- **Chip view.** Macros from LibreLane run directories (size and pins from their LEF) are placed in the core, with a flyline from every off-chip macro pin to its pad. Checks flag crossing flylines, split differential pairs, sensitive pads next to noisy ones, macros too close to each other and macros without a supply pad within reach. Pads and macros are dragged in the same picture, and *Optimize Pad Order*, *Add Missing Pads* and *Suggest Supply Pads* do the routine edits. See [Chip view](https://github.com/iic-jku/prep-ic#chip-view).
|
|
64
64
|
|
|
65
65
|
The plan goes straight into the chip flow: the pad ring part of the LibreLane `config.yaml`, a `pad_cfg.tcl` that places the IO cells exactly as planned, a `chip_top.sv` with the IO cell instances, the matching core template, `macros.yaml` and the bondplan `PINOUT`. A pin list (CSV) and the drawing (SVG, PNG) document it.
|
|
@@ -92,6 +92,9 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
92
92
|
├─ 📁 examples/
|
|
93
93
|
│ ├─ 📁 macros/ abstract LEFs of four demo macros (ADC, PLL, LNA, digital core)
|
|
94
94
|
│ ├─ chip_demo.json chip view demo: IHP SG13G2, two domains, four macros, an RF input
|
|
95
|
+
│ ├─ gf180mcud_demo.json gf180mcuD ring
|
|
96
|
+
│ ├─ sky130a_demo.json sky130A ring
|
|
97
|
+
│ ├─ wafer_space_slot_*.json one project per wafer.space gf180mcuD slot
|
|
95
98
|
│ ├─ ihp_sg13g2_domains.json IHP SG13G2 ring on a fixed die, two domains, QFN32 package
|
|
96
99
|
│ ├─ padring.json pad ring without a PDK
|
|
97
100
|
│ └─ script_example.py build, check and export a pad ring in code
|
|
@@ -133,6 +136,7 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
133
136
|
│ ├─ test_gui.py GUI smoke tests
|
|
134
137
|
│ ├─ test_model.py entry parser, settings, die and core sizing
|
|
135
138
|
│ ├─ test_pdk.py PDK profiles, IO cells, LibreLane and bondplan exports
|
|
139
|
+
│ ├─ test_pdk_lef.py every profile against the LEF of its IO library, needs PDK_ROOT (CI has no PDK)
|
|
136
140
|
│ └─ test_qt_essentials.py guards the PySide6-Essentials-only dependency
|
|
137
141
|
├─ 📁 LICENSES/ license texts the REUSE check resolves against
|
|
138
142
|
│ └─ Apache-2.0.txt
|
|
@@ -145,7 +149,7 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
145
149
|
├─ pyproject.toml packaging, dependency and the prep-ic entry point
|
|
146
150
|
├─ README.md
|
|
147
151
|
├─ REUSE.toml licensing of files that cannot carry an SPDX header
|
|
148
|
-
└─ ToDo.md
|
|
152
|
+
└─ ToDo.md planned work
|
|
149
153
|
```
|
|
150
154
|
|
|
151
155
|
|
|
@@ -223,17 +227,18 @@ One line per entry. Each side lists its pads as seen on the die: top and bottom
|
|
|
223
227
|
| `LO [gsgsg]` | differential: GND, LO_P, GND, LO_N, GND |
|
|
224
228
|
| `NAME [in\|out\|tri\|io\|analog\|vdd\|vss\|iovdd\|iovss\|none]` | IO function, selects the IO cell (default guessed from name and type) |
|
|
225
229
|
| `NAME [16mA]` | drive strength of output, tristate and bidirectional cells |
|
|
230
|
+
| `NAME [schmitt]`, `NAME [noesd]` | another IO cell of the same function, where the PDK has one: a Schmitt trigger input, an analog pad without ESD clamp |
|
|
226
231
|
| `NAME [lock]` | locked pad: it can no longer be dragged and *Optimize Pad Order* leaves it in place |
|
|
227
232
|
| `=== NAME` | power split: cuts the IO ring here and starts power domain `NAME` |
|
|
228
233
|
|
|
229
|
-
Options combine: `RFOUT [gsg] {70x70} @125`, `DOUT[3] [out] [4mA]`. An unknown tag or a malformed option stays in the pad name together with the options left of it, so `A [in] [foo]` is a pad named `A [in] [foo]` and `A {60x}` a pad named `A {60x}`. The warning line and `prep-ic check` report it.
|
|
234
|
+
Options combine: `RFOUT [gsg] {70x70} @125`, `DOUT[3] [out] [4mA]`. An unknown tag or a malformed option stays in the pad name together with the options left of it, so `A [in] [foo]` is a pad named `A [in] [foo]` and `A {60x}` a pad named `A {60x}`. A size or pitch below 1 µm and `[0mA]` count as malformed. The warning line and `prep-ic check` report it.
|
|
230
235
|
|
|
231
236
|
### PDK, package and LibreLane
|
|
232
237
|
|
|
233
|
-
In *Settings → Technology* choose a PDK (IHP SG13G2 or
|
|
238
|
+
In *Settings → Technology* choose a PDK (IHP SG13G2, IHP SG13CMOS5L, sky130A or gf180mcuD) and optionally a package from the EUROPRACTICE library.
|
|
234
239
|
|
|
235
240
|
- **With a PDK** the preview shows the real ring: the seal ring spacing, the IO cells, the corner cells and the bondpads (sizes in [Supported PDKs and Packages](https://github.com/iic-jku/prep-ic#supported-pdks-and-packages)). Function and drive of each pad are set in the *Pin List* or with tags in the editor. The rows of the *Pin List* also show the IO cell, the power domain and the package pin.
|
|
236
|
-
- **Power splits**: an `=== NAME` line leaves a 10 µm gap in the IO ring. Every ring segment gets its own rails (`VDD_NAME`, `VSS_NAME`, `IOVDD_NAME`, `IOVSS_NAME`), and without splits they are `VDD`, `VSS`, `IOVDD` and `IOVSS`. PREP-IC warns when a domain has no supply pad of a kind.
|
|
241
|
+
- **Power splits**: an `=== NAME` line leaves a 10 µm gap in the IO ring of an IHP PDK. sky130A and gf180mcuD have no split cell in their profile yet, so there the line stays in the editor and gets a warning. Every ring segment gets its own rails (`VDD_NAME`, `VSS_NAME`, `IOVDD_NAME`, `IOVSS_NAME`), and without splits they are `VDD`, `VSS`, `IOVDD` and `IOVSS`. PREP-IC warns when a domain has no supply pad of a kind.
|
|
237
242
|
- **The LibreLane tab and *File → Export LibreLane Files…*** write:
|
|
238
243
|
- `padring_config.yaml`: `DIE_AREA`, `CORE_AREA`, `PAD_CFG` and the `PAD_SOUTH/EAST/NORTH/WEST` lists, to copy into the LibreLane `config.yaml` (flow `Chip`),
|
|
239
244
|
- `pad_cfg.tcl`: places the IO cells exactly as planned (LibreLane's default script spreads them evenly) and keeps the split gaps free,
|
|
@@ -241,7 +246,8 @@ In *Settings → Technology* choose a PDK (IHP SG13G2 or SG13CMOS5L) and optiona
|
|
|
241
246
|
- `chip_core_template.sv`: the matching core ports, and with macros the instances to create in the core,
|
|
242
247
|
- `macros.yaml` (with macros): `MACROS` with LEF and GDS, the `vh`, `nl`, `pnl`, `lib` and `spef` views found in LibreLane's layout below `final/`, and the instance locations (`i_chip_core.<instance>`),
|
|
243
248
|
- `bondplan_pinout.yaml` (with a package): `PACKAGE_NAME` and `PINOUT` for the bondplan config.
|
|
244
|
-
-
|
|
249
|
+
- An IHP design must still provide the bondpad cell (`PAD_BONDPAD_NAME`, e.g. `sg13g2_ip__bondpad_70x70` with `EXTRA_LEFS` and `EXTRA_GDS`). The IO cells of sky130A and gf180mcuD carry their own bond pad.
|
|
250
|
+
- On sky130A and gf180mcuD, `padring_config.yaml` ends with a comment naming the IO cells LibreLane's disconnected pin check has to skip (gf180mcuD output pads leave `Y` open, the sky130A connect cells and analog pads mark no pin as a power pin). Add them to `IGNORE_DISCONNECTED_MODULES` in your `config.yaml`. The export writes no key there, since it would replace your own list.
|
|
245
251
|
|
|
246
252
|
See [`examples/ihp_sg13g2_domains.json`](https://github.com/iic-jku/prep-ic/blob/main/examples/ihp_sg13g2_domains.json). From the command line:
|
|
247
253
|
|
|
@@ -335,39 +341,46 @@ The GUI tests run offscreen and are skipped when Qt is not installed.
|
|
|
335
341
|
| `prep-ic export chip.json --librelane DIR` | write the LibreLane files into `DIR` (needs a PDK in the project) |
|
|
336
342
|
| `prep-ic check chip.json` | list the findings of the project |
|
|
337
343
|
|
|
338
|
-
The `export` options combine, e.g. `prep-ic export chip.json --csv pins.csv --svg ring.svg`. Each written LibreLane file is printed, and all findings go to stderr. Exit code 0 from `export` says only that the files were written, so gate a script on `check`: it prints one finding per line or `no findings`, and exits 0 when clean, 1 with findings and 2 when the check did not run. A finding is a layout warning, a macro LEF that is gone, a marked pin no longer in the LEF, or what `prep.analyse` reports: unknown tags and options, bad power domain names, crossings, long analog flylines, pins without a pad, split differential pairs, sensitive pads next to noisy ones, macro and supply checks. Both commands run without Qt. From a source checkout without installing, use `python -m prep_ic` with `src` on the Python path in place of `prep-ic`.
|
|
344
|
+
The `export` options combine, e.g. `prep-ic export chip.json --csv pins.csv --svg ring.svg`. Each written LibreLane file is printed, and all findings go to stderr. Exit code 0 from `export` says only that the files were written, so gate a script on `check`: it prints one finding per line or `no findings`, and exits 0 when clean, 1 with findings and 2 when the check did not run. A finding is a layout warning, an entry of the project file that could not be read, a macro LEF that is gone, a marked pin no longer in the LEF, or what `prep.analyse` reports: unknown tags and options, bad power domain names, crossings, long analog flylines, pins without a pad, split differential pairs, sensitive pads next to noisy ones, macro and supply checks. Both commands run without Qt. From a source checkout without installing, use `python -m prep_ic` with `src` on the Python path in place of `prep-ic`.
|
|
339
345
|
|
|
340
346
|
|
|
341
347
|
## Supported PDKs and Packages
|
|
342
348
|
|
|
343
|
-
The PDK profiles are taken from the IO cell LEF and the LibreLane IO config of
|
|
349
|
+
The PDK profiles are taken from the IO cell LEF and the LibreLane IO config of each PDK (`libs.ref/<library>/lef/<io_library>*.lef`, for sky130A `libs.ref/sky130_fd_io/lef/sky130_ef_io.lef`, and `libs.tech/librelane/<io_library>/config.tcl`).
|
|
344
350
|
|
|
345
|
-
| | IHP SG13G2 | IHP SG13CMOS5L |
|
|
346
|
-
|
|
347
|
-
| Profile name | `ihp-sg13g2` | `ihp-sg13cmos5l` |
|
|
348
|
-
| IO library | `sg13g2_io` | `sg13cmos5l_io` |
|
|
349
|
-
| IO cell (width × depth) | 80 × 180 µm | 80 × 180 µm |
|
|
350
|
-
| Corner cell | 180 × 180 µm | 180 × 180 µm |
|
|
351
|
-
|
|
|
352
|
-
| Seal ring spacing | 140 µm | 140 µm |
|
|
353
|
-
| Minimum pad pitch (IO cell width) | 80 µm | 80 µm |
|
|
354
|
-
| Core margin (core power ring) | 45 µm | 45 µm |
|
|
355
|
-
| Power split gap and filler | 10 µm, `sg13g2_Filler2000` | 10 µm, `sg13cmos5l_Filler2000` |
|
|
351
|
+
| | IHP SG13G2 | IHP SG13CMOS5L | sky130A | gf180mcuD |
|
|
352
|
+
|---|---|---|---|---|
|
|
353
|
+
| Profile name | `ihp-sg13g2` | `ihp-sg13cmos5l` | `sky130A` | `gf180mcuD` |
|
|
354
|
+
| IO library | `sg13g2_io` | `sg13cmos5l_io` | `sky130_ef_io` | `gf180mcu_fd_io` |
|
|
355
|
+
| IO cell (width × depth) | 80 × 180 µm | 80 × 180 µm | 80 × 198 µm GPIO, 75 × 198 µm supply, 75 × 200 µm analog | 75 × 350 µm |
|
|
356
|
+
| Corner cell | 180 × 180 µm | 180 × 180 µm | 200 × 204 µm | 355 × 355 µm |
|
|
357
|
+
| Bond pad | 70 × 70 µm, a separate cell | 70 × 70 µm, a separate cell | in the IO cell, 62.6 × 62.45 µm GPIO | in the IO cell, 60 × 60 µm |
|
|
358
|
+
| Seal ring spacing | 140 µm | 140 µm | 0 (added after the ring) | 26 µm |
|
|
359
|
+
| Minimum pad pitch (IO cell width) | 80 µm | 80 µm | 80 µm | 75 µm |
|
|
360
|
+
| Core margin (core power ring) | 45 µm | 45 µm | 100 µm | 61 µm |
|
|
361
|
+
| Power split gap and filler | 10 µm, `sg13g2_Filler2000` | 10 µm, `sg13cmos5l_Filler2000` | none, a split gets a warning | none, a split gets a warning |
|
|
356
362
|
|
|
357
|
-
A new project starts standard pads at the minimum pitch and RF pads at 100 µm. Selecting a PDK in the GUI raises a pitch below
|
|
363
|
+
A new project starts standard pads at 80 µm, the minimum pitch of the IHP PDKs and sky130A, and RF pads at 100 µm. Selecting a PDK in the GUI raises a pitch below its minimum to 100 µm.
|
|
358
364
|
|
|
359
|
-
The IO function of a pad selects its cell (`<lib>` is `sg13g2` or `sg13cmos5l`):
|
|
365
|
+
The IO function of a pad selects its cell (`<lib>` is `sg13g2` or `sg13cmos5l`, the sky130A cells start with `sky130_ef_io__`, the gf180mcuD ones with `gf180mcu_fd_io__`):
|
|
360
366
|
|
|
361
|
-
| Function |
|
|
362
|
-
|
|
363
|
-
| `[in]` | `<lib>_IOPadIn` | |
|
|
364
|
-
| `[out]` | `<lib>_IOPadOut<drive>mA` |
|
|
365
|
-
| `[tri]` | `<lib>_IOPadTriOut<drive>mA` |
|
|
366
|
-
| `[io]` | `<lib>_IOPadInOut<drive>mA` |
|
|
367
|
-
| `[analog]` | `<lib>_IOPadAnalog` | |
|
|
368
|
-
| `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss`
|
|
369
|
-
| `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss`
|
|
370
|
-
| `[none]` | no IO cell | |
|
|
367
|
+
| Function | IHP | sky130A | gf180mcuD |
|
|
368
|
+
|---|---|---|---|
|
|
369
|
+
| `[in]` | `<lib>_IOPadIn` | `gpiov2_pad` | `in_c`, with `[schmitt]` `in_s` |
|
|
370
|
+
| `[out]` | `<lib>_IOPadOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
371
|
+
| `[tri]` | `<lib>_IOPadTriOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
372
|
+
| `[io]` | `<lib>_IOPadInOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
373
|
+
| `[analog]` | `<lib>_IOPadAnalog` | `analog_esd_pad`, with `[noesd]` `analog_noesd_pad` | `asig_5p0` |
|
|
374
|
+
| `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss` | `vccd_lvc_clamped_pad`, `vssd_lvc_clamped_pad` | `dvdd`, `dvss` |
|
|
375
|
+
| `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss` | `vddio_hvc_clamped_pad`, `vssio_hvc_clamped_pad` | `dvdd`, `dvss` |
|
|
376
|
+
| `[none]` | no IO cell | no IO cell | no IO cell |
|
|
377
|
+
| Drive | 4, 16 or 30 mA, default 30 mA | none, a drive tag gets a warning | 24 mA, another drive gets a warning |
|
|
378
|
+
|
|
379
|
+
The control pins of the sky130A and gf180mcuD cells are tied per function in `chip_top.sv`, so the core ports are the same as for IHP.
|
|
380
|
+
|
|
381
|
+
On sky130A, PREP-IC adds two 20 µm connect cells in front of the first IO supply pad. They tie `VCCHIB` to `VCCD`, `VSWITCH` and `VDDA` to `VDDIO`, and `VSSA` to `VSSIO`, and that side grows by 40 µm. On gf180mcuD, the `dvdd` and `dvss` pads short their two supply rings, so the IO supply and the core supply are one net (`VDD`, `VSS`).
|
|
382
|
+
|
|
383
|
+
[`examples/`](https://github.com/iic-jku/prep-ic/tree/main/examples) has one project per wafer.space gf180mcuD slot (`wafer_space_slot_*.json`) with the die of the slot, its pad order and positions, and the supply pads locked. Name your signals and save it under a new name. Three slots put an analog pad next to a digital one, which `prep-ic check` reports as `Sensitive pad next to noisy pad`.
|
|
371
384
|
|
|
372
385
|
The 25 packages are named after the cells of the EUROPRACTICE package library (`EP_PACKAGES_08022018.gds`). Their pins are numbered counter-clockwise, seen from the top.
|
|
373
386
|
|
|
@@ -379,7 +392,7 @@ The 25 packages are named after the cells of the EUROPRACTICE package library (`
|
|
|
379
392
|
| SOIC | 16, 20, 24, 28 | top of the left side |
|
|
380
393
|
| DIL | 16, 24, 28, 40, 48 | top of the left side |
|
|
381
394
|
|
|
382
|
-
A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, a further package one more entry in `src/prep_ic/data/packages.json`.
|
|
395
|
+
A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, with the fields of `model/pdk.py`, a further package one more entry in `src/prep_ic/data/packages.json`.
|
|
383
396
|
|
|
384
397
|
|
|
385
398
|
## Cite This Work
|
|
@@ -398,7 +411,7 @@ A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, a further packa
|
|
|
398
411
|
|
|
399
412
|
## Acknowledgements
|
|
400
413
|
|
|
401
|
-
- The IO cell profiles and the LibreLane pad ring files follow the IO libraries and the LibreLane integration of the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK).
|
|
414
|
+
- The IO cell profiles and the LibreLane pad ring files follow the IO libraries and the LibreLane integration of the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK), sky130A and gf180mcuD, and the ring wiring of the public chip templates [sky130A-ams-chip-template](https://github.com/iic-jku/sky130A-ams-chip-template) and [gf180mcuD-ams-chip-template](https://github.com/iic-jku/gf180mcuD-ams-chip-template).
|
|
402
415
|
- The exports are made for the `Chip` flow of [LibreLane](https://github.com/librelane/librelane).
|
|
403
416
|
- The package names and pin counts come from the [EUROPRACTICE](https://europractice-ic.com) package library.
|
|
404
417
|
|
|
@@ -18,7 +18,7 @@ Institute for Integrated Circuits and Quantum Computing (IICQC), Johannes Kepler
|
|
|
18
18
|
|
|
19
19
|
> [!IMPORTANT]
|
|
20
20
|
> PREP-IC (GUI, CLI and Python API) runs anywhere with **Python ≥ 3.10** and **PySide6-Essentials**, see [Install](https://github.com/iic-jku/prep-ic#install) below. The CLI export and the Python API do not load Qt at all.
|
|
21
|
-
> *Using* the exported files needs a **LibreLane** chip flow and the **IHP
|
|
21
|
+
> *Using* the exported files needs a **LibreLane** chip flow and one of the supported PDKs (**IHP SG13G2**, **IHP SG13CMOS5L**, **sky130A** or **gf180mcuD**). The easiest way to get both is the [IIC-OSIC-TOOLS](https://github.com/iic-jku/IIC-OSIC-TOOLS) container.
|
|
22
22
|
|
|
23
23
|
|
|
24
24
|
|
|
@@ -29,7 +29,7 @@ Institute for Integrated Circuits and Quantum Computing (IICQC), Johannes Kepler
|
|
|
29
29
|
It works in three layers, each optional on top of the one before:
|
|
30
30
|
|
|
31
31
|
- **Pad ring.** Plain-text side editors with tags for the pad type, IO function, drive strength, bond pad size and pitch, RF ground-signal-ground groups (`[gsg]`, and `[gsgsg]` for a differential pair), spacers, and power splits that cut the IO ring into domains.
|
|
32
|
-
- **PDK and package.** With
|
|
32
|
+
- **PDK and package.** With a supported PDK chosen, the ring shows the real IO cells, corner cells, bondpads and seal ring spacing, and every pad gets its IO cell. A package from the EUROPRACTICE library gives every pad its package pin. See [Supported PDKs and Packages](https://github.com/iic-jku/prep-ic#supported-pdks-and-packages).
|
|
33
33
|
- **Chip view.** Macros from LibreLane run directories (size and pins from their LEF) are placed in the core, with a flyline from every off-chip macro pin to its pad. Checks flag crossing flylines, split differential pairs, sensitive pads next to noisy ones, macros too close to each other and macros without a supply pad within reach. Pads and macros are dragged in the same picture, and *Optimize Pad Order*, *Add Missing Pads* and *Suggest Supply Pads* do the routine edits. See [Chip view](https://github.com/iic-jku/prep-ic#chip-view).
|
|
34
34
|
|
|
35
35
|
The plan goes straight into the chip flow: the pad ring part of the LibreLane `config.yaml`, a `pad_cfg.tcl` that places the IO cells exactly as planned, a `chip_top.sv` with the IO cell instances, the matching core template, `macros.yaml` and the bondplan `PINOUT`. A pin list (CSV) and the drawing (SVG, PNG) document it.
|
|
@@ -62,6 +62,9 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
62
62
|
├─ 📁 examples/
|
|
63
63
|
│ ├─ 📁 macros/ abstract LEFs of four demo macros (ADC, PLL, LNA, digital core)
|
|
64
64
|
│ ├─ chip_demo.json chip view demo: IHP SG13G2, two domains, four macros, an RF input
|
|
65
|
+
│ ├─ gf180mcud_demo.json gf180mcuD ring
|
|
66
|
+
│ ├─ sky130a_demo.json sky130A ring
|
|
67
|
+
│ ├─ wafer_space_slot_*.json one project per wafer.space gf180mcuD slot
|
|
65
68
|
│ ├─ ihp_sg13g2_domains.json IHP SG13G2 ring on a fixed die, two domains, QFN32 package
|
|
66
69
|
│ ├─ padring.json pad ring without a PDK
|
|
67
70
|
│ └─ script_example.py build, check and export a pad ring in code
|
|
@@ -103,6 +106,7 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
103
106
|
│ ├─ test_gui.py GUI smoke tests
|
|
104
107
|
│ ├─ test_model.py entry parser, settings, die and core sizing
|
|
105
108
|
│ ├─ test_pdk.py PDK profiles, IO cells, LibreLane and bondplan exports
|
|
109
|
+
│ ├─ test_pdk_lef.py every profile against the LEF of its IO library, needs PDK_ROOT (CI has no PDK)
|
|
106
110
|
│ └─ test_qt_essentials.py guards the PySide6-Essentials-only dependency
|
|
107
111
|
├─ 📁 LICENSES/ license texts the REUSE check resolves against
|
|
108
112
|
│ └─ Apache-2.0.txt
|
|
@@ -115,7 +119,7 @@ The code is split into a pure-Python, Qt-free model and exporters (`prep_ic.mode
|
|
|
115
119
|
├─ pyproject.toml packaging, dependency and the prep-ic entry point
|
|
116
120
|
├─ README.md
|
|
117
121
|
├─ REUSE.toml licensing of files that cannot carry an SPDX header
|
|
118
|
-
└─ ToDo.md
|
|
122
|
+
└─ ToDo.md planned work
|
|
119
123
|
```
|
|
120
124
|
|
|
121
125
|
|
|
@@ -193,17 +197,18 @@ One line per entry. Each side lists its pads as seen on the die: top and bottom
|
|
|
193
197
|
| `LO [gsgsg]` | differential: GND, LO_P, GND, LO_N, GND |
|
|
194
198
|
| `NAME [in\|out\|tri\|io\|analog\|vdd\|vss\|iovdd\|iovss\|none]` | IO function, selects the IO cell (default guessed from name and type) |
|
|
195
199
|
| `NAME [16mA]` | drive strength of output, tristate and bidirectional cells |
|
|
200
|
+
| `NAME [schmitt]`, `NAME [noesd]` | another IO cell of the same function, where the PDK has one: a Schmitt trigger input, an analog pad without ESD clamp |
|
|
196
201
|
| `NAME [lock]` | locked pad: it can no longer be dragged and *Optimize Pad Order* leaves it in place |
|
|
197
202
|
| `=== NAME` | power split: cuts the IO ring here and starts power domain `NAME` |
|
|
198
203
|
|
|
199
|
-
Options combine: `RFOUT [gsg] {70x70} @125`, `DOUT[3] [out] [4mA]`. An unknown tag or a malformed option stays in the pad name together with the options left of it, so `A [in] [foo]` is a pad named `A [in] [foo]` and `A {60x}` a pad named `A {60x}`. The warning line and `prep-ic check` report it.
|
|
204
|
+
Options combine: `RFOUT [gsg] {70x70} @125`, `DOUT[3] [out] [4mA]`. An unknown tag or a malformed option stays in the pad name together with the options left of it, so `A [in] [foo]` is a pad named `A [in] [foo]` and `A {60x}` a pad named `A {60x}`. A size or pitch below 1 µm and `[0mA]` count as malformed. The warning line and `prep-ic check` report it.
|
|
200
205
|
|
|
201
206
|
### PDK, package and LibreLane
|
|
202
207
|
|
|
203
|
-
In *Settings → Technology* choose a PDK (IHP SG13G2 or
|
|
208
|
+
In *Settings → Technology* choose a PDK (IHP SG13G2, IHP SG13CMOS5L, sky130A or gf180mcuD) and optionally a package from the EUROPRACTICE library.
|
|
204
209
|
|
|
205
210
|
- **With a PDK** the preview shows the real ring: the seal ring spacing, the IO cells, the corner cells and the bondpads (sizes in [Supported PDKs and Packages](https://github.com/iic-jku/prep-ic#supported-pdks-and-packages)). Function and drive of each pad are set in the *Pin List* or with tags in the editor. The rows of the *Pin List* also show the IO cell, the power domain and the package pin.
|
|
206
|
-
- **Power splits**: an `=== NAME` line leaves a 10 µm gap in the IO ring. Every ring segment gets its own rails (`VDD_NAME`, `VSS_NAME`, `IOVDD_NAME`, `IOVSS_NAME`), and without splits they are `VDD`, `VSS`, `IOVDD` and `IOVSS`. PREP-IC warns when a domain has no supply pad of a kind.
|
|
211
|
+
- **Power splits**: an `=== NAME` line leaves a 10 µm gap in the IO ring of an IHP PDK. sky130A and gf180mcuD have no split cell in their profile yet, so there the line stays in the editor and gets a warning. Every ring segment gets its own rails (`VDD_NAME`, `VSS_NAME`, `IOVDD_NAME`, `IOVSS_NAME`), and without splits they are `VDD`, `VSS`, `IOVDD` and `IOVSS`. PREP-IC warns when a domain has no supply pad of a kind.
|
|
207
212
|
- **The LibreLane tab and *File → Export LibreLane Files…*** write:
|
|
208
213
|
- `padring_config.yaml`: `DIE_AREA`, `CORE_AREA`, `PAD_CFG` and the `PAD_SOUTH/EAST/NORTH/WEST` lists, to copy into the LibreLane `config.yaml` (flow `Chip`),
|
|
209
214
|
- `pad_cfg.tcl`: places the IO cells exactly as planned (LibreLane's default script spreads them evenly) and keeps the split gaps free,
|
|
@@ -211,7 +216,8 @@ In *Settings → Technology* choose a PDK (IHP SG13G2 or SG13CMOS5L) and optiona
|
|
|
211
216
|
- `chip_core_template.sv`: the matching core ports, and with macros the instances to create in the core,
|
|
212
217
|
- `macros.yaml` (with macros): `MACROS` with LEF and GDS, the `vh`, `nl`, `pnl`, `lib` and `spef` views found in LibreLane's layout below `final/`, and the instance locations (`i_chip_core.<instance>`),
|
|
213
218
|
- `bondplan_pinout.yaml` (with a package): `PACKAGE_NAME` and `PINOUT` for the bondplan config.
|
|
214
|
-
-
|
|
219
|
+
- An IHP design must still provide the bondpad cell (`PAD_BONDPAD_NAME`, e.g. `sg13g2_ip__bondpad_70x70` with `EXTRA_LEFS` and `EXTRA_GDS`). The IO cells of sky130A and gf180mcuD carry their own bond pad.
|
|
220
|
+
- On sky130A and gf180mcuD, `padring_config.yaml` ends with a comment naming the IO cells LibreLane's disconnected pin check has to skip (gf180mcuD output pads leave `Y` open, the sky130A connect cells and analog pads mark no pin as a power pin). Add them to `IGNORE_DISCONNECTED_MODULES` in your `config.yaml`. The export writes no key there, since it would replace your own list.
|
|
215
221
|
|
|
216
222
|
See [`examples/ihp_sg13g2_domains.json`](https://github.com/iic-jku/prep-ic/blob/main/examples/ihp_sg13g2_domains.json). From the command line:
|
|
217
223
|
|
|
@@ -305,39 +311,46 @@ The GUI tests run offscreen and are skipped when Qt is not installed.
|
|
|
305
311
|
| `prep-ic export chip.json --librelane DIR` | write the LibreLane files into `DIR` (needs a PDK in the project) |
|
|
306
312
|
| `prep-ic check chip.json` | list the findings of the project |
|
|
307
313
|
|
|
308
|
-
The `export` options combine, e.g. `prep-ic export chip.json --csv pins.csv --svg ring.svg`. Each written LibreLane file is printed, and all findings go to stderr. Exit code 0 from `export` says only that the files were written, so gate a script on `check`: it prints one finding per line or `no findings`, and exits 0 when clean, 1 with findings and 2 when the check did not run. A finding is a layout warning, a macro LEF that is gone, a marked pin no longer in the LEF, or what `prep.analyse` reports: unknown tags and options, bad power domain names, crossings, long analog flylines, pins without a pad, split differential pairs, sensitive pads next to noisy ones, macro and supply checks. Both commands run without Qt. From a source checkout without installing, use `python -m prep_ic` with `src` on the Python path in place of `prep-ic`.
|
|
314
|
+
The `export` options combine, e.g. `prep-ic export chip.json --csv pins.csv --svg ring.svg`. Each written LibreLane file is printed, and all findings go to stderr. Exit code 0 from `export` says only that the files were written, so gate a script on `check`: it prints one finding per line or `no findings`, and exits 0 when clean, 1 with findings and 2 when the check did not run. A finding is a layout warning, an entry of the project file that could not be read, a macro LEF that is gone, a marked pin no longer in the LEF, or what `prep.analyse` reports: unknown tags and options, bad power domain names, crossings, long analog flylines, pins without a pad, split differential pairs, sensitive pads next to noisy ones, macro and supply checks. Both commands run without Qt. From a source checkout without installing, use `python -m prep_ic` with `src` on the Python path in place of `prep-ic`.
|
|
309
315
|
|
|
310
316
|
|
|
311
317
|
## Supported PDKs and Packages
|
|
312
318
|
|
|
313
|
-
The PDK profiles are taken from the IO cell LEF and the LibreLane IO config of
|
|
319
|
+
The PDK profiles are taken from the IO cell LEF and the LibreLane IO config of each PDK (`libs.ref/<library>/lef/<io_library>*.lef`, for sky130A `libs.ref/sky130_fd_io/lef/sky130_ef_io.lef`, and `libs.tech/librelane/<io_library>/config.tcl`).
|
|
314
320
|
|
|
315
|
-
| | IHP SG13G2 | IHP SG13CMOS5L |
|
|
316
|
-
|
|
317
|
-
| Profile name | `ihp-sg13g2` | `ihp-sg13cmos5l` |
|
|
318
|
-
| IO library | `sg13g2_io` | `sg13cmos5l_io` |
|
|
319
|
-
| IO cell (width × depth) | 80 × 180 µm | 80 × 180 µm |
|
|
320
|
-
| Corner cell | 180 × 180 µm | 180 × 180 µm |
|
|
321
|
-
|
|
|
322
|
-
| Seal ring spacing | 140 µm | 140 µm |
|
|
323
|
-
| Minimum pad pitch (IO cell width) | 80 µm | 80 µm |
|
|
324
|
-
| Core margin (core power ring) | 45 µm | 45 µm |
|
|
325
|
-
| Power split gap and filler | 10 µm, `sg13g2_Filler2000` | 10 µm, `sg13cmos5l_Filler2000` |
|
|
321
|
+
| | IHP SG13G2 | IHP SG13CMOS5L | sky130A | gf180mcuD |
|
|
322
|
+
|---|---|---|---|---|
|
|
323
|
+
| Profile name | `ihp-sg13g2` | `ihp-sg13cmos5l` | `sky130A` | `gf180mcuD` |
|
|
324
|
+
| IO library | `sg13g2_io` | `sg13cmos5l_io` | `sky130_ef_io` | `gf180mcu_fd_io` |
|
|
325
|
+
| IO cell (width × depth) | 80 × 180 µm | 80 × 180 µm | 80 × 198 µm GPIO, 75 × 198 µm supply, 75 × 200 µm analog | 75 × 350 µm |
|
|
326
|
+
| Corner cell | 180 × 180 µm | 180 × 180 µm | 200 × 204 µm | 355 × 355 µm |
|
|
327
|
+
| Bond pad | 70 × 70 µm, a separate cell | 70 × 70 µm, a separate cell | in the IO cell, 62.6 × 62.45 µm GPIO | in the IO cell, 60 × 60 µm |
|
|
328
|
+
| Seal ring spacing | 140 µm | 140 µm | 0 (added after the ring) | 26 µm |
|
|
329
|
+
| Minimum pad pitch (IO cell width) | 80 µm | 80 µm | 80 µm | 75 µm |
|
|
330
|
+
| Core margin (core power ring) | 45 µm | 45 µm | 100 µm | 61 µm |
|
|
331
|
+
| Power split gap and filler | 10 µm, `sg13g2_Filler2000` | 10 µm, `sg13cmos5l_Filler2000` | none, a split gets a warning | none, a split gets a warning |
|
|
326
332
|
|
|
327
|
-
A new project starts standard pads at the minimum pitch and RF pads at 100 µm. Selecting a PDK in the GUI raises a pitch below
|
|
333
|
+
A new project starts standard pads at 80 µm, the minimum pitch of the IHP PDKs and sky130A, and RF pads at 100 µm. Selecting a PDK in the GUI raises a pitch below its minimum to 100 µm.
|
|
328
334
|
|
|
329
|
-
The IO function of a pad selects its cell (`<lib>` is `sg13g2` or `sg13cmos5l`):
|
|
335
|
+
The IO function of a pad selects its cell (`<lib>` is `sg13g2` or `sg13cmos5l`, the sky130A cells start with `sky130_ef_io__`, the gf180mcuD ones with `gf180mcu_fd_io__`):
|
|
330
336
|
|
|
331
|
-
| Function |
|
|
332
|
-
|
|
333
|
-
| `[in]` | `<lib>_IOPadIn` | |
|
|
334
|
-
| `[out]` | `<lib>_IOPadOut<drive>mA` |
|
|
335
|
-
| `[tri]` | `<lib>_IOPadTriOut<drive>mA` |
|
|
336
|
-
| `[io]` | `<lib>_IOPadInOut<drive>mA` |
|
|
337
|
-
| `[analog]` | `<lib>_IOPadAnalog` | |
|
|
338
|
-
| `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss`
|
|
339
|
-
| `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss`
|
|
340
|
-
| `[none]` | no IO cell | |
|
|
337
|
+
| Function | IHP | sky130A | gf180mcuD |
|
|
338
|
+
|---|---|---|---|
|
|
339
|
+
| `[in]` | `<lib>_IOPadIn` | `gpiov2_pad` | `in_c`, with `[schmitt]` `in_s` |
|
|
340
|
+
| `[out]` | `<lib>_IOPadOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
341
|
+
| `[tri]` | `<lib>_IOPadTriOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
342
|
+
| `[io]` | `<lib>_IOPadInOut<drive>mA` | `gpiov2_pad` | `bi_24t` |
|
|
343
|
+
| `[analog]` | `<lib>_IOPadAnalog` | `analog_esd_pad`, with `[noesd]` `analog_noesd_pad` | `asig_5p0` |
|
|
344
|
+
| `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss` | `vccd_lvc_clamped_pad`, `vssd_lvc_clamped_pad` | `dvdd`, `dvss` |
|
|
345
|
+
| `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss` | `vddio_hvc_clamped_pad`, `vssio_hvc_clamped_pad` | `dvdd`, `dvss` |
|
|
346
|
+
| `[none]` | no IO cell | no IO cell | no IO cell |
|
|
347
|
+
| Drive | 4, 16 or 30 mA, default 30 mA | none, a drive tag gets a warning | 24 mA, another drive gets a warning |
|
|
348
|
+
|
|
349
|
+
The control pins of the sky130A and gf180mcuD cells are tied per function in `chip_top.sv`, so the core ports are the same as for IHP.
|
|
350
|
+
|
|
351
|
+
On sky130A, PREP-IC adds two 20 µm connect cells in front of the first IO supply pad. They tie `VCCHIB` to `VCCD`, `VSWITCH` and `VDDA` to `VDDIO`, and `VSSA` to `VSSIO`, and that side grows by 40 µm. On gf180mcuD, the `dvdd` and `dvss` pads short their two supply rings, so the IO supply and the core supply are one net (`VDD`, `VSS`).
|
|
352
|
+
|
|
353
|
+
[`examples/`](https://github.com/iic-jku/prep-ic/tree/main/examples) has one project per wafer.space gf180mcuD slot (`wafer_space_slot_*.json`) with the die of the slot, its pad order and positions, and the supply pads locked. Name your signals and save it under a new name. Three slots put an analog pad next to a digital one, which `prep-ic check` reports as `Sensitive pad next to noisy pad`.
|
|
341
354
|
|
|
342
355
|
The 25 packages are named after the cells of the EUROPRACTICE package library (`EP_PACKAGES_08022018.gds`). Their pins are numbered counter-clockwise, seen from the top.
|
|
343
356
|
|
|
@@ -349,7 +362,7 @@ The 25 packages are named after the cells of the EUROPRACTICE package library (`
|
|
|
349
362
|
| SOIC | 16, 20, 24, 28 | top of the left side |
|
|
350
363
|
| DIL | 16, 24, 28, 40, 48 | top of the left side |
|
|
351
364
|
|
|
352
|
-
A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, a further package one more entry in `src/prep_ic/data/packages.json`.
|
|
365
|
+
A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, with the fields of `model/pdk.py`, a further package one more entry in `src/prep_ic/data/packages.json`.
|
|
353
366
|
|
|
354
367
|
|
|
355
368
|
## Cite This Work
|
|
@@ -368,7 +381,7 @@ A further PDK is one more JSON file in `src/prep_ic/data/pdks/`, a further packa
|
|
|
368
381
|
|
|
369
382
|
## Acknowledgements
|
|
370
383
|
|
|
371
|
-
- The IO cell profiles and the LibreLane pad ring files follow the IO libraries and the LibreLane integration of the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK).
|
|
384
|
+
- The IO cell profiles and the LibreLane pad ring files follow the IO libraries and the LibreLane integration of the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK), sky130A and gf180mcuD, and the ring wiring of the public chip templates [sky130A-ams-chip-template](https://github.com/iic-jku/sky130A-ams-chip-template) and [gf180mcuD-ams-chip-template](https://github.com/iic-jku/gf180mcuD-ams-chip-template).
|
|
372
385
|
- The exports are made for the `Chip` flow of [LibreLane](https://github.com/librelane/librelane).
|
|
373
386
|
- The package names and pin counts come from the [EUROPRACTICE](https://europractice-ic.com) package library.
|
|
374
387
|
|
|
@@ -16,7 +16,7 @@ authors = [
|
|
|
16
16
|
]
|
|
17
17
|
keywords = [
|
|
18
18
|
"EDA", "IC design", "pad ring", "IO ring", "pinout", "floorplan", "bondplan",
|
|
19
|
-
"LibreLane", "IHP", "SG13G2", "SG13CMOS5L",
|
|
19
|
+
"LibreLane", "IHP", "SG13G2", "SG13CMOS5L", "sky130A", "gf180mcuD",
|
|
20
20
|
]
|
|
21
21
|
classifiers = [
|
|
22
22
|
"Development Status :: 4 - Beta",
|
|
@@ -20,6 +20,16 @@ def _print(text):
|
|
|
20
20
|
print(text.encode(encoding, "backslashreplace").decode(encoding))
|
|
21
21
|
|
|
22
22
|
|
|
23
|
+
def _inform(text):
|
|
24
|
+
"""``_print`` for a line nobody has to read: a closed output ends the lines, not the command."""
|
|
25
|
+
try:
|
|
26
|
+
_print(text)
|
|
27
|
+
if sys.stdout is not None:
|
|
28
|
+
sys.stdout.flush()
|
|
29
|
+
except (OSError, ValueError):
|
|
30
|
+
sys.stdout = None # the flush at exit would fail too and turn the exit code into 120
|
|
31
|
+
|
|
32
|
+
|
|
23
33
|
def _export(argv):
|
|
24
34
|
ap = argparse.ArgumentParser(prog="prep-ic export", description="Export a project without the GUI.")
|
|
25
35
|
ap.add_argument("project", help="project file (.json)")
|
|
@@ -38,7 +48,7 @@ def _export(argv):
|
|
|
38
48
|
export_svg(project, args.svg)
|
|
39
49
|
if args.librelane:
|
|
40
50
|
for path in export_librelane(project, args.librelane, source=args.project):
|
|
41
|
-
|
|
51
|
+
_inform(f"wrote {path}")
|
|
42
52
|
except (OSError, ValueError) as e:
|
|
43
53
|
print(f"error: {e}", file=sys.stderr)
|
|
44
54
|
return 1
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "gf180mcuD",
|
|
3
|
+
"label": "GlobalFoundries gf180mcuD",
|
|
4
|
+
"io_library": "gf180mcu_fd_io",
|
|
5
|
+
"_source": "/foss/pdks/gf180mcuD/libs.ref/gf180mcu_fd_io/lef and libs.tech/librelane/gf180mcu_fd_io/config.tcl, pad opening from the GDS (37/0)",
|
|
6
|
+
"site": 0.1,
|
|
7
|
+
"cell_width": 75.0,
|
|
8
|
+
"cell_depth": 355.0,
|
|
9
|
+
"corner": 355.0,
|
|
10
|
+
"edge_spacing": 26.0,
|
|
11
|
+
"bondpad": {
|
|
12
|
+
"w": 60.0,
|
|
13
|
+
"h": 60.0,
|
|
14
|
+
"inset": 2.0
|
|
15
|
+
},
|
|
16
|
+
"default_pitch": 100.0,
|
|
17
|
+
"core_margin": 61.0,
|
|
18
|
+
"rails": {
|
|
19
|
+
"vdd": "VDD",
|
|
20
|
+
"vss": "VSS",
|
|
21
|
+
"iovdd": "VDD",
|
|
22
|
+
"iovss": "VSS"
|
|
23
|
+
},
|
|
24
|
+
"power_pins": {
|
|
25
|
+
"vdd": "VDD",
|
|
26
|
+
"vss": "VSS",
|
|
27
|
+
"iovdd": "DVDD",
|
|
28
|
+
"iovss": "DVSS"
|
|
29
|
+
},
|
|
30
|
+
"ignore_disconnected": [
|
|
31
|
+
"gf180mcu_fd_io__bi_24t"
|
|
32
|
+
],
|
|
33
|
+
"cells": {
|
|
34
|
+
"in": {
|
|
35
|
+
"master": "gf180mcu_fd_io__in_c",
|
|
36
|
+
"variants": {
|
|
37
|
+
"schmitt": {
|
|
38
|
+
"master": "gf180mcu_fd_io__in_s"
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
"pins": {
|
|
42
|
+
"pad": "PAD",
|
|
43
|
+
"in": "Y"
|
|
44
|
+
},
|
|
45
|
+
"ties": {
|
|
46
|
+
"PU": "1'b0",
|
|
47
|
+
"PD": "1'b0"
|
|
48
|
+
}
|
|
49
|
+
},
|
|
50
|
+
"out": {
|
|
51
|
+
"master": "gf180mcu_fd_io__bi_24t",
|
|
52
|
+
"drives": [
|
|
53
|
+
24
|
|
54
|
+
],
|
|
55
|
+
"default_drive": 24,
|
|
56
|
+
"pins": {
|
|
57
|
+
"pad": "PAD",
|
|
58
|
+
"out": "A"
|
|
59
|
+
},
|
|
60
|
+
"ties": {
|
|
61
|
+
"OE": "1'b1",
|
|
62
|
+
"IE": "1'b0",
|
|
63
|
+
"CS": "1'b0",
|
|
64
|
+
"SL": "1'b0",
|
|
65
|
+
"PU": "1'b0",
|
|
66
|
+
"PD": "1'b0",
|
|
67
|
+
"Y": null
|
|
68
|
+
}
|
|
69
|
+
},
|
|
70
|
+
"tri": {
|
|
71
|
+
"master": "gf180mcu_fd_io__bi_24t",
|
|
72
|
+
"drives": [
|
|
73
|
+
24
|
|
74
|
+
],
|
|
75
|
+
"default_drive": 24,
|
|
76
|
+
"pins": {
|
|
77
|
+
"pad": "PAD",
|
|
78
|
+
"out": "A",
|
|
79
|
+
"oe": "OE"
|
|
80
|
+
},
|
|
81
|
+
"ties": {
|
|
82
|
+
"IE": "1'b0",
|
|
83
|
+
"CS": "1'b0",
|
|
84
|
+
"SL": "1'b0",
|
|
85
|
+
"PU": "1'b0",
|
|
86
|
+
"PD": "1'b0",
|
|
87
|
+
"Y": null
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
"inout": {
|
|
91
|
+
"master": "gf180mcu_fd_io__bi_24t",
|
|
92
|
+
"drives": [
|
|
93
|
+
24
|
|
94
|
+
],
|
|
95
|
+
"default_drive": 24,
|
|
96
|
+
"pins": {
|
|
97
|
+
"pad": "PAD",
|
|
98
|
+
"in": "Y",
|
|
99
|
+
"out": "A",
|
|
100
|
+
"oe": "OE"
|
|
101
|
+
},
|
|
102
|
+
"ties": {
|
|
103
|
+
"IE": "1'b1",
|
|
104
|
+
"CS": "1'b0",
|
|
105
|
+
"SL": "1'b0",
|
|
106
|
+
"PU": "1'b0",
|
|
107
|
+
"PD": "1'b0"
|
|
108
|
+
}
|
|
109
|
+
},
|
|
110
|
+
"analog": {
|
|
111
|
+
"master": "gf180mcu_fd_io__asig_5p0",
|
|
112
|
+
"pins": {
|
|
113
|
+
"pad": "ASIG5V",
|
|
114
|
+
"analog": "ASIG5V"
|
|
115
|
+
}
|
|
116
|
+
},
|
|
117
|
+
"vdd": {
|
|
118
|
+
"master": "gf180mcu_fd_io__dvdd",
|
|
119
|
+
"pins": {},
|
|
120
|
+
"power_pins": {
|
|
121
|
+
"vss": "VSS",
|
|
122
|
+
"iovdd": "DVDD",
|
|
123
|
+
"iovss": "DVSS"
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
"vss": {
|
|
127
|
+
"master": "gf180mcu_fd_io__dvss",
|
|
128
|
+
"pins": {},
|
|
129
|
+
"power_pins": {
|
|
130
|
+
"vdd": "VDD",
|
|
131
|
+
"iovdd": "DVDD",
|
|
132
|
+
"iovss": "DVSS"
|
|
133
|
+
}
|
|
134
|
+
},
|
|
135
|
+
"iovdd": {
|
|
136
|
+
"master": "gf180mcu_fd_io__dvdd",
|
|
137
|
+
"pins": {},
|
|
138
|
+
"power_pins": {
|
|
139
|
+
"vss": "VSS",
|
|
140
|
+
"iovdd": "DVDD",
|
|
141
|
+
"iovss": "DVSS"
|
|
142
|
+
}
|
|
143
|
+
},
|
|
144
|
+
"iovss": {
|
|
145
|
+
"master": "gf180mcu_fd_io__dvss",
|
|
146
|
+
"pins": {},
|
|
147
|
+
"power_pins": {
|
|
148
|
+
"vdd": "VDD",
|
|
149
|
+
"iovdd": "DVDD",
|
|
150
|
+
"iovss": "DVSS"
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
}
|