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

ILI9881C란 무엇인가

ILI9881C는 MIPI DSI 방식 TFT 패널용 Ilitek 드라이버 IC로, 주로 720×1280 또는 800×1280의 포트레이트(세로 방향) 패널에 사용됩니다. SPI나 RGB 픽셀 인터페이스는 없으며, 명령과 픽셀 데이터 모두 DSI를 통해 전송됩니다. Ilitek은 데이터시트를 공개하지 않으므로, 실질적인 참고 자료는 메인라인 Linux 드라이버인 panel-ilitek-ili9881c.c와 패널 제조사에서 제공하는 초기화 테이블입니다.

하나의 컨트롤러, 여러 개의 초기화 테이블

Linux 드라이버는 단일 구성이 아닙니다. 지원하는 각 패널마다 별도의 초기화 테이블, 디스플레이 타이밍, 레인 수를 담고 있습니다. 메인라인에 등록된 패널은 다음과 같습니다:

• Raspberry Pi Touch Display 2, 5″ 및 7″(raspberrypi,dsi-5inch, raspberrypi,dsi-7inch): 720×1280, 데이터 레인 2개.
• Waveshare 7.0″ DSI Touch A: 데이터 레인 2개.
• Banana Pi, Startek, TDO, Feixin, Bestar, Wanchanglong, Ampire 패널: 720×1280 또는 800×1280, 패널에 따라 2 또는 4 레인.

동일한 컨트롤러를 사용하더라도 패널마다 서로 다른 초기화 테이블과 타이밍이 필요할 수 있습니다. 다른 보드의 초기화 테이블을 복사하면 DSI 링크가 정상적으로 연결되어 있어도 화면이 검게 나오거나 줄무늬가 표시될 수 있습니다. 반드시 해당 패널에 맞는 테이블로 시작해야 합니다.

메인라인 Linux에는 ILI9881C 드라이버가 있지만 ILI9881D 항목은 없습니다. 당사의 PJ5015B14(4.99″ 720×1280 IPS)와 같은 ILI9881D 패널은 패널 데이터시트에 명시된 고유한 초기화 테이블과 타이밍이 필요한 것으로 취급해야 합니다.

Linux 드라이버의 전원 인가 시퀀스

메인라인 드라이버는 다음 순서로 패널을 구동합니다:

1. IOVCC를 인가하고 5 ms 대기한 후, 메인 전원을 인가하고 5 ms 대기합니다.
2. 리셋을 20 ms 동안 활성화한 뒤 해제하고, 20 ms 대기합니다.
3. 패널의 초기화 테이블을 전송합니다. ILI9881C는 페이지 전환 명령을 사용하여 벤더 레지스터에 접근합니다.
4. 페이지 0으로 복귀하고, 티어링 이펙트(TE) 출력을 활성화한 뒤, Exit Sleep을 전송합니다.
5. 120 ms 대기 후, Display On을 전송합니다.

Raspberry Pi: Touch Display 2

Raspberry Pi 공식 문서는 다음 오버레이를 사용하여 Touch Display 2를 구성합니다:

• dtoverlay=vc4-kms-dsi-ili9881-5inch
• dtoverlay=vc4-kms-dsi-ili9881-7inch

다른 DSI 포트를 사용하려면 ,dsi0을 추가합니다. 5″ 및 7″ 모델 모두 720×1280 해상도에 5점 터치를 지원합니다. 10″ 모델은 다른 컨트롤러와 오버레이(vc4-kms-dsi-ili79600-10-1inch)를 사용하며, DSI 레인 4개가 필요합니다.

Pi에서 커스텀 ILI9881C 또는 ILI9881D 패널을 사용하려면 일치하는 패널 항목을 지정하는 디바이스 트리 오버레이가 필요합니다. Touch Display 2 오버레이를 재사용해도 실제로 해당 초기화 테이블과 타이밍이 일치하는 경우에만 정상 동작합니다.

ESP32-P4와 M5Stack Tab5

ESPHome의 mipi_dsi 드라이버는 ESP32-P4에서 ILI9881C 패널을 구동하며, 데이터 레인 1개 또는 2개(기본값 2개)를 지원합니다. M5Stack Tab5는 이 선택이 얼마나 까다로운지 보여주는 사례입니다. ESPHome은 세 가지 하드웨어 버전을 문서화하고 있습니다:

• 2025년 10월 14일 이전 제조분: ILI9881C 디스플레이 드라이버와 별도의 GT911 터치 컨트롤러 사용. 모델 M5STACK-TAB5를 사용합니다.
• 이후 제조분: 디스플레이와 터치가 통합된 컨트롤러로, ST7123(M5STACK-TAB5-ST7123) 또는 ST7121(M5STACK-TAB5-ST7121)입니다.

세 가지 초기화 시퀀스는 상호 호환이 되지 않습니다. 잘못된 디스플레이 모델을 선택하면 화면이 검게 유지되고 관련 로그도 기록되지 않습니다. 반면 잘못된 터치 드라이버는 오류를 로그로 남기므로, ESPHome은 터치 드라이버를 기준으로 보드를 먼저 식별할 것을 권장합니다.

브링업 체크리스트

1. 패널 데이터시트에서 레인 수와 DSI 모드(video, sync-pulse, burst)를 확인하고, 호스트 측 설정이 이와 일치하는지 확인합니다.
2. 컨트롤러 이름이 아닌, 해당 패널에 정확히 맞는 초기화 테이블을 사용합니다.
3. 리셋 및 전원 시퀀스를 확인합니다. 일부 보드는 IO 익스팬더를 통해 리셋이나 전원을 제어합니다.
4. 백라이트는 켜지지만 화면이 나오지 않는 경우는 대체로 패널 불량이 아니라 잘못된 초기화 테이블, 잘못된 레인 수, 또는 DSI 타이밍 불일치가 원인입니다.

인터페이스 선택에 대해서는 MIPI DSI vs LVDS vs eDP 문서와 MIPI DSI 인터페이스 페이지를 참조하십시오.