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.
Files changed (57) hide show
  1. {prep_ic-0.1.2 → prep_ic-0.2.0}/CITATION.cff +2 -1
  2. {prep_ic-0.1.2 → prep_ic-0.2.0}/PKG-INFO +49 -36
  3. {prep_ic-0.1.2 → prep_ic-0.2.0}/README.md +47 -34
  4. {prep_ic-0.1.2 → prep_ic-0.2.0}/pyproject.toml +1 -1
  5. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/__init__.py +1 -1
  6. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/cli.py +11 -1
  7. prep_ic-0.2.0/src/prep_ic/data/pdks/gf180mcud.json +154 -0
  8. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/pdks/ihp-sg13cmos5l.json +4 -2
  9. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/pdks/ihp-sg13g2.json +4 -2
  10. prep_ic-0.2.0/src/prep_ic/data/pdks/sky130a.json +391 -0
  11. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/librelane.py +127 -62
  12. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/project_file.py +3 -2
  13. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/chip_view.py +3 -3
  14. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/main_window.py +7 -4
  15. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/qt.py +4 -2
  16. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/chip.py +34 -6
  17. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/constants.py +1 -0
  18. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/floorplan.py +78 -10
  19. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/layout.py +100 -35
  20. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/parse.py +16 -10
  21. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/pdk.py +51 -13
  22. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/project.py +58 -6
  23. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/PKG-INFO +49 -36
  24. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/SOURCES.txt +3 -0
  25. {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_chip.py +31 -1
  26. {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_floorplan.py +21 -0
  27. {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_formats.py +141 -1
  28. {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_gui.py +19 -0
  29. prep_ic-0.2.0/tests/test_pdk.py +778 -0
  30. prep_ic-0.2.0/tests/test_pdk_lef.py +72 -0
  31. prep_ic-0.1.2/tests/test_pdk.py +0 -276
  32. {prep_ic-0.1.2 → prep_ic-0.2.0}/LICENSE +0 -0
  33. {prep_ic-0.1.2 → prep_ic-0.2.0}/LICENSES/Apache-2.0.txt +0 -0
  34. {prep_ic-0.1.2 → prep_ic-0.2.0}/MANIFEST.in +0 -0
  35. {prep_ic-0.1.2 → prep_ic-0.2.0}/REUSE.toml +0 -0
  36. {prep_ic-0.1.2 → prep_ic-0.2.0}/setup.cfg +0 -0
  37. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/__main__.py +0 -0
  38. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/data/packages.json +0 -0
  39. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/__init__.py +0 -0
  40. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/lef.py +0 -0
  41. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/pinlist.py +0 -0
  42. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/formats/svg.py +0 -0
  43. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/__init__.py +0 -0
  44. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/about_dialog.py +0 -0
  45. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/app.py +0 -0
  46. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/assets/prep_ic_logo.svg +0 -0
  47. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/macro_panel.py +0 -0
  48. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/scene.py +0 -0
  49. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/gui/widgets.py +0 -0
  50. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/model/__init__.py +0 -0
  51. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic/style.py +0 -0
  52. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/dependency_links.txt +0 -0
  53. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/entry_points.txt +0 -0
  54. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/requires.txt +0 -0
  55. {prep_ic-0.1.2 → prep_ic-0.2.0}/src/prep_ic.egg-info/top_level.txt +0 -0
  56. {prep_ic-0.1.2 → prep_ic-0.2.0}/tests/test_model.py +0 -0
  57. {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-06
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.1.2
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 Open PDK** (SG13G2 or SG13CMOS5L). The easiest way to get both is the [IIC-OSIC-TOOLS](https://github.com/iic-jku/IIC-OSIC-TOOLS) container.
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 IHP SG13G2 or SG13CMOS5L 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).
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 open defects, release follow-ups, sky130A and gf180mcuD
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 SG13CMOS5L) and optionally a package from the EUROPRACTICE library.
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
- - The design must still provide the bondpad cell (`PAD_BONDPAD_NAME`, e.g. `sg13g2_ip__bondpad_70x70` with `EXTRA_LEFS` and `EXTRA_GDS`), as in any IHP chip.
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 the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK) (`libs.ref/<io_library>/lef/` and `libs.tech/librelane/<io_library>/config.tcl`).
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
- | Bondpad | 70 × 70 µm | 70 × 70 µm |
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 the minimum to 100 µm.
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 | IO cell | Drive |
362
- |---|---|---|
363
- | `[in]` | `<lib>_IOPadIn` | |
364
- | `[out]` | `<lib>_IOPadOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
365
- | `[tri]` | `<lib>_IOPadTriOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
366
- | `[io]` | `<lib>_IOPadInOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
367
- | `[analog]` | `<lib>_IOPadAnalog` | |
368
- | `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss` (core supply) | |
369
- | `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss` (IO supply) | |
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 Open PDK** (SG13G2 or SG13CMOS5L). The easiest way to get both is the [IIC-OSIC-TOOLS](https://github.com/iic-jku/IIC-OSIC-TOOLS) container.
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 IHP SG13G2 or SG13CMOS5L 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).
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 open defects, release follow-ups, sky130A and gf180mcuD
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 SG13CMOS5L) and optionally a package from the EUROPRACTICE library.
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
- - The design must still provide the bondpad cell (`PAD_BONDPAD_NAME`, e.g. `sg13g2_ip__bondpad_70x70` with `EXTRA_LEFS` and `EXTRA_GDS`), as in any IHP chip.
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 the [IHP Open PDK](https://github.com/IHP-GmbH/IHP-Open-PDK) (`libs.ref/<io_library>/lef/` and `libs.tech/librelane/<io_library>/config.tcl`).
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
- | Bondpad | 70 × 70 µm | 70 × 70 µm |
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 the minimum to 100 µm.
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 | IO cell | Drive |
332
- |---|---|---|
333
- | `[in]` | `<lib>_IOPadIn` | |
334
- | `[out]` | `<lib>_IOPadOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
335
- | `[tri]` | `<lib>_IOPadTriOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
336
- | `[io]` | `<lib>_IOPadInOut<drive>mA` | 4, 16 or 30 mA, default 30 mA |
337
- | `[analog]` | `<lib>_IOPadAnalog` | |
338
- | `[vdd]`, `[vss]` | `<lib>_IOPadVdd`, `<lib>_IOPadVss` (core supply) | |
339
- | `[iovdd]`, `[iovss]` | `<lib>_IOPadIOVdd`, `<lib>_IOPadIOVss` (IO supply) | |
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",
@@ -22,7 +22,7 @@ Scripting API (no Qt needed)::
22
22
  """
23
23
 
24
24
  # defined before the imports: submodules import them
25
- __version__ = "0.1.2"
25
+ __version__ = "0.2.0"
26
26
  APP_NAME = "PREP-IC"
27
27
 
28
28
  from .formats.lef import read_lef
@@ -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
- _print(f"wrote {path}")
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
+ }
@@ -14,8 +14,10 @@
14
14
  },
15
15
  "default_pitch": 100.0,
16
16
  "core_margin": 45.0,
17
- "split_gap": 10.0,
18
- "split_filler": "sg13cmos5l_Filler2000",
17
+ "split": {
18
+ "gap": 10.0,
19
+ "filler": "sg13cmos5l_Filler2000"
20
+ },
19
21
  "power_pins": {
20
22
  "vdd": "vdd",
21
23
  "vss": "vss",
@@ -14,8 +14,10 @@
14
14
  },
15
15
  "default_pitch": 100.0,
16
16
  "core_margin": 45.0,
17
- "split_gap": 10.0,
18
- "split_filler": "sg13g2_Filler2000",
17
+ "split": {
18
+ "gap": 10.0,
19
+ "filler": "sg13g2_Filler2000"
20
+ },
19
21
  "power_pins": {
20
22
  "vdd": "vdd",
21
23
  "vss": "vss",