아두이노 I2C OLED를 일주일 연결해봤더니

• 목록
• 답변
• 글쓰기
• 옵션
  • 수정
  • 삭제

점퍼선 네 가닥을 꽂고 예제 코드를 올렸는데 OLED 화면은 계속 검은색이었습니다. 전원을 다시 연결하고 코드도 바꿔 봤지만, 원인은 뜻밖에도 I2C 주소와 전압 확인 순서에 있었습니다. 아두이노를 처음 다루는 분이 같은 시행착오를 줄일 수 있도록, 일주일 동안 0.96인치 OLED를 사용하며 확인한 과정을 기초부터 풀어봅니다.

I2C OLED가 선 네 가닥으로 동작하는 원리

전원선 두 개와 통신선 두 개를 구분합니다

I2C OLED 모듈에는 대개 GND, VCC, SCL, SDA 핀이 있습니다. GND와 VCC는 화면에 전원을 공급하고, SCL과 SDA는 아두이노와 데이터를 주고받습니다. 병렬 방식 디스플레이보다 배선이 단순해서 입문 프로젝트에 잘 맞지만, 핀 이름과 보드별 위치가 항상 같지는 않다는 점부터 알아야 합니다.

SCL은 통신 타이밍을 만드는 클록 선이며 SDA는 명령과 화면 데이터를 전달하는 선입니다. 아두이노 우노에서는 일반적으로 SDA가 A4, SCL이 A5에 연결됩니다. 다만 메가, 나노 계열, ESP32처럼 보드가 달라지면 핀 위치도 달라질 수 있으므로 보드의 핀 배치도를 먼저 확인해야 합니다. 아두이노의 전체 개념이 낯설다면 아두이노 지식백과 설명을 함께 읽으면 하드웨어와 소프트웨어의 관계를 잡는 데 도움이 됩니다.

주소를 붙여 장치를 구분합니다

I2C 통신에서는 각 장치가 주소를 사용합니다. 시중의 SSD1306 기반 0.96인치 OLED는 흔히 0x3C를 쓰지만, 제품이나 납땜 설정에 따라 0x3D일 수도 있습니다. 겉모습만 보고 주소를 단정하면 정상 배선에서도 화면이 나오지 않으므로 I2C 스캐너로 실제 주소를 읽는 습관이 중요합니다.

• GND: 아두이노 GND와 연결해 전압 기준을 공유합니다.
• VCC: 모듈 사양을 확인한 뒤 3.3V 또는 5V에 연결합니다.
• SDA: 문자열과 그래픽 데이터가 이동하는 통신선입니다.
• SCL: 데이터 전송 시점을 맞추는 클록선입니다.

처음부터 코드를 길게 작성하지 마세요. 전원 확인, 주소 검색, 기본 예제 실행의 세 단계로 나누면 어느 구간에서 문제가 생겼는지 바로 좁힐 수 있습니다.

첫날 화면을 띄운 배선과 설정 순서

부품을 연결하기 전에 사양부터 읽습니다

실습에는 아두이노 우노 호환 보드, SSD1306 I2C OLED, 브레드보드용 점퍼선 네 가닥, USB 케이블이 필요합니다. OLED는 크기와 해상도가 비슷해 보여도 컨트롤러가 SH1106인 제품이 섞여 있습니다. 구매 가격은 판매처와 구성에 따라 달라지지만 작은 단색 모듈은 대체로 부담이 적으므로, 최저가보다 컨트롤러명·해상도·동작 전압이 명시된 제품을 고르는 편이 안전합니다.

전원을 넣은 상태에서 배선을 바꾸면 핀이 순간적으로 잘못 접촉할 수 있습니다. USB 케이블을 뺀 뒤 GND, VCC, SDA, SCL 순으로 연결하고, VCC와 GND가 뒤바뀌지 않았는지 한 번 더 살펴보세요. 모듈 뒷면의 인쇄 순서가 제품마다 다르므로 다른 사람의 사진과 선 색깔만 따라 연결해서는 안 됩니다.

스캐너에서 예제 화면까지 단계별로 진행합니다

아두이노 IDE에서 Wire 라이브러리를 이용한 I2C 스캐너 예제를 실행하면 연결된 주소를 시리얼 모니터에서 확인할 수 있습니다. 이어 Adafruit SSD1306와 Adafruit GFX 라이브러리를 설치하고, 확인된 주소와 실제 해상도를 예제 코드에 반영합니다. IDE와 드라이버가 어떤 역할을 하는지 더 알고 싶다면 통합개발환경의 개요도 기초 용어를 이해하는 참고 자료가 됩니다.

1. USB를 분리한 상태에서 네 개의 핀을 보드에 연결합니다.
2. 보드와 포트를 선택한 뒤 I2C 스캐너 코드를 업로드합니다.
3. 시리얼 모니터의 전송 속도를 코드와 동일하게 맞춥니다.
4. 검색된 0x3C 또는 0x3D 주소를 메모합니다.
5. SSD1306 기본 예제에서 해상도와 주소를 수정해 업로드합니다.
6. 문자, 선, 사각형이 차례로 표시되는지 확인합니다.

화면이 떴다면 곧바로 복잡한 센서 프로젝트로 넘어가기보다 글자 한 줄부터 바꿔 보세요. 커서 위치와 글자 크기를 조절하고 display 호출 전후의 차이를 관찰하면, 화면 데이터를 메모리에 그린 다음 한 번에 전송한다는 구조가 눈에 들어옵니다.

사흘째부터 만난 검은 화면과 깨짐의 원인

아무것도 표시되지 않을 때 확인할 부분

가장 흔한 원인은 SDA와 SCL의 뒤바뀜, 잘못된 주소, 컨트롤러 불일치입니다. 전원 LED가 켜졌다고 해서 통신까지 정상인 것은 아닙니다. I2C 스캐너에서 장치가 한 개도 발견되지 않는다면 그래픽 코드보다 배선, 보드 핀 번호, 납땜 상태를 먼저 의심해야 합니다.

스캐너에서는 주소가 보이는데 화면만 검다면 코드에 지정된 해상도와 드라이버를 확인합니다. 128×64 모듈에 128×32 설정을 사용하거나 SH1106 제품에 SSD1306 전용 예제를 올리면 일부만 표시되거나 전혀 나오지 않을 수 있습니다. 또 초기화 함수의 반환값을 확인하도록 코드를 작성하면 초기화 실패와 그리기 오류를 구분하기 쉽습니다.

센서를 함께 연결했을 때 생기는 문제

OLED가 단독으로는 잘 동작하지만 온습도 센서를 함께 꽂자 멈춘다면 주소 충돌, 풀업 저항의 합성값, 전원 부족을 차례로 살펴야 합니다. 서로 다른 주소를 쓰는 장치는 SDA와 SCL을 공유할 수 있지만, 모듈마다 풀업 저항이 이미 실장되어 있으면 병렬 연결 수가 늘수록 전체 저항값이 낮아집니다. 초보 실습에서는 우선 짧은 배선과 낮은 장치 수로 성공 조건을 만든 뒤 하나씩 추가하는 방식이 좋습니다.

• 스캐너에 주소가 없음: SDA·SCL 위치, 공통 GND, 단선 여부를 점검합니다.
• 주소는 있지만 검은 화면: 라이브러리, 컨트롤러, 해상도, 초기화 주소를 확인합니다.
• 화면이 간헐적으로 깨짐: 점퍼선을 짧게 하고 느슨한 접점을 교체합니다.
• 센서 추가 후 멈춤: 주소 중복과 전원 용량, 풀업 저항 구성을 검사합니다.
• 업로드 자체가 실패함: 보드 종류, 포트, USB 데이터 케이블을 확인합니다.

문제 해결 기록에는 ‘안 됨’ 대신 전압, 검색 주소, 사용 라이브러리, 해상도, 단독 연결 결과를 적으세요. 측정 가능한 정보가 쌓이면 같은 고장을 다시 만났을 때 해결 속도가 크게 빨라집니다.

일주일 뒤 세운 부품 선택 순서와 초보 FAQ

자주 막히는 질문을 실제 조건으로 답합니다

Q. OLED를 5V에 바로 연결해도 되나요? 제품 설명에서 입력 전압 범위를 확인해야 합니다. 레귤레이터와 레벨 처리 회로가 포함된 모듈도 있지만 3.3V 전용 제품도 있습니다. 아두이노 계열의 구성과 활용 사례는 또 다른 아두이노 지식백과 항목에서 배경을 넓혀 볼 수 있으나, 실제 연결 전압은 반드시 구매한 모듈의 데이터시트와 판매 사양을 기준으로 판단해야 합니다.

Q. 풀업 저항을 별도로 달아야 하나요? 짧은 점퍼선으로 OLED 하나만 연결한 입문 키트라면 모듈에 이미 풀업 저항이 달려 있는 경우가 많습니다. 무조건 저항을 추가하기보다 전원을 끄고 모듈 기판의 저항 표기나 회로도를 확인하세요. 여러 장치를 연결하거나 배선이 길어지면 오실로스코프로 상승 시간을 확인하는 접근이 정확하지만, 처음에는 장치를 하나씩 추가하며 증상을 비교하는 것으로도 많은 원인을 찾을 수 있습니다.

구매와 설계의 판단 기준을 다시 세웁니다

Q. 값싼 OLED와 설명이 자세한 OLED 중 무엇이 좋나요? 첫 프로젝트라면 몇백 원의 차이보다 컨트롤러명과 예제 코드 제공 여부가 더 중요합니다. 일주일 동안 사용해 보니 화면 크기나 색상보다도 정확한 핀 표기와 동작 전압, 검증된 라이브러리가 성공률을 좌우했습니다. 나중에 라즈베리파이나 3.3V 마이크로컨트롤러로 옮길 계획이 있다면 로직 전압 호환성까지 살펴보는 편이 좋습니다.

1. 첫째, 전기적 호환성: 보드와 OLED의 전압 범위, 핀 배열, 공통 GND 구성을 가장 먼저 확인합니다.
2. 둘째, 칩과 라이브러리: SSD1306인지 SH1106인지 확인하고 유지 관리되는 라이브러리와 예제가 있는 제품을 고릅니다.
3. 셋째, 진단 가능성: I2C 스캐너에서 주소가 확인되고 초기화 실패를 출력할 수 있게 구성합니다.
4. 넷째, 확장 조건: 센서 연결 수, 주소 충돌 가능성, 배선 길이와 전원 여유를 계산합니다.
5. 다섯째, 가격과 외형: 앞의 조건이 충족된 후보 안에서 화면 크기, 색상, 배송비를 비교합니다.

처음 살 부품을 고를 때는 가격표부터 보기 쉽지만, 판단 순서는 전압 호환성 → 컨트롤러와 라이브러리 → 고장 진단 가능성 → 확장성 → 가격이 되어야 합니다. 이 순서를 지키면 검은 화면 앞에서 코드를 무작정 바꾸는 시간을 줄이고, 다음 센서 연결 프로젝트에도 그대로 활용할 수 있는 I2C 통신 감각을 익힐 수 있습니다.