用語集
ドキュメントで使うファームウェア、電子回路、PCB、製造、機構設計、Embedrの用語を簡潔に定義します。
Embedrの用語
エージェント(Agent)
チャットパネルのAIアシスタントです。ファイルの読み書き、ファームウェアのビルドと書き込み、コマンドの実行、回路図・基板・機構設計の作業を行い、リスクのある操作の前には確認を求めます。Embedrエージェントを参照してください。
チェックポイント(Checkpoint)
チャットのターンごとに保存されるプロジェクトの状態です。そのターンでエージェントが行った変更を取り消せます。
デバイス(Device)
書き込みとシリアルモニターに使う、接続中のシリアルポートまたはUSBポートです(例: COM5、/dev/cu.usbserial-0001)。
Embedr CLI
デスクトップアプリがビルドやプロジェクト操作に使うembedrコマンドラインツールです。直接使うこともできます。CLIリファレンスを参照してください。
ヘルパー(Helper)
レビューや部品調達など、特定の作業のためにメインエージェントが起動する別のエージェントです。各ヘルパーは自分のスレッドで作業し、終わると報告します。チャットには「… started working」と「… finished」が表示されます。ヘルパーを参照してください。
マニフェスト(Manifest)
embedr.yamlのことです。プロジェクトのルートにあり、プロジェクトに何が含まれ、どうビルドするかをEmbedrに伝えます。プロジェクトマニフェストを参照してください。
プランモード(Plan Mode)
エージェントがプロジェクトを変更する代わりに、あなたにヒアリングして仕様書を書くチャットモードです。Shift+Tabで切り替えます。プランモードを参照してください。
共有リンク(Share link)
studio.embedr.app上に公開したプロジェクトのコピーへのリンクです。リンクを知っている全員に公開するか、メールで招待した人だけに公開するかを選べます。プロジェクトの共有を参照してください。
仕様書(Spec)
プランモードがspecs/以下に保持するMarkdownファイルです。目的、confirmed・assumed・openのいずれかが付いた要件、決定事項、対象外の項目、計画を含みます。Implement this specでエージェントに渡します。
実行中の指示(Steering)
エージェントの作業中にメッセージを送ることです。メッセージは作業を止めずに、エージェントの次のステップの前に加わります。
ターゲット(Target)
ツールバーで選択するビルドプロファイルです。ボード、プラットフォーム、フレームワークに解決されます。ターゲットと環境を参照してください。
スレッド(Thread)
チャット履歴に一覧表示される、エージェントとの1つの会話です。1つのプロジェクトに複数のスレッドを持てて、各ヘルパーにも専用のスレッドがあります。
ファームウェア
ボーレート(Baud rate)
シリアル通信の速度です。シリアルモニターの値はファームウェアの値(例: 115200)と一致させる必要があります。
ブートローダー(Bootloader)
マイコン上で新しいファームウェアを受け付ける小さなプログラムです。ボードによっては、書き込むためにブートローダーモードにする必要があります(例: ESP32でBOOTを押したままにする)。
環境(Environment)
PlatformIOプロジェクトの[env:esp32dev]のような、名前付きのビルドプロファイルです。
ファームウェア(Firmware)
マイコン上で動くソフトウェアです。
書き込み(Flash)
コンパイルしたファームウェアをボードのメモリに書き込むことです。ツールバーのFlashボタンで行います。
フレームワーク(Framework)
Arduino、ESP-IDF、Zephyrなど、ファームウェアが前提とするソフトウェアの土台です。
GPIO
汎用入出力(General-Purpose Input/Output)です。ファームウェアが読み取ったり駆動したりできるマイコンのピンです。
プラットフォーム(Platform)
espressif32やststm32など、チップ向けのPlatformIOパッケージ群です。
PlatformIO
Embedrが多くのファームウェアプロジェクトで使うビルドシステムです。
Rosetta 2
Apple Silicon搭載のMacでIntel向けプログラムを動かすAppleの変換レイヤーです。一部のボードのツールチェーンで必要です。
電子回路とシミュレーション
ERC
回路図に対する電気的ルールチェックです。未接続のピン、出力同士の衝突、電源の欠落などを検出します。
ネット(Net)
電気的に接続されたピンの集合です。
ネットリスト(Netlist)
回路図から生成される、部品とそれらをつなぐネットの一覧です。
ngspice
Embedrが使うオープンソースのSPICEシミュレーターです。インストールされていればローカルで、そうでなければクラウドで動きます。
回路図(Schematic)
回路の論理的な図面です。部品とその接続を表します。
SPICE
ネットリストと入力信号から、アナログ回路や混在回路をシミュレーションする標準的な方式です。シミュレーションを参照してください。
Zener(.zen)
EmbedrのPCBワークスペースが回路図と基板の意図を記述するのに使うテキスト言語です。回路図とPCBを参照してください。
PCB
コートヤード(Courtyard)
ほかの部品が近づきすぎないように、フットプリントが基板上に確保する領域です。
DRC
デザインルールチェックです。KiCadが、クリアランス、配線幅、穴、未接続の項目、回路図との一致について、基板をルールに照らして確認します。エラーは常に注文を妨げます。個々の警告はManufacturingタブで承認できます。
フットプリント(Footprint)
部品が基板上で必要とする銅パッド、穴、外形です。
KiCad
Embedrが基板に使う、オープンソースの回路図・PCBスイートです。ローカルの基板ツールにはKiCad 10が必要です。ボードとKiCadを参照してください。
製造プロファイル(Manufacturing profile)
基板が対象とする基板メーカーの工程(既定はPCBWay)で、基板に記録されます。最小の配線幅、クリアランス、ドリル径、アニュラリングを設定し、メーカーが製造できないものをDRCで検出できるようにします。
ネットクラス(Net class)
配線幅、クリアランス、ビアのサイズを共有するネットのグループです。
PCB
プリント基板(Printed circuit board)です。
配線(Routing)
各ネットをつなぐ銅の配線とビアを描くことです。Embedrは自動で配線できます。配置と配線を参照してください。
未配線の接続(Unrouted connection)
ネットリストにあるものの、まだ基板上に銅がない接続です。基板のフッターではUnroutedとして数えられます。
ビア(Via)
異なる層の銅をつなぐ、めっきされた穴です。
製造
アニュラリング(Annular ring)
ドリル穴の周囲に残る銅のリングです。
BOM
部品表(Bill of materials)です。基板上のすべての部品を、数量、パッケージ、メーカー型番、調達情報とともに記載します。Embedrはpcb/bom.csvに保持し、BOMタブに表示します。
DFM
製造性設計(Design for manufacturing)です。メーカーが実際に製造できるもののルールです。EmbedrはManufacturingタブでProvider DFMとしてチェックします。DFMの指摘は常に注文を妨げます。
製造図面(Fabrication drawing)
基板メーカー向けの、基板外形、ドリル表、製造上の注記をまとめたPDFです。
ガーバー(Gerber)
PCBの各層(銅、ソルダーマスク、シルク、外形)の標準ファイル形式です。基板メーカーはガーバーとドリルファイルから基板を製造します。
IPC-2581
基板全体を記述する1ファイルの交換形式です。Embedrは基板をこの形式でエクスポートし、そこからレンダリング、図面、ガーバー、BOM、部品実装データを生成します。
MPN
メーカー型番(Manufacturer part number)です。注文できる正確な部品を表します。
PCBA
プリント基板アセンブリ(Printed circuit board assembly)です。部品がはんだ付けされた基板を指します。EmbedrではPCB + assemblyです。
部品実装データ(Pick-and-place、CPL)
実装機が使う部品の配置リスト(リファレンス、位置、回転、面)です。
極性 / 向き(Polarity / orientation)
部品を配置すべき向きで、1番ピンや極性マークで示されます。向きの誤りは最も多い実装不良のため、Embedrは実装の注文を送る前に向きの確認を求めます。
製造と注文を参照してください。
機構設計
組立ガイド(Assembly guide)
エージェントが書く、機構設計を組み立てるための手順書です。mechanical/assembly/に保存されます。
図面(Blueprint)
ビルド済みの設計を描いた10枚の2D図面シート(4つの斜め方向のビューと6つの側面)です。寸法と部品ラベルを付けることもできます。
分解図(Explode view)
アセンブリの部品を引き離して、どう組み合わさるかを見せるビューです。MechanicalワークスペースでEを押します。
GLB
プレビューやWebで使うコンパクトな3Dファイル形式です。
パラメーター(Parameter)
肉厚など、機構設計の中の名前付きの値です。スライダーで変更して再ビルドできます。
比較用のシーン(Reference scene)
実際の大きさがわかるようにモデルの横に置く、机、部屋、人物です。
リビジョン(Revision)
機構設計の1回のビルドです。ビルドのたびに、後から戻れる新しいリビジョンが作られます。
断面図(Section view)
モデルを平面で切断して内部を見せるビューです。MechanicalワークスペースでSを押します。
STEP
正確な3D CADモデルの標準交換形式(.stepまたは.stp)です。機構設計はSTEPとしてビルドされ、基板もSTEPとしてエクスポートできます。
機構設計を参照してください。
