コンテンツにスキップ

インストール

1. 始める前に

必要なもの 確認方法 入手方法
Linux x86-64(または WSL2)、glibc 2.28 以上 ldd --version Ubuntu 20.04 以降、RHEL / Rocky / AlmaLinux 8 または 9。ディストリビューション別を参照
git、curl git --version sudo apt install git curl / sudo dnf install git curl
pixi pixi --version 下のインストーラ(~/.pixi/bin に実行ファイルが1つ入ります)。その後、新しいシェルを開く
KLayout アプリケーション 0.30 以上(DRC / LVS) klayout -v ディストリビューションの公式パッケージ(下記)。./setup.sh check がコマンドを表示します
ディスク 約 5 GB 大半は PDK と EDA ツール
curl -fsSL https://pixi.sh/install.sh | sh     # pixi

それ以外はすべて pixi が pixi.toml(ロックファイルは pixi.lock の1つ)から用意します: Python、サーバー、UI 用の Node.js、Xschem、Netgen、Magic、Verilator、vlsirtools、PDK 用の ciel、 2 つの PCell 用環境(sky130 と IHP の PyCell 用に kfactory ベースの gdsfactory 8.x、GF180MCU 用に gdsfactory 7.9)、それにサーバーのネイティブコア (server/src。サーバーのパッケージに組み込んでビルド)をビルドする Rust ツールチェーンです。 システムの Python、Node、Rust、conda は不要で、どのディストリビューションでも同じものが入ります。ngspice は setup.sh が pixi 環境の中で ソースからビルドします(手順 ngspice、pixi の C コンパイラを使用)。conda-forge の ngspice は、IHP のモデルに必要な OSDI に対応していないためです。 唯一の例外は KLayout アプリケーションです。conda パッケージが conda-forge から入らなくなったため、klayout.de のシステム パッケージを使います(サーバー自体は pixi 経由で PyPI の klayout Python モジュールを使います)。

ディストリビューション別

KLayout アプリケーションは klayout.de/build.html から入手します(0.30.12。pixi.lock の Python モジュールと同じバージョン)。apt / dnf が依存関係をディストリビューション標準のリポジトリから入れるので、EPEL は不要です。

ディストリビューション KLayout パッケージ インストール 一緒に入る依存関係
Ubuntu 22.04 Ubuntu-22 .deb sudo apt install ./klayout_0.30.12-1_amd64.deb Qt 5.15、Ruby 3.0、Python 3.10、libgit2 1.1
Ubuntu 24.04 Ubuntu-24 .deb sudo apt install ./klayout_0.30.12-1_amd64.deb Qt 5.15、Ruby 3.2、Python 3.12、libgit2 1.7
Ubuntu 20.04 Ubuntu-20 の .deb(ファイル名は同じ) 上と同じ そのリリースの Qt 5、Ruby、Python 3
RHEL / Rocky / AlmaLinux 9 RockyLinux_9 .rpm sudo dnf install ./klayout-0.30.12-0.x86_64.rpm qt5(base、multimedia、svg、tools、xmlpatterns)5.15、Ruby 3.0、Python 3.9、http-parser
RHEL / Rocky / AlmaLinux 8 CentOS_8 .rpm sudo dnf install ./klayout-0.30.12-0.x86_64.rpm qt5(上と同じ)、Ruby 2.5、Python 3.6、libgit2
CentOS 7 非対応: glibc 2.17 は pixi 環境が必要とするものより古く(UI 用の Node.js に 2.28 が必要)、CentOS 7 は 2024 年にサポートが終了しています

どのディストリビューションでも pmap が必要です(Debian / Ubuntu ではパッケージ procps、RHEL 系では procps-ng)。 sky130 の KLayout LVS デッキがメモリ使用量の記録に使い、これがないと失敗します。通常のインストールには含まれていますが、 最小構成のコンテナイメージには入っていません。

動作確認済み: Ubuntu 22.04(WSL2)、Ubuntu 24.04、Rocky Linux 8 と 9(コンテナ)で、./setup.sh、デモの設計、シミュレーション、 Tiny Tapeout のサインオフ一式(KLayout の DRC / LVS、Magic の DRC、Magic + Netgen の LVS)を実行しました。表のほかの行も 同じパッケージに沿っていますが、実行はしていません。

2. インストール

git clone https://github.com/kadomoto-lab/undine-eda.git
cd undine-eda
./setup.sh

setup.sh は次の手順を実行します。何度でも実行し直せます(例: git pull の後)。手順名を指定すると、その手順だけを実行します (./setup.sh web、./setup.sh --help):

手順 同じ意味のコマンド 内容
install pixi install -e default、-e pcell、-e pcell-gf180 default 環境(サーバー、Node、EDA ツール)と PCell 環境: sky130(と IHP の PyCell)用の gdsfactory 8、GF180MCU 用の gdsfactory 7.9(docs 環境はこのドキュメントとスクリーンショット専用)
ngspice pixi run ngspice OSDI 対応の ngspice 47 を default 環境にビルド(初回だけ数分。入っていれば飛ばします)
web pixi run web UI を web/dist にビルド
pdk pixi run pdk に近いもの(違い) ciel で SKY130 PDK をダウンロードして有効化($PDK_ROOT、既定は ~/.ciel)。Undine で動作確認したバージョンに固定。そのバージョンがすでにあれば飛ばします
osdi pixi run osdi 既定では実行しません。インストールした IHP の PDK の Verilog-A モデルを、ngspice 用に OpenVAF でコンパイル(IHP SG13G2 の Verilog-A モデルを参照)
check pixi run doctor チェック(後述)だけを実行。setup.sh は毎回最後にこれを実行します

古い Undine から更新する場合

プロジェクトは、作成時のツールのバージョンを undine.lock に記録しています。ngspice 47 に更新すると、依存関係のチェックで ngspice: locked 41, here 47 from pixi (…) と警告が出ます(不一致には数えません)。結果を確認したら、 pixi run python -m undine lib lock PROJECT で新しいバージョンを記録してください(undine.lockを参照)。

ほかの PDK

GF180MCU、IHP SG13G2、SKY130 の別のバージョンも ciel で入れます。PDK のページに、動作確認した バージョンとそれぞれで使えるもの、入れ方、プロジェクトが PDK を固定するしくみと 別のバージョンへ移す方法があります。

3. 確認と修正

setup.sh は最後にチェックを行います。単独では ./setup.sh check(または pixi run doctor)で実行できます。各行に見つかったものが表示され、 足りないものがあれば、それを直すコマンドも表示されます:

 ✓ klayout Python module >= 0.30          ok  0.30.12
 ✓ a PDK                                  ok  sky130A@8afc8346a57f, sky130B@8afc8346a57f
 - klayout (DRC / LVS)                    missing  [recommended]  -> install the KLayout application (>= 0.30) ...

required の項目は起動に必要です。recommended の項目がないと、その機能(シミュレーション、DRC/LVS、PCell)が使えません。 pixi run の中(と pixi 環境の MCP の起動役が起動したサーバー)では、ツールは pixi 環境($UNDINE_TOOLS。未設定ならサーバー自身の環境、次に ~/undine-tools)から、それ以外は PATH から探します。そのため、別の方法で入れた ツール(apt、Homebrew、IIC-OSIC-TOOLS、ソースからのビルド)も使えます。PDK は $PDK_ROOT、~/.ciel、~/.volare から探します (Undine が PDK を探す場所)。

pixi を使わない場合

システムの Python 3.10 以上と Node 18 以上を使います:

python3 -m venv .venv
.venv/bin/pip install -e "server[pdk,dev]"     # server with its Rust core (needs cargo, e.g. rustup), ciel, pytest
(cd web && npm ci && npm run build)                                      # UI
.venv/bin/ciel enable --pdk-family sky130 8afc8346a57fe1ab7934ba5a6056ea8b43078e71

ngspice(IHP を使うなら --enable-osdi 付きでビルドしたもの)、Xschem、Netgen(LVS ツール)、Magic を PATH(または $UNDINE_TOOLS/bin)に置きます。PCell を使うには、Python 3.12 の環境に pixi.toml の [feature.pcell.pypi-dependencies](gdsfactory 8.32.2。kfactory 0.23 が入ります)を入れ、その python を UNDINE_PCELL_PYTHON で指定します。 GF180MCU の PCell には、[feature.pcell-gf180.pypi-dependencies](gdsfactory 7.9.4)を入れたもう 1 つの環境を作り、UNDINE_PCELL_GF180_PYTHON で指定します。 vlsirtools(任意のネットリスタ)は pip install vlsirtools で入ります。

次のステップ