라즈베리 파이 피코 OLED 128x32
이 튜토리얼은 Raspberry Pi Pico를 OLED 128x32 I2C 디스플레이와 함께 사용하는 방법을 안내합니다. 여러분은 다음을 배우게 될 것입니다:
- 128x32 OLED 디스플레이를 Raspberry Pi Pico에 연결하는 방법.
- Raspberry Pi Pico를 사용하여 128x32 OLED 화면에 텍스트와 숫자를 표시하는 방법.
- Raspberry Pi Pico를 사용하여 128x32 OLED 화면에 그림을 그리는 방법.
- Raspberry Pi Pico를 사용하여 128x32 OLED 화면에 이미지를 표시하는 방법.
- 128x32 OLED 화면 중앙에 텍스트와 숫자를 정렬하는 방법.

준비물
1 | × | 라즈베리 파이 피코 W | 쿠팡 | 아마존 | |
1 | × | 라즈베리 파이 피코 (또는) | 쿠팡 | 아마존 | |
1 | × | 마이크로 USB 케이블 | 아마존 | |
1 | × | SSD1306 I2C OLED 디스플레이 128x32 | 아마존 | |
1 | × | 점퍼케이블 | 쿠팡 | 아마존 | |
1 | × | (추천) 라즈베리 파이 피코용 스크루 터미널 확장 보드 | 아마존 |
OLED 디스플레이에 대해
I2C OLED 디스플레이 핀아웃
- GND 핀: Raspberry Pi Pico의 접지에 연결하세요.
- VCC 핀: 전원 공급을 위해 Raspberry Pi Pico의 5V 핀에 연결하세요.
- SCL 핀: I2C 통신용 클럭 핀입니다.
- SDA 핀: I2C 통신용 데이터 핀입니다.

※ 주의:
OLED 모듈의 핀 설정은 제조사와 모듈 종류에 따라 달라질 수 있습니다. OLED 모듈에 있는 표시를 항상 확인하고 따르세요. 주의하세요!
이 가이드는 SSD1306 I2C 드라이버를 사용하는 OLED 화면용입니다. DIYables의 OLED 화면으로 테스트해 보았으며 문제 없이 잘 작동했습니다.
선연결

이 이미지는 Fritzing을 사용하여 만들어졌습니다. 이미지를 확대하려면 클릭하세요.
아래는 128x32 OLED 모듈과 Raspberry Pi Pico 간의 배선 표입니다.
128x32 OLED Module | Raspberry Pi Pico |
---|---|
VCC | 3.3V |
GND | GND |
SDA | GP0 |
SCL | GP1 |
Raspberry Pi Pico 코드 - OLED에서 텍스트, 정수 및 부동 소수점 숫자 표시
자세한 사용 방법
다음의 지침을 단계별로 따라 주십시오:
- 컴퓨터에 Thonny IDE가 설치되어 있는지 확인하십시오.
- Raspberry Pi Pico에 MicroPython 펌웨어가 설치되어 있는지 확인하십시오.
- Raspberry Pi Pico를 처음 사용하신다면, 자세한 지침을 위해 라즈베리 파이 피코 - 시작하기 튜토리얼을 참고하십시오.
- 제공된 다이어그램에 따라 OLED 디스플레이를 Raspberry Pi Pico에 연결하십시오.
- Raspberry Pi Pico를 USB 케이블을 사용하여 컴퓨터에 연결하십시오.
- 컴퓨터에서 Thonny IDE를 실행하십시오.
- Thonny IDE에서 도구 옵션으로 이동하여 MicroPython (Raspberry Pi Pico) 인터프리터를 선택하십시오.
- 인터프리터 탭에서 드롭다운 메뉴를 사용해 MicroPython (Raspberry Pi Pico)를 선택하십시오.
- 올바른 포트가 선택되어 있는지 확인하십시오. Thonny IDE가 자동으로 포트를 감지하지만, 수동으로 선택해야 할 수도 있습니다 (예: Windows에서는 COM3, Linux에서는 /dev/ttyACM0).
- Thonny IDE의 도구 패키지 관리로 이동하십시오.
- “DIYables-MicroPython-OLED”를 검색한 후, DIYables에서 만든 OLED 라이브러리를 찾으십시오.
- DIYables-MicroPython-OLED를 클릭한 다음, Install 버튼을 눌러 OLED 라이브러리를 설치하십시오.

- 위의 코드를 복사하여 Thonny IDE의 에디터에 붙여넣으세요.
- Raspberry Pi Pico에 스크립트를 저장하려면:
- 저장 버튼을 클릭하거나 Ctrl+S 키를 사용하세요.
- 저장 대화상자에서 '이 컴퓨터'와 Raspberry Pi Pico 두 섹션이 표시됩니다. Raspberry Pi Pico를 선택하세요.
- 파일을 main.py라는 이름으로 저장하세요.
- 녹색 Run 버튼을 클릭하거나(F5 키를 누르세요) 스크립트를 실행하세요. 스크립트가 실행될 것입니다.
- OLED 디스플레이를 확인하세요. 아래와 같은 모습입니다:

Raspberry Pi Pico 코드 - OLED에 그리기
위의 코드를 실행하면 아래에 제시된 것처럼 OLED 화면에 사각형, 원, 삼각형이 표시됩니다.

라즈베리 파이 피코 코드 – OLED에 이미지 표시
아래 코드는 LCD 디스플레이에 이미지를 그립니다. 이 이미지는 DIYables 아이콘입니다.
위 코드를 실행하면 아래와 같이 OLED 화면에 이미지가 나타납니다.

OLED 화면에 다른 이미지를 표시하려면 다음 단계를 따르세요:
- 이미지를 (어떠한 포맷이든) 비트맵 배열로 변환합니다. 변환을 위해 이 온라인 도구를 사용할 수 있습니다. 아래 이미지를 참고하여 이미지를 비트맵 배열로 변환하는 방법에 대해 안내받으세요. 이 예시에서는 Raspberry Pi Pico 아이콘을 비트맵 배열로 변환했습니다.

- 기존 Raspberry Pi Pico 코드에 있는 비트맵 배열을 새로 변환된 배열로 교체하세요.
- 새 이미지의 크기에 맞게 Raspberry Pi Pico 코드에서 이미지의 가로와 세로 값을 조정하세요.
참고: 이미지 크기가 OLED 화면 크기보다 작거나 같도록 확인하십시오.
OLED에서 텍스트/숫자를 자동으로 수직 및 수평 중앙 정렬하는 방법
아래의 MicroPython 코드는 OLED 화면에서 텍스트를 수직 및 수평으로 자동 중앙에 배치합니다.
코드를 실행하면 텍스트가 OLED 화면에서 수직 및 수평으로 중앙 정렬됩니다.

OLED 문제 해결
128x32 OLED 화면에 아무 것도 표시되지 않는 경우, 다음 단계를 시도해 보십시오:
- 모든 배선 연결이 올바른지 확인하십시오.
- I2C OLED가 SSD1306 드라이버를 사용하고 있는지 확인하십시오.
- Raspberry Pi Pico에서 I2C 주소 스캐너 코드를 실행하여 OLED의 I2C 주소를 확인하십시오.
Thonny 하단의 셸에 출력: