XIAO ESP32S3 + ILI9341 + TFT_eSPI トラブルシュートまとめ

投稿者: | 2025年9月8日

症状

Adafruit_ILI9341 ライブラリでは表示できるのに、TFT_eSPI を使うと Guru Meditation Error (StoreProhibited) でリブートを繰り返す。

Adafruit_ILI9341 ライブラリでは問題なく動作しているのでピン接続に問題があるとは考えづらかった。とにかくいろいろな方法を試して見つけたのが以下の原因(たぶん)と解決策である。

原因

  • SPI ポートが正しくなかった。

直接の原因はSPIポートの設定が正しくなかったことである。ESP32S3 では SPI ポートが複数あり、TFT_eSPI が誤ってポートを掴むことがあるらしい。そのため結果的に Guru Meditation Error (StoreProhibited)のエラーとなったと推測される。

解決策

User_Setup.h に以下を追加した。

これでクラッシュが解消した。

以下にこちらで使った設定を示す。

以上