トラブルシューティング
シミュレーションが起動しない
Section titled “シミュレーションが起動しない”- Output console(出力コンソール)を確認してください。コンパイルに失敗した場合、エラーはファイル名と行番号とともにそこに表示されます。コンパイルエラーの読み方を参照してください。
- circuit verifier(回路検証)の警告(例: 電気モードで直列抵抗のないLED)は、意図的に実行をブロックします。指摘された配線を修正してください。
- セッションの最初の実行はコールドコンパイルとなり、大規模なツールチェーン(ESP-IDF)では時間がかかることがあります。以降の実行ははるかに高速です。ハングしたと判断する前に、最初の実行には時間を与えてください。
実行されるが、何も起こらない
Section titled “実行されるが、何も起こらない”- ツールバーのボードセレクターで正しいボードが選択されていますか?
- serial monitor(シリアルモニター)を開いてください。クラッシュしたファームウェアや入力を待っているファームウェアは、そこにメッセージを表示します。
- パーツを右クリックしてプロパティを確認してください(0個のLEDに設定されたNeoPixelストリップは、まったく何も描画しません)。
ページ自体の動作がおかしい
Section titled “ページ自体の動作がおかしい”- Velxioは、デスクトップ版のChromiumまたはFirefox(十分に新しいバージョン)を必要とします。
- 更新後はハードリロード(Ctrl+Shift+R)を行ってください。古いキャッシュされたバンドルは、新しいバックエンドと組み合わせると問題が発生する可能性があります。
- WebAssembly、canvas、WebSocketsに干渉するブラウザ拡張機能(強力なプライバシーブロッカーなど)は、エミュレータを壊す可能性があります。シークレットウィンドウを試してください。
Webフラッシュでボードが認識されない
Section titled “Webフラッシュでボードが認識されない”- ChromeまたはEdgeを使用してください。Firefox/SafariにはブラウザシリアルAPIが搭載されていません。
- そのポートを使用している他のプログラム(シリアルモニター、IDE)をすべて閉じてください。
- 別のケーブルを試してください。充電専用USBケーブルは古典的な落とし穴です。
WiFiサンプルが接続できない
Section titled “WiFiサンプルが接続できない”- SSIDは正確に
Velxio-GUESTで、オープン(パスワードなし)です。 - シリアルモニターでWiFiスタック自体の進行行(
wifi:connected、got ip)を確認し、どのステップで失敗しているかを確認してください。
それでも解決しない場合
Section titled “それでも解決しない場合”プロジェクトを開いた状態でAIアシスタントに質問してください。アシスタントはあなたと同じエラーを読み取ります。バグについては、Helpメニュー、Discord、またはGitHubからチームに連絡してください。