トラブルシューティングと FAQ¶
このページでは、よく起きる問題をその原因と対処とともに挙げ、そのあとで Undine についてのよくある質問に答えます。ほとんどの項目は 表示されるメッセージから始まります。メッセージの一部をこのページで検索してください。
ここにない問題は、バグを報告するには を見てください。
まずチェックを実行する¶
インストールしたばかりのときの問題は、ほとんどがツールか PDK の不足です。まずチェックを実行します:
./setup.sh check # or: pixi run doctor
各行に見つかったものが表示され、足りないものがあれば、それを直すコマンドも表示されます:
| 印 | 意味 |
|---|---|
✓ |
見つかった |
✗ |
見つからず、required: サーバーが起動しない、または何も表示されない |
- |
見つからず、recommended(シミュレーション、DRC / LVS、PCell などの機能が使えない)または optional |
! |
注記。Undine がサポートを終了した PDK のバージョンなど |
最後の行は ready: python -m undine serve か、required items are missing(終了コード 1)です。レベルの説明は
インストール にあります。
Undine の動作中に何かが失敗したときは、サーバーの出力を見ます。出力がどこにあるかは、サーバーの起動のしかたによります:
| 起動のしかた | 出力の行き先 |
|---|---|
pixi run serve |
そのターミナル |
./scripts/restart.sh |
$UNDINE_LOG。既定は /tmp/undine.log |
AI アプリが起動した(undine mcp-stdio) |
$UNDINE_LOG。既定は ~/.undine/serve.log |
シミュレーション、DRC、LVS のジョブは、それぞれ自分のフォルダ <project>/runs/<job>/ も持ち、そこに status.json とツールのログが
あります(データ配置)。
インストール¶
pixi not found¶
原因。 setup.sh はすべてを pixi で入れますが、pixi が入っていないか、使っているシェルが pixi を入れる前に
開いたものです。
対処。 pixi を入れ、新しいシェルを開いて、もう一度 ./setup.sh を実行します:
curl -fsSL https://pixi.sh/install.sh | sh
failed: <step> -- see the messages above¶
原因。 setup.sh の手順(install、ngspice、web、pdk、osdi)のどれかが失敗しました。ほかの手順は実行され、最後に
チェックも行われています。
対処。 まとめの上にあるその手順のメッセージを読み、原因を直してから、その手順だけをもう一度実行します。例えば:
./setup.sh ngspice
どの手順もいつでも実行し直せます。./setup.sh --help で一覧が出ます。
KLayout アプリケーションが PATH にない¶
原因。 DRC と LVS は、KLayout の アプリケーション(klayout)で PDK のデッキを実行します。これは pixi では入れられず、
klayout.de からシステムのパッケージとして入れます。ないと、チェックで klayout (DRC / LVS) が missing と表示され、DRC や LVS の
実行は klayout not found (set UNDINE_TOOLS or put it on PATH) で失敗します。
対処。 KLayout 0.30 以上を klayout.de/build.html から入れます。
./setup.sh check が、使っているディストリビューション向けのダウンロードとインストールのコマンドを表示します。パッケージは
インストールの ディストリビューション別 の表にあります。入れたら確認します:
klayout -v
サーバーは、レイアウトのデータベースに PyPI の klayout Python モジュール(pixi 経由)を使います。こちらは setup.sh が入れるもので、
アプリケーションとは別物です。
pmap is missing、または sky130 の LVS がすぐに失敗する¶
原因。 sky130 の KLayout LVS デッキは、メモリ使用量を記録するために pmap を呼び、それがないと失敗します。普通の Linux には
入っていますが、最小構成のコンテナイメージには入っていません。
対処。 それを含むパッケージを入れます:
sudo apt install procps
sudo dnf install procps-ng
ディストリビューションが古すぎる(CentOS 7)¶
原因。 pixi の環境には glibc 2.28 以上が必要です(UI 用の Node.js がそれを必要とします)。CentOS 7 の glibc は 2.17 です。
対処。 サポートしているシステムを使います: Ubuntu 20.04 以上、RHEL / Rocky / AlmaLinux 8 または 9、Windows の WSL2。glibc の
バージョンは ldd --version で確かめられます。インストールの 始める前に を見てください。
undine._core (Rust core) が missing¶
原因。 サーバーには Rust で書いたネイティブのコア(server/src)があり、pixi install がそれをコンパイルしてサーバーの
パッケージに入れます。ビルドが実行されなかったか失敗した、または(git pull のあとで)Rust のコードが変わったのにビルドし直していません。
対処。 pixi install(または ./setup.sh install)を実行し、出力にコンパイルエラーがないか読みます。pixi を使わない場合、ビルドには
cargo(例えば rustup で入れたもの)が要ります。pixi を使わない場合 を見てください。
web UI build (web/dist) が missing、または UI が古いままに見える¶
原因。 ブラウザの UI は web/dist にビルドします。一度もビルドしていないか、作業コピーを更新したのにビルドが古いコードのままです。
対処。 ビルドし直してから、ページを再読み込みします:
./setup.sh web # same as: pixi run web
git pull のたびに ./setup.sh(すべての手順)を実行すれば、すべてが最新になります。ngspice と PDK の手順はすることがなければ飛ばし、
UI はビルドし直します。
ngspice not found、または別の方法で入れたツールが使われない¶
原因。 Undine は ngspice、Xschem、Netgen、Magic を、まず pixi の環境(pixi run が設定する $UNDINE_TOOLS)から、次に PATH から
探します。pixi の外の Python で起動したサーバーには、pixi の環境のツールが見えません。そのとき、チェックの pixi environment の行は
none (not run with pixi) です。
対処。 Undine を pixi から起動します: pixi run serve、または pixi run python -m undine ...。ほかの場所のツール(apt、
IIC-OSIC-TOOLS、自分でビルドしたもの)を使うには、それを PATH に置くか、bin/ にそれらがあるプレフィックスを UNDINE_TOOLS に
設定します(設定)。
PCell environment が missing¶
原因。 PCell は別の Python 環境で動きます: pcell(gdsfactory 8 と kfactory。sky130 と IHP 用)と pcell-gf180(gdsfactory 7.9。
GF180MCU 用)です。ないと、PCell の配置が the PCell environment is not installed: pixi install -e pcell で失敗します。
対処。
pixi install -e pcell
pixi install -e pcell-gf180 # only for GF180MCU
pixi を使わない場合は、それらのパッケージを入れた Python を UNDINE_PCELL_PYTHON(と UNDINE_PCELL_GF180_PYTHON)で指定します。
PDK¶
PDK が見つからない(チェックの a PDK、または undine: no PDK sky130A)¶
原因。 Undine が PDK を見つけられませんでした。探す場所は $PDK_ROOT、~/.ciel、~/.volare です。
対処。 Undine が動作確認したバージョンの sky130 PDK を入れます:
./setup.sh pdk # the tested SKY130 version, then the check
そのあと、Undine が見つけたものを一覧します:
pixi run python -m undine pdk list
GF180MCU と IHP SG13G2 は PDK のインストール を見てください。
PDK を入れたのに Undine の一覧に出ない¶
原因。 サーバーは起動したときに PDK を探すので、動作中に入れた PDK はまだ一覧にありません。または、PDK が Undine の探さない
ディレクトリにあります: あるシェルで PDK_ROOT を設定したのに、サーバーはそれのない別のシェルから(または AI アプリによって)起動された、
という場合です。
対処。 PDK のバッジをクリックして PDK を再検出 を選びます(または POST /api/pdks/rescan)。サーバーが再起動なしに探し直します。
再起動しても同じで、作業は失われません。それでも見つからなければ、PDK_ROOT をサーバーの環境に含めます
(./scripts/restart.sh と、AI アプリが起動するサーバーでは、~/.undine/env に PDK_ROOT=... を書きます)。または、グローバル
オプション --pdk-root DIR で PDK のルートを指定します。これはコマンドの前に置き、複数指定でき、既定の一覧を置き換えます:
pixi run python -m undine --pdk-root /opt/pdks --pdk-root ~/.ciel serve
pixi run python -m undine pdk list は、見つかった PDK をそれぞれのディレクトリとともに表示します。
Undine が PDK を探す場所 を見てください。
PDK sky130A@… is not on this server¶
原因。 プロジェクトが PDK の特定のバージョン(project.json の pdk フィールド)に固定されていて、そのバージョンがこのマシンに
入っていません。例えば、新しいコンピューターにプロジェクトをクローンしたあとです。日本語の UI では「このサーバーには PDK sky130A@… が
ありません」と表示されます。
対処。 取得します: PDK のバッジをクリックして 取得... を選び、ダイアログの内容を確かめて 取得 を押します。ciel が終われば プロジェクトが PDK を見つけます。コマンドラインからは次のとおりです(その後、動いているサーバーでは PDK を再検出):
pixi run python -m undine pdk fetch PROJECT # add --network when the 12-character id is not installed here
または、プロジェクトを手元にあるバージョンに移します:
pixi run python -m undine set-pdk PROJECT sky130A@8afc8346a57f
プロジェクトの PDK を取得する を見てください。
set-pdk は移したことを pdk_history に記録し、新しいバージョンを undine.lock に記録します(プロジェクトになければ作ります)。
プロジェクトを別の PDK バージョンに移す を見てください。
pdk fetch: no PDK root scanned is a ciel root¶
原因。 ciel は PDK のルートに入れ、Undine は自分が探すルートにだけ取得します: --pdk-root(または $PDK_ROOT、~/.ciel、
~/.volare)のうち、ciel/ があるか、まだないか、空の最初のものです。どれも当てはまりません。例えば ~/.volare しか探さないときや、
PDK_ROOT がほかのファイルのあるディレクトリを指しているときです。
対処。 ciel 用のディレクトリを指定します: コマンドの前に --pdk-root DIR(サーバーにも同じもの)を書くか、PDK_ROOT をそこに
設定します。当てはまるルートがあれば、pixi run python -m undine pdk fetch PROJECT は尋ねる前にそれを表示します。
PDK …: libs.tech differs from the pin (…)(変更あり)¶
原因。 プロジェクトの undine.lock は PDK をファイルで固定しています(format 2)。
入っている PDK のファイルが固定したときと違います: 入れた後に PDK を編集したか、別の取得元から入れ直しました。lib status は
これを問題として示し、PDK のバッジには 変更あり と出ます。
対処。 リリースされたとおりに入れ直してから確かめます:
pixi run ciel rm --pdk-family sky130 <commit> # the command the message names
pixi run python -m undine pdk fetch PROJECT
pixi run python -m undine pdk verify PROJECT
変更が意図したもの(新しいファイルを使う)なら、代わりに今のとおりに PDK を固定します:
pixi run python -m undine pdk verify PROJECT --pin。
PDK …: unchecked: run python -m undine pdk verify PROJECT¶
原因。 問題ではなく注記です。Undine が前にハッシュを取った後に PDK のファイルが変わった(いま取得した、更新した)か、このマシンでは
一度もハッシュを取っていません。lib status とバッジは、自分では PDK を読みません。
対処。 pixi run python -m undine pdk verify PROJECT がハッシュを取ります(数秒)。その後、状態は 未検証 か 変更あり になります。
PDK のバッジに「未検証(初回の内容を信頼)」と出る¶
エラーではありません。PDK は undine.lock に固定したハッシュと合っていますが、そのバージョンのハッシュを公開している PDK プロファイルは
まだないので、リリースとではなく、固定したマシンにあったものと照らしています。PDK の状態 を見てください。
PDK のバッジに「サポート終了」(no longer supported)と出る¶
原因。 プロジェクトが 2025 年より前の open_pdks の sky130(例えば bdc9412)を使っていて、Undine はその PCell のコードを
もう実行しません。プロジェクトは開けて、シミュレーションと DRC / LVS も動きますが、PCell は使えません。
対処。 バッジをクリックして … に切り替える(Move to …)を選びます(サポートしているバージョンが入っていなければ、
ダイアログがそのバージョンを示します。先に ./setup.sh pdk を実行してバッジのメニューの PDK を再検出 を選んでください)。または、次を実行します:
pixi run python -m undine set-pdk PROJECT sky130A@8afc8346a57f
古い PCell から生成したレイアウトのセルは、生成し直すまでそのまま残ります(回路図駆動のレイアウトでは すべてのデバイスを再生成 (Regenerate all devices))。詳しくは サポートを終了したバージョン にあります。
Note
pixi run doctor の ! の注記は、最初に見つかったサポート対象の PDK を示しますが、それは別のファミリーのものかもしれません。
プロジェクトは同じファミリーのバージョンに移してください(sky130A のプロジェクトなら sky130A@…)。
project has no PDK¶
原因。 プロジェクトを PDK なしで作成しました(--pdk なしの undine new PROJECT)。シミュレーション、DRC、LVS には PDK が必要です。
対処。 PDK に固定します:
pixi run python -m undine set-pdk PROJECT sky130A
名前だけを指定すると、入っているバージョンのうち Undine が PCell を実行できるものを選びます。動作確認したバージョンが優先です。
シミュレーション¶
Verilog-A models are not compiled(IHP SG13G2)¶
原因。 IHP のトランジスタのモデルは Verilog-A です。ngspice はそれをコンパイルした OSDI ファイルとして読み込み、そのファイルは PDK を
入れたあとに一度だけ作ります。それまでは、シミュレーションが
ihp-sg13g2's Verilog-A models are not compiled (…): run ./setup.sh osdi (OpenVAF), then simulate again で止まります。
対処。
./setup.sh osdi
これは OpenVAF をダウンロードし、コンパイルしたモデルを Undine のストア ~/.undine/store/build/<commit>/<variant>/osdi/ に書き出します。
FORCE=1 pixi run osdi でコンパイルし直せます。IHP SG13G2 の Verilog-A モデル を見てください。
… from the old cache: run pixi run osdi to move them into the store¶
原因。 pixi run doctor のコンパイルしたモデルの行の注記です。以前の Undine は IHP のモデルをキャッシュ
~/.cache/undine/osdi/<PDK id>/ にコンパイルしていました。今はストアに置くものです。シミュレーションはそこにあるものも見つけます。
対処。 移します(コンパイルし直しはしません):
pixi run osdi
モデルごとに moved psp103.osdi from … into … と表示し、空になった古いディレクトリを消します。
ngspice with OSDI が missing¶
原因。 conda-forge の ngspice は OSDI なしでビルドされていて、IHP のモデルにはそれが必要です。setup.sh は OSDI 付きの ngspice 47 を
自分でビルドして pixi の環境に入れますが、その手順が実行されなかったか、失敗しました。
対処。
./setup.sh ngspice # same as: pixi run ngspice
数分かかりますが、一度だけです。
シミュレーションでマシン全体が遅くなる¶
原因。 既定では、サーバーはコア数から 2 を引いた数(最低 1)のシミュレーションを同時に実行し、それぞれが ngspice のスレッドを 1 つ 使います。
対処。 サーバーの環境で UNDINE_SIM_JOBS(同時に実行するシミュレーションの数。ほかはキューで待ちます)を下げます。共用のマシンでは
UNDINE_SIM_THREADS を 1 のままにします。長くかかりすぎる実行は UNDINE_SIM_TIMEOUT(既定 3600 秒)で止まります。
設定 を見てください。
two cells named inv are netlisted, a/inv and b/inv … and they differ¶
メッセージの全体: tb: two cells named inv are netlisted, a/inv and b/inv (instance x2 in tb), and they differ: a
netlist has one subcircuit per name, so one would stand for the other. Rename one of them, or place the same cell in
both places。ネットリストのビュー、シミュレーション、LVS、スペック、スイープから、どのネットリストのバックエンドでも出ます。
原因。 SPICE のネットリストは、サブサーキットをセルの名前だけで呼びます。ネットリストにするセルが、別々のライブラリにある同じ名前の
2 つのセル(例えば自分の inv と依存関係の inv)や、最上位のセルと同じ名前の別のライブラリのセルを配置していて、それらが違う行に
ネットリストされます。以前は、先のものが何も言わずに両方の代わりになっていました。同じ行にネットリストされる同じ名前の 2 つのセルは
受け付け、一度だけ書きます。
対処。 自分のライブラリにあるほうのセルの名前を変えるか、両方の場所に同じライブラリのセルを配置します。依存関係や PDK のセルは
ここでは名前を変えられないので、自分のほうを変えてください。PDK のデモのページのいくつか(sky130 の sky130_tests/top、IHP の
start_page)も同じ名前の 2 つのセルを配置しているので、同じ理由で拒否されます。これらは例であって、ネットリストにするセルではありません。
ツールのバージョンと undine.lock¶
プロジェクトは PDK のバージョンと、KLayout、Xschem、ngspice、Magic、Netgen のバージョンを undine.lock に記録しています。
pixi run python -m undine lib status PROJECT と、ウィンドウ上部の 固定バージョンとの不一致(lock issues)のバッジが、このマシンで
違うものを一覧します(undine.lock)。バージョンや出どころの違うツールは警告です(lib status では
~、ロックのダイアログでは薄い字の行)。不一致には数えず、lib status を終了コード 1 にもせず、何も止めません。
ngspice: locked 41, here 47 from pixi (…)¶
原因。 Undine が ngspice 47 に移る前に作ったプロジェクトです。エラーではありません。プロジェクトを確認したときの結果と違う結果に なるかもしれない、と警告が知らせています。
対処。 新しいバージョンでプロジェクトの結果を確かめてから、記録します:
pixi run python -m undine lib lock PROJECT
klayout: locked 0.28.17, here 0.30.12 from PATH (/usr/bin/klayout)¶
原因。 多くの場合は更新ではなく、そのツールの別のコピーが先に見つかっています。コマンドラインとサーバーは、$UNDINE_TOOLS のある
環境とない環境という、違う環境から起動していることがあります。from は実行ファイルの出どころ(pixi、UNDINE_TOOLS、undine-tools、
env、PATH)、括弧の中のパスはここで見つかった実行ファイルです。format 2 の lock は出どころも記録するので、同じ番号でも別の場所の
ものなら警告します。
対処。 パスが意図したツールでなければ、サーバーとコマンドを同じ方法で起動します(どちらも pixi run で)。意図した更新なら、
上と同じく lib lock で記録します。
no undine.lock: run python -m undine lib lock PROJECT¶
原因。 プロジェクトにロックファイルがありません(Undine が新しいプロジェクトにロックファイルを書くようになる前に作ったものです)。
対処。 メッセージにあるコマンドを実行します。
ライブラリの依存関係が unlocked、missing、other version、modified¶
原因。 このマシンのライブラリの依存関係が、undine.lock の記録と違います: クローンしたあとでまだ入れて
いない、git pull のあとで別のコミットになっている、手で編集した、のいずれかです。
対処。 依存関係をロックのとおりに入れます:
pixi run python -m undine lib sync PROJECT
ライブラリの依存関係が leftover(project.json にないが残っている)¶
メッセージ: library X: not in project.json, still installed in .undine/deps/X/ and/or locked in undine.lock。
原因。 project.json がもうその依存関係を指定していない(git pull、元に戻す操作、採用した changeset、手での編集で消えた)のに、
そのファイルかロックのエントリがまだここにあります。project.json がほかの依存関係を指定している間は、そのシンボルがこのマシンでは
見つかり続け、新しいチェックアウトでは見つかりません。
対処。 lib sync がそのファイルとロックのエントリを削除します。ブラウザでは、固定バージョンとの不一致のバッジをクリックし、
ダイアログが最初に示す 固定されたバージョンの依存ライブラリを導入し、project.json にないものを削除(sync) を選びます。コマンドラインでは:
pixi run python -m undine lib sync PROJECT
プロジェクトがまだそのライブラリを必要とするなら、代わりに project.json に戻します(lib add)。
undine.lock has format 3, made by a newer Undine¶
原因。 プロジェクトで作業している誰かが、より新しい Undine で、この Undine が読めない形式の lock を書きました(この Undine が読むのは
format 1 と 2 です。ストアより前の Undine は format 1 しか読まず、ここで format 2 と言います)。lib と pdk のコマンド、
set-pdk、ロックのダイアログ、HTTP API の依存関係の呼び出しはどれもそれを拒否します。この Undine が lock を書き直して、より新しい
Undine が記録したものを落とさないためです。プロジェクトは何も変わっていません。プロジェクトは今までどおり開けます。
対処。 Undine を更新してから、プロジェクトで作業します:
git pull
./setup.sh
undine.lock is not valid JSON、is not a lock、または has format …, which no Undine writes¶
原因。 lock が手で、またはほかのツールで編集されたか、git のマージが衝突のマーカーを残しました。format のない lock は
format 1 として読み、エラーにはなりません。
対処。 ファイルを直すか git から元に戻し、lib status を実行します:
git checkout undine.lock
pixi run python -m undine lib status PROJECT
ブラウザからローカルリポジトリを追加する: this server takes no local repository from the browser¶
ほかに: … is outside the directories this server fetches local repositories from。
原因。 ローカルのリポジトリ(file://、/path、~/path)からのライブラリの依存関係を、ブラウザか
HTTP API で追加、更新、同期しようとしましたが、サーバーが --dep-root なしで起動されているか、リポジトリがそのディレクトリのどれかの
下にありません。ブラウザからサーバーのディスクにある任意のリポジトリを読ませることはできません。
対処。 メッセージにある lib コマンドをコマンドラインで実行します。コマンドラインはどのローカルのパスも受け付けます。または、
リポジトリより上のディレクトリを指定してサーバーを起動し直します:
pixi run python -m undine serve --dep-root ~/ip
ブラウザから追加する: from the browser this server fetches only from …¶
メッセージ全体は not from gitlab.com. Start the server with --dep-host gitlab.com, or run python -m undine lib add ...
from the command line で終わります。
原因。 依存関係やインデックスを、ブラウザか HTTP API で追加、更新、ロック、同期しようとしましたが、その URL のどれかのホストが、
このマシンが設定するインデックスのホスト(既定のインデックスの github.com と、$UNDINE_HOME/config.toml にあるもの)でも、
--dep-host で指定したホストでもありません。URL は、リクエスト、project.json、パッケージのマニフェスト、インデックスの行の
どれから来たものでもかまいません。クローンした project.json はどのホストでも指定できるので、その indexes はホストを足しません。
対処。 メッセージにあるコマンドをコマンドラインで実行します。コマンドラインはどのホストからも取得します。または、そのホストを 指定してサーバーを起動し直します:
pixi run python -m undine serve --dep-host gitlab.com
ブラウザからは、… does not fetch every branch and tag of … for a request from the browser と出ることもあります。リポジトリの
サーバーが、そのコミットをそれだけでは渡しません(短縮したコミット ID や、どのブランチやタグからもたどれないコミット)。同じ操作を
一度コマンドラインで実行してください。コミットがストアに残り、ブラウザからはそこを読みます。
取得が止まる: the fetch received more than … bytes¶
メッセージ全体は the most one fetch may take (UNDINE_FETCH_MAX); it was stopped and nothing of it was kept で
終わります。
原因。 依存関係のリポジトリかインデックスが、UNDINE_FETCH_MAX バイト(既定は 1 GiB)より多くを送ってきました。量は git の
実行中に数えます。そのリポジトリのストアの写しは消したので、取得したものは何も残っていません。
対処。 URL が意図したリポジトリを指しているか確かめてください。モノレポ全体や、履歴をすべて取得したものは、パッケージより ずっと大きいことがよくあります。その大きさが想定どおりなら、そのコマンドだけ上限を上げます:
UNDINE_FETCH_MAX=4294967296 pixi run python -m undine pkg add demo big_ip
changeset の採用: after merging project.json and undine.lock: …¶
メッセージ全体は、lib status と同じように依存関係を示します: ip: project.json asks for rev v2, undine.lock locks v1、
または lock が必要としているのに固定していないパッケージ。
原因。 Undine は project.json と undine.lock をエントリ単位でマージし、どちらの側の変更もきれいにマージされましたが、
マージした 2 つのファイルが合っていません: 一方の変更が要求を、もう一方が固定したエントリを動かした(または一方が必要とする
パッケージを、もう一方が取り除いた)ときです。何かを書く前に採用を拒否しました。
対処。 changeset の中で、要求と lock のエントリがプロジェクトの今の状態に合うように更新し直してから(またはもう一方の変更を 先に採用し、その後で更新してから)、もう一度採用します。プロジェクト本体では:
pixi run python -m undine lib lock demo
pkg vendor: not in the store or installed: …¶
メッセージ全体は run python -m undine lib sync PROJECT, or pkg vendor from the command line, which fetches them;
nothing was written で終わります。テープアウトのバンドルでは report.json の vendor.error にこれが入り、vendor の
チェックが警告します。
原因。 固定した木が、ストアにも、固定したとおりのプロジェクトのインストールにもありません(クローンしたばかり、ストアを
空にした、インストールを手で変えた)。テープアウトのエクスポートは取得せず、--offline も取得しません。
対処。 lock をインストールしてから、もう一度 vendor またはエクスポートします:
pixi run python -m undine lib sync demo
pkg sync --from-vendor: its files do not hash to the lock's tree¶
メッセージ全体は a file was changed, added or removed after pkg vendor; restore it from the bundle's zip, or vendor
again; nothing was imported で終わります。
原因。 その vendor/<dir>/ の下のファイルが、pkg vendor が書いたものと違います(変えた、加えた、消した)。木はストアに
何かを入れる前に undine.lock と比べるので、何も読み込んでいません。is not a regular file は、そこにリンクか特殊な
ファイルがあることを示します。pkg vendor はそれを書きません。
対処。 エクスポートがディレクトリの隣に書いたバンドルの zip から、vendor/ を取り直してください。バンドルを作ってから
undine.lock 自体が変わったなら、バンドルを作ったコミットをチェックアウトします。vendor.json に lock の SHA-256
(lock.sha256)が記録されています。
依存関係とストア¶
lib sync: … project.json asks for rev …, undine.lock locks …(または not in undine.lock)¶
メッセージは run python -m undine lib lock PROJECT to resolve it, or python -m undine lib update PROJECT NAME; nothing was changed
で終わります。
原因。 lib sync は undine.lock が固定するものをそのままインストールし、何も解決しません。project.json が指定する依存関係を
lock がそのとおりに固定していません: git pull が別の rev、subdir、URL の project.json を持ってきた(lock は一緒にコミット
されていなかった)、手で依存関係を加えた、依存関係があって lock のないプロジェクト、のどれかです。
対処。 project.json が指定するものを固定してから sync します:
pixi run python -m undine lib lock PROJECT
pixi run python -m undine lib sync PROJECT
lib lock はそれらの依存関係だけを取得して固定します。undine.lock の変更を確かめ、project.json と一緒にコミットしてください。
ブラウザでは、この場合ロックのダイアログが lock を先に出します。sync は lock をそのままインストールする
を見てください。
offline, and not in the store: …¶
メッセージは依存関係ごとにコミットとハッシュを示し、run the sync with the network (without --offline or UNDINE_OFFLINE=1) to fetch
it; nothing was changed で終わります。
原因。 sync をオフラインで実行しました(lib sync --offline、サーバーの環境の UNDINE_OFFLINE=1、HTTP の
{"offline": true})。固定したバージョンが、ストアにも、ストアに残したそのリポジトリの写しにもありません: このマシンで一度も
取得していない(またはストアを空にした、UNDINE_STORE で動かした)ということです。
対処。 一度ネットワークありで sync します。その後はそのバージョンがストアにあります:
pixi run python -m undine lib sync PROJECT
could not fetch … @ …: …¶
原因。 固定したコミットがストアになく、git が取得できませんでした: リモートに届かない、認証を求められた(Undine は入力を求め ません)、またはそのコミットがリモートから消えた(force-push)。メッセージは依存関係ごとにコミットと git の最後の行を示します。何も インストールも削除もしていません。
対処。 URL と自分のアクセス権を確かめます(git ls-remote URL)。コミットが消えていれば、依存関係を存在するものに移します:
pixi run python -m undine lib update PROJECT NAME --rev REV。
取得の途中で止められた git(時間切れ、サーバーや CLI の強制終了、停電)は、ストアに残したリポジトリの写しに shallow.lock などの
ロックファイルを残すことがあります。Undine はその写しに取得する前に毎回これを消します(そのときほかの取得は動いていません)。
なので次の取得は通ります。それでも git が Unable to create '….lock' と言うときは、メッセージがそのファイルを示します。
.undine/deps is a link or not a directory(または .undine is ...)¶
原因。 このプロジェクトの .undine か .undine/deps がシンボリックリンク(またはファイル)です。たとえば、それをコミットした
リポジトリからチェックアウトしたものです。Undine は依存関係を .undine/deps/ に入れ、project.json がもう示さないものを消します。
リンクを通すと、リンクの先のディレクトリを置き換えたり消したりしてしまうので、依存関係のコマンドはどれも、何かを読み書きしたり
消したりする前に断ります。lib status はこれを問題として報告します。
対処。 リンク(その先ではなく)を消してから sync します。Undine がディレクトリを作り直します:
rm PROJECT/.undine/deps # or: rm PROJECT/.undine
pixi run python -m undine lib sync PROJECT
リンクがプロジェクトのリポジトリにあるなら、そこからも消します(git rm --cached .undine/deps)。.undine/ は Undine 自身のもので、
バージョン管理しません。
依存関係がプロジェクトごとにディスクを使う¶
原因。 依存関係はストアへのハードリンクで入れるのでディスクを使いませんが、それは 1 つのファイルシステムの中だけです。ストア
(~/.undine/store)とプロジェクトが別のファイルシステムにあるとき(別のディスクのプロジェクト、マウントした共有、WSL の Windows の
ドライブ)、またはファイルシステムがリンクを断るときは、ファイルごとに(読み取り専用で)何も言わずにコピーします。
UNDINE_STORE_LINK=copy でもコピーします。
対処。 サーバーとシェルの環境で、ストアをプロジェクトと同じファイルシステムに置きます:
export UNDINE_STORE=/data/undine-store # a directory on the projects' file system
pixi run python -m undine lib sync PROJECT # each project once, offline if you like, after the first fetch
ストア を見てください。
store verify: object …: its content does not match its name¶
原因。 ストアのファイルが変わりました: インストールした依存関係のファイルを書き込めるようにして編集した(それはストアのものと
同じファイルです)か、ディスクが壊しました。store verify はそれを消しました(--dry-run なら示すだけ)。lib status は、それを
使っていた依存関係を modified と報告します。書き込めるようにしただけで中身が変わっていないファイル(chmod u+w)は壊れたことに
なりません: store verify と次のインストールが読み取り専用に戻します。
対処。 その依存関係を使う各プロジェクトで:
pixi run python -m undine lib sync PROJECT
sync は、ストアに残したリポジトリの写しからそのファイルを取り直すか、取得します。依存関係のファイルは編集しないでください。
ライブラリはそれ自身のリポジトリで変えて、lib update します。
store gc: nothing was removed: make these locks readable (or remove them), then run store gc again¶
原因。 store gc は、このマシンのどのプロジェクトも固定しているものを残します。そのうちの undine.lock が読めません(マージの
後の衝突のマーカー、より新しい形式、正しくない JSON)。それがないとそのプロジェクトに何が要るか分からないので、何も消しません。
メッセージの上の ! の行が、それぞれの lock を示します。
対処。 示された lock を直すか、元に戻す(git checkout undine.lock)か、もう要らないプロジェクトを消してから、もう一度
pixi run python -m undine store gc を実行します(先に --dry-run で消すものを見ておけます)。
パッケージと信頼¶
lib add、lib update、lib lock、set-pdk は、まずすべてのパッケージを確かめ、すべての問題を
挙げて一度に拒否します。最後は nothing was changed です(いくつもあれば N problems with the dependencies: と、問題ごとに - の
行)。HTTP では、フォームの上のダイアログに問題を並べます(コード resolution_refused)。
…: two versions are required, … and …¶
メッセージの全体: sar_common: two versions are required, demo -> analog_ip 1.2.0 (v1.2.0 @ 229914698b1f) ->
sar_common 1.3.1 (v1.3.1 @ 5b1c0e2a9d11) and demo -> sar_common 1.2.0 (v1.2.0 @ 0c4e2b7a1f30): align the revs (one
version per package)。
原因。 2 つの要求が、1 つのパッケージに別々のツリーを求めています: ここでは、プロジェクトが sar_common を v1.2.0 で指定し、
analog_ip はそれを v1.3.1 で必要としています。ネットリストとレイアウトはセルを名前だけで呼ぶので、プロジェクトに入るのは
パッケージごとに 1 つのバージョンです。
対処。 要求が同じバージョンを指すようにします: 自分のほうを動かす(lib update demo sar_common --rev v1.3.1)か、別のものを
必要としているパッケージを、合うバージョンに動かします。それぞれの経路が、求める rev とコミットを示しています。
… requires … ^1.3, but … is 1.2.0¶
原因。 マニフェストの version の要求が、その rev が指すツリーの [package] のバージョンに合いません(version はラベルを
確かめ、何をインストールするかは rev が決めます)。
対処。 要求する側のパッケージで、rev を合うバージョンに向けるか、version を変えます。要求があなたのもののように見えても
(project.json には version がありません)、それはあなたが依存するパッケージから来ています: そのパッケージを更新してください。
comparator: analog_ip 1.2.0 and sar_common 1.3.1¶
原因。 2 つのパッケージ、またはパッケージとあなたのライブラリや PDK のライブラリが、同じ名前のセルを持っています。ネットリストは 名前ごとにサブサーキットを 1 つ、レイアウトは名前ごとにセルを 1 つしか持てないので、両方をプロジェクトに入れることはできません (セルの名前は重ならない)。名前は大文字と小文字を区別せずに比べます。パッケージの セルを配置したときにあなたのライブラリにできたレイアウトのコピーは数えません。
対処。 あなたのライブラリとの重なりなら、自分のセルの名前を変えます。2 つのパッケージの間なら、どちらかのセルの名前を変えた
バージョンを使うか、その作者に頼みます。lib status は、プロジェクトのセルとのこのような重なりを問題として報告します(...: a
netlist has one subcircuit per name: rename one of them)。
通常の git の依存関係(マニフェストなし)は拒否しません: lib status は、そのセルと同じ名前のプロジェクトのセルを注記するだけで
(inv: ip (git 229914698b1f) and project library mylib: ...)、両方を配置するテストベンチはネットリストのときに拒否されます
(下記)。
…: one local name for two packages, … and …¶
原因。 ローカル名はプロジェクト全体で共通です: 1 つのディレクトリ .undine/deps/<名前>/ がすべての回路図に使われます。2 つの
ライブラリ(またはプロジェクトとライブラリ)が、大文字と小文字を区別せずに同じ名前を、別々のパッケージに与えています。たとえば
あなたの bias は bias_gen で、あるパッケージの bias は別のパッケージです。
対処。 どちらかに別のローカル名を与えます: 自分のものなら lib remove してから別の名前で lib add、パッケージのものならその
マニフェストの [dependencies] で(新しいバージョンで)。パッケージは自身の [package] の名前でもインストールされるので、その名前も
使われています(ローカル名と別名)。
… has that name, and .undine/deps would shadow it(予約された名前)¶
メッセージの全体: sky130_fd_pr: the PDK library sky130_fd_pr has that name, and .undine/deps would shadow it: choose
another local name; nothing was changed。マニフェストが与える名前なら: ...: ... installs it under this local name, which
is ...: a dependency may not shadow it; rename it in the requirer's [dependencies]。
原因。 .undine/deps/ はシンボルの検索パスの先頭にあるので、プロジェクトのライブラリ、PDK のライブラリ、devices、Xschem の
ライブラリや symbol_paths の中のフォルダと同じ名前の依存関係は、すべての回路図でそのライブラリと入れ替わってしまいます。
対処。 別のローカル名を選びます(lib add PROJECT NAME ...)。パッケージのマニフェストが与える名前なら、そのパッケージが
変える必要があります。以前から project.json にある名前はそのまま使え、lib status が隠しているライブラリを注記します。
… does not fit this project's PDK: …¶
メッセージの全体は、パッケージ、理由、それを求める経路を示します: sar_common 1.3.1 does not fit this project's PDK:
sky130A@0c4e2b7a1f30 is not among commits 8afc8346a57f (required by demo -> analog_ip 1.2.0 (...) -> sar_common 1.3.1
(...))。
原因。 パッケージの [pdk] が、undine.lock が固定する PDK を受け入れません: 別のファミリかバリアント、並べていない
コミット、PDK のないプロジェクト、コミットを確かめられないバージョンのない PDK
(PDK との互換性)。tag ... is not known to this Undine: パッケージが互換性のタグだけを
示していて、この Undine はまだそれを解決できません。
対処。 あなたの PDK のコミットを並べたバージョンのパッケージを使うか、それが受け入れる PDK にプロジェクトを移します
(set-pdk)。バージョンのない PDK は、ciel で入れます(pdk fetch)。タグだけを示すパッケージは、作者がコミットを commits に
並べる必要があります。
the PDK … is not accepted by N locked packages¶
原因。 固定済みのパッケージが受け入れない PDK への set-pdk(または PDK のバッジのダイアログでの切り替え)です。続く行が、
それぞれのパッケージを経路と理由とともに示します。何も変えていません。
対処。 先にそれらのパッケージを新しい PDK を受け入れるバージョンに動かす(lib update)か、削除し、それから PDK を移します。
プロジェクトを別の PDK バージョンへ移すを参照してください。
pdk verify --pin や lib lock --format 2 による固定は、入っているものの記録なので拒否しません: どちらもそのようなパッケージ
ごとに ! の行を表示し、その後は、パッケージか PDK を動かすまで、lib status がそのようなパッケージごとに ! ...: does not fit the PDK ... を表示します。
…: not in the store or installed: run lib sync first¶
原因。 固定済みのパッケージを確かめるコマンド(lib add、lib update、lib lock、set-pdk)は、それぞれのマニフェストを
ストアかプロジェクトのインストールから読み、ネットワークからは読みません。クローンした直後は、どちらにもまだありません。HTTP では
コード not_synced です。set-pdk では、そのパッケージは拒否の中の 1 行になります。
対処。 固定したものをインストールしてから、もう一度コマンドを実行します:
pixi run python -m undine lib sync PROJECT
… needs lock format 2: run python -m undine lib lock PROJECT --format 2 first¶
メッセージの全体: analog_ip: package analog_ip names dependencies (sar_common, bias): needs lock format 2: ...; nothing was
changed、または ...: package bias_gen is also installed under its own name bias_gen: ...。
原因。 依存関係を持つパッケージや、自身の名前以外のローカル名でインストールするパッケージには、lock の format 2 の
packages、names、deps のキーが必要です。プロジェクトの lock は format 1 です(new が作るプロジェクトはすべてそうして始まります)。
対処。 一度 lock を変換してから、もう一度コマンドを実行します:
pixi run python -m undine lib lock PROJECT --format 2
ここに入っている PDK を固定する(なければ先に取得してください)ので、プロジェクトの全員がこのバージョンの Undine を使う必要が
あります。lock 自体がそのようなパッケージを持っているとき(pull の後)は、lib lock --format 2 が変換と解決を一度に行います。
ボタンはなく、コマンドラインだけです。
インデックスのパッケージが拒否される¶
メッセージ(どれも nothing was changed で終わります):
demo -> analog_ip ^1.2: index https://... lists no package analog_ip: ここで取得したインデックスに、その名前がありません。pkg searchで名前を探し、pkg index updateでインデックスを取得し直します(何も見つからなかった解決は、一度は自分で取得し 直します)。sar_common: no version matches: ...; https://... lists 1.0.0, 2.0.0: インデックスが一覧にするどのバージョンも要求を満たし ません。project.jsonの要求を変える(またはpkg update --version)か、公開した人に頼みます。sar_common: no version meets all of them: demo -> analog_ip 1.2.0 -> sar_common ^1.2 and demo -> sar_common ~1.0 ... (one version per package): 2 つのパッケージが、1 つのパッケージの重ならないバージョンを必要としています。要求する側の一方を合う バージョンに動かす(pkg update)か、自分の要求を緩めます。... sar_common is locked at 1.0.0: pkg update sar_common moves it: ほかの依存の追加や更新では、固定したものは固定したまま です。新しい要求には、それを動かす必要があります。それを持ち込む依存にpkg updateを実行します。every sar_common version that matches is yanked: 公開した人が取り下げました。それを固定している lock はそのまま持ちます。sar_common: from two indexes, ... and ...: one index per package name: 2 つの依存が、同じ名前のパッケージを別々のインデックス から求めています。どちらか一方から取ります(project.jsonの"index")。... in index https://...: the files at 229914698b1f hash to sha256:..., the index says sha256:...: the index line and the repository disagree、または... [dependencies] differ from the index line's deps: インデックスとパッケージのリポジトリが、 同じリリースを示していません。インデックスの管理者に知らせてください。そのパッケージは何もインストールされません。analog_ip: a package from an index: needs lock format 2:python -m undine lib lock demo --format 2を一度実行します。
マニフェストや project.json のバージョンの要求を読めないときは、書くものを示します: '>=1.2,': an empty part in a comma
list、~ needs MAJOR.MINOR, e.g. ~1.2。
undine-package.toml が拒否される¶
メッセージは <where>: undine-package.toml: <key>: <what>: <fix> の形です。例: ... @ 229914698b1f:lib: undine-package.toml:
package.version: '1.2' is not semver: MAJOR.MINOR.PATCH, e.g. 1.2.0。続いて、それを求めた経路が付きます。
原因。 パッケージのマニフェストが Undine の読める形ではありません: 正しい TOML や UTF-8 でない、256 KiB より大きい、
シンボリックリンク、Undine の知らないキーやテーブル(unknown key (made for a newer Undine?)。revision = のような書き間違いも
これで分かります)、種類の違う値、[a-z][a-z0-9_]* でない名前、前方だけのコミット、パッケージの外に出る subdir や include の
パターン、最上位のセルを 1 つも選ばない [files] include、ファイルの中にない公開セル。
対処。 自分のパッケージなら、メッセージが示す行を直してコミットし、rev をそのコミットに向けます。ほかの人のものなら、
Undine が読めるマニフェストのバージョンを使うか、作者に頼みます。すべてのキーはマニフェスト
にあります。
同じ確認から出る関連のもの: ... has no undine-package.toml: a package may depend only on packages(マニフェストが通常の git の
リポジトリを指定している: できるのは project.json だけ)、... asks for package X, but ... is Y(指定した package や --package
が、ツリーが持つものと違う)、... is a path on this machine, and ... comes from ...(リモートのリポジトリのパッケージがローカルの
ものを指定している: 公開者に git の URL を頼む)。
…: … is a dependency of this project already, as …¶
メッセージの全体: bias2: bias_gen 0.3.0 is a dependency of this project already, as bias: one package has one name in
project.json; use bias; nothing was changed。
原因。 project.json が別のローカル名ですでに指定しているパッケージへの lib add です。パッケージは undine.lock に 1 つの
エントリを持つので、project.json での名前も 1 つです。自身の名前や、パッケージが与える名前の下には、いずれにせよ一緒に入ります。
対処。 今ある名前でセルを配置する(bias/<cell>.sym)か、その名前を lib remove して新しい名前で追加します。
library IP exists (as ip)、または IP and ip: one local name spelled two ways¶
原因。 既存のライブラリ(自身のもの、依存関係、パッケージが入っている名前)と大文字小文字だけが違うローカル名です。大文字 小文字を区別しないファイルシステム(macOS、Windows)では両方が 1 つのディレクトリなので、片方を削除するともう片方のインストール も消えます。
対処。 すでにある綴りの名前を使うか、別の名前を選びます。マニフェストがパッケージの名前を 2 通りに綴っているなら、その パッケージが直す必要があります。
note: …: locked before packages had dependencies; … resolves it¶
注記の全体: ip: package analog_ip, which undine.lock does not install under its own name: locked before packages had
dependencies; ...、または format 1 の lock では ...: its undine-package.toml names dependencies (...) that undine.lock does not
lock: ...。
原因。 古い Undine が固定した依存関係(エントリに package がない)で、そのマニフェストがエントリの入れるもの以上を求めて
います。固定したとおりに動き続け、ほかの lib コマンドはそれを変えも確かめもしません。パッケージ自身の名前
(analog_ip/<cell>.sym)や、それが指定する依存関係を配置する回路図は、解決するまで解決できません。format 2 の lock では、
固定していない依存関係は注記ではなく問題です。
対処。 準備ができたら解決します: lib update PROJECT NAME、または lib lock PROJECT(format 1 の lock では
lib lock PROJECT --format 2)。
…: …: pin name '…' holds a space or a line break, which a netlist line cannot carry¶
原因。 シンボルのピン名(または回路図のポートのラベル)が空白か改行を含んでいます。それは .subckt の行の語になるので、
改行があるとネットリストに独自のカードを書き込むことになります。ネットリストは拒否されます。
対処。 シンボルのピン(とその回路図のラベル)の名前を変えます。依存関係のシンボルなら、その作者に頼みます。
…: placed by …; update or remove that instead¶
原因。 パッケージだけが配置している名前への lib update や lib remove です: それはプロジェクトの依存関係ではなく、示された
パッケージの依存関係です。
対処。 そのパッケージを更新または削除します。lib remove は、もう何も必要としないパッケージを一緒に削除し、ほかの依存関係が
まだ配置しているものは残して示します(sar_common: still placed by analog_ip)。
… (dependency …, not trusted): …(シミュレーションが拒否される)¶
メッセージの全体は、見つかったものすべてと、すべきことを示します: ip/opamp (dependency analog_ip 1.2.0, not trusted): code
block s1 line 1: .control; a person can trust analog_ip@1.2.0 in this project (undine lib trust demo ip, or Trust... in
Undine); an agent cannot。マニフェストのない依存関係では、ラベルは git <commit> です。
原因。 シミュレーション(またはスイープ、仕様の確認)が、コマンドを実行する(.control ブロック、*# の行)か、PDK の外の
ファイルを読む(絶対パス、..、$、~ を含む .include / .lib / file=)依存関係
のセルを使っていて、このプロジェクトでその依存関係を人が信頼していません。これは通常の git の依存関係にも当てはまります:
依存関係のセルに .control ブロックや絶対パスの .include があり、以前はシミュレーションできたプロジェクトも、今は信頼が必要です。
対処。 見つかったものを読み、実行されることを受け入れるなら、そのバージョンを信頼します: 拒否の中の 信頼...(または ライブラリの行の盾のボタン)か、
pixi run python -m undine lib trust PROJECT NAME
別のバージョンへの更新は、信頼されるまでまた拒否されます。または、そのような内容のないバージョンの依存関係を使うか、そのセルを
テストベンチから外します。エージェントは信頼できません: 拒否を伝えてあなたに尋ねます。lib trust が has no install record と
言う依存関係は Undine が入れたものではありません: lib sync が削除するか入れ直します。
信頼のダイアログの 信頼する が what NAME holds changed since it was confirmed ...: confirm the trust again と言うことが
あります: その間に sync や update がファイルを入れ替えました。ダイアログを開き直してください。
RTL: … (dependency …, not trusted): line …: $c(…)¶
原因。 C++ やシェルのコード($c(...)、`systemc_*、$system(...)、DPI の import、それらを組み立てる `define)を
持つか、絶対パスや .. でファイルを読み書きする(`include、$fopen、$dumpfile、$readmem*、$writemem*)依存関係の RTL での
Simulate(Verilator)です。Lint が拒否するのは、そのような `include のパスだけです。依存関係の RTL のファイルは
すべて読みます。
対処。 コードが実行されることを受け入れるなら、上と同じように依存関係を信頼します。または、それのないバージョンを使います。 依存関係の RTL を参照してください。
Xschem のネットリスタ: … (dependency …, not trusted): … tcleval(…)¶
原因。 Xschem バックエンドでの netlist ビューは Xschem 自身のネットリスタを実行し、それは読むどのシンボルでも、属性の
tcleval(...) を Tcl として評価します。そのため、プロジェクトが信頼していないインストール済みの依存関係のどれかが .sch や
.sym にそれを持っていれば、この回路図がそれを配置しているかどうかにかかわらず拒否します。
対処。 (Tcl を受け入れるなら)依存関係を信頼するか、Tcl を決して実行せず警告するだけの Undine 自身のネットリスタを使います
(not trusted: would be refused in a simulation: ...)。
LVS: 実行を始めるときの … (dependency …, not trusted): …¶
原因。 LVS の参照ネットリスト(KLayout、または Magic + Netgen)に、PDK の外の .include や .lib のパスを持つ依存関係のセルの
行があり、その依存関係を人が信頼していません。LVS は制御コードを実行しないので、パスだけを、実行を始めるときにだけ確かめます:
サインオフの状態の表示や、結果の再利用は拒否しません。
対処。 (上と同じように)依存関係を信頼し、もう一度実行を始めます。実行を待ち行列に入れた後に与えた信頼も数えます。
サーバー、ポート、再起動¶
[Errno 98] … address already in use¶
原因。 ほかのプロセスがそのポート(既定は 8700)で待ち受けています。多くは、すでに動いている Undine です。undine mcp-stdio で
Undine を起動する AI アプリは、チャットが終わっても Undine を動かしたままにします。サーバーは終了コード 3 で終わります。
対処。 それが Undine かどうかを確かめます:
curl -s http://127.0.0.1:8700/api/health
Undine なら、"undine": true、プロジェクトのルート、MCP が有効かどうかを返します。そのサーバーを使うか、止めるか、自分のサーバーを
別のポートで起動します:
pixi run python -m undine serve --port 8710
止めるには、そのプロセスを見つけて終了させます。サーバーのコマンドラインには serve が含まれます。mcp-stdio を含む行は AI アプリの
起動役で、チャットとともに終わります:
pgrep -af undine # Undine processes, with their command lines
kill PID # PID of the server's line
./scripts/restart.sh は、AI アプリが起動したサーバーを止めません(次の項目を見てください)。
./scripts/restart.sh が別の Undine を止めた、または止めなかった¶
原因。 restart.sh は新しいサーバーを起動する前に、コマンドラインに python -m undine serve を含むマシン上のプロセスを、ポートや
プロジェクトのルートにかかわらず、すべて止めます。これは pixi run serve や restart.sh 自身が起動したサーバーに当てはまります。
python -m undine --root … serve や --pdk-root … serve のように、serve の前にグローバルオプションを付けて起動したサーバーには
当てはまらず、AI アプリが起動するサーバーはすべてこちらです。そのようなサーバーはポートを持ち続け、新しいサーバーは
[Errno 98] … address already in use で終わります。それでも restart.sh は server: 200 と表示します。古いサーバーが確認に答えるからです。
対処。 1 台のマシンで複数の Undine を動かすときは、restart.sh ではなく pixi run python -m undine serve --port … で自分で起動し、
自分で止めます。AI アプリが起動したサーバーを置き換えるには、[Errno 98] のとおりにそれを止めてから
restart.sh を実行し(アプリが MCP を必要とするなら UNDINE_MCP=1 付きで)、server: 200 を信じるのではなくログ(/tmp/undine.log)を
読みます。
別のコンピューターから Undine を開けない¶
原因。 サーバーは既定で 127.0.0.1 で待ち受けるので、サーバーが動いているマシンからしかつながりません。
対処。 SSH でポートを転送し、手元のコンピューターで http://127.0.0.1:8700 を開きます:
ssh -L 8700:127.0.0.1:8700 me@eda-server
Warning
UI と HTTP API にはサインインがありません。トークンを確かめるのは MCP のエンドポイント(/mcp)だけです。ポートに届く人は誰でも、
サーバーのすべてのプロジェクトを読み、変更できます。信頼できないネットワークでは --host 0.0.0.0 で起動しないでください。AI アプリには、
起動役の --ssh HOST がポートを転送します(Undine が別のマシンにある場合)。
another server still holds the simulations of …¶
原因。 同じプロジェクトのルートで、最初のサーバーがまだ動いている(またはまだ止まる途中の)間に 2 つめのサーバーを起動しました。 1 つのルートのシミュレーションを扱うサーバーは、一度に 1 つだけです。
対処。 最初のサーバーがもうすぐ止まるのなら、何もしなくてかまいません。止まれば、新しいサーバーがシミュレーションを引き継ぎます。 そうでなければ、どちらかを止めます。
AI エージェントと MCP¶
すべての一覧は、AI エージェントをつなぐの 困ったときは にあります。よくあるのは 次の場合です:
Undine at … runs without MCP¶
原因。 AI アプリの起動役が動いている Undine を見つけましたが、それは MCP なしで起動されていました。起動役はそれを再起動しません。
対処。 それを止め、MCP を有効にして起動し直します:
UNDINE_MCP=1 pixi run serve # or: UNDINE_MCP=1 ./scripts/restart.sh
Claude Code に Undine のツールが出ない、または open_in_undine しかない¶
原因。 Undine を登録する前に始めたセッションである、Undine を 1 つのフォルダにだけ登録した(--scope user なし)、または起動役が
サーバーにつながりませんでした。
対処。 新しいセッションを始めます。claude mcp list で ✔ Connected になっているか確かめます。ツールが 1 つのフォルダでしか
使えないなら、--scope user 付きで登録し直します(Claude Code)。サーバーが起動しないなら、
~/.undine/serve.log を読みます。
… is editing this changeset. It is read only until it finishes.¶
原因。 エージェントがまだこの changeset に書き込んでいます。書き込んでいる間、changeset はそのエージェントだけのものです。日本語の UI では「…がこの変更セットを編集中です。完了まで読み取り専用です。」と表示されます。
対処。 待つか、レビューで 停止(Stop)をクリックします。チャットを閉じればすぐに、異常終了した場合は 2 分後に解除されます。
the server policy does not allow … connections¶
原因。 サーバーが --llm-policy(または UNDINE_LLM_POLICY)付きで起動されていて、使える LLM の接続が制限されています。
--llm-policy none では MCP も無効です。日本語の UI では「サーバーのポリシーでは … 接続を許可していません」と表示されます。
対処。 サーバーを動かしている人に確認するか、必要なポリシーで起動します (設計エージェント(アプリ内))。
changeset と採用¶
changeset は、プロジェクトの git ブランチ上の提案です。採用(Adopt)は、それを設計に全か無かでマージします。 採用できなかったときは何も書き込まず、設計は元のままです。
Wait for running checks before adopting or discarding.¶
日本語の UI では「採用・破棄する前に、実行中の検証の完了を待ってください。」です。
原因。 提案またはその起点で、ジョブ(DRC、LVS、シミュレーションの実行)が待機中か実行中です。ツールが結果を書いている途中で採用すると、 その半分だけを保存することになりかねません。
対処。 ジョブが終わるのを待つか、取り消します。前のサーバーが実行したままにしたシミュレーションも、終わるまで採用を止めます。
Not adopted: … conflict with edits made since the proposal was opened.¶
日本語の UI では「採用できませんでした: 提案の作成後に加えられた編集と競合する変更が … 個のファイルにあります。」です。
原因。 あるオブジェクト(インスタンス、配線、図形、設計の意図の項目)が、設計と提案の両方で、違う値に変えられています。レビューには ファイルごとに衝突が表示され、それぞれ今の設計の値、提案の値、提案を開いたときの値が示されます。
対処。 それらのオブジェクトを両側で一致させてから、もう一度採用します。設計側で変える(提案を開いたときの値に戻すと、提案の値が 入ります)か、提案側で変えます(プレビューで手で直すか、修正を依頼(Request changes))。または提案を破棄します。提案はブランチに 残ります。採用: マージ を見てください。
Not adopted: … changed in the design while the proposal was being adopted.¶
日本語の UI では「採用できませんでした: 採用の処理中に … 個のファイルが設計側で変更されました。」です。
原因。 ほかのプログラム(エディタ、git pull)が、採用の最中に設計のファイルを書きました。
対処。 もう一度採用します。マージは今の設計から、その編集も含めて作り直されます。
The … file cannot be read, so it cannot be merged¶
日本語の UI では「…のファイルを読み込めないため、統合できません」です。
原因。 マージに必要なファイル(設計の意図や netlist の YAML など)が壊れています。
対処。 ファイルを直してから(読み込めない理由はレビューに表示されます)、もう一度採用します。
waiting for “…” (adopting) to finish¶
日本語の UI では「「…」(採用中)の完了を待っています」です。
原因。 changeset は一度に 1 つずつ閉じます。ほかの changeset を採用、破棄、取り消ししている最中で、数 GB の実行結果の証拠があると 時間がかかることがあります。
対処。 何もしなくてかまいません。ほかの処理が終われば、この changeset の処理が続きます。ほかの処理の進み具合はレビューに表示されます。
採用したが、the merge was left uncommitted¶
原因。 Undine がマージをコミットするのは、プロジェクトにほかに未コミットのものがなかったときだけです。どの場合かはメッセージが 示します:
| メッセージの終わり | 対処 |
|---|---|
the project had other uncommitted changes |
準備ができたら git でマージをコミットします。未コミットのものは履歴パネルに表示されます |
the repository had no commit yet |
履歴パネルで 最初のコミットを作成(Make the first commit)をクリックします。マージもそれに含まれ、以降の採用はコミットされます |
its commit failed |
git でコミットします |
日本語の UI では、レビューに「提案を採用しました。…」で始まる同じ内容の表示が出ます。
changeset を開くのを断られる: … is in the git repository …, which is not set up for Undine¶
原因。 プロジェクトが、誰も Undine 用にセットアップしていない git リポジトリの中にあります。git で管理しているホームディレクトリなど です。Undine はそのようなリポジトリにブランチや設定を書き込みません。日本語の UI では「このプロジェクトは git リポジトリ … の中にありますが、 このリポジトリは Undine 用にセットアップされていません。…」と表示されます。
対処。 履歴パネルの git をセットアップ(Set up git)か、メッセージにあるコマンドでセットアップするか、プロジェクトをその リポジトリの外に移します:
pixi run python -m undine git-setup PROJECT
ライブラリのせいで changeset を開くのを断られる¶
原因。 プロジェクトのライブラリが、プロジェクトの外を指す(またはどこも指さない)シンボリックリンク、絶対パスのリンク、git が 保持しないリンク、または独自の git リポジトリです。changeset の作業コピー(git の worktree)にはそれを入れられません。
対処。 新しい変更セット(New changeset)のダイアログが、そのライブラリとパスを示し、どうすればよいかを表示します。ファイルそのものを プロジェクトに入れるか、ライブラリを依存関係にすれば、必ず解決します。 changeset は git のブランチ を見てください。
採用の途中で Undine が止まった¶
原因。 マージを書いている途中で、サーバーが止まりました(再起動、異常終了)。
対処。 もう一度起動します。起動すると、UI やクライアントに答える前に、マージを終えるか元に戻し(その後にあなたが行ったことは
残します)、the interrupted merge of the changeset … was finished or taken back と表示します。元に戻した場合はレビューがそう表示するので、
もう一度採用してください。Undine が途中で止まったとき を見てください。
検証¶
LVS: pin VDD: connected to nothing inside the schematic and no VDD label in the layout's top cell¶
原因。 回路図のポートが、セルの中で何にもつながっていません(シンボルのためにあるインターフェースのピン。CDAC の vdd など)。LVS
デッキは素子のないネットを取り除くので、レイアウトにはそれと照合するピンがありません。
対処。 レイアウトのトップセルに、その名前のラベルを、ピンのラベルのレイヤー(met1.label …)で、そのメタルの図形の上に置きます。
すると Undine はそのポートを受け入れ、LVS のまとめの unused_pins に挙げます。レイアウトがすでに使っているメタルの上にはラベルを
置かないでください: pin VDD: connected to nothing in the schematic but its label is on the layout net … もエラーです。別のネットを
セルのポートにしてしまうからです。検証 を見てください。
LVS: pin VDPWR: no VDPWR label on the layout net it matched ($12)¶
原因。 回路図のトップセルのピンが、照合したネットでレイアウトのトップセルのピンになっていません。KLayout の比較だけなら受け入れて しまうので、ラベルを付けたストライプから切り離された電源でも「一致」しかねません。Undine はこれを不一致として報告します。
対処。 レイアウトのトップセルで、そのネットが実際に使っている図形の上に、ピンの名前でラベルを付けます。
LVS: tie cell … joins the ports … and …¶
原因。 レイアウトでは conb_1 の HI と LO の出力は電源なので、ポートにつないだタイセルはそのポートを別のポートとつないでしまい、
LVS は 1 つのネットを 2 つのピンと比べられません。
対処。 定数のポートに自分のドライバ(タイセルのネットからのバッファ)を付けるか、そのポートをなくします。検証 の LVS の標準セル(sky130) を見てください。
LibreLane is not available¶
原因。 Undine が探す場所に LibreLane が入っていません。探す場所は、PATH 上の librelane か、Nix のある ~/librelane の
LibreLane のチェックアウトです。
対処。 LibreLane のガイドのとおりに Nix で入れ、~/librelane にクローンしてスモークテストを一度実行するか、それを実行するコマンドを
UNDINE_LIBRELANE に設定します。LibreLane: RTL から GDS へ を見てください。
Verilator is not installed¶
原因。 RTL ビューのリントとシミュレーションには Verilator が必要で、pixi install がそれを入れます。
対処。 pixi install を実行するか、verilator を PATH に置きます(Verilator のインストール)。
git¶
コミットを断られる: library … has layout edits not saved to its cell files¶
原因。 git-setup が入れる pre-commit フックは、ステージした操作ログに、セルのファイルに保存していないレイアウトの編集がある
コミットを断ります。
対処。 Undine でレイアウトを保存し、セルのファイルとログを git add して、もう一度コミットします。
コミットの前にレイアウトを保存する を見てください。
project.json cannot be read (…): a git merge may have left conflict markers in it¶
原因。 git のマージがプロジェクトの project.json に衝突マーカーを残したため、正しい JSON ではなくなっています。プロジェクトの一覧に、
このエラーとともに表示されます。
対処。 ファイルの衝突を解決し(履歴パネルに表示されます)、再読み込みします。
git のマージがセルのファイルで止まった¶
原因。 両方のブランチが、回路図、レイアウト、設計の意図、操作ログの同じオブジェクトを、違うように変えました。
対処。 Undine の環境のシェルを開き、プロジェクトに移って、残っている衝突を一覧し、それぞれでどちらかを選びます(マージが ID と、 続けるためのコマンドを表示します):
cd ~/undine-eda && pixi shell
cd ~/undine-projects/PROJECT
python -m undine merge-check
python -m undine resolve PATH --theirs ID
git add :/PATH
履歴パネルにも、同じ衝突と、DRC / LVS で確認し直すべきセルが表示されます。 git の履歴 と 意味的な差分とマージ を見てください。
WSL2¶
Undine は WSL2 でも Linux と同じように動きます。WSL2 の Ubuntu 22.04 で動作確認しています。いくつか違う点があります:
- プロジェクトは Linux のファイルシステムに置きます。 既定のプロジェクトのルート
~/undine-projectsはそこにあります。WSL から見た Windows のドライブ(/mnt/c/...)は大文字と小文字を区別しないので、大文字と小文字だけが違う名前のセルを保存できません (レイアウトのセルのファイル)。 - Undine のコマンドは WSL のターミナルで実行します。 PowerShell やコマンドプロンプトではありません。
claude mcp addもそうです。 - ブラウザは Windows のものです。 AI アプリが作業を始めると、レビューは Windows のブラウザで開きます。
- WSL の中のファイルを Windows から見る。
pixi run mcpbで作った Claude Desktop の拡張は、Windows のエクスプローラーでは\\wsl$\<distribution>\home\<you>\undine-eda\dist\にあります。 - 拡張を使わない Claude Desktop は、Undine の起動役を
wsl.exe経由で実行します。設定は AI エージェントをつなぐ にあります。
大きなプロジェクト¶
- レビューの差分が途中で切れる。 差分(Diff)のモードが描く違いのポリゴンは最大 4000 個で、ファイルごと(By file)は 取り込んだ大きなレイアウトだと数秒かかることがあります(一度に 1 つずつ読むので、最初からやり直すのではなく待ちます)。
- changeset を閉じるたびに証拠が増える。 採用や破棄をすると、提案の実行結果が証拠として残ります。閉じた changeset のレビューに その大きさが表示され、波形を削除(Prune waveforms)で生の波形を消せます。実行の記録とハッシュは残ります。 採用・破棄の後の証拠 を見てください。
- 大きなリポジトリの中のプロジェクト では、changeset の作業コピーごとにリポジトリ全体をチェックアウトします(スパースチェックアウトは まだありません)。大きな設計は専用のリポジトリに置いてください。
- 多くのシミュレーションを同時に実行する。 シミュレーションでマシン全体が遅くなる のとおりに、
UNDINE_SIM_JOBSとUNDINE_SIM_THREADSを調整します。 - エージェントへの長い答え は短くされます(
undine callが表示するのは最大UNDINE_MAX_CHARS文字、既定は 25000 です。 長い結果 を見てください)。
FAQ¶
Undine とは何ですか?¶
Undine は、カスタム IC(アナログ / ミックスドシグナル)設計のための AI ネイティブな Web ベースの EDA 環境です。回路図、シンボル、レイアウト、RTL、 シミュレーション、DRC / LVS、テープアウトをブラウザで行えます。設計のデータベース、PDK、PCell、DRC / LVS、シミュレーションはサーバーで 動き、HTTP API の向こうにあります。ブラウザの UI はその API のクライアントの 1 つで、スクリプトや AI エージェントもクライアントです。 すべての変更は記録され、レビューできます。概要 を見てください。
Undine でないものは何ですか?¶
- ホスティングされたサービスではありません。 サーバーは自分のマシンか、自分が管理するマシンで動かします。ユーザーアカウントや サインインはありません。
- Undine が動かすツールの代わりではありません。 Undine は KLayout、Xschem の形式、ngspice、Magic、Netgen、Verilator、LibreLane を
使います。それらの結果はそれらのツールのものです。Undine は Xschem の
.sch/.symファイルを読み書きするので、Xschem でも開けます。 - 完成していません。 Undine はアルファ版です。インターフェース、ファイル形式、HTTP API は、コミットの間でまだ変わることがあります。
どの OS で動きますか?¶
サーバーは、glibc 2.28 以上の Linux x86-64、または Windows の WSL2 で動きます。pixi の環境は linux-64 用にだけ作っているので、サーバーは
macOS や Windows でネイティブには動きません。ブラウザは、サーバーに届くどのコンピューターにあってもかまいません
(別のコンピューターから Undine を開けない を見てください)。
どのブラウザに対応していますか?¶
最新のデスクトップのブラウザです。UI は Vite の既定のターゲット、つまりネイティブの ES モジュールに対応したブラウザ(Chrome 87、 Edge 88、Firefox 78、Safari 14 以降)向けにビルドしています。Undine のスクリーンショットは Chromium で撮っています。
どの PDK に対応していますか?¶
SkyWater SKY130、GlobalFoundries GF180MCU、IHP SG13G2 です。ciel で入れ、それぞれデッキ、 モデル、コーナー、PCell が使えます。ciel が SG13G2 と一緒に入れる SG13CMOS5L は未検証です。DRC は 設定してあり、LVS とシミュレーションは設定してありますが実行したことがなく、PCell はありません。ほかのファミリーの PDK も一覧には 出ますが、プロファイル が必要な機能は使えません。動作確認したバージョンは サポートしている PDK に、コマンドは PDK のインストール にあります。
設計はどこかに送られますか?¶
Undine 自身は送りません。サーバーは起動した場所で動き、テレメトリーはありません。ブラウザはサーバーが送ったものを描くだけです。 データが手元のマシンから出るのは、次の場合だけです:
- AI エージェント。 MCP では、AI アプリのプロバイダーが Undine のツールの返したものを受け取ります。アプリ内の設計エージェントでは、
追加した API キーのプロバイダーが、エージェントの送ったものを受け取ります。ローカル LLM(Ollama)なら何も出ません。送ったものは
すべて
<project>/llm/audit.jsonlに記録され、--llm-policy noneで LLM の接続をすべて無効にできます (AI エージェントをつなぐ)。 - 自分で始めたダウンロード。
setup.shはパッケージ、ngspice のソース、PDK、OpenVAF をダウンロードします。lib addとlib syncは、 ライブラリの依存関係をその git のリモートから取得します。 - フォント。 UI のページはフォントを Google Fonts(
fonts.googleapis.com)から読み込みます。そのリクエストに設計のデータは 含まれません。
PDK もサーバーに留まります。ブラウザが見るのはレイヤーの色、シンボル、PCell のパラメータ、描画した結果で、モデル、ルールデッキ、 PCell のコードは見ません。
AI エージェントが勝手に設計を変えることはありますか?¶
ありません。エージェントは changeset、つまり git のブランチ上の作業コピーで作業します。設計が変わるのは、人がレビューで 採用 (Adopt)をクリックしたときだけで、エージェントには採用するツールがありません。レビューの 停止(Stop)でエージェントを止めたり、 提案を前の手順の状態に戻したり、破棄したりできます。changeset を見てください。
再起動すると作業は失われますか?¶
失われません。実行中のシミュレーションは走り続け、同じプロジェクトのルートで次に起動したサーバーが引き継ぎます。待機中のシミュレーションは
順番を保ち、エージェントはセッションと changeset を保ちます。サーバーが終わらせなかった DRC、LVS、抽出、RTL、LibreLane の実行は
interrupted と示されるので、実行し直します(レビューの 必要な検証を実行(Run needed checks))。
詳しくは サーバーの再起動 にあります。
ブラウザの claude.ai や ChatGPT から Undine を使えますか?¶
まだ使えません。それらのコネクターはプロバイダーのクラウドから MCP サーバーにつなぐので、Undine がインターネットから届き、きちんとした サインインを備えている必要がありますが、それはまだ作っていません。Claude Desktop、Claude Code、またはほかのローカルの MCP クライアントを 使ってください。
手持ちの Xschem や GDS のファイルを使えますか?¶
使えます。Undine は Xschem の .sch / .sym 形式を読み書きし、GDS と OASIS のレイアウトを取り込みます。UI ではライブラリの行の
既存セルをインポート(Import existing cell)、コマンドラインでは次のとおりです:
pixi run python -m undine import PROJECT LIB chip.gds
Undine のライセンスは何ですか? KLayout と一緒に配布できますか?¶
Undine は Apache License 2.0 でライセンスされています。Undine と一緒に使うツール、Python のパッケージ、PDK は、それぞれ自分の ライセンスのままです。サーバーは GPL-3.0-or-later の KLayout Python モジュールを import するので、Undine とそのモジュールは 1 つの 結合したプログラムになります。Undine を動かすこと(サービスとして動かすことも)は、GPL の義務を生じさせません。2 つを一緒に 配布する 人 (コンテナイメージ、VM、インストーラー)は、その結合物を GPL-3.0 で配布することになり、その条件を満たす必要があります。全体の表は ライセンス にあります。これは要約で、法的な助言ではありません。
Undine を日本語で使えますか?¶
使えます。上部バーの右にある言語メニューで 日本語 を選びます(表示言語)。このドキュメントも、すべての ページに日本語版があります。ヘッダーの言語の切り替えを使ってください。日本語版がまだない新しいページは英語で表示されます。
バグを報告するには?¶
https://github.com/kadomoto-lab/undine-eda/issues で、開いている issue と閉じた issue を検索してから、issue を作成します。何をしたか、 何を期待したか、何が起きたかと、次の出力を含めてください:
pixi run doctor # what is installed (tool paths) and the PDKs found
pixi run python -m undine lib status PROJECT # tool versions vs undine.lock
git rev-parse --short HEAD # the Undine version
プロジェクトの PDK の id(project.json の pdk フィールド)、使っているディストリビューション(または WSL2)、UI の問題ならブラウザ、
そして まずチェックを実行する にあるログも添えてください。よい報告に何が必要かは
CONTRIBUTING.md にあります。
Warning
issue は公開されます。秘密保持契約(NDA)のもとにある PDK のファイル、共有してはいけない設計のデータ、~/.undine/env(API キーが
入っていることがあります)は添付しないでください。