본문으로 건너뛰기
Display Engineer
드라이버 IC · Ilitek

ILI9341: 데이터시트, 핀 배치 및 초기화 코드

ILI9341은 240×320 TFT 패널을 구동하며, 2.2″~3.2″ SPI 디스플레이 모듈과 ESP32 "Cheap Yellow Display"에 들어간 대표적인 컨트롤러입니다.

DEDisplay Engineer Applications Team · 디스플레이 애플리케이션 엔지니어엔지니어 검토: 2026년 10월 11일
제조사Ilitek
유형디스플레이 드라이버
인터페이스SPI / MCU(8080 병렬) / RGB(병렬)
최대 해상도240×320

ILI9341이란?

ILI9341은 172,800바이트의 온칩 GRAM을 갖춘 262K 색 TFT 드라이버로, 이는 18비트 컬러 기준 240×320 전체 프레임 정확히 한 장 분량입니다. 2.4″와 2.8″ 취미용·산업용 SPI 모듈의 기본 컨트롤러가 되었습니다.

ESP32에서의 ILI9341

ESP32에서는 보통 40 MHz SPI와 DMA로 패널을 구동합니다. LVGL UI를 부드럽게 하려면 화면 1/10 크기의 부분 버퍼를 쓰고, PSRAM이 없는 설계에서는 더블 버퍼링을 활성화하세요.

관련 항목

ILI9341 라이브러리 지원

라이브러리드라이버 / 클래스비고
TFT_eSPI (Arduino)ILI9341_DRIVER (or ILI9341_2_DRIVER)
LovyanGFX (Arduino / ESP-IDF)lgfx::Panel_ILI9341
ESP-IDF esp_lcdespressif/esp_lcd_ili9341
ILI9341 설정 템플릿 다운로드

User_Setup_ILI9341.h · LGFX_ILI9341.hpp. 핀은 임시 값입니다. 검증된 설정을 추가하면 이메일로 알려 드립니다.

ILI9341 탑재 개발 보드

ILI9341 탑재 디스플레이 모듈

ILI9341 문제 해결 및 FAQ

ILI9341과 ST7789: 무엇을 선택해야 하나요?

둘 다 GRAM이 있는 240×320 드라이버입니다. ILI9341 모듈은 보통 2.4″~3.2″의 TN 또는 IPS이고, 작은 IPS 패널에서는 ST7789가 주류입니다. 둘 다 라이브러리 지원이 뛰어나므로 패널 크기, 시야각, 공급 상황으로 고르세요.

ILI9341이 흰 화면을 보이는 이유는 무엇인가요?

가장 흔한 원인은 리셋 누락이나 오류, MISO/MOSI 뒤바뀜, 백라이트만 전원이 들어가는 경로, 다른 드라이버로 설정된 라이브러리입니다. 레지스터 0xD3을 읽어 드라이버 ID를 확인하세요.

ILI9341 모듈에는 어떤 터치 컨트롤러를 쓰나요?

저항막식 버전은 보통 SPI 방식 XPT2046을, 정전용량식 버전은 보통 I2C 방식 FT6206/FT6336을 사용합니다.

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

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