ESP8266, ESP-WROOM-02, ESPr Developer トラブルシューティングまとめ

今回は、ESP8266, ESP-WROOM-02, ESPr Developer のトラブルシューティングについて、コメント等でお問い合わせがあったものと、私の過去の体験等を含めて、自分流にまとめてみました（趣味程度の範囲内です。）
以下、Windows 8.1 以上で、Arduino IDE を使った場合で説明します。

 

Aruino IDE 、ESP8266 ボード、SPIFFSアップローダーのバージョンは以下の場合で説明します。

Arduino IDE — ver 1.8.1 以上
Arduino Core for ESP8266 WiFi chip — ser 2.3.0 以上
SPIFFS ファイルシステムアップローダー — ver 0.3.0 以上

Arduino IDE のインストール方法、ESP8266ボードの設定については以下のページを参照してください。
Arduino IDE に Staging(Stable)版ESP8266 ボードをインストールする方法

Arduino IDE にSPIFFSファイルシステムアップローダープラグインのインストール方法は以下のページを参照してください。
Arduino IDE に ESP8266 SPIFFS ファイルシステムアップローダーをインストールする方法

ESPr Developer とは、スイッチサイエンス製で、ESPRESSIF社製 の技適認証済みWiFiボード ESP-WROOM-02 を、700mA 電源レギュレーター、USBシリアル変換、ロジック変換、リセットスイッチ等でパッケージ化した、とても使いやすく安定した超おすすめボードです。
Amazon.co.jp

この組み立て方法や使い方については、以下のページを参照してください。
ESPr Developer ( ESP-WROOM-02 開発ボード )の使い方をザッと紹介

では、トラブルシューティングについては以下の目次をクリックするとそこへジャンプします。

ESP32 ( ESP-WROOM-32 )のトラブルシューティングは以下のリンクを参照してください。
ESP32 ( ESP-WROOM-32 ) 自分的 トラブルシューティング まとめ

【目次】
※このトラブルシューティングはかなり古いです。
現在、私はESP-WROOM-02およびESP8266を使用せず、ESP32しか使っておりません。
環境も大幅に変更になっており、ご質問には殆んどお答えできないことをご了承ください。
あくまでも、昔の思い出日記として読んで下さいね。

 

※ESP-WROOM-02 のFlashサイズが実は 2MB だったという情報が出ています。
以下のページを参照して、メモリサイズを確認してください。
(2017/10/1)
●ESP-WROOM-02 ( ESP8266 ) チップ・メモリ・MACアドレス情報確認方法

1. Arduino IDE には警告やエラーが無いのに、シリアルモニターに Exception や wdt、loadエラーが出て、延々とリセットを繰り返す
2. espcomm_sync failed や espcomm_open failed エラーが出る
3. シリアルモニターで全ての文字が文字化けする
4. シリアルモニターで 115200 bps にしているのに、最初の行だけが文字化けする
5. SPIFFS アップロードで、SPIFFS Upload failed! エラーが出る
6. SPIFFS ファイルシステムアップローダー、4M ( 3M SPIFFS )で SPIFFS Upload failed! エラーが出る
7. 起動が安定しない、動作が不安定
8. SDカード使用で、「SD.h」に対して複数のライブラリが見つかりました、というエラーが出る
9. Soft WDT reset というメッセージが出て、リセットされてしまう
10. ESPr Developer ( ESP-WROOM-02, ESP8266 )に接続したデバイスがうまく動作しない
11. 正常に動作するプログラムでも、コンパイル後の実行で、シリアルモニターに文字化けデータしか表示されない
12. Web と連動してテキストを抽出する場合に、途中でフリーズ（固まる）する
13. ESPr Developer ( ESP-WROOM-02, ESP8266 )にLEDを接続したら壊れた
14. Arduino IDE スケッチのコンパイル書き込みで、「シリアルポート「COM9」が開けません。」というメッセージが出る
15. ライブラリマネージャーでインストール、アップデート、アンインストールができない
16. ZIP形式ライブラリがインストールできない
17. ライブラリをアップデートしたが、うまく動作しない
18. EasyWebSocketライブラリでブラウザ表示が文字化けする
19. Arduino IDE のシリアルポート(COMポート)がグレー表示になっていて、選択できない
20. マイコンボードに書き込もうとしましたが、エラーが発生しました。というメッセージが出る
21. ESP8266ボード や Arduinoボードで、配列やポインタを使用すると、シリアルモニター表示が変だ
22. グローバル変数とローカル変数のメモリに余裕があるのに正常に動作しない
23. Arduino IDE のシリアルモニター出力で、日本語漢字が文字化けする
24. ブラウザからスケッチ（ソースコード）をコピーして、Arduino IDE スケッチ画面に貼り付け、そのままコンパイル書き込みしたら、うまく動作しない
25. 突然 Wi-Fi ルーター（アクセスポイント）につながらなくなった
26. SPIFFSフラッシュへアップロードする時、Bad Answer:Invalid bootstrapping state, reset ESP8266 before updating と表示されて、アップロードできない
27. Arduino – ESP32 ver 2.4.0 がうまく動作しない
28. Arduino – ESP8266 ver 2.4.1 で Wi-Fi が接続できない。シリアルモニターが文字化けする
29. ESP-WROOM-02でATコマンドを使っていた時にはWiFiルータに接続できたが、Arduino IDEでコンパイル書き込みすると、WiFiルータに接続できなくなった
    (2021/09/14追加)
30. ESP-WROOM-02(ESP8266)でATコマンドおよびArduinoプログラミングでWiFiのSSIDとパスワードを設定したのに、なぜかパスワードが設定されない
    (2022/06/04追加)

１．Arduino IDE には警告やエラーが無いのに、Exceptin や wdt、load エラーがシリアルモニターに出て、延々とリセットを繰り返す

Arduino IDE で ESPr Developer ( ESP-WROOM-02, ESP8266 )ボードをコンパイルすると、コンパイラの警告やエラーメッセージが一切なく、RAM使用領域も余裕があって、正常なスケッチのはずなのに、シリアルモニターで以下のようなエラーメッセージが出て、延々とリセットを繰り返す場合があります。

ets Jan  8 2013,rst cause:4, boot mode:(3,6)

wdt reset
load 0x4010f000, len 1384, room 16
tail 8
chksum 0x2d
csum 0x2d
v09f0c112
~ld

Exception (9):

epc1=0x40104278 epc2=0x00000000 epc3=0x00000000 excvaddr=0x00050a26 depc=0x00000000

ctx: sys
sp: 3ffffbb0 end: 3fffffb0 offset: 01a0

>>>stack>>>
3ffffd50:  5c5c5c5c 5c5c5c5c 5c5c5c5c 5c5c5c5c
・・・etc

ets Jan  8 2013,rst cause:2, boot mode:(3,6)

load 0x4010f000, len 1384, room 16
tail 8
chksum 0x2d
csum 0x2d
v09f0c112
~ld

【原因】
こういう場合は、プログラム（スケッチ）中で RAMメモリを多く消費し過ぎている場合があります。
例えば、配列宣言の文字数が多すぎるなど・・・。

【対策】
配列宣言の文字数や大きさを少なくしてみて下さい。
詳細は以下の記事を参照してください。
Arduino / ESP8266 の使用できるRAM 領域を再考

２．espcomm_sync failed や espcomm_open failed エラーが出る

ESPr Developer ( ESP-WROOM-02 開発ボード) を使っていて、Arduino IDE に以下のようなメッセージが出た場合です。

warning: espcomm_sync failed
error: espcomm_open failed
error: espcomm_upload_mem failed
error: espcomm_upload_mem failed

【原因その１】
Arduino IDE の ESP8266ボード設定の Reset Method が ck になっていることが原因です。

【対策その１】
Arduino IDE の ESP8266ボード設定の Reset Method を “nodemcu” にする必要があります。
“ck” の場合は、ご自分でGPIO #0 を押しながらリセットキーを押すと書き込み可能になります。
“nodemcu” にするとリセットキーを押さずとも、自動で書き込みモードに切り替えて書き込みできます。
これは、スイッチサイエンスさんのESPr Developer のトランジスタで構成された、リセット回路の素晴らしいところです。
ESP8266 ボードの設定については、以下のページを参照してください。

Arduino IDE に Staging(Stable)版ESP8266 ボードをインストールする方法

---

【原因その２】
USBを差し替えたり、前にスケッチを書き込んだりした場合、リセットボタンを押していない（LOWレベルにしていない）場合に表示されることがあるようです。

【対策その２】
一旦USBケーブルを外して挿し直し、リセットボタンを押してから再度スケッチをコンパイルしてみてください。

---

【原因その３】
ＵＳＢシリアルの転送速度が速すぎる場合があります。

【対策その３】
USBシリアルの転送速度を 115200bps 以下、例えば 9600bps にしてみてください。
それでもダメなら、Arduino-ESP8266 のバージョンを下げる（例えば 2.3.0）という方法も検討してみてください。

３．シリアルモニターで全ての文字が文字化けする

【原因】
Arduino IDE のシリアルモニターの右下のところの通信速度が 115200 bps 以外になっている。

【対策】
ESP8266, ESP-WROOM-02 のシリアル通信速度のデフォルトは 115200 bps です。
それ以外にすると、すべての通信が文字化けしてしまいますので、115200 bps に変更してください。

４．シリアルモニターで 115200 bps にしているのに、最初の行だけが文字化けする

【原因】
ESP-WROOM-02 ( ESP8266 ) の起動直後は76800 bps で起動メッセージをシリアル出力します。
その後起動完了後に 115200 bps でシリアル通信するので、最初の１行が文字化けするわけです。

【対策】
そのメッセージを読み取りたいのであれば、シリアルモニターの速度を74880 bps にすれば読み取れます ( Arduino IDE 1.6.13 の場合 )
こんな感じのメッセージです。

ets Jan 8 2013,rst cause:2, boot mode:(3,2)

load 0x4010f000, len 1384, room 16
tail 8
chksum 0x2d
csum 0x2d
v60000318

ただし、その後のメッセージは全て文字化けしてしまいますが・・・。
ですから、シリアルモニターの速度を115200 bps にしてあれば、最初の１行の文字化けは無視して良いです。

５．SPIFFS アップロードで、SPIFFS Upload failed! エラーが出る

【原因その１】
SPIFFS アップローダーをクリック後、即以下のようなメッセージが出た場合、

error: Failed to open COM6
error: espcomm_open failed
error: espcomm_upload_mem failed
SPIFFS Upload failed!

シリアルモニターが起動していることが原因です。

【対策その１】
SPIFFS ファイルシステムアップローダーはシリアルモニターが起動していると動作しません。
シリアルモニターを閉じてください。

---

【原因その２】
旧型の ESP-WROOM-02 や ESPr Developer の Flash は 4MB でしたが、現在流通しているものは 2MB が殆どです。
1MB以上のSPIFFS データはアップロードできません。
ESP-WROOM-02 のチップ情報を確認してみてください。

ESP-WROOM-02 ( ESP8266 ) チップ・メモリ・MACアドレス情報確認方法