回路図とPCB

ハードウェアを.zenで記述し、PCBワークスペースを用意し、回路図タブを読み、要件から回路図を作ります。

Embedrプロジェクトのハードウェアはテキストです。ファームウェアの隣にある pcb/ フォルダの .zen ソースファイルで記述します。Schematicsタブはそのソースを描画し、Boardタブはソースから生成されたKiCadのレイアウトを表示し、エージェントは両方を編集します。

ハードウェアのソース層

新しいエレクトロニクスのワークスペースは次のような構成です。

my-project/
  embedr.yaml
  src/
    main.cpp
  pcb/
    pcb.toml        # workspace settings and the selected board
    main.zen        # the board's schematic source
    .gitignore      # ignores the .pcb/ cache
    layout/         # KiCad board files, created when the layout is generated
      main.kicad_pcb
      main.kicad_pro
  • .zen ファイルが正となるソースです。コードと同じように編集、レビュー、コミットします。
  • pcb/pcb.toml は、SchematicsタブとBoardタブで開くボードを指定します(name と path を持つ [board])。
  • ボードファイルではボード自体を宣言します。例:Board(name="main", layout_path="layout", layers=2)。
  • layout/ 以下のファイルはソースから生成され、その後は配置、配線、基板ツールで編集されます。他の人が再生成せずに同じ基板を開けるようにしたい場合はコミットしてください。

.zen ソースの小さな例:

Resistor = Module("@stdlib/generics/Resistor.zen")

VCC_3V3 = Power(voltage="3.3V")
GND = Ground()
LED_A = Net()

Resistor(name="R1", value="330ohm", P1=VCC_3V3, P2=LED_A)

ネットは変数、部品はモジュールのインスタンスで、接続は各ピンに渡すネットで表します。

ワークスペースを用意する

Add tab(+)メニューの Workspaces から Schematics タブを開きます。ワークスペースがない場合、タブには次のいずれかの状態が表示されます。

状態 表示 対処
プロジェクトが開いていない Open a project to start schematics 先にプロジェクトを開くか作成します。
pcb/ ワークスペースがない Initialize the PCB workspace Ask agent to initialize schematics をクリックします。
ワークスペースはあるがメインの .zen がない Restore the main board file Ask agent to initialize schematics をクリックします。

このボタンはエージェントに依頼を送り、エージェントが pcb/pcb.toml、pcb/main.zen、pcb/.gitignore を作成します。既存のファイルは上書きされません。ワークスペースに .zen ファイルはあるもののボードが選択されていない場合は、エージェントが pcb.toml に [board] の項目を追加し、古いファイルのバックアップを残します。

ターミナルから embedr pcb init を実行してもワークスペースを作成できます。この場合、ボードファイルにはプロジェクト名が付きます。CLIリファレンスを参照してください。

リンクから開いた公開プロジェクトは閲覧専用です。ボタンは無効になり、フッターに "Public projects are view only" と表示されます。

Schematicsタブ

.zen ファイル、pcb.toml、pcb.sum を保存するたびに、回路図は自動で更新されます。評価中は、ヘッダーに "Evaluating schematic..." と表示されます。

読みやすいブロック

位置が保存されていない部品は、機能ブロックごとに自動で配置され、各ブロックは太字のタイトル付きの破線の枠で囲まれます(たとえば電源ブロックや、周辺部品を伴うIC)。枠は読みやすくするためのもので、クリックはできず、KiCadにも書き出されません。

すでに配置した回路図に部品を追加すると、自分で置いた部品はその場所に残り、新しい部品はその周りに配置されます。

操作

操作 方法
ズーム マウスホイール、または下部バーの Zoom in / Zoom out
パン Viewモードでキャンバスをドラッグするか、マウスの中ボタンでドラッグ
全体を表示 Fit to Viewport
100%に戻す、または選択範囲にフォーカス ズーム率をクリック
図面の一部に移動 ヘッダーの Jump to section…:Whole schematic または任意のセクション枠
再評価 Refresh Schematic

下部バーには Components と Nets の数も表示されます。

ツール

左側の Tools パネル(最初は折りたたまれています。Expand tools をクリック)には次のツールがあります。

ツール ショートカット 用途
View / pan H 既定。ドラッグでパン、部品をダブルクリックで選択。
Select / move V クリックで選択、部品をドラッグで移動。
Section frame F 部品のグループをタイトル付きの枠で囲みます。
Text T テキストラベルを配置します。
Note box N 枠付きのメモを配置します。
Rectangle 四角形を描きます。
Line L 線を描きます。
Arrow A 矢印を描きます。
Circle O 円を描きます。

パネルには、Copy screenshot、注釈用の Undo(⌘Z / Ctrl+Z)と Redo(⇧⌘Z / Ctrl+Shift+Z)もあります。

キャンバスでのその他のキー:

  • Esc でViewモードに戻ります。
  • R で選択した部品を90°回転します(下部バーの Rotate Selected (R) でも可能)。
  • ドラッグ中に ⌘ / Ctrl を押し続けると、グリッドから外して部品を移動できます。
  • Enter で選択した注釈のテキストを編集し、⌘Enter / Ctrl+Enter で確定します。
  • Delete / Backspace で選択した注釈を削除します。

編集の保存先

  • ドラッグした部品の位置は、.zen ファイルの末尾にコメントブロックとして、# pcb:sch R1 x=… y=… rot=… のような行で保存されます。先にそのファイルの未保存の編集を保存してください。保存していないと "Save the edited board file before saving component positions." と表示されます。
  • セクション枠、メモ、テキスト、図形は、.zen ファイルの先頭に # embedr:schematic-graphic のコメント行として保存されます。

どちらも普通のテキストなので、差分に表示され、プロジェクトと一緒に持ち運ばれます。

検索、確認、書き出し

  • サイドパネル(Toggle Right Panel)には Components、Properties、必要に応じて Diagnostics と Inputs のタブがあります。
  • Components には検索ボックス "Find component or net..." があり、リファレンス、値、名前、接続されたネットに一致します。
  • Properties には、選択した部品の名前、位置、回転、フットプリント、接続されたネット(クリックするとハイライト)が表示され、データシートがわかっている場合は Open Datasheet も表示されます。
  • Inputs には、ボードの設定可能なパラメーターが一覧表示されます。
  • カメラアイコン(Copy schematic screenshot)はPNGをクリップボードにコピーします。
  • Export schematic はPNG、PDF、SVGで保存します。画像の解像度は1倍〜100倍です。
  • Export to KiCad はKiCadの回路図を書き出し、KiCadで開きます。ローカルにKiCad 10がインストールされている必要があります。

部品をクリックしてどこにあるか探す

部品を選択すると(Viewモードではダブルクリック、Selectモードではクリック)、下部にバーが表示されます。

  • Ref · Value でプロパティを開きます。
  • Add to chat は、部品(ソースファイル、リファレンス、値、フットプリント、接続されたネット、データシート)を次のメッセージに添付します。
  • View on board はBoardタブに切り替えて同じ部品にフォーカスします。まだ基板上にない場合は、Boardタブにその旨が表示されます。
  • Datasheet は、データシートがわかっている場合にそれを開きます。

Boardタブには逆方向の操作 View in schematic があります。ボードとKiCadを参照してください。

診断

.zen ソースの問題は2か所に表示されます。

  • エディタ内。 .zen ファイルには言語サポートがあります。エラーと警告の波線、ホバーでのドキュメント、補完、シグネチャヘルプ、定義へ移動が使えます。
  • Schematicsタブ内。 下部バーに "2 Errors" や "1 Warning" のような件数が表示されます。クリックすると Diagnostics タブが開き、各問題が場所とともに一覧表示されます。矢印キーで順に移動できます。

回路図を評価できない場合は、キャンバスの上に Copy と Retry 付きのエラーカードが表示されます。

エージェントも作業中にソースのリントとビルドを行います。タイムラインの行には、たとえば "Lint PCB/Zener file" や "Build PCB project" と表示され、詳細にエラーと警告の件数が示されます。

ソースの自動修正

よくあるソースの問題は、エージェントに修正を依頼できます("Run pcb fix on the workspace and show me the diff first")。Fix Zener source の行には次のいずれかが表示されます。

  • "Nothing to fix in …"
  • "Previewed pcb fix for …"(詳細に差分)
  • "Applied pcb fix to …"

修正の対象は、1つの .zen ファイルか pcb/ ワークスペース全体です。編集するのは .zen ソースだけで、KiCadの基板ファイルには触れません。プランモードでは、エージェントはソースの修正を実行しません。

KiCadシンボルライブラリを確認する

自分のKiCadシンボルを持ち込む場合、エージェントはプロジェクト内の .kicad_sym ファイルや .kicad_symdir フォルダを読めます("Inspect pcb/libs/sensors.kicad_sym and tell me which symbols have footprints")。Inspect symbol library の行には "Read N symbol(s) from …" と表示され、エージェントは各シンボルの名前、リファレンス、値、フットプリント、データシート、説明、キーワードを取得します。プロジェクト外のパスは拒否されます。

読みやすさの調整を依頼する

依頼しない限り、エージェントは図面に手を加えません。回路図をすっきりさせたいときは、望む内容を伝えてください。

  • "Tidy up the schematic."
  • "Rearrange the whole schematic from scratch."(保存した位置は破棄されます。)
  • "Add a section frame around the power supply and label it."
  • "The I2C labels overlap near U1, fix that."

エージェントは部品を動かしたり注釈を追加したりし、再描画された回路図を見て、読みやすくなるまで繰り返します。エージェントが位置や図形を保存すると、Schematicsタブが自動で開きます。表示される行には Arrange schematic、Save schematic positions、Schematic graphics、Schematic screenshot があります。

要件から回路図まで

エージェントとの典型的な流れ:

  1. ボードについて説明します。何をするか、電源入力、コネクタ、マイコン、どこで製造するか。プランモードでは、エージェントがヒアリングして仕様書を書きます。
  2. "Initialize the PCB workspace."
  3. "Find real parts for a 3.3 V regulator, a USB-C connector and a BME280 in the component library and install them." コンポーネントライブラリを参照してください。
  4. "Write the schematic in pcb/main.zen and build it."
  5. "Inspect the netlist and confirm VCC_3V3, GND, SDA and SCL reach the right pins."
  6. "Check that the pins match src/main.cpp." ファームウェアと回路図のピン割り当ては同じタスクの中で扱いましょう。
  7. "Generate the PCB layout." これで pcb/layout/ にKiCadの基板が作成され、基板メーカーの製造条件が記録されます。配置と配線を参照してください。

レイアウトの前に回路の動作を確かめるには、シミュレーションを参照してください。

対応するCLIコマンド

embedr pcb init          # scaffold pcb/ (pcb.toml, README.md, board .zen)
embedr pcb status        # workspace, board file and pcb runtime version
embedr pcb build         # build the board .zen
embedr pcb test          # run pcb tests
embedr pcb layout        # generate the KiCad layout (--check, --no-open, --sync-footprints)
embedr pcb open          # open the layout in KiCad
embedr pcb fmt           # format .zen source

ソースの自動修正とシンボルライブラリの確認は、エージェントからのみ利用できます。