Arduinoトラブルシューティング

Arduino開発を行っていて発生した失敗事例やトラブルと、それらの解決方法などを掲載します。

記事の目的
チェックリスト
ライブラリトラブル
現象と対策
基板個別トラブル

記事の目的

Arduino開発でこれまでに経験した失敗事例やトラブル等、同じ事象が発生しても手早く解決するための対応方法を掲載します。

チェックリスト

原因から思い当たるチェックリストです。
リンクをクリックするともう少し詳しい内容へジャンプします。

選択しているボードライブラリが違う
選択しているCOMポートが違う
書き込み用のCOMポートは、別のアプリケーションが使用している(ESP32, RP2040)
ボードライブラリ、モジュールライブラリのバージョンにバグがある

ライブラリトラブル

ボードライブラリは日々バージョンアップされています。
残ながらバージョンが上がったことでそれまで動作していたスケッチが動作しなくなることもあるので、試しにバージョンダウンをすることで解決することがあります。

同じ原因であっても、使用しているバージョンにより症状の出方（例えば開発環境上のメッセージや画面の表示）が異なることがあります。

現象と対策

スケッチの書き込みができない（ESP32）

現象

「出力」(Output)に
Traceback (most recent call last):
<以下省略>
表示がされる。

原因と対処

いくつかの原因がありますが、代表的なものを記載します。

・マイコン基板(EPS)にUSB接続ケーブルが接続されていない。
ケーブルの接続を確認します。
スイッチ付きUSBハブを使用している場合スイッチのOFF/ON状態を確認します。

・スケッチ書き込み後にCOMポート番号が変わった。
スケッチ書き込み後や、USBの挿し口を変更することで時々COMポート番号が変わることがあります。
新しく認識されたCOMポート番号を選択して書き込みを行います。

・他のアプリケーションがCOMポートを占有している。
アプリケーションを閉じるか、COMポートの開放をしてからもう一度書き込みボタンを押す。

対応

シリアルモニタアプリケーションなどを閉じる、またはCOMポートを開放する。

スケッチの書き込みができない（RP2040）

現象

「出力」(Output)に
Failed uploading: uploading error: exit status 1
表示がされる。

原因と対処

いくつかの原因がありますが、代表的なものを記載します。

・RaspberryPi PicoがUSB接続されていない。
ケーブルの接続を確認します。
スイッチ付きUSBハブではスイッチのOFF/ON状態を確認します。

・スケッチ書き込み後にCOMポート番号が変わった。
スケッチ書き込み後や、USBの挿し口を変更することで時々COMポート番号が変わることがあります。
新しく認識されたCOMポート番号を選択して書き込みを行います。

・他のアプリケーションがCOMポートを占有している。
アプリケーションを閉じるか、COMポートの開放をしてからもう一度書き込みボタンを押す。
画像の例ではRP2040基板(RaspberryPi Pico)のPortを”COM7″で使用していますが、背面のウインドウではTeratermでもCOM7を使用しています。

起動しない、COM認識しなくなった（RP2040）

現象

スケッチの書き込み後起動しなくなった。
COM認識しなくなった。
Windowsエラーメッセージ「USBデバイスが認識されません」が表示された。

原因と対処

RP2040では、UART, I2C, SPIのピン設定に指定箇所以外を設定すると発生します。
UARTにはUART0とUART1の２系統があり、それぞれのピンには設定できるピンが決まっています。
例えばUART0のTXに設定できるピンは(0, 12, 16, 28)ですが、これらのピン以外に設定をして書き込みを行うことで今回の現象が発生します。
I2CとSPIも同じです。

当サイトの「Arduino環境でRaspberryPi Picoを使う」で紹介しているように、「BOOT」ボタンを押しながら電源を入れて、空の「.uf2」ファイルを書き込むことで復旧します。