PDK¶
PDK(プロセスデザインキット)は、Undine が製造プロセスについて知っていることのすべてです。レイヤーとデザインルール、DRC と LVS のデッキ、SPICE モデル、デバイスのシンボル、PCell のジェネレータが含まれます。PDK はサーバーにだけ置き、ブラウザには レイヤーの名前と色、生成した形状だけを渡します。モデルやルールデッキは渡しません。
Undine は PDK を同梱していません。PDK はオープンソースの PDK バージョン管理ツール ciel で入れ、各プロジェクトは 1 つの PDK の 1 つのバージョンに固定します。 このページでは、Undine が対応する PDK、そのインストール方法、プロジェクトが PDK を記録する方法、プロジェクトを別のバージョンへ 移す方法を説明します。
対応している PDK¶
| PDK | バリアント | Undine で動作確認したバージョン | 使えるもの |
|---|---|---|---|
| SkyWater SKY130 | sky130A、sky130B |
open_pdks 8afc8346a57fe1ab7934ba5a6056ea8b43078e71(2025 年)。./setup.sh が入れます |
KLayout の DRC と LVS、Magic DRC、Magic + Netgen LVS、コーナー tt、ss、ff、sf、fs での ngspice、PDK の PCell、Tiny Tapeout と Caravel のテープアウトのターゲット |
| GlobalFoundries GF180MCU | gf180mcuA(メタル 3 層)、gf180mcuB(4 層)、gf180mcuC、gf180mcuD(5 層) |
open_pdks 792ef67037d74c8c51811eab3ce23cf793491296(wafer.space が固定しているバージョン) |
KLayout の DRC と LVS、Magic DRC、Magic + Netgen LVS、typical、ss、ff、sf、fs での ngspice、29 種類の PCell(nfet、pfet、抵抗、MIM / MOS 容量、ダイオード、BJT、ビア)、wafer.space のテープアウトのターゲット |
| IHP SG13G2 | ihp-sg13g2 |
IHP-Open-PDK 89d42ee6d2fd9b50b86a1aada6fee6673c3e6008 |
KLayout の DRC と LVS、Magic DRC、Magic + Netgen LVS、Verilog-A のモデルをコンパイルした後の mos_tt、mos_ss、mos_ff、mos_sf、mos_fs での ngspice、38 種類の PCell(nmos、pmos、抵抗、MIM 容量など) |
| IHP SG13CMOS5L | ihp-sg13cmos5l |
未確認(ciel が ihp-sg13 ファミリーと一緒に入れます) |
未検証。KLayout DRC と Magic DRC。Magic + Netgen LVS と ngspice(mos_* コーナー、モデルをコンパイルした後)は SG13G2 と同じように設定してありますが、実行したことはありません。KLayout LVS はなく(Undine がまだ設定していません)、PCell もなく、PDK には標準セルのライブラリがありません |
レイアウトエディタの PCell パネルでは各 PDK 自身の PCell を置けます。
レイアウトエディタの回路図駆動レイアウトは、SKY130、GF180MCU、SG13G2 で、回路図から MOSFET、抵抗、
MIM 容量を生成します。幅のパラメータに注意してください。GF180MCU の w_gate は 1 フィンガーあたり、SG13G2 の w は ng 本の
ゲートの合計です。
これらの PDK のほかのバージョンも、たいていは動きますが、動作確認はしていません。例外は 2025 年より前の open_pdks の SKY130 で、その PCell コードを Undine はもう実行しません(サポートが終了したバージョンを参照)。
ほかのファミリーの PDK も見つかって一覧に出ますが、Undine にはそのプロファイルがありません。レイヤーも デッキもモデルも分からないので、それらを使う機能は使えません。
PDK のインストール¶
SKY130¶
./setup.sh は手順 pdk で、動作確認したバージョンの SKY130 を入れます。この手順だけを実行するには:
./setup.sh pdk
Undine で動作確認したバージョンで ciel enable --pdk-family sky130 を実行します。そのバージョンは組み込みの
プロファイルが挙げています(pixi run python -m undine pdk tested sky130 が表示します:
8afc8346a57fe1ab7934ba5a6056ea8b43078e71)。これで PDK を $PDK_ROOT(既定は ~/.ciel)にダウンロードして有効にします。そのバージョンがすでに入っていれば飛ばし、最後に ./setup.sh のチェックを実行します。
別のバージョンを入れるには、open_pdks のコミットを PDK_VERSION で指定します:
pixi run ciel ls-remote --pdk-family sky130 # the versions ciel can install
PDK_VERSION=<open_pdks commit> ./setup.sh pdk
pixi run pdk
pixi run pdk(python -m undine pdk enable sky130)は、動作確認した SKY130 のバージョンを ciel enable するだけです。PDK_VERSION も PDK_FAMILY も読まず、
入っているバージョンも飛ばさず、最後のチェックもしません。それ以外のことをするときは ./setup.sh pdk を使います。
GF180MCU と IHP SG13G2¶
動作確認したバージョンを ciel で入れます(./setup.sh pdk と pdk enable は、バージョンを指定しなければ、family の組み込みの
プロファイルから取ります):
PDK_FAMILY=gf180mcu ./setup.sh pdk
PDK_FAMILY=ihp-sg13 ./setup.sh pdk
pixi run python -m undine pdk enable gf180mcu
pixi run python -m undine pdk enable ihp-sg13
pixi run ciel enable --pdk-family gf180mcu 792ef67037d74c8c51811eab3ce23cf793491296
pixi run ciel enable --pdk-family ihp-sg13 89d42ee6d2fd9b50b86a1aada6fee6673c3e6008
ihp-sg13 ファミリーを入れると、SG13G2 と SG13CMOS5L の両方が入ります。続けて:
- IHP では、トランジスタのモデルを一度コンパイルします:
./setup.sh osdi(下記)。 - GF180MCU の PCell は専用の環境
pcell-gf180(gdsfactory 7.9)で動きます。この環境は./setup.shの手順installが 作ります(pixi install -e pcell-gf180)。
PDK を入れたら探し直します
サーバーは起動したときに PDK を探します。動いている間に入れた PDK は、再起動しなくても探し直せば現れます: PDK のバッジの
メニューの PDK を再検出、または POST /api/pdks/rescan。ブラウザから取得した PDK
(プロジェクトの PDK を取得する)はすぐに見つかります。再起動(./scripts/restart.sh)でも
見つかり、作業は失われません(サーバーの再起動)。
pixi を使わない場合は、サーバーと一緒に ciel を入れて(pip install -e "server[pdk,dev]")、同じ ciel enable を実行します。
pixi を使わない場合を参照してください。
Undine が PDK を探す場所¶
Undine は起動時に、次の PDK ルートをこの順に探します:
$PDK_ROOT(設定されているとき。ciel もここに入れます)~/.ciel~/.volare(ciel の前身の volare で入れた PDK)
--pdk-root DIR はこの一覧を置き換えます。グローバルなオプションなので、コマンドの前に書きます。何度でも指定できます:
pixi run python -m undine --pdk-root /opt/pdks --pdk-root ~/.ciel serve
--pdk-root とセットアップの手順
--pdk-root を受け付けるのは python -m undine のコマンドだけです。手順 osdi と、手順 pdk の「すでに入っているか」の
チェックは、いつも既定のルートを探します。ほかのルートにある PDK に対して実行するときは、PDK_ROOT にそのルートを
設定します。例: PDK_ROOT=/opt/pdks ./setup.sh osdi。
各ルートで、Undine は次のものを見つけます:
- ciel のストア
<root>/ciel/<family>/versions/<commit>/<variant>/と、volare のストア<root>/volare/<family>/versions/<commit>/<variant>/にあるすべてのバージョン。有効にしたものだけではありません。 - 素の PDK ディレクトリ
<root>/<variant>/libs.tech/。それがversions/<commit>/のディレクトリへのリンク(ciel や volare が 有効にしたバージョン)なら、そのコミットがバージョンです。そうでなければバージョンはありません。
PDK は id で区別します。バリアント、@、コミットの先頭 12 文字をつなげたもので、例えば sky130A@8afc8346a57f です。
バージョンのない PDK は、名前だけが id です。2 つのルートに同じ id があれば、先に見つけたほうを使います。見つけたものを
一覧するには:
pixi run python -m undine pdk list # or: pdks
上の 3 つのファミリーを入れていれば、出力は次のように始まります(一部省略):
gf180mcuA@792ef67037d7 lyp=yes xschem=yes 792ef67037d74c8c51811eab3ce23cf793491296 ciel /home/you/.ciel/ciel/gf180mcu/versions/792ef67.../gf180mcuA libraries=gf180mcu_fd_pr,...
...
ihp-sg13g2@89d42ee6d2fd lyp=yes xschem=yes 89d42ee6d2fd9b50b86a1aada6fee6673c3e6008 ciel /home/you/.ciel/ciel/ihp-sg13/versions/89d42ee.../ihp-sg13g2 libraries=sg13g2_pr,sg13g2_stdcell,...
sky130A@8afc8346a57f lyp=yes xschem=yes 8afc8346a57fe1ab7934ba5a6056ea8b43078e71 ciel /home/you/.ciel/ciel/sky130/versions/8afc834.../sky130A libraries=sky130_fd_pr,sky130_fd_sc_hd,...
lyp は PDK に KLayout のレイヤープロパティ(レイヤーの色)があるか、xschem は Xschem のデバイスシンボルがあるかを示します。
続いて、コミット全体、入れたもの(ciel、volare、素のディレクトリなら -)、ディレクトリ、入っているライブラリ(libs.ref/)
が出ます。
プロジェクトが PDK を固定するしくみ¶
新しいプロジェクトは、PDK の 1 つのバージョンに固定されます:
上部バーの + プロジェクト で 新しいプロジェクト が開き、名前と PDK(このバージョンに固定) を尋ねます。 サーバーが見つけた id のどれか、または なし を選びます。
pixi run python -m undine new demo --pdk sky130A
id 全体でも、名前だけでも指定できます。sky130A のような名前だけを指定すると、バージョンを次の順で選びます: Undine が
PCell を実行できるバージョンを、できないものより先に。動作確認したバージョンを、ほかのものより先に。それでも決まらなければ、
最初に見つけたもの。プロジェクトには選んだ id そのものを記録します。
project.json は PDK を id で指定します:
{
"name": "demo",
"pdk": "sky130A@8afc8346a57f",
"libraries": {"mylib": "libs/mylib"}
}
プロジェクトの undine.lock にも、ツールのバージョンと並んで同じ id を記録します。こうすると、別の
マシンのチェックアウトで PDK のバージョンが違うことが分かります。format 2 の lock は、さらに PDK のファイルも固定します
(PDK をファイルで固定する)。project.json に名前だけ("pdk": "sky130A")を書いて手で
作ったプロジェクトも開けますが、開くたびに名前からバージョンを選びます。どのマシンでも同じバージョンを
使うように、id で固定してください。
ウィンドウ上部の PDK のバッジに、プロジェクトの PDK が表示されます:
| バッジ | 意味 |
|---|---|
| sky130A @8afc834 | プロジェクトが固定している PDK がここに入っています。マウスを重ねると id 全体が出ます。format 2 の lock では、PDK が固定と比べてどうか(未検証(初回の内容を信頼)、変更あり など)もバッジに出ます(PDK の状態) |
| sky130A @bdc9412 サポート終了 | 入っていますが、Undine はその PCell コードをもう実行しません。クリックするとプロジェクトを移せます |
| このサーバーには PDK sky130A@8afc8346a57f がありません | プロジェクトが指定する PDK を、このサーバーが見つけていません。取得するか(バッジのメニューの 取得...。下記)、入れて探し直すか、入っているものにプロジェクトを移します |
| PDK なし | プロジェクトに PDK がありません |
バッジをクリックするとメニューが開きます: undine.lock と比べた PDK の状態とその意味の 1 行、PDK がないか変更されているときの
取得...、PDK を再検出、サポートが終了したバージョンなら移動。
PDK が見つからないプロジェクトも、PDK なしで開けます。レイアウトと回路図のファイルはありますが、PDK のモデル、デッキ、 シンボル、PCell は使えません。
PDK をファイルで固定する¶
format 1 の lock は PDK を id で固定します。id はコミットを示しますが、このマシンにあるファイルについては何も言いません。入れた後に 編集した PDK や、同じコミットで別の取得元から入れた PDK も同じに見えます。PDK をファイルで固定するには:
pixi run python -m undine pdk verify demo --pin
undine.lock: the PDK pinned as installed here (format 2)
PDK unverified
これは入っている PDK のハッシュを取り、undine.lock を format 2 で書きます(undine.lock): コミット
全体、どこから来たか(ciel とその取得元)、入っているライブラリ、部分ごと(libs.tech、libs.ref/<lib> のそれぞれ、IHP のほかの
libs.* のディレクトリ)のハッシュです。だから、より多くのライブラリと一緒に入れた PDK も合い、変更はそれがある部分について報告
されます。入れた後に PDK に書き込まれるものは数えません: __pycache__/ と *.pyc(PCell のコードを import したときにできる。
Undine 自身の PCell の実行は書きません)と libs.tech/ngspice/osdi/(以前のセットアップがそこにコンパイルしたモデル)です。12 文字の
id は、ここに入っている PDK からコミット全体に広げます。入っていないものは、--network を付けると ciel が調べます
(ciel ls-remote)。
SKY130 の 1 つのバリアント(約 1 GB)のハッシュは、初回は数秒かかります。Undine はハッシュをファイルのスタンプと一緒に
ストア(pdk/)に保ち、その後はスタンプの変わったファイルだけを読みます。lib status と
バッジは保ったハッシュだけを読み、PDK そのものは読みません。
その後、pdk verify demo(--pin なし)は PDK を固定と比べ、lock は書きません:
libs.tech: modified ngspice/sky130.lib.spice
~ the PDK files differ from the pin: reinstall it (`ciel rm --pdk-family sky130 8afc8346a57fe1ab7934ba5a6056ea8b43078e71`, then pdk fetch), or pin it as it is now with pdk verify --pin
PDK modified
すでに format 2 の lock での pdk verify --pin は、PDK を今のとおりに固定し直し、前の固定に対してどうだったかを示します。
lib lock --format 2 も format 2 を書き(PDK は --pin と同じく固定します)、PDK のないプロジェクトにも使えます。どちらも、ここに
入っていない PDK は拒否します: 先に取得してください。format 2 の lock では、set-pdk も新しい PDK を同じように固定し、lib lock は
固定に触れません。
固定は入っているものの記録なので、pdk verify --pin と lib lock --format 2 は、固定済みのパッケージ
が受け入れない PDK でも固定します。どちらもそのようなパッケージごとに 1 行表示し(! demo -> solo (git
3f1a9c0b7e21): does not fit the PDK sky130A@8afc8346a57f: ...)、その後は、パッケージか PDK が動くまで、lib status がそれぞれを
問題として報告します。
PDK の状態¶
lib status、PDK のバッジ、pdk verify は、undine.lock と比べた PDK の状態を示します:
| 状態 | 意味 | 扱い |
|---|---|---|
verified(検証済み) |
PDK のプロファイルがこのコミットについて公開するハッシュと合う。まだ出ません: プロファイルがハッシュを公開するのは後の段階です(段階) | |
unverified(未検証) |
undine.lock に固定したハッシュと合う。このバージョンのハッシュを公開するプロファイルはまだないので、初回を信頼しています: 固定したマシンにあったときと同じ PDK ですが、公開されたリリースと照らしてはいません |
注記 |
unchecked(未確認) |
前回ハッシュを取った後にファイルが変わった(またはここでは一度も取っていない): pdk verify PROJECT を実行します。lib status は自分では PDK のハッシュを取りません |
注記 |
not pinned(未固定) |
lock が format 1 で、id だけを固定している: pdk verify PROJECT --pin でファイルを固定します |
注記 |
modified(変更あり) |
ある部分が固定と違う。このマシンで固定したバージョンのハッシュを前に取っていれば、ファイルの名前も出ます | 問題 |
missing(未導入) |
固定した PDK がここに入っていない: 取得します | 問題 |
mismatch |
project.json が lock の固定と別の PDK を求めている(手での編集やマージ): set-pdk PROJECT PDK で両方を移します |
問題 |
other version |
(format 1)lock の id がここで見つかった PDK と違う | 問題 |
not locked、none |
undine.lock がない。プロジェクトに PDK がない |
バージョンのない PDK(素のディレクトリ)はハッシュだけで固定し、警告を出します。固定したライブラリが入っていなければそれも問題です。 lock にないライブラリが入っていても、示すだけです。
プロジェクトの PDK を取得する¶
Undine はプロジェクトの PDK を ciel で入れます。PDK のバッジのメニューの 取得... (PDK がないか変更されているとき)か、コマンドラインから:
pixi run python -m undine pdk fetch demo
fetch the PDK of demo with ciel:
family sky130
variant sky130A
commit 8afc8346a57fe1ab7934ba5a6056ea8b43078e71
libraries ciel default
source static-web:https://fossi-foundation.github.io/ciel-releases
root /home/you/.ciel
fetch it? [y/N] y
...
installed /home/you/.ciel/ciel/sky130/versions/8afc8346a57fe1ab7934ba5a6056ea8b43078e71/sky130A
~ undine.lock pins the PDK by id only: `python -m undine pdk verify demo --pin` pins its tree
PDK not pinned
a running Undine server finds it after a rescan: Rescan PDKs in the PDK badge's menu, or POST /api/pdks/rescan
取得するもの:
- ファミリー。 ciel はファミリー単位で入れます:
sky130Aとsky130Bはsky130、gf180mcuAからDはgf180mcu、ihp-sg13g2とihp-sg13cmos5lはihp-sg13です。 - コミット。 format 2 の固定ならそのコミット全体。format 1 の id(lock がなければ
project.jsonの id)なら、12 文字をここに 入っている PDK からコミット全体に広げ、なければ--network(ダイアログでは ネットワークを使う のチェックボックス)でciel ls-remoteを使って広げます。 - ライブラリ。 固定にあるライブラリ。なければ ciel の既定のセット。
- 取得元。 format 2 の固定は ciel の取得元を書いています。format 1 の id は、ciel の既定の取得元
static-web:https://fossi-foundation.github.io/ciel-releasesから来たものとみなします。volare で固定した PDK は拒否します (volare で入れてください)。ブラウザからは ciel の既定の取得元からだけ取得し、ほかの取得元はコマンドラインから取得します。 - ルート。 Undine が探す PDK のルート(Undine が PDK を探す場所)のうち、
ciel/があるか、 まだないか、空の最初のもの:--pdk-rootがあればそれ、なければ$PDK_ROOT、なければ~/.ciel。どれも当てはまらなければ (~/.volareだけなど)、ほかの場所に取得した PDK は見つからないので拒否します:--pdk-root DIRを指定するかPDK_ROOTを 設定してください。ciel はそこにある自身のストアに入れ、そのバージョンを有効にはしません(<root>/<variant>のリンクはそのまま)。 Undine は ciel のストアのどのバージョンも見つけます。
その後、Undine は PDK を lock と比べ(pdk verify と同じ)、ブラウザからなら PDK を探し直すので、プロジェクトは再起動なしに PDK を
見つけます。取得は undine.lock を書きません。PDK のファイルを固定したいときは pdk verify --pin を使います。コマンドラインは
ciel を動かす前に尋ね(--yes なら尋ねない)、動いているサーバーには届かないので、サーバーでは PDK を再検出 を使います。
ブラウザの PDK を取得 は、ファミリー、バリアント、コミット、ライブラリ、取得元、入れる先のディレクトリを示します。取得 を 押すまでは何も取得しません。取得はサーバーで動き、その出力がダイアログに出ます。ダイアログを閉じても取得は続きます(サーバーを 再起動すると失われます: 取得し直すか、探し直せば入れたものが見つかります)。エージェントは取得を始められません: そのツールの どれも、取得に要る確認を求めないからです(HTTP API)。
modified の PDK を入れ直すには、先に ciel rm --pdk-family FAMILY COMMIT(バッジのメニューと pdk verify がコマンドを示します)
で消してから取得します。
プロジェクトを別の PDK バージョンへ移す¶
set-pdk は、プロジェクトを入っている別の PDK に固定し直します:
pixi run python -m undine set-pdk demo sky130A@8afc8346a57f
demo: sky130A@bdc9412b3e46 -> sky130A@8afc8346a57f
cells generated from PCells of the old PDK stay until regenerated (schematic-driven layout: Regenerate all devices)
変わるのは次のものです:
project.jsonのpdk-
project.jsonのpdk_history。古い id、新しい id、時刻の項目が 1 つ増えます:"pdk_history": [{"from": "sky130A@bdc9412b3e46", "to": "sky130A@8afc8346a57f", "time": "2026-11-10T09:30:00+0900"}] -
undine.lockのpdk。ロックができる前に作ったプロジェクトには undine.lock がありません。そのときはset-pdkがlib lockと同じように、今使っているツールのバージョンを記録して作り、created undine.lock (format 1)と表示します。 format 2 の lock には、先にファイルのハッシュを取った新しい PDK の固定を書きます(ハッシュを取ったことのない PDK なら数秒)。 lock がすでに固定している PDK に移すときは、固定はそのままです。
サーバーが動いているとき
コマンドラインの set-pdk は、プロジェクトのファイルを書き換えるだけです。動いているサーバーは、読み込んだレイアウトを
(PCell の配置にもエディタにも)古い PDK のまま、再起動するまで使い続けます。サーバーが動いている間は、サーバーを通して
プロジェクトを移してください。PDK のバッジのダイアログに … に切り替える があればそれを使い、なければ HTTP の呼び出し
POST /api/p/{project}/pdk(HTTP API。バッジもこれを使います)を使います。または、
set-pdk の後にサーバーを再起動してください。
移した後は:
- シミュレーション、DRC、LVS は新しいバージョンを使います。
- それまでの結果は古くなります。理由は
PDK <old> → <new>と表示されます。 - 古いバージョンの PCell から生成したレイアウトのセルは、作り直すまでそのまま残ります(回路図駆動レイアウトの すべてのデバイスを再生成)。
元に戻すには、古い id で set-pdk を実行します。pdk_history には両方の移動が残ります。PDK はプロジェクトそのもので変更し、
changeset の中では変更しません。HTTP の呼び出しは changeset のプレビューでは拒否されます。
PDK を受け入れないパッケージ。 set-pdk は、固定済みのすべてのパッケージ(依存関係が
連れてきたものも)の [pdk] と新しい PDK を照合し、受け入れないものがあれば、それぞれを経路とともに示して移動を拒否し、何も
変えません:
error: the PDK sky130A@0c4e2b7a1f30 is not accepted by 2 locked packages:
- demo -> analog_ip 1.2.0 (v1.2.0 @ 229914698b1f): sky130A@0c4e2b7a1f30 is not among commits 8afc8346a57f
- demo -> analog_ip 1.2.0 (v1.2.0 @ 229914698b1f) -> sar_common 1.3.1 (v1.3.1 @ 5b1c0e2a9d11): sky130A@0c4e2b7a1f30 is not among commits 8afc8346a57f
update or remove them (lib update, lib remove), or choose a PDK they accept; nothing was changed
先にパッケージを動かす(新しいコミットを並べたバージョンへ lib update)か、削除してください。HTTP では、一覧を付けたコード
pdk_incompatible の 409 になり、PDK のバッジのダイアログ(… に切り替える)がそれを表示します。ストアにもここのインストールにもない
固定済みのパッケージ(クローンした直後)は確かめられないので、run lib sync first として拒否します。プロジェクトがすでに指定している
PDK への移動は拒否しません。
Warning
通常の git の依存関係(undine-package.toml のないもの)や、[pdk] のないパッケージは確かめません。別の PDK バージョンで
描いたライブラリは、移した後でレイアウトをもう一度確認(DRC と LVS)する必要があるかもしれません。
サポートが終了したバージョン¶
2025 年より前の open_pdks の SKY130(例: bdc9412)は、古い世代の PCell コードを持っていて、Undine はもう実行しません。
今の PCell コードは kfactory ベースの gdsfactory 8 を必要とします。そのバージョンに固定したプロジェクトも開けて、
シミュレーションと DRC / LVS は動きますが、PCell は使えず、PDK のバッジに サポート終了 と出ます。

バッジをクリックします。同じ PDK で Undine が PCell を実行できるバージョンが入っていれば(動作確認したものが優先)、ダイアログ
サポートが終了した PDK のバージョン が、sky130A@8afc8346a57f に切り替える のように、そのバージョンへの移動を提案します。set-pdk と同じことをします。
入っていなければ、ダイアログは対応しているバージョンと set-pdk のコマンドを示します。./setup.sh pdk を実行し、バッジの
メニューの PDK を再検出 を選んでから、もう一度バッジをクリックしてください。
pixi run doctor もこうした PDK を一覧し、固定しているプロジェクト向けに set-pdk のコマンドを表示します。このコマンドが
示す PDK は、Undine が PCell を実行できる PDK のうち最初に見つけたもので、別のファミリーのこともあります(GF180MCU が入って
いれば gf180mcuA@...)。移す先はバッジのダイアログから選ぶか、同じバリアントの動作確認したバージョン
(例: sky130A@8afc8346a57f)を使ってください。
IHP SG13G2 の Verilog-A モデル¶
IHP のトランジスタモデル(PSP103 など)は Verilog-A です。ngspice はそれを OSDI ファイルにコンパイルしたものを読み込むので、 次の 2 つが必要です:
- OSDI 対応でビルドした ngspice。
./setup.shの手順ngspiceが、OSDI 対応の ngspice 47 を pixi 環境にビルドします (conda-forge の ngspice は OSDI に対応していません)。 -
コンパイルしたモデル。 PDK を入れた後に一度コンパイルします:
./setup.sh osdi # or: pixi run osdi
手順 osdi は OpenVAF 23.5.0 を .pixi/build にダウンロードし、PDK 付属のコンパイル用スクリプトを Verilog-A のソースの
コピーに対して実行します。PDK はインストールしたときのまま変わりません。OSDI ファイルは Undine の
ストア ~/.undine/store/build/<commit>/<variant>/osdi/ に書き出し($UNDINE_STORE で場所を
変えられます。バージョンのない PDK は build/local-<ディレクトリのハッシュ>/<variant>/osdi/)、どのプロジェクトでも共有します。
- Undine は IHP のシミュレーションのたびにそれを読み込みます。まずストアから、次に PDK の中(
libs.tech/ngspice/osdi/。以前の セットアップがそこにコンパイルしたもの)から、次に以前の Undine がコンパイルしたキャッシュ(~/.cache/undine/osdi/<PDK の id>/) から探します。 - 古いキャッシュからの移動。 古いキャッシュにあるモデルもそのまま使い、
pixi run doctorがそれを注記します(... from the old cache: run pixi run osdi to move them into the store)。pixi run osdiは、それをコンパイルし直さずにストアへ移し (ihp-sg13g2: moved psp103.osdi from ... into ...)、空になった古いディレクトリを消します。pixi run osdi -nは何を移すかを 示すだけです。 - コンパイルするまでは、IHP のシミュレーションは
./setup.sh osdiを実行するよう案内して止まります。 - モデルがある PDK は飛ばします。
FORCE=1 pixi run osdiでコンパイルし直し、pixi run osdi -nは何をするかを表示するだけです。
この手順は、引数なしの ./setup.sh には含まれません。$PDK_ROOT、~/.ciel、~/.volare にある PDK のうち、モデルが必要な
すべての PDK(SG13G2 と SG13CMOS5L)のモデルをコンパイルします。ほかのルートにある PDK については
--pdk-root とセットアップの手順を参照してください。
PDK の確認¶
./setup.sh check(または pixi run doctor)は、Undine が見つけたものと、足りないものを直すコマンドを表示します。例えば、
SKY130、GF180MCU、ihp-sg13 ファミリーを動作確認したバージョンで入れ、IHP のモデルをまだコンパイルしておらず、古い SKY130 が
~/.volare に残っているとき、PDK に関する行は次のようになります(一部省略):
✓ a PDK ok gf180mcuA@792ef67037d7, ..., ihp-sg13cmos5l@89d42ee6d2fd, ihp-sg13g2@89d42ee6d2fd, sky130A@8afc8346a57f, ...
✓ ngspice with OSDI (IHP's Verilog-A models) ok ngspice-47 : Circuit level simulation program
- compiled Verilog-A models of the PDKs that need them missing [recommended] -> pixi run osdi (OpenVAF; missing for ihp-sg13cmos5l@89d42ee6d2fd, ihp-sg13g2@89d42ee6d2fd)
✓ PCell environment (gdsfactory 8 with kfactory; sky130, IHP) ok .../.pixi/envs/pcell/bin/python
✓ GF180MCU PCell environment (gdsfactory 7.9) ok .../.pixi/envs/pcell-gf180/bin/python
✓ a PDK whose PCells Undine runs ok gf180mcuA@792ef67037d7, ..., ihp-sg13g2@89d42ee6d2fd, sky130A@8afc8346a57f, sky130B@8afc8346a57f
! PDKs no longer supported (PCell code before 2025) sky130A@bdc9412b3e46, sky130B@bdc9412b3e46 [note] -> projects pinned to them: python -m undine set-pdk PROJECT gf180mcuA@792ef67037d7
✓ ciel (PDK manager) ok .../.pixi/envs/default/bin/ciel
a PDK は必須で、1 つもなければ doctor は終了コード 1 で終わります。GF180MCU PCell environment の行とコンパイルした
モデルの行は、該当する PDK が入っているときだけ出ます。no longer supported の行の set-pdk の移動先は、SKY130 の
プロジェクトに使うものではありません。サポートが終了したバージョンを参照してください。
doctor は、ツールごとのバージョン番号と出どころ(0.30.12 (pixi))、Undine のバージョン、その pixi.lock のハッシュも示します。
1 つのプロジェクトについては、lib status が PDK(とツールと依存関係)を undine.lock と比べます:
pixi run python -m undine lib status demo
PDK pdk other version sky130A@bdc9412b3e46
mylib own ok libs/mylib
! PDK: locked sky130A@bdc9412b3e46, here sky130A@8afc8346a57f
note: origins, Undine version and pixi.lock are not recorded (format 1)
ウィンドウでは、PDK のバッジの隣にあるロックのバッジに バージョン固定済み または 固定バージョンとの不一致 N 件 と
出ます。クリックすると同じ一覧が出ます。違いが意図したものなら(PDK を手で移した、このマシンでは別のバージョンをわざと使う)、
lib lock か、ロックのダイアログの lock の操作で、使っているものを記録します(format 1 の lock の場合。format 2 の固定は
set-pdk か pdk verify --pin で動かします)。undine.lock と PDK の状態を参照して
ください。
PDK のプロファイル¶
PDK のファミリーごとに プロファイル があります。PDK のファイルのほかに、Undine がそのプロセスについて知っておく必要の あることです。プロファイルには、レイヤーとメタルスタック、DRC と LVS のデッキとそのオプション、Magic と Netgen の設定ファイル、 モデルのライブラリとそのコーナー、シミュレーションが読み込むコンパイル済みモデル、PCell のライブラリとそれを実行する環境、 標準セル、まだ動かないことが書かれています。Undine はプロファイルを PDK の名前で、次にファミリーで選びます。
Undine には SKY130、GF180MCU、IHP SG13G2、IHP SG13CMOS5L のプロファイルがあります。最初の 3 つは動作確認したバージョンの PDK で実行して確かめましたが、SG13CMOS5L のものはまだです。プロファイルのないファミリーの PDK には汎用のプロファイル Unknown process を使い、これは何も知りません。そうした PDK も一覧に出て、プロジェクトを固定することもできますが、DRC、LVS、 シミュレーションのモデル、PCell は使えません。
プロファイルはデータです。ciel の family ごとに 1 つの プロファイルのパッケージ(profile_sky130、profile_gf180mcu、
2 つの IHP のプロセスを持つ profile_ihp_sg13)にある profile.toml です。それぞれは Undine で動作確認した PDK のバージョンも
挙げています。./setup.sh pdk、pixi run pdk、pdk enable はその最初のものを入れ、PDK の名前だけ(sky130A)で作った
プロジェクトは、そのバージョンが入っていればそれになります。表示するには:
pixi run python -m undine pdk tested gf180mcu # 792ef67037d74c8c51811eab3ce23cf793491296
Undine は、プロファイルのうち知っているものだけを読みます。知らないキー、Undine が持つ式とスタックの生成関数以外の計算、
PDK の外を指すパスは拒否します。今のところプロファイルのパッケージは Undine に組み込まれている(server/undine/data/profiles/)
ので、新しいプロファイルは Undine の新しいバージョンと一緒に入ります。Undine のテストがプロファイルを実行したかどうか
(プロファイルの verified の印。PDK の状態ではありません)は、プロファイルではなく Undine 自身の記録です。
サーバーの中でプロファイルがどこにあるかはアーキテクチャと開発にあります。
予定
ライブラリと PDK のパッケージの仕組み(index でパッケージとして公開するプロファイルと、PDK を 検証済み にするハッシュ)は パッケージと PDK で設計しています。今あるものは段階に書いてあります。 PDK をファイルで固定することと、ciel で取得することは、もうできます。
関連項目¶
- インストール:
./setup.shとその手順 - ライブラリと依存関係:
undine.lock、lib status、lib lock - コマンドラインと設定:
new、set-pdk、pdk list、pdk verify、pdk fetch、doctor、PDK_ROOT、UNDINE_STORE - テープアウト: PDK ごとのシャトルのターゲット