기기 코딩 9 / 31
업로드가 안 될 때
자주 나오는 오류 문구와 해결 방법이에요. 오류는 '여기 확인해 줘'라는 신호예요.
IDE 아래쪽 검은 창(출력 창)에 빨간 글씨가 나오면 오류예요. 긴 글이라도 겁먹지 말고, 아래 표에서 비슷한 문구를 찾아보세요.
| 오류 문구 (일부) | 이렇게 해 보세요 |
|---|---|
| Port not selected / no upload port | 보드 선택 상자에서 포트를 골라요. 포트가 없으면 'USB 연결과 포트 찾기' 글을 봐요. |
| avrdude: … not in sync / programmer is not responding | 보드 종류가 Arduino Uno인지, 포트가 맞는지 확인해요. 0번·1번 핀에 꽂은 선이 있으면 잠깐 빼요. |
| Access is denied / Permission denied / port busy | 다른 프로그램이 포트를 쓰는 중이에요. 다른 IDE 창, 시리얼 모니터, Thonny, 브라우저의 기기 연결을 닫고 다시 해요. |
| Failed to connect to ESP32 / Wrong boot mode / Timed out waiting for packet header | ESP32의 BOOT 버튼을 누른 채로 업로드를 누르고, 'Connecting...'이 보이면 떼요. |
| 오류 문구 (일부) | 뜻과 해결 |
|---|---|
| expected ';' before … | 그 줄이나 바로 앞줄 끝에 ; (세미콜론)이 빠졌어요. |
| 'xxx' was not declared in this scope | xxx라는 이름을 못 찾았어요. 오타나 대소문자(digitalwrite ✗ → digitalWrite ✓)를 확인해요. |
| xxx.h: No such file or directory | 필요한 라이브러리가 없어요. 도구 → 라이브러리 관리에서 이름을 검색해 설치해요. |
| LED_BUILTIN was not declared | ESP32에서 자주 나와요. LED_BUILTIN을 2로 바꿔요. |
그래도 안 되면 💬 도우미에게 오류 문구를 그대로 복사해 붙여 넣어 보세요. 보드 종류(Uno인지 ESP32인지)도 함께 알려 주면 더 정확해요.
💬 막히면 도우미에게 물어보세요
오류가 나면 오류 문구를 그대로 붙여 넣으면 더 정확해요. 예: “업로드할 때 이런 오류가 나요: (여기에 오류 문구를 붙여 넣어 주세요)”