用語集

ドキュメントで使うファームウェア、電子回路、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で切り替えます。プランモードを参照してください。

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としてエクスポートできます。

機構設計を参照してください。