ILI9341 TFT 컬러 LCD 모듈
일반
ILI9341 TFT 컬러 LCD 모듈로 2.2~2.8인치의 크기와 320X240 해상도를 지원합니다. SPI 인터페이스를 사용합니다. (터치 기능은 지원하지 않습니다.)
사양
- 유형: TFT
- 드라이버: ILI9341
- 해상도: 240x320p
- 인터페이스: 4 wire SPI
- VCC : 2.8.V~3.3V
- 로직 I/O포트 전압 : 3.3V(TTL)
사용 가능한 GPIO
- 라즈베리파이 0~4
- 라즈베리파이 5
- 비글본 블랙/그린
- 젯슨 나노
- FT232H, FT2232H, FT4232H
명령
[INIT]
초기 설정을 입력합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| DC핀 | WRITE | D/C (Data/Command)핀의 GPIO 번호를 입력합니다. |
| RESET핀 (옵션) | WRITE | RESET핀의 GPIO 번호를 입력합니다. RESET기능을 사용하지 않을 경우 -1을 입력하고 핀을 3.3V에 연결합니다. |
[SET_ROTATION]
디스플레이의 표시방향을 설정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 회전방향 | WRITE | 디스플레이에 문자, 그림등이 표시되는 방향을 선택합니다. (0도,90도,180도,270도) |
[CLEAR]
디스플레이에 표시된 내용을 모두 삭제합니다.
[SET_CURSOR]
디스플레이에 텍스트를 쓸 위치를 지정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 위치(x) | WRITE | 텍스트의 시작위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 위치(y) | WRITE | 텍스트의 시작위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
[PRINT_TEXT]
디스플레이에 텍스트를 씁니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 텍스트 | WRITE | 표시할 텍스트를 입력합니다. |
| 크기 | WRITE | 텍스트의 크기입니다. (1~255) |
| 자동줄바꿈 | WRITE | 텍스트가 가로 표시길이를 초과할 경우 자동줄바꿈을 할지 여부를 결정합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_PIXEL]
디스플레이에 픽셀을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 위치(x) | WRITE | 픽셀의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 위치(y) | WRITE | 픽셀의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_LINE]
디스플레이에 직선을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 직선의 시작점 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 직선의 시작점 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 종료점(x) | WRITE | 직선의 종료점 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 종료점(y) | WRITE | 직선의 종료점 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_TRIANGLE]
디스플레이에 속이 빈 삼각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 점1(x) | WRITE | 삼각형의 점1의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점1(y) | WRITE | 삼각형의 점1의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점2(x) | WRITE | 삼각형의 점2의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점2(y) | WRITE | 삼각형의 점2의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점3(x) | WRITE | 삼각형의 점3의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점3(y) | WRITE | 삼각형의 점3의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_TRIANGLE]
디스플레이에 속이 찬 삼각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 점1(x) | WRITE | 삼각형의 점1의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점1(y) | WRITE | 삼각형의 점1의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점2(x) | WRITE | 삼각형의 점2의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점2(y) | WRITE | 삼각형의 점2의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 점3(x) | WRITE | 삼각형의 점3의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 점3(y) | WRITE | 삼각형의 점3의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_RECT]
디스플레이에 속이 빈 사각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_RECT]
디스플레이에 속이 찬 사각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_ROUND_RECT]
디스플레이에 속이 빈 모서리가 둥근 사각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 모서리반지름 | WRITE | 사각형 모서리의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_ROUND_RECT]
디스플레이에 속이 찬 모서리가 둥근 사각형을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 시작점(x) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 사각형의 시작점(왼쪽상단)의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 가로길이 | WRITE | 사각형의 가로길이를 입력합니다. |
| 세로길이 | WRITE | 사각형의 세로길이를 입력합니다. |
| 모서리반지름 | WRITE | 사각형 모서리의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_CIRCLE]
디스플레이에 속이 빈 원을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 중심(x) | WRITE | 원의 중심의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 중심(y) | WRITE | 원의 중심의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 반지름 | WRITE | 원의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_CIRCLE]
디스플레이에 속이 찬 원을 그립니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 중심(x) | WRITE | 원의 중심의 위치(x)를 입력합니다. 가장 왼쪽 픽셀이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 중심(y) | WRITE | 원의 중심의 위치(y)를 입력합니다. 가장 위의 픽셀이 0이며, 아래로 갈수록 증가합니다. |
| 반지름 | WRITE | 원의 반지름을 입력합니다. |
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[FILL_SCREEN]
디스플레이 전체를 지정된 색상으로 채웁니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 색상 타입 | WRITE | 설정할 색상의 타입을 선택합니다. |
색상 타입 : RGB
| 항목 | 타입 | 설명 |
|---|---|---|
| R | WRITE | 색상의 R성분을 입력합니다. (0~255) |
| G | WRITE | 색상의 G성분을 입력합니다. (0~255) |
| B | WRITE | 색상의 B성분을 입력합니다. (0~255) |
색상 타입 : HSV
| 항목 | 타입 | 설명 |
|---|---|---|
| H | WRITE | 색상의 H (Hue)성분을 입력합니다. (0~360) |
| S | WRITE | 색상의 S (Saturation, 채도)성분을 입력합니다. (0~100) |
| V | WRITE | 색상의 V (Value, 명도)성분을 입력합니다. (0~100) |
[DRAW_RGB_BITMAP]
디스플레이에 bmp 형식의 이미지파일을 표시합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 파일 경로 * | WRITE | 이미지 파일의 로컬 경로를 입력합니다. (예: /home/pi/test.bmp) |
| 시작점(x) | WRITE | 이미지의 좌측상단이 위치할 픽셀의 위치(x)를 입력합니다. 가장 왼쪽이 0 이며, 오른쪽으로 갈수록 증가합니다. |
| 시작점(y) | WRITE | 이미지의 좌측상단이 위치할 픽셀의 위치(y)를 입력합니다.아래로 갈수록 증가합니다. |
* Windows bitmap (*.bmp) 형식의 이미지만 사용할 수 있습니다. (OS/2 bitmap은 지원하지 않음)
* 이미지 파일은 컨트롤러의 로컬 경로에 위치해야 합니다. (디스플레이 모듈에 탑재된 SD 슬롯은 사용안함)
* 이미지 파일은 컨트롤러의 로컬 경로에 위치해야 합니다. (디스플레이 모듈에 탑재된 SD 슬롯은 사용안함)
[INVERT_DISPLAY]
디스플레이의 색상을 반전할지 여부를 설정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 색상 반전 | WRITE | 값이 true이면 반전된 색상을, false이면 원래 색상을 표시합니다. |
[SCROLL_TO]
디스플레이를 아래 방향으로 스크롤합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 스크롤 크기 (픽셀) | WRITE | 스크롤시 한번에 이동할 세로 방향 픽셀 크기를 입력합니다. |
[SET_SCROLL_MARGINS]
디스플레이의 상단 및 하단에 스크롤하지 않는 고정 영역을 설정합니다.
| 항목 | 타입 | 설명 |
|---|---|---|
| 상단 마진 (픽셀) | WRITE | 스크롤시 고정할 상단 영역의 세로 방향 픽셀 크기를 입력합니다. |
| 하단 마진 (픽셀) | WRITE | 스크롤시 고정할 하단 영역의 세로 방향 픽셀 크기를 입력합니다. |
예제
목표
2초 간격으로 임의의 직선, 원, 사각형, 텍스트, 이미지를 계속 반복하여 표시합니다.
부품
| 부품 | 갯수 |
|---|---|
| 라즈베리파이 4 * | 1 |
| ILI9341 TFT LCD | 1 |
* 다른 하드웨어를 사용할 수도 있습니다. 사용 가능한 GPIO를 참고하세요.
연결
| ILI9341 TFT LCD | GPIO |
|---|---|
| VCC | 3.3V |
| GND | GND |
| CS | 8 (SPI0 CE0) |
| RST | 23 * |
| D/C | 24 * |
| SDI (MOSI) | 10 (SPI0 MOSI) |
| SCK (SCLK) | 11 (SPI0 SCLK) |
| LED (BL) | 3.3V |
* 임의의 GPIO 핀을 사용할 수 있습니다.
프로젝트
준비중…
