トラブルシューティング

インストール、サインイン、ビルド、基板、製造、シミュレーション、共有、Git、エージェント実行の症状、原因、対処。

各項目では、表示される症状、その原因、対処を説明します。まず最初に出た本来のエラーメッセージを確認してください。後に続くエラーは、その結果として出ていることがよくあります。

インストールとアップデート

アップデートが失敗する、インストールされない

Update failed カード("The update could not be completed.")や、"The update has not finished downloading." が表示されます。

  • カードの Retry をクリックします。代わりにダウンロードページが開いた場合は、そこから新しいバージョンをインストールします(手動インストールの場合は Download update)。
  • Restart and update は、エージェントがまだタスクを実行中の場合に警告を出します。再起動すると実行が止まるためです。実行が終わるのを待つか、確認してそのまま再起動します。再起動しない場合、アップデートは次回の終了時にインストールされます。
  • Windowsでは、アップデートは自動でインストールされ、中断されたアップデートも自動で回復します。古いインストールでアプリ内アップデートがいつまでも成功しない場合は、最新バージョンを一度だけ手動でダウンロードしてインストールしてください。以降はアプリ内アップデートが動作します。

Windowsで、スペースや引用符を含むパスのコマンドが失敗する

スペースや引用符を含むパスのコマンドはそのまま渡され、長いスクリプトはファイルから実行されるため、Windowsのコマンドライン長の上限で切れることはありません。それでも失敗する場合は、Embedrを最新バージョンにアップデートしてください。

Linux:Embedrの外で変更したファイルが反映されない

大きなプロジェクトでは、Linuxのファイル監視数の上限に達することがあります。その場合Embedrはクラッシュせず、ライブ更新を制限した状態で動作を続けます。上限を引き上げてからEmbedrを再起動してください。

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

サインイン

メッセージ 原因 対処
We could not open the sign-in window. Try again. ブラウザへの引き継ぎが始まりませんでした。 もう一度試します。デスクトップでのGoogleサインインは "Opening browser for authentication..." と表示され、ブラウザで完了します。
Sign-in was cancelled before it finished. ブラウザのタブやウィンドウが途中で閉じられました。 最初からやり直し、ブラウザでサインインを完了します。
Please verify your email before logging in. メールアドレスとパスワードのアカウントがまだ確認されていません。 確認メールを開いてから、サインインします。
This link has expired. Request a new one. 古いメールのリンクです。 新しいリンクをリクエストします。
This email is already connected to another sign-in method. 以前にGoogle(またはメール)で登録しています。 登録したときの方法を使います。
Too many attempts. Please try again later. 試行回数の制限です。 しばらく待ってから、もう一度試します。
Your sign-in session expired. Please sign in again to continue. セッションを更新できませんでした。 もう一度サインインします。中断された実行には "Reauthenticate to continue this run." と表示されます。

モデル

"Model not available on your ChatGPT plan"

接続しているChatGPTのプランに、選んだモデルが含まれていません。カードの Choose another model をクリックし、プランに含まれるモデルを選んで、依頼をもう一度送信します。

Embedr自体のプランを使っていて "Your plan doesn't include this model" と表示された場合は、別のモデルを選ぶかアップグレードしてください。モデルを参照してください。

ファームウェアのビルド

コンパイルが失敗する

Output パネルを開き、最初のエラーを探します。

症状 考えられる原因
インクルードで No such file or directory ライブラリが足りないか、インクルードパスが間違っています。
undefined reference コンパイルは通りましたが、リンカが実装を見つけられません。
was not declared in this scope タイプミス、インクルード漏れ、またはフレームワークの違いです。
パッケージやプラットフォームのインストールエラー ツールチェーンのダウンロードが失敗したか、不完全です。

Outputパネルの Ask agent to fix をクリックすると、エラーをエージェントに渡せます。ビルド、書き込み、シリアルと依存関係とライブラリを参照してください。

"Build timed out after 20 minutes"

ボードの最初のビルドではツールチェーンのダウンロードとインストールが行われるため、時間がかかることがあります。最初のビルドには20分、以降のビルドには10分の制限があります。メッセージの最後には、ビルドログの末尾の数行が表示されます。

  • 接続を確認して、もう一度ビルドします。
  • タイムアウトした場合、エージェントは同じビルドを繰り返さずに状況を説明します。
  • インストールが途中で止まったツールチェーンパッケージはビルド中に検出され、エージェントがどのパッケージが不完全かを伝え、修復する前に確認を求めます。

Apple SiliconでのArduinoビルドにはRosettaが必要

"This board's compiler is an Intel (x86_64) build and needs Rosetta 2 on Apple Silicon, which is not installed." と表示されます。一部のボードのツールチェーンはIntel向けのバイナリしか提供していません。ターミナルでRosettaをインストールしてから、もう一度ビルドしてください。

softwareupdate --install-rosetta --agree-to-license

ツールチェーンのプログラムが "could not run on this Mac's CPU" と表示される場合は、まずクリーンビルドを実行してツールチェーンを入れ直してください。

書き込みが失敗する

ビルドは成功するのに書き込みが失敗する場合:

  • ポートが選択されていないと、Flash ボタンに Select a device to flash と表示されます。デバイスメニューから選んでください("No devices detected" はOSがデバイスを認識していないことを意味します)。
  • データ通信に対応したUSBケーブルを使い、ボードに電源が入っているか確認します。
  • ボード用のUSBシリアルドライバをインストールします。
  • Serial Monitor や、ポートを使っている他のアプリを閉じます。
  • ブートローダーに入らないESP32ボードでは、アップロードの開始時にBOOTボタンを押し続けます。

Serial Monitorに読めない文字が出る場合、たいていはボーレートがファームウェアの Serial.begin(...) と一致していません。

KiCad、ローカルツール、基板

Windowsで基板ツールが失敗する、または "KiCad 10 CLI was not found"

ローカルでの基板操作にはKiCad 10が必要です。Settings → Local tools を開きます。

  • KiCadの行には、KiCad 10がインストールされているか、アップグレードが推奨されるかが表示されます。
  • Where tools run には Local when available(インストールされていればこのマシンのKiCad 10やngspiceを使い、なければクラウドを使う)と Always cloud があります。

KiCad 10がない場合は、KiCadで Always cloud を選ぶか、KiCad 10をインストールします。"KiCad 10 Python is required for this PCB operation" のようなメッセージは、古いKiCad 10を使っていることを意味します。10.0.3以降にアップグレードしてください。クラウドのツールを使うにはサインインが必要です。ボードとKiCadを参照してください。

基板の3D表示が読み込まれない

メッセージ 対処
Unable to generate a 3D preview. 基板が2Dで開けることを確認してから、3Dタブを開き直します。3D表示をクラウドで作成する場合は、サインインしていることを確認します。
Unable to load the generated 3D preview file. 3Dタブを開き直します。

3D表示はKiCad 10がなくても動作します(クラウドを使います)。KiCad 10がインストールされていれば、2Dの基板を見ている間にバックグラウンドでモデルが準備されるため、3Dタブが速く開きます。

配線で未接続が残る

現在の部品配置では、ルーターがすべての接続を完了できませんでした。基板のフッターに Unrouted の数が表示され、結果には見つかった中で最良の配線が残ります。

  • 未接続のネットの周りの部品を移動または回転させてルーターに余地を作り、もう一度配線します。
  • エージェントに自動レイアウトと配線を依頼します(先に承認を求めます)。

手動配線だけにしたい場合は、そう伝えてください。エージェントはそれに従います。配置と配線を参照してください。

製造チェックで注文できない

Manufacturing タブのフッターに、何が妨げになっているかが表示されます。

ステータス 対処
Check board to continue Check board をクリックします。
Board changed チェック後に基板が変更されました。Check again をクリックします。
N DRC warnings to fix or accept 警告を修正するか、問題のないものを1つずつチェックして Accept N warnings をクリックします。
KiCad DRC: N errors, Zen ERC: N errors, Provider DFM: N errors エラーは承認できません。修正してください。DFMの指摘は Show on board で場所を確認できます。
… couldn't confirm N measurements 指摘された形状を修正し、もう一度チェックします。
Sync the BOM to continue BOM を開き、Sync をクリックします。
Check part orientation Orientation review で部品を確認し、I've checked these orientations をクリックします。
Quote unavailable サインインしてオンラインであることを確認し、Configure に戻ります。

ERCとDFMの警告も承認できません。製造と注文を参照してください。

シミュレーション

メッセージ 原因 対処
<file> has no Simulation() setup .zen ファイルにシミュレーションベンチがありません。 刺激(スティミュラス)とコントロールブロックを含む Simulation を追加するようエージェントに依頼します。
The SPICE simulation failed; see the ngspice output. 回路かコントロールブロックが失敗したか、アサーションで停止しました。 ツール行のngspice出力を読み、ベンチの修正をエージェントに依頼します。
ngspice is not installed … and the simulation worker needs a signed-in session. ローカルにngspiceがなく、サインインもしていません。 サインインするか、ngspiceをインストールします(macOSは brew install ngspice、Linuxは sudo apt install ngspice、Windowsは ngspice.sourceforge.io からダウンロード)。
Simulations are set to run in the cloud (Settings → Local tools), and the simulation worker needs a signed-in session. サインインしていない状態でクラウドが選ばれています。 サインインするか、SPICEを Local when available に切り替えます。

シミュレーションを参照してください。

共有

メッセージ 対処
Shared projects are limited to 500 files; this project has N. 生成物や大きなフォルダを .gitignore で除外してから、もう一度公開します。
Shared projects are limited to 100 MB; this project has N MB. 同様に、大きな出力、アーカイブ、メディアを除外します。
<path> is larger than the 25 MB per-file limit for shared projects. そのファイルを除外するか、小さくします。
あるはずのファイルがない 共有プレビューの Left out の一覧を確認します。ファイルは、生成物、秘密情報らしいもの、.gitignore による除外、リンクのいずれかとして除外されることがあります。

招待制のプロジェクトを開いた人には、次のいずれかが表示されます。

ページ 対処
Sign in to view <project> プロジェクトが共有されたメールアドレスでサインインします。
You don't have access to this project 別のアドレスでサインインしています。Sign in with a different account をクリックするか、そのアドレスを招待するようオーナーに依頼します。
Your email address isn't verified yet メールアドレスを確認してから、もう一度リンクを開きます。
Project not found プロジェクトが非公開か未公開であるか、リンクが間違っています。

プロジェクトの共有を参照してください。

Git

"The repository needs you to sign in"

リモートが認証情報のないリクエストを拒否しました(Embedrはターミナルのプロンプトを開きません)。Gitメニューで Access token(必要なら Username (if your host needs it))を入力し、必要に応じて Remember for <host> on this computer にチェックを入れて、Try again をクリックします。記憶したトークンはシステムのキーチェーンで暗号化されます。SSHのリモートの場合は、Embedrの外でSSH鍵の設定を修正してください。メッセージは "The server refused the connection" で始まります。

マージやプルが競合で止まった

Gitメニューに Merge in progress と競合しているファイルが表示されます。ファイルごとに片方を残すか、編集して Resolved にするか、Resolve with agent をクリックします。その後 Complete merge で完了するか、Abort merge で元に戻します。競合マーカーが残っているファイルは解決済みにできません。

バージョン管理を参照してください。

エージェントの実行

症状 原因 対処
実行中にウィンドウが再読み込みされた 実行はバックグラウンドで続いています。 スレッドを開き直すと、実行の進捗が引き継がれます。
"Compacting context…" の後に "Context automatically compacted" 会話がモデルのコンテキストを使い切ったため、以前のやり取りが要約されました。 何もする必要はありません。エージェントは作業を続けます。新しい話題は新しいチャットで始めてください。
"This draft (~N tokens) won't fit; remove attachments or start a new chat." メッセージと添付が大きすぎます。 添付を外すか、添付するファイルを減らすか、新しいチャットを始めます。
"Waiting for a worker…"(ブラウザ) クラウドでの実行がまだ始まっていません。 待ちます。90秒後には "Still waiting for a worker…" と表示されます。始まらない実行は自動で再試行されるか、エラーで終了します。
"Waiting for you" エージェントが承認か質問への回答を待っています。 チャットのカードに回答します。
ヘルパーが "was stopped" または "failed" ヘルパースレッドが途中で終了しました。 ヘルパーのスレッドを開いて理由を確認し、エージェントに再試行を依頼します。
エージェントの作業がずれていく コンテキストが足りません。 @ でファイルを指定し、エラーをそのまま貼り付け、ターゲットを明示し、範囲を絞った変更を1つずつ依頼します。

実行中に送ったメッセージは、実行をキャンセルせず、次のステップの前に実行に加わります("Joins next step")。Embedrエージェントを参照してください。

サポートへの連絡

support@embedr.app に、次の情報を添えてメールしてください。

  • OSと、Settings → About にある Embedr Version
  • デスクトップアプリかブラウザか
  • 関係するターゲットとフレームワーク、またはボードファイル
  • エラーの全文(Outputパネルの Copy を使います)
  • エージェントの問題の場合は、チャットで選択しているモデル
  • 失敗し始める直前に何を変更したか、再起動後も再現するか