아두이노(Arduino) Uno R4 WiFi LED(LCD) 

매트릭스 출력 오류 완벽 해결법

1. 아두이노 보드 설정 확인 (필수)

가장 많은 실수가 여기서 발생합니다. 아두이노 IDE에서 보드를 'Arduino Uno'로 설정하면 안 됩니다.

   해결 방법:

1.  아두이노 IDE의 [툴] -> [보드] -> [보드 매니저]를 엽니다.
2. 검색창에 R4를 입력합니다.
3. [Arduino UNO R4 Boards] 패키지를 설치합니다.
4. [툴] -> [보드] 메뉴에서 [Arduino UNO R4 WiFi]를 정확하게 선택했는지 확인하세요.

2. 'Arduino_LED_Matrix' 라이브러리 설치

내장된 매트릭스를 제어하기 위해서는 전용 라이브러리가 반드시 필요합니다.

    해결 방법:

1.  [툴] -> [라이브러리 관리]를 클릭합니다.
2. 검색창에 Arduino_LED_Matrix를 입력합니다.
3. Arduino에서 제공하는 해당 라이브러리를 [설치]합니다.
4. 코드 상단에 #include "Arduino_LED_Matrix.h"가 포함되어 있는지 확인하세요.

3. WiFi 모듈 펌웨어 업데이트 (중요)

R4 WiFi 보드는 내장된 ESP32-S3(WiFi 모듈) 펌웨어 버전이 낮으면 매트릭스 동작이나 연결에 간헐적인 오류를 일으킬 수 있습니다.

    해결 방법:

1.  아두이노 IDE [툴] -> [Firmware Updater]를 클릭합니다.
2. 나타나는 창에서 보드가 인식되는지 확인합니다.
3. [Update Firmware] 버튼을 눌러 최신 버전으로 업데이트를 진행하세요. (업데이트 도중 케이블이 빠지지 않도록 주의하세요.)

4. 코드 논리 오류 점검

매트릭스가 켜지지 않는 가장 단순한 이유는 코드 내에 출력 명령어가 없거나 잘못되었기 때문입니다. 예제 코드로 먼저 테스트해 보세요.

     테스트 방법:

1.  [파일] -> [예제] -> [Arduino_LED_Matrix] -> [HelloWord] (또는 기타 예제)를 엽니다.
2. 이 코드를 그대로 업로드해 보세요.
3. 만약 예제 코드는 잘 작동한다면, 현재 작성 중인 본인의 코드에서 매트릭스 출력 명령(matrix.renderBitmap(...))이 제대로 호출되고 있는지 확인해야 합니다.

5. 전원 공급 및 핀 간섭

LED 매트릭스는 생각보다 전류를 많이 소모합니다.

• 점검:  USB 케이블이 불량하거나 전원 공급이 불안정한 PC 포트를 사용 중일 때 오류가 날 수 있습니다. 다른 USB 포트나 정품 케이블을 사용해 하십시오.

  • 만약 외부 모듈(센서 등)을 많이 연결했다면, 전원 부족으로 매트릭스 구동이 안 될 수 있습니다. 다른 모듈을 다 뽑고 매트릭스만 테스트 하십시오.

💡 외부 I2C LCD를 연결하셨나요?

만약 내장 매트릭스가 아니라, 외부에 별도의 I2C LCD(예: 1602 LCD)를 연결했는데 글자가 안 나오는 것이라면 다음을 확인하십시오.

• 핀 번호: R4 WiFi의 SDA, SCL 핀 위치가 기존 Uno R3와 다를 수 있으니 핀맵(Pinout)을 재확인 바랍니다.

• 주소값(Address): 0x27 또는 0x3F인지 확인해야 합니다. i2c_scanner 코드를 실행해 LCD의 정확한 주소를 파악하는 것이 우선입니다.

💡 증상 종류

1.  내장 LED 매트릭스가 아예 켜지지 않나요?
2. 코드는 업로드되는데 원하는 무늬나 글자가 나오지 않나요?
3. 혹시 '연결 오류(Port not found)' 같은 메시지가 뜨나요?