ST7789V란?
ST7789V는 프레임 메모리(GRAM)를 내장한 Sitronix의 TFT LCD 소스·게이트 드라이버입니다. 이미지가 드라이버 안에 있으므로 마이크로컨트롤러는 바뀐 픽셀만 보내면 되고 자체 프레임 버퍼가 필요 없습니다. 그래서 ST7789V 모듈은 ESP32, STM32, RP2040, Arduino급 보드에서 인기가 있습니다.
어떤 인터페이스를 써야 할까
인터페이스 | 핀 수 | 일반 용도 |
|---|---|---|
4-wire SPI | 4–5 | 대부분의 모듈. 간단한 배선, 최대 약 60 MHz |
8080 병렬(MCU) | 12–20 | FSMC/FMC가 있는 MCU에서 빠른 전체 화면 리프레시 |
RGB | 18–24 | 소형 모듈에서는 드묾. 영상 같은 리프레시 |
흔한 초기 구동 문제
- 흰 화면 또는 검은 화면: 리셋 타이밍과 SLPOUT 후 DISPON 전에 120 ms 지연이 있는지 확인합니다.
- 색 오류: INVON/INVOFF와 MADCTL의 BGR 비트를 전환합니다.
- 이미지 어긋남: 240×240과 135×240 패널에서는 올바른 열/행 시작 위치를 설정합니다.
- 티어링: 모듈에 TE 핀이 나와 있으면 사용합니다.
단계별 체크리스트는 TFT 흰 화면 문제 해결 가이드를 참조하세요.
ST7789V 초기화 코드
// Reference init sequence. Adjust MADCTL, inversion and offsets per panel.
write_cmd(0x01); // SWRESET
delay_ms(150);
write_cmd(0x11); // SLPOUT
delay_ms(120);
write_cmd(0x3A); write_data(0x55); // COLMOD: 16-bit RGB565
write_cmd(0x36); write_data(0x00); // MADCTL: rotation / RGB order
write_cmd(0x21); // INVON: most IPS panels need inversion
write_cmd(0x13); // NORON
write_cmd(0x29); // DISPON
delay_ms(20);ST7789V 라이브러리 지원
| 라이브러리 | 드라이버 / 클래스 | 비고 |
|---|---|---|
| TFT_eSPI (Arduino) | ST7789_DRIVER | |
| LovyanGFX (Arduino / ESP-IDF) | lgfx::Panel_ST7789 | |
| ESP-IDF esp_lcd | esp_lcd_new_panel_st7789() (built in) | |
| 참고 | 많은 ST7789 패널은 색상 반전을 활성화해야 합니다. |
User_Setup_ST7789V.h · LGFX_ST7789V.hpp. 핀은 임시 값입니다. 검증된 설정을 추가하면 이메일로 알려 드립니다.
ST7789V 탑재 개발 보드
ST7789V 탑재 디스플레이 모듈
2.8" 240×320 TFT LCD, SPI (PJ2801H22-23H10P200)
- 크기
- 2.8"
- 해상도
- 240×320
- 휘도
- 200 nits
2.4" 240×320 TFT LCD, SPI (PJ2401I24-22H30P250)
- 크기
- 2.4"
- 해상도
- 240×320
- 휘도
- 250 nits
2.4" 240×320 TFT LCD, MCU (PJ2401I02-22H38P300)
- 크기
- 2.4"
- 해상도
- 240×320
- 휘도
- 300 nits
2.4" 240×320 IPS TFT LCD, SPI / MCU / RGB (PJ2401H28-22H45P200)
- 크기
- 2.4"
- 해상도
- 240×320
- 휘도
- 200 nits
2.4" 240×320 IPS TFT LCD, SPI / MCU / RGB (PJ2401H25-22H45P200)
- 크기
- 2.4"
- 해상도
- 240×320
- 휘도
- 200 nits
2" 240×320 TFT LCD, SPI / MCU (PJ2003L02-22H22P300)
- 크기
- 2"
- 해상도
- 240×320
- 휘도
- 300 nits
ST7789V 문제 해결 및 FAQ
ST7789 디스플레이의 색이 반전되는 이유는 무엇인가요?
ST7789V를 쓰는 IPS 패널 대부분은 디스플레이 반전 활성화(명령 0x21, INVON)가 필요합니다. 색이 사진 네거티브처럼 보이면 반전을 전환하고, 빨강과 파랑이 뒤바뀌었다면 MADCTL(0x36)의 RGB/BGR 비트를 바꾸세요.
ST7789V는 어느 정도의 SPI 클록을 처리할 수 있나요?
많은 모듈은 배선이 짧으면 40~62.5 MHz SPI에서 안정적으로 동작합니다. 20 MHz에서 시작해 이미지를 확인한 뒤, 깨짐이 없는지 보면서 올리세요.
240×240 이미지가 80픽셀 밀리는 이유는 무엇인가요?
ST7789V의 프레임 메모리는 240×320입니다. 240×240 패널에서는 일부 회전에서 CASET/RASET에 행 또는 열 오프셋(보통 80)이 필요하며, 대부분의 라이브러리는 이를 rowstart/colstart 설정으로 제공합니다.