IOTHUB SOFTWARE · 01

Arduino IDE 실무 설치

Arduino IDE 설치는 버튼 몇 번으로 끝나지만, 실제 문제는 업로드 단계에서 터집니다. 여기서는 ESP32와 ESP8266 보드를 안정적으로 인식시키기 위한 설치 기준과 확인 절차를 정리합니다.

ESP32에 코드를 업로드하려면 Arduino IDE가 필요합니다. 처음 보면 전문 개발 도구처럼 느껴질 수 있지만, 이 시리즈에서 주로 사용하는 작업은 코드를 붙여넣고 업로드 버튼을 누르는 흐름입니다.

다운로드

arduino.cc/en/software 에서 사용 중인 OS에 맞는 버전을 받습니다.

Windows 설치

• 다운로드한 .exe 파일을 실행합니다.
• 라이선스 동의 → Next → Next → Install 순서로 진행합니다.
• 중간에 "장치 드라이버를 설치하시겠습니까?"라는 안내가 나오면 반드시 "예"를 선택합니다. 이 단계를 건너뛰면 ESP32를 USB로 연결해도 인식되지 않을 수 있습니다.
• 설치 완료 후 Arduino IDE를 실행합니다.

Mac 설치

• 다운로드한 .dmg 파일을 실행합니다.
• Arduino 아이콘을 Applications 폴더로 드래그합니다.
• 처음 실행할 때 "인터넷에서 다운로드한 앱" 경고가 뜨면 열기를 선택합니다.

설치 확인

Arduino IDE를 실행했을 때 이런 창이 뜨면 OK다:

파일  편집  스케치  툴  도움말
┌──────────────────────────┐
│ void setup() {          │
│   // put your setup     │
│ }                       │
│ void loop() {           │
│   // put your main      │
│ }                       │
└──────────────────────────┘

안 될 때

현장에서 바로 쓰는 작업 흐름

Arduino IDE를 설치한 뒤에는 “설치 확인”에서 멈추지 말고 실제 보드 업로드까지 한 번에 끝내야 합니다. 현장에서 확인할 때는 먼저 보드를 USB에 꽂고, 포트가 새로 생기는지 확인한 다음, 아무 센서도 연결하지 않은 상태에서 빈 스케치를 올립니다. 이 단계가 성공해야 이후 센서, 릴레이, OLED 문제를 제대로 분리해서 볼 수 있습니다.

보드에 센서까지 모두 연결한 뒤 업로드를 처음 시도하면 원인을 찾기 어렵습니다. 전원 문제인지, USB 드라이버 문제인지, 코드 문제인지 한꺼번에 섞입니다. 그래서 처음 하루는 보드 단독 업로드, 시리얼 로그, Blink 또는 빈 스케치, 재부팅 확인만 따로 끝내는 편이 좋습니다.

기록해두면 좋은 설치 정보

• 운영체제와 버전: Windows 11, macOS, Linux 등.
• Arduino IDE 버전.
• 보드 패키지 이름과 버전.
• 사용한 보드명: ESP32 Dev Module, ESP32-S3 Dev Module 등.
• 정상 업로드된 USB 포트명.
• 업로드 속도와 시리얼 모니터 속도.

이 기록이 있으면 나중에 PC를 바꾸거나 다른 사람이 같은 장치를 만들 때 시행착오가 크게 줄어듭니다.

실무에서 설치보다 중요한 것은 드라이버와 케이블이다

Arduino IDE를 설치했는데 업로드가 안 되는 경우가 많습니다. 이때 IDE 자체보다 USB 케이블, USB-Serial 칩 드라이버, 포트 선택 문제가 원인인 경우가 많습니다. 특히 저가 보드는 CH340, CP210x 같은 USB 변환칩을 쓰는 경우가 많아서 운영체제가 자동으로 잡지 못할 수 있습니다.

• 충전 전용 케이블이 아닌 데이터 케이블을 사용합니다.
• 보드 연결 전후로 포트 목록이 달라지는지 확인합니다.
• Windows 장치 관리자에서 알 수 없는 장치가 뜨면 드라이버 문제를 먼저 봅니다.
• Mac에서는 보안 설정 때문에 처음 실행이나 드라이버 로딩이 막힐 수 있습니다.

설치 후 반드시 해볼 테스트

IDE가 실행된다고 끝난 것이 아닙니다. 실제 보드에 빈 스케치나 Blink 예제를 올려야 개발환경이 준비된 것입니다. 업로드가 성공하면 시리얼 모니터를 열어 보드가 재부팅되는지, 로그 속도가 맞는지도 확인합니다.

1. 보드를 USB로 연결합니다.
2. Tools에서 Board와 Port를 선택합니다.
3. 빈 스케치를 업로드합니다.
4. 시리얼 모니터를 열고 115200 baud로 로그를 확인합니다.
5. 업로드 실패 시 케이블, 드라이버, 포트, 보드 선택 순서로 확인합니다.

자주 보는 오류와 판단