ESP32-2432S028R (CYD) 디스플레이: 사양, 드라이버 리비전 및 설정
Cheap Yellow Display: ESP32 보드에 2.8인치 240×320 SPI TFT를 얹은 제품입니다. 생산 배치에 따라 ILI9341 또는 ST7789 디스플레이 컨트롤러가 들어가므로, 같은 스케치가 어떤 보드에서는 동작하고 다른 보드에서는 흰 화면이 될 수 있습니다.
ESP32-2432S028R (CYD) 디스플레이 사양
| MCU | ESP32 (ESP32-WROOM-32) |
|---|---|
| 디스플레이 | 2.8″ · 240×320 |
| 디스플레이 버스 | SPI (HSPI) |
| 드라이버 IC | ILI9341 또는 ST7789 |
| 터치 | XPT2046 저항막식(별도 SPI 핀) |
보유한 ESP32-2432S028R (CYD)은 어떤 리비전인가요?
같은 이름으로 판매되는 보드라도 서로 다른 디스플레이 드라이버 IC가 탑재되어 출하됩니다. 한 리비전용 코드를 다른 리비전에서 실행하면 흰 화면, 색상 오류가 나타나거나 아무것도 표시되지 않으므로 먼저 보유한 리비전을 확인하세요.
| 리비전 | 드라이버 IC | 확인 방법 | 라이브러리 설정 |
|---|---|---|---|
| 초기 버전(micro-USB) | ILI9341 | 커뮤니티 User_Setup.h를 그대로 사용 가능 | TFT_eSPI: ILI9341_2_DRIVER, 반전 없음 |
| 후기 배치(일부는 USB 포트 2개) | ST7789 | ILI9341 설정에서 흰 화면, 바랜 색 또는 반전된 색 | TFT_eSPI: ST7789_DRIVER. TFT_INVERSION_ON/OFF와 TFT_RGB_ORDER TFT_BGR을 하나씩 시도. 백라이트는 여전히 GPIO 21 |
ESP32-2432S028R (CYD) 디스플레이 및 터치 핀
| 신호 | GPIO | 비고 |
|---|---|---|
| TFT MOSI | 13 | HSPI |
| TFT MISO | 12 | HSPI |
| TFT SCLK | 14 | HSPI |
| TFT CS | 15 | |
| TFT DC | 2 | |
| TFT RST | -1 | GPIO에 연결되지 않음 |
| Backlight | 21 | 액티브 High. 다른 용도로 쓰지 말 것 |
| Touch CLK | 25 | XPT2046 |
| Touch CS | 33 | XPT2046 |
| Touch DIN (MOSI) | 32 | XPT2046 |
| Touch DO (MISO) | 39 | XPT2046 |
| Touch IRQ | 36 | XPT2046 |
양산용 동일 사양 디스플레이
ESP32-2432S028R (CYD)로 프로토타입을 만드셨나요? 이 직영 공장 모듈은 패널 크기와 해상도가 같고, 데이터시트와 생산 로트별 고정 드라이버 IC를 제공하며, 샘플은 1개부터 가능합니다. 최소 주문 수량과 납기는 프로젝트별로 협의합니다.
ESP32-2432S028R(CYD) 프로토타입에서 양산까지
개발 보드는 UI 검증에 이상적이지만 패널은 공개 시장에서 조달됩니다. 배치마다 컨트롤러가 바뀔 수 있고(이 보드에서 실제로 일어났습니다), 데이터시트는 거의 없으며, 수명도 보장되지 않습니다. 제품에는 생산 로트마다 드라이버 IC가 고정되고 데이터시트와 라이프사이클 약정이 있는 모듈을 지정하세요.
직영 공장에서는 같은 2.8″ 240×320 형식의 모듈을 생산합니다. 샘플은 1개부터 가능하며, MOQ와 리드타임은 프로젝트별로 영업팀과 협의합니다.
코드를 디버깅하기 전에
- 어떤 리비전인지 확인하세요(위 표). 드라이버 IC 변경이 흰 화면의 가장 흔한 원인입니다.
- 스케치에서 백라이트 핀을 다른 용도로 쓰고 있지 않은지 확인하세요.
- 설정(드라이버, 반전, 색 순서)은 한 번에 하나씩 바꾸고, 비교용으로 동작이 검증된 예제를 남겨 두세요.
설정 예시
#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define SPI_FREQUENCY 55000000
#define SPI_READ_FREQUENCY 20000000
#define SPI_TOUCH_FREQUENCY 2500000
#define USE_HSPI_PORT// replace the ILI9341_2_DRIVER line with:
#define ST7789_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
// if colours are inverted, toggle ONE of these:
#define TFT_INVERSION_ON
// #define TFT_INVERSION_OFF
// if red and blue are swapped:
// #define TFT_RGB_ORDER TFT_BGR
// pins and SPI settings stay the same as the ILI9341 setup자주 묻는 질문
다른 사람에게는 동작하는 코드인데 내 CYD가 흰 화면인 이유는?
보드에 ILI9341 대신 ST7789 디스플레이 컨트롤러가 들어 있을 가능성이 큽니다. TFT_eSPI 드라이버를 ST7789_DRIVER로 바꾸고 반전과 색 순서를 조정하세요. 핀은 그대로입니다.
CYD 백라이트를 제어하는 GPIO는?
GPIO 21, 액티브 High입니다. 스케치에서 GPIO 21을 다른 용도로 쓰면 화면이 어두워집니다.
CYD에서 TFT_eSPI 터치가 동작하지 않는 이유는?
XPT2046 터치 컨트롤러는 디스플레이 SPI 버스가 아닌 별도 핀(CLK 25, CS 33, DIN 32, DO 39, IRQ 36)에 연결되어 있으므로, 해당 핀으로 별도의 XPT2046 라이브러리 인스턴스를 사용하세요.
출처
어떤 디스플레이가 설계에 맞는지 고민되시나요?
크기, 인터페이스, 호스트 프로세서를 알려 주세요. 디스플레이 엔지니어가 12시간 이내에 데이터시트와 초기화 코드를 포함한 2–3가지 옵션을 회신합니다. 샘플 1개부터.