コンポーネントライブラリ

検証済み部品の検索、シンボル、フットプリント、3Dモデル、パッケージの導入、製造条件との照合。

コンポーネントライブラリは、Embedrが公開しているハードウェア部品のカタログです。各レコードは実在の部品(メーカー、型番、パッケージ)と、基板に必要なファイル(.zen パッケージ、KiCadのシンボルとフットプリント、3Dモデル、データシート)を結び付けます。エージェントは部品を選ぶ前にライブラリを検索し、部品を pcb/ ワークスペースに導入します。そのため回路図には推測ではなく実際のピンとフットプリントが使われます。

ライブラリはエージェントを通じて使います。専用の閲覧画面はなく、各ステップがチャットのタイムラインに1行ずつ表示されます。

行 内容
Search components 公開されている部品を検索します。
Component record 1つの部品のレコード全体を読みます。
Component asset フットプリントやデータシートなど、アセットを1つ取得します。
Install component 部品のパッケージをプロジェクトに導入します。
Component asset files アセットファイルを1つプロジェクトに保存します。
Search component knowledge / Read component knowledge / Ask component knowledge 部品のインデックス済みデータシートとノートを検索したり、質問したりします。

検索

普通の言葉でも、型番でも、両方を組み合わせても依頼できます。

Find a 3.3 V LDO regulator in SOT-23-5 that can supply 300 mA.
Search the component library for BME280. I need a PCB-ready part with a datasheet.

エージェントは説明、コンポーネントID、別名、パッケージ、メーカー型番で検索でき、結果を絞り込むこともできます。

  • カテゴリ(Connectorなど)。
  • 実装方式: 表面実装またはスルーホール。
  • 必須条件: PCB用アセット、ブレッドボード表示、データシート、調達情報があること。

結果カードには最大8件が表示されます。各件には部品名、続いて ID • メーカー • 型番 • パッケージ • 実装方式、そして短い説明が表示されます。

明示した要件は守られます。型番、接点数、実装方式は一致している必要があります。別の部品のデータシートに記載されているだけの部品は一致とはみなしません。条件を満たす部品がない場合、カードは無関係な代替品を出さずに "No published components matched the request." と表示し、エージェントはデータシートやWebでの調査に移ります。

プランモードでは、エージェントはライブラリを検索せず、部品の比較もしません。使いたい部品を仕様書に記録し、実装時に調べます。

レコードの内容

Component record には、部品の Component、Manufacturer(名前 • 型番)、Category、Package(パッケージ • 実装方式)、Readiness が表示され、続いて Assets、Description、Structured Record 全体が表示されます。

レコードには次の情報が含まれることがあります。

  • 識別情報: ID、名前、バージョン、メーカー、型番、カテゴリ、パッケージ、実装方式、説明。
  • ピン: 番号、名前、信号、方向、種類、電圧、プロトコル。注意が必要なピン(ブートストラップ、使用を避けるピン)には注記が付きます。
  • 設計上の制約: デカップリングやレイアウトのルールなど、データシートの要件。それぞれに重要度、対象ピン、出典があります。
  • 準備状況: スコア、PCBで使える状態かどうか、使えない場合に不足しているもの。
  • パッケージの内容: .zen モジュール名と公開ピン、導入されるファイルとそれぞれのチェックサム。
  • 依頼に応じた追加セクション: データシート、調達、バリエーション、ファームウェアのメモ、.zen のドキュメント、PCB検証。

アセット

アセット ファイル
KiCadシンボル .kicad_sym
KiCadフットプリント .kicad_mod
3Dモデル .step、.stp、.wrl
.zen パッケージ、スニペット、生成されたソース .zen
.zen のドキュメントや概要 .md
データシート .pdf とインデックス済みのMarkdown版
ブレッドボード表示 .svg
写真と画像 画像ファイル
検証レポート .json

データシートの知識

多くの部品には、インデックス済みのデータシートとバージョン管理された実装ノートがあります。「BME280のデータシートではどんなデカップリングが必要?」のように質問すると、エージェントはインデックス済みのページをもとに答えます。Ask component knowledge を使うにはサインインが必要です。インデックス済みのデータシートがない部品の場合、エージェントはそのことを伝えて別の情報源に切り替えます。

リンクされた各文書には、それが何を説明しているか(チップ単体、表示パネル、モジュール、キャリアボード、コネクタ、システム全体)が記録されています。チップのパッケージ図面からは、そのチップを載せたブレークアウトモジュールの寸法はわかりません。モジュールや基板の外形については、エージェントはモジュールメーカー自身の図面やCADを探します。自分のデータシートについてはデータシートを参照してください。

部品の導入

エージェントに部品の導入を依頼します(「ライブラリのBME280をこのプロジェクトに導入して」)。先にPCBワークスペースが必要です。ない場合、行には "An initialized PCB workspace is required before installing a component." と表示されます。

  1. エージェントが部品を見つけ、レコードを読みます。
  2. Install component がパッケージのファイルをダウンロードし、それぞれを公開されたチェックサムと照合します。
  3. ファイルを保持する前に、Embedrは依存関係を同期し、パッケージをビルドし、作業用コピー上で基板への取り込みを試します。行には "Dependency sync, module build and exact board import passed …" と表示されます。チェックに失敗した場合は、以前のファイルが復元されます。
  4. 行に "Installed … as a local PCB component package" と、基板ソースに追加すべき行がそのまま表示されます。
  5. エージェントはその行と部品のインスタンスを .zen ファイルに追加し、依存関係を同期し(Sync PCB dependencies)、基板をビルドします。

パッケージは pcb/components/<component-id>/ に置かれます。

pcb/
  main.zen
  components/
    bosch-bme280/
      BME280.zen
      ...symbol, footprint and 3D model files
.embedr/
  component-assets.json

基板ソースでは、たとえば次のように使います。

BME280 = Module("./components/bosch-bme280/BME280.zen")

BME280(name="U2", VDD=VCC_3V3, GND=GND, SDA=I2C_SDA, SCL=I2C_SCL)

ピン名は部品のパッケージで決まっており、エージェントはレコードから読み取ります。

導入するだけでは、基板ファイルや embedr.yaml は編集されません。プロジェクトに複数の基板がある場合、エージェントが別の基板を指定しない限り、pcb/pcb.toml で選択されている基板向けに導入します。

再導入と自分の編集

.embedr/component-assets.json には、導入されたすべてのファイルが出所とチェックサムとともに記録されます。再導入すると次のようになります。

  • すでに一致しているファイルはそのままです。
  • Embedrが導入し、あなたが変更していないファイルは置き換えられます。
  • あなたが編集したファイルは上書きされません。導入は "Refusing to overwrite a modified component file: …" で止まります。

component-assets.json はプロジェクトに残してください。プロジェクトを共有するときにも含まれます。

製造条件との照合

導入された各フットプリントは、パッドごとに基板メーカーの限界値と照合されます。

チェック 比較対象
銅箔が最小フィーチャー幅より細い 最小配線幅
スロットが最小スロット幅より細い 最小スロット幅
穴が最小穴径より小さい 最小ビアドリル径
アニュラリングが最小値未満 最小アニュラリング(めっきスルーホール)

限界値は、基板に記録された製造プロセス(配置と配線を参照)から取得します。記録がない場合はPCBWayの標準2層プロセスを使います。合わないフットプリントがあると、次のような行が追加されます。

This footprint will fail the board's pcbway-standard-2layer-1oz process: SOT-23-5 pad 2:
copper narrower than the minimum feature width (0.1 mm, needs 0.127 mm). Choose another
package or footprint, or confirm the fabricator can build it, before placing it.

部品は導入されたままで、指摘は助言です。問題は最大5件まで具体的に示されます。

embedr.yaml の部品

プロジェクトマニフェストには components: と connections: のリストがあります。これらは上記のライブラリ導入とは別のもので、embedr CLIのローカル部品カタログで使われます。

components:
  - id: led-5mm
    version: latest
    instance: led1

connections:
  - from: {component: led1, pin: Anode}
    to: {component: resistor-through-hole, pin: "1"}
    wire_color: red
  • components: id(必須)、version(既定は latest)、instance(任意の名前)。
  • connections: from と to(それぞれ component と pin)、任意の wire_color。

embedr search、embedr add <id>、embedr remove <id>、embedr list はこれらのエントリを扱います。配線表や初期の計画に使い、実際の回路図には .zen ソースを使ってください。プロジェクトマニフェストとCLIリファレンスを参照してください。

エージェントとの作業

良い依頼では、部品の役割と必須の要件を伝えます。

Use the component library for every part on this board. I need an ESP32-S3 module,
a USB-C receptacle (16-pin, SMD), a 3.3 V regulator and a status LED. Install them
and wire them in pcb/main.zen.
Check the pins of the installed BME280 against src/sensors.cpp before wiring it.
The footprint for J1 failed the fabrication check. Find an alternative connector
with the same pinout that fits our PCBWay process.

ライブラリに適した部品がない場合、エージェントはそのことを伝え、代わりにデータシートやWebで部品を調べます。ライブラリ以外から来た部品はライブラリのチェックを経ていないため、ピンとフットプリントを入念に確認してください。