⚠️ 반드시 3.3V 사용. 5V 연결 시 패널 손상. 배선은 전원 차단 상태에서.
| LCD 핀 | 기능 | Pi GPIO (BCM) | 물리 핀 번호 | 선색 예시 |
|---|---|---|---|---|
| VCC | 전원 3.3V | 3V3 | 17 | 빨강 |
| GND | 접지 | GND | 20 | 검정 |
| SCL | SPI 클럭(SCLK) | GPIO11 | 23 | 주황 |
| SDA | SPI 데이터(MOSI) | GPIO10 | 19 | 노랑 |
| RES | 리셋 (RST/RESET 과 동일 표기) | GPIO24 | 18 | 초록 |
| DC | 데이터/명령 선택 | GPIO25 | 22 | 파랑 |
| CS | 칩 선택(CE0) | GPIO8 | 24 | 보라 |
배선 7가닥 전부 물리 17~24번 블록에 모여 있다 — 헤더 중간 8핀 구간만 쓰면 된다.
보드 부품면(위)에서 본 헤더. SD 카드 슬롯이 위, GPIO 헤더가 오른쪽 세로로 오는 방향 기준 — 핀 1 = 헤더 맨 위 왼쪽(사각 납땜 패드). 왼쪽 열=홀수 핀(보드 안쪽), 오른쪽 열=짝수 핀(보드 가장자리).
| 3V3 | 1 | 2 | 5V |
| GPIO2 (SDA1) | 3 | 4 | 5V |
| GPIO3 (SCL1) | 5 | 6 | GND |
| GPIO4 | 7 | 8 | GPIO14 (TXD) |
| GND | 9 | 10 | GPIO15 (RXD) |
| GPIO17 | 11 | 12 | GPIO18 |
| GPIO27 | 13 | 14 | GND |
| GPIO22 | 15 | 16 | GPIO23 |
| 3V3→ VCC | 17 | 18 | GPIO24→ RES |
| GPIO10 (MOSI)→ SDA | 19 | 20 | GND→ GND |
| GPIO9 (MISO) | 21 | 22 | GPIO25→ DC |
| GPIO11 (SCLK)→ SCL | 23 | 24 | GPIO8 (CE0)→ CS |
| GND | 25 | 26 | GPIO7 (CE1) |
| ID_SD | 27 | 28 | ID_SC |
| GPIO5 | 29 | 30 | GND |
| GPIO6 | 31 | 32 | GPIO12 |
| GPIO13 | 33 | 34 | GND |
| GPIO19 | 35 | 36 | GPIO16 |
| GPIO26 | 37 | 38 | GPIO20 |
| GND | 39 | 40 | GPIO21 |
방향 확인법: 헤더 납땜면에서 핀 1만 사각 패드(나머지는 원형). 핀 1 은 SD 카드 슬롯과 같은 쪽 모서리다.
ls /dev/spidev0.0 (install.sh 가 dtparam=spi=on 설정, 재부팅 필요할 수 있음)config.py 의 INVERT 토글FORCE_SIMULATION = True → /tmp/display_preview.png