범위

HU32 0.1 트러블슈팅은 ESP32-S3에서 ST7796S TFT 화면을 출력하고, Asset 기반 UI를 구성하는 과정에서 발생한 문제를 기준으로 정리한다.

1. TFT 흰 화면 문제

문제

업로드는 되었지만 TFT 화면이 흰색으로만 표시되었다.

원인

TFT_eSPI 설정 핀이 실제 ESP32-S3 배선과 맞지 않았다. 또한 로컬 설정 헤더를 만들어도 라이브러리 본체가 해당 설정을 참조하지 않는 문제가 있었다.

조치

TFT_eSPI의 User_Setup.h를 실제 배선 기준으로 수정했다. MOSI GPIO35, SCLK GPIO36, CS GPIO10, DC GPIO9, RST GPIO8로 정리했다.

2. ESP32 Core 3.x 빌드/동작 충돌

문제

TFT_eSPI 초기화 과정에서 Guru Meditation Error가 발생했다.

원인

사용 중인 라이브러리와 ESP32 Arduino Core 3.x 조합에서 안정적으로 동작하지 않았다.

조치

ESP32 Arduino Core를 2.0.14로 낮춰 TFT 초기화가 정상 통과되는 것을 확인했다.

3. Asset 미표시 문제

문제

UI는 그려졌지만 PNG 이미지가 표시되지 않았다.

원인