ここから始める
KiCadからの移行
agenteeがKiCadから引き継ぐものと、異なる点: インポート元のライブラリ、基板全体のインポート、概念の対応関係。
agenteeは、ファイル形式が異なるKiCadの代替品ではありません。エージェント向けの設計ツールであり、KiCadのライブラリを借用し、KiCadの基板を読み込みます。KiCadを知っていれば、ほとんどの概念は引き継がれます。変わる点は、ファイルがインターフェースであること、人がエディタではなくエージェントとビューアを通じて編集することです。
ライブラリ
agenteeには独自の部品ライブラリはありません。agentee searchとagentee importは、以下の場所からKiCadのシンボルとフットプリントライブラリを読み込みます。
- Linuxでは
/usr/share/kicadと/usr/local/share/kicad、 - macOSでは
/Applications/KiCad/KiCad.app/Contents/SharedSupport、 - それ以外(Windowsを含む)では
KICAD9_SYMBOL_DIRとKICAD9_FOOTPRINT_DIR。KICAD8_*とKICAD_*も機能します。
agentee search symbol lm358
agentee import symbol Amplifier_Operational:LM358 --with-footprint
agentee import footprint Package_TO_SOT_SMD:SOT-89-3インポートは、symbols/またはfootprints/に.sym.tomlまたは.fp.tomlを書き込みます。それ以降、プロジェクトが所有します。ライブラリへのリンクはなく、KiCadが更新されても部品が変化しません。標準ライブラリ外の部品には、Library:Nameの代わりに.kicad_symまたは.kicad_modのパスが機能します。
3Dモデルは、KICAD9_3DMODEL_DIRなど、プロジェクト内の3dmodels/、またはagentee modelsがkicad-packages3Dリポジトリから埋めるキャッシュから来ます。
概念の対応
| KiCad | agentee |
|---|---|
.kicad_proの基板設定: 層、ルール、ネットクラス | *.board.toml: 基板メーカープリセット、層構成プリセット、[rules]、[[netclasses]]、[[vias]] |
| シンボルライブラリエントリ | *.sym.toml、シンボルごとに1つ |
| フットプリント | *.fp.toml、パッドごとに1エントリではなくパッド行を使用 |
| 配線付き回路図シート | *.sch.toml: 部品とネットをピンリストとして記述、配線は任意 |
| 階層型シート | 最上位回路図のsheets = [...]、ネットは名前で結合 |
.kicad_pcb | *.pcb.toml: 配置、配線、ビア、ベタ、シルク |
| DRC | agentee check、agentee drc NAME --listで全ルールを列挙 |
| ベタ充填 | 読み込み時に自動実行、キャッシュあり。agentee fillでファイルに保存 |
| Gerberとドリルファイルのプロット | agentee fab |
フットプリントのフィールドmpn、lcsc | 回路図の部品に同じフィールドを設定、BOMとagentee partsが読み取り |
挙動が異なる点:
- ネットクラスの線幅は最小値です。KiCadではクラス線幅は新規配線のデフォルトですが、agenteeではクラスより細い配線はエラーになります。パッドへの短いネックダウンを除きます。
- インピーダンスと電流はクラスに設定します。クラスに
impedance = "50ohm"またはcurrent = "2A"を設定すると、checkが層構成の全層で線幅を計算します。 - 層構成は基板メーカーのものです。厚さを手入力する代わりに、
agentee stackupsからJLC04161H-7628やPCBWayのビルドを選択します。 - Y軸は下向きです。全ファイルでKiCadのフットプリントエディタと同様です。回転は画面上で反時計回りです。
- 不明なキーはエラーです。キーのタイプミスは無視されず、報告されます。
- 全基板にバージョンウォーターマークがあります。シルクにagenteeのバージョンと、ファブパッケージをビルドしたコミットが記載されます。
基板全体のインポート
agentee import board path/to/NAME.kicad_pcb --dir NAME
cd NAME
agentee check
agentee render pcb:NAME -o NAME.pngインポートで書き出されるファイル:
| ファイル | 元 |
|---|---|
NAME.board.toml | Edge.Cutsのアウトラインとそのカットアウト、厚さ・誘電率・損失正接を含む層構成、仕上げとソルダーレジストの色、NAME.kicad_proからの設計ルールとネットクラス |
NAME.pcb.toml | フットプリント配置、配線（アークは短いセグメントとして）、充填を保存したビアとベタ、シルクとファブのテキストおよび線。${TITLE}とプロジェクトのテキスト変数は展開済み |
NAME.sch.toml | 値付きの全部品、ネットラベルで描画したピンリストとしての各ネット |
footprints/ | 基板上の配置どおりの各フットプリント、底面のは上面に反転 |
symbols/ | フットプリントごとにボックスシンボル1つ、パッド番号ごとにピン |
回路図はネットリストであり、図面ではありません。KiCadの回路図は読み込まれないため、ピン名、シンボルの図、シート構造は引き継がれません。これでも基板のチェック、レンダリング、シミュレーション、製造が可能で、エージェントによるレイアウト変更もできます。
ビアはタイプを保持します。KiCadのmicroビアはマイクロビアになり、blindはスパンに応じてブラインドまたはバリアになります。ドリル、パッド、スパン、充填、バックドリルの組み合わせごとに、基板のビアタイプが作成されます。座標はアウトラインが0, 0から始まるように移動します。
除外され、報告されるもの: ティアドロップ、キープアウト領域、アウトライン外のEdge.Cutsのループ。クラスより細い配線がある場合は、agenteeが線幅を最小値とみなすため、最も細いものが採用されます。クリアランスはKiCadの0.5 umの許容誤差でチェックされます。
KiCadのvideoとcomplex_hierarchyデモでは、インポートしたレイアウトの全パッドが、KiCadのIPC-D-356エクスポートと同じ位置に配置されます: 2089と165パッド。HackRF Proの例はこの方法でインポートした完全な基板です。
戻す
KiCadファイルへのエクスポートはありません。agenteeから出ていくのは、ファブパッケージ（X2属性付きGerber、Excellonドリル、BOM、配置、IPC-D-356ネットリスト）と、組立済み基板のSTEPです。これらはどの基板メーカーでも、どのMCADツールでも読み取れます。