본문으로 건너뛰기
Display Engineer
가이드

ESP32용 1.28인치 원형 디스플레이(GC9A01): 배선, 라이브러리, 원형 UI 팁

ESP32로 240×240 GC9A01 원형 TFT를 구동하는 방법: SPI 배선, TFT_eSPI / LovyanGFX / ESP-IDF 설정, 현실적인 프레임 레이트, 원형 화면 레이아웃 규칙.

DEDisplay Engineer Applications Team · 디스플레이 애플리케이션 엔지니어엔지니어 검토: 2026년 10월 11일

1.28인치 원형 디스플레이란

대부분의 소형 원형 TFT는 240×240 픽셀 패널을 원형으로 자른 것으로 GC9A01 컨트롤러를 탑재합니다. 컨트롤러는 여전히 정사각형 프레임 버퍼로 동작하며, 모서리에는 보이는 픽셀이 없을 뿐입니다. 웨어러블, 노브, 게이지, 스마트홈 컨트롤러가 이 형식을 사용합니다.

배선(4선식 SPI)

신호

용도

SCLK

SPI 클록

MOSI (SDA)

패널로 가는 SPI 데이터

CS

칩 선택

DC

데이터 / 명령 선택

RST

리셋(또는 MCU 리셋에 연결)

BL

백라이트(디밍용 PWM)

MISO는 보통 사용하지 않습니다. 검증된 레퍼런스 핀 맵은 Waveshare ESP32-S3-Touch-LCD-1.28 보드 페이지를 참조하세요.

라이브러리

라이브러리

설정

TFT_eSPI (Arduino)

#define GC9A01_DRIVER, 240×240

LovyanGFX

lgfx::Panel_GC9A01

ESP-IDF

espressif/esp_lcd_gc9a01 컴포넌트

LVGL

위의 것 중 하나를 플러시 드라이버로 쓰고 부분 그리기 버퍼 사용

GC9A01 페이지에서 설정 템플릿을 내려받을 수 있습니다.

리프레시는 얼마나 빠를까

RGB565 전체 프레임은 240 × 240 × 16비트 = 921,600비트(112.5 KB)입니다. SPI 이론 한계는 40 MHz에서 약 43 fps, 80 MHz에서 약 86 fps입니다. 실제 UI는 명령 오버헤드와 렌더링 시간 때문에 더 느리므로 LVGL은 보통 바뀐 영역만 다시 그립니다. ESP32에서 80 MHz는 전용 SPI 핀에서만 가능하며, 40 MHz가 안전한 기본값입니다.

전체 프레임은 내부 RAM에 들어가지만, LVGL은 각각 화면 1/10(약 11 KB)인 부분 버퍼 2개로도 잘 동작해 애플리케이션용 RAM을 남겨 줍니다.

원형 화면 디자인

  • 텍스트는 내접 정사각형 안에 둔다. 240픽셀 원에 들어가는 가장 큰 정사각형은 약 170×170픽셀이며, 라벨과 숫자는 그 안에 배치하세요.
  • 데이터에는 호와 링을 쓴다. 게이지, 진행 링, 방사형 메뉴는 사각형이 낭비하는 가장자리를 활용합니다.
  • 터치는 정사각형 좌표를 보고한다. 원형 보드는 패널에 CST816S 터치 컨트롤러를 자주 조합하는데, 240×240 정사각형 기준 x/y를 반환하므로 원 밖의 터치는 무시하세요.
  • 보이는 영역을 베젤과 대조한다. 사용자가 보는 범위는 유리가 아니라 패널의 액티브 영역이 결정합니다.

당사 카탈로그의 원형 디스플레이

직영 공장에서는 1.28인치 240×240 IPS SPI 모듈, 정전용량식 터치를 갖춘 1.3인치 360×360 버전, 2.1인치 480×480 버전 등 원형 모듈을 생산합니다. 원형 LCD 디스플레이 전체를 확인하세요. 다른 크기에서는 GC9A01과 다를 수 있으므로 컨트롤러는 데이터시트로 확인하세요. 샘플은 1개부터 가능합니다.

자주 묻는 질문

1.28인치 원형 디스플레이의 해상도는?

보통 GC9A01 컨트롤러의 240×240픽셀이며, 보이는 영역은 그 정사각형에 내접하는 원입니다.

ESP32로 GC9A01을 60 fps로 구동할 수 있나요?

전체 화면 다시 그리기는 이론상 40 MHz SPI에서 약 43 fps가 한계입니다. LVGL이 쓰는 부분 업데이트 덕분에 일반적인 게이지와 워치 UI에서는 부드러운 애니메이션이 가능합니다.

GC9A01 디스플레이에는 어떤 핀이 필요한가요?

SCLK, MOSI, CS, DC, 리셋, 백라이트입니다. MISO는 보통 연결하지 않습니다.

이 가이드에 소개된 모듈

어떤 디스플레이가 설계에 맞는지 고민되시나요?

크기, 인터페이스, 호스트 프로세서를 알려 주세요. 디스플레이 엔지니어가 12시간 이내에 데이터시트와 초기화 코드를 포함한 2–3가지 옵션을 회신합니다. 샘플 1개부터.