ESP32 ( ESP-WROOM-32 , M5Stack )自分的トラブルシューティングまとめ

ESP32 ( ESP-WROOM-32 )

2018.02.012023.07.26

１１．Arduino – ESP32 でコンパイルした時に、コンパイラメッセージ欄に「libraries\BLE に、無効なライブラリ」と表示される場合の対処法

最新版 Arduino core for ESP32 をインストールして、新たにスケッチをコンパイルすると、コンパイルは通るのですが、IDE のコンパイラメッセージに下図の様に表示される場合があります。

C:\Users\USER-NAME\Documents\Arduino\hardware\espressif\esp32\libraries\BLE」に、無効なライブラリ「C:\Users\USER-NAME\Documents\Arduino\hardware\espressif\esp32\libraries\BLE」があります。

原因

2017/10/15頃、GitHub の Arduino core for ESP32 の Bluetooth ( BLE )ライブラリが新たに追加されました。
ただ、このライブラリだけ、別の GitHub ユーザーのリポジトリに存在するようになっていました。
ESP32 kolban books で有名な、kolbanさんが作っているようです。
その為、ZIPファイルをダウンロードしても BLE ライブラリフォルダがダウンロードされないようになってしまいました。
将来的には恐らく統合される可能性はあります。

対策

Bluetooth および BLE ライブラリを使わないのであれば、このメッセージは無視しても問題ありません。
コンパイル書き込みは実行されます。

どうしてもこのメッセージを消したければ、以下の記事の最後の方に方法を記述していますのでご参照ください。

Arduino core for the ESP32 のインストール方法

１２．A fatal error occurred: Timed out waiting for packet content または Timed out waiting for packet header というメッセージが出て、コンパイルできない

まず、Arduino core for the ESP32 でコンパイルする時、A fatal error occurred というエラーが出て、コンパイル書き込みできない時があります。
この次のメッセージには私が知るところによると、３種類メッセージが出ました。
まず、特に、M5Stack を使った時に発生しやすい以下のメッセージです。

A fatal error occurred: Timed out waiting for packet header

原因その１

M5Stack の場合、シリアル通信系の GPIO に何かしらの通信ジャンパーワイヤーが接続されていると起こります。
私の場合は、GPIO #2 に SPI 通信用の CS を接続していました。
その状態でコンパイル書き込みしようとするとエラーになります。

対策その１

コンパイル書き込みするときだけ、その GPIO ピンを外すことです。
コンパイル書き込みが終了してから、再度接続して再起動してください。
GPIO #1～#3 はコンパイル書き込み時は外すか、そこにアサインしない方が無難と思われます。

その他、Arduino IDE に下図の様なメッセージが出て、コンパイル書き込みができない場合があります。

A fatal error occurred: Timed out waiting for packet content

原因その２

コンパイルは通っても、ESP-WROOM-32 ( ESP32 ) に USB シリアルで書き込みができないようです。
2017/09頃～12月頃までは特に問題無かったのですが、Arduino core for the ESP32 の以下のバージョンでは、このエラーが顕著に出るようになりました。

●Commits on Dec 19, 2017 バージョン
●Commits on Jan 18, 2018 バージョン
●Commits on Jan 19, 2018 バージョン
●Commits on Jan 23, 2018 バージョン

対策その２

１回目の書き込みは失敗しますが、再度続けてコンパイル書き込みを実行すれば問題ありません。

どうしてもこのメッセージが嫌な方は、もっと古いバージョンをインストールし直せば良いと思います。
旧バージョンのインストール方法については以下の記事を参照してください。

旧バージョン Arduino – ESP32 のインストール方法

また、ESP32 の Chip Revision が最新のものでは 1 になっているので、それを使えばこのエラーは出ないかも知れません。

また、何回やってもこのエラーメッセージが出てコンパイルできない場合は、別の原因が考えられます。
以前、某雑誌の付録ボードを使った方がこのメッセージで悩んでおられました。
ボード側のUSB-シリアル変換回路の問題や、電源容量が足りない回路だった、などのように記憶しています。

原因その３

M5StackやM5Stack Fireの場合、M5Stack側のUSB-TypeCコネクタの上下を逆に挿していると、Arduino IDEでコンパイル書き込みする時に、以下の書き込みエラーが出る場合があります。

A fatal error occurred: Timed out waiting for packet content

対策その３

M5StackのUSB-TypeCコネクタには上下方向があるようです。
USB-TypeCコネクタを上下逆に挿して、再度コンパイル書き込みしてみてください。

原因その４

ESP32関連ボードでWiFiを使っていて、何度もコンパイル書き込みしていると、パソコンのUSBポートおよびUSBハブのポートが故障または不具合が起きる場合があるようです。
私の勝手な想像ですが、USBポートに大きな電流が流れて、USBポートの一部のパーツが故障したのかも知れません。

対策その４

USBポートを別のポートに変えてみる。
ただ、もしかすると将来的にそのポートも故障する可能性があるかも知れません。
また、大電流にも耐えられる信頼性の高いメーカーのUSBハブに交換すると良いかも知れません。

私の場合は、もう５年くらいESP32で一部のUSBポートを酷使したので、別のポートに変えたら書き込みできるようになりました。

１３．A fatal error occurred: Invalid head of packet (‘F’) とメッセージが出て、コンパイルできない

Arduino core for the ESP32 で、コンパイルすると以下のようなメッセージが出てコンパイルできない場合があります。

A fatal error occurred: Invalid head of packet ('F')

同じようなエラーとして、以下の様な場合もあります。

A fatal error occurred: Failed to calculate md5sum (result was 8080)

原因

この原因も前項と殆ど同じです。
Arduino core for the ESP32 の以下のバージョンから、コンパイル書き込みが１回で成功できなくなりました。

●Commits on Dec 19, 2017 バージョン
●Commits on Jan 18, 2018 バージョン
●Commits on Jan 19, 2018 バージョン
●Commits on Jan 23, 2018 バージョン

これ以前の2017の9月頃からは特に問題無く書き込めていたのですが、バージョンアップして何かしら不具合が出たものと思われます。

対策

恐らく、コンパイルはできても、ESP32 への書き込みが出来ないだけだと思われます。
よって、もう一度コンパイル書き込みしてみてください。
２回目は成功すると思います。

１４．「○○.h」に対して複数のライブラリが見つかりました。というメッセージが出て、コンパイルできない

例えば、Arduino IDE のコンパイルを実行して、

「WiFi.h」に対して複数のライブラリが見つかりました

というメッセージが出て、コンパイルできないことがあります。

原因

これは実は、ご自分のスケッチ（プログラム）の単なる記述ミスであることが殆どです。
Arduino UNO 用の WiFi ライブラリと、ESP32 用の WiFi ライブラリが重複したエラーと勘違いして、Arduino 純正 WiFi ライブラリを削除しても意味ありません。
何でこんなメッセージが出るのかは不明です。
どうしても知りたければ、Espressif Systemの Arduino core for ESP32 開発チームに問い合わせるしかありません。

対策

このメッセージの前に大抵、プログラム中のエラー個所がメッセージで表示されているはずです。
表示されていなければ、Arduino IDE の「ファイル」メニューの、「環境設定」を開いて下さい。
下図の様に、コンパイラの警告を「全て」にしてください。

こうすると、プログラム中のどこがエラーなのかが、詳細なメッセージで見えます。

例えば、

collect2.exe: error: ld returned 1 exit status

と出ていた場合、は以下を参照してください。
２８．Arduino-ESP32で、collect2.exe: error というエラーが出てコンパイルできない

その部分を修正して、プログラムミスが無くなれば、「複数のライブラリが見つかりました」というメッセージは表示されずにコンパイルできると思います。

Arduino core for the ESP32 のライブラリと、Arduino 純正ライブラリとは競合しないように出来ていますので、勘違いしないようにしてください。

１５．最新版 Arduino – ESP32 をインストールしたら、うまく動作しない（旧バージョンのインストール方法）

GitHub の最新版 Arduino core for the ESP32 は、いろいろと動作不良の場合が多々あります。
オープンソース無保証なので、仕方ありません。

対策

正常に動作した旧バージョンの Arduino core for the ESP32 に再インストールし直すことです。
正常に動作したころの Arduino core for the ESP32 はパソコンに保存しておくことをお勧めします。

旧バージョンの Arduino core for the ESP32 のインストール方法は以下の記事を参照してください。