# Arduino IDE 설치

Arduino IDE는 아두이노 보드에 올릴 코드를 쓰고, 컴파일하고, USB로 보드에 올리는 프로그램입니다. 6회차(11월 7일) 수업에서 모터와 센서를 움직일 때 씁니다. **수업 전에 설치하고 아래 「확인」까지 해 오세요.** 보드가 아직 없어도 확인까지 할 수 있습니다.

## 내 컴퓨터 확인

- **Windows**: Windows 10 이상, 64비트면 됩니다. 요즘 노트북은 거의 다 해당합니다.
- **Mac**: 왼쪽 위 사과 메뉴 → **이 Mac에 관하여**. 「칩」에 **Apple M1/M2/M3/M4** 가 보이면 Apple Silicon, 「프로세서」에 **Intel** 이 보이면 Intel입니다.

## 내려받기

[arduino.cc/en/software](https://www.arduino.cc/en/software) 의 **Arduino IDE 2** 칸에서 **Download** 를 누르고, 내 컴퓨터에 맞는 파일을 고릅니다. 지금 버전은 **2.3.10** 이고, 파일은 150~200MB입니다.

| 컴퓨터 | 받을 파일 |
| --- | --- |
| Windows | Windows 64비트 설치 파일(`.exe`) |
| Mac, Apple Silicon | macOS Apple Silicon 의 `.dmg` |
| Mac, Intel | macOS Intel 의 `.dmg` |

> [!NOTE]
> 고르기 어렵거나 사이트가 열리지 않으면 [GitHub 릴리스](https://github.com/arduino/arduino-ide/releases/latest)에서 같은 파일을 받습니다. 파일 이름에 `Windows_64bit.exe`, `macOS_arm64.dmg`(Apple Silicon), `macOS_64bit.dmg`(Intel)가 들어 있습니다.

## 설치

### Windows

1. 받은 `.exe` 파일을 더블클릭합니다.
2. 「Windows의 PC 보호」 파란 창이 뜨면 **추가 정보** → **실행**.
3. 사용권 계약에서 **동의함(I Agree)**, 나머지는 기본값 그대로 **다음**, 마지막에 **설치**.
4. 시작 메뉴에서 **Arduino IDE** 를 실행합니다.
5. 처음 실행하면 「이 장치 소프트웨어를 설치하시겠습니까?」 창이 몇 번 뜹니다. 보드를 USB로 알아보는 드라이버라서 모두 **설치**를 누릅니다. 방화벽 창이 뜨면 **허용**.

### Mac

1. 받은 `.dmg` 파일을 더블클릭합니다.
2. 열린 창에서 **Arduino IDE** 아이콘을 **Applications** 폴더로 끌어다 놓습니다.
3. **응용 프로그램** 폴더에서 Arduino IDE를 실행합니다. 「인터넷에서 다운로드한 앱입니다」 창이 뜨면 **열기**.
4. 「들어오는 네트워크 연결을 허용하겠습니까?」 창이 뜨면 **허용**.

> [!WARNING]
> 「확인되지 않은 개발자」 창이 나오면 아이콘을 **오른쪽 클릭 → 열기**를 한 번 해 주세요. 그래도 안 되면 **시스템 설정 → 개인정보 보호 및 보안** 맨 아래의 **그래도 열기**.

처음 실행하면 오른쪽 아래에 보드 파일을 내려받는 알림이 잠깐 지나갑니다. 끝날 때까지 기다린 뒤 다음으로 넘어갑니다.

> [!TIP]
> 메뉴를 한국어로 보려면 **File → Preferences**(Mac은 **Arduino IDE → Settings**)에서 **Language** 를 **한국어**로 바꾸고 **OK**. 아래 설명은 영어 메뉴 이름에 한국어를 함께 적었습니다.

## 확인

보드 없이 컴파일까지 되는지 봅니다. 컴파일할 때 필요한 파일을 한 번 더 내려받으므로 집에서 해 오면 수업 시간이 줄어듭니다.

1. **File → Examples → 01.Basics → Blink** (파일 → 예제 → 01.Basics → Blink). 새 창에 예제 코드가 열립니다.
2. 위쪽 가운데 **Select Board**(보드 선택) 칸을 누르고 **Select other board and port...**(다른 보드 및 포트 선택).
3. 왼쪽 검색칸에 `uno` 를 치고 **Arduino Uno** 를 고른 뒤 **OK**. 포트는 비워 둡니다.
4. 왼쪽 위 **✓ (Verify, 확인)** 단추를 누릅니다.

아래 출력 창에 `Sketch uses ... bytes` 로 시작하는 줄이 나오면 설치가 잘 된 것입니다. 처음 한 번은 1~2분 걸릴 수 있습니다.

## 수업에서: 보드 연결

보드를 받으면 USB 케이블로 컴퓨터에 꽂고 아래를 합니다.

1. **Select Board** 칸을 누르면 꽂은 보드가 포트와 함께 보입니다. 그것을 고릅니다.
   - Windows 포트 이름: `COM3`, `COM4` 처럼 COM 뒤에 숫자
   - Mac 포트 이름: `/dev/cu.usbmodem…` 또는 `/dev/cu.usbserial…`
2. 오른쪽 아래에 「이 보드용 패키지를 설치하겠습니까」 알림이 뜨면 **설치**.
3. Blink 예제를 연 채로 **→ (Upload, 업로드)** 단추를 누릅니다.
4. 출력 창에 `Done uploading`(업로드 완료)이 나오고 보드 위 작은 LED가 1초 간격으로 깜빡이면 성공입니다.

## 포트가 안 보이거나 업로드가 안 될 때

- **USB 케이블부터 바꿔 봅니다.** 충전만 되는 케이블은 보드에 불은 들어오지만 컴퓨터가 보드를 알아보지 못합니다. 가장 흔한 원인입니다.
- USB 허브나 변환 젠더를 빼고 노트북에 바로 꽂아 봅니다. 다른 USB 구멍에도 꽂아 봅니다.
- **호환 보드(칩에 CH340 이 적힌 보드)** 는 드라이버가 따로 필요할 수 있습니다.
  - Windows: **장치 관리자 → 포트(COM & LPT)** 또는 **기타 장치**에 노란 느낌표가 붙은 `USB2.0-Serial` 이 보이면 [WCH 드라이버(CH341SER.EXE)](https://www.wch-ic.com/downloads/CH341SER_EXE.html)를 받아 **INSTALL** 을 누르고 케이블을 다시 꽂습니다.
  - Mac: 포트 목록에 `cu.usbserial` 이나 `cu.wchusbserial` 이 없으면 [WCH Mac 드라이버](https://www.wch-ic.com/downloads/CH34XSER_MAC_ZIP.html)를 설치하고, **시스템 설정 → 개인정보 보호 및 보안**에서 허용한 뒤 재시동합니다.
- 업로드 중 `avrdude` 나 `programmer is not responding` 오류가 나오면 **Select Board** 에서 보드와 포트를 다시 고르고, 케이블을 뺐다 꽂은 뒤 다시 업로드합니다.

> [!TIP]
> IDE 창을 열지 않고 Cursor 채팅으로 코드를 쓰고, 올리고, 보드가 보내는 값까지 확인하는 방법은 [6회차 · Cursor에서 아두이노 올리기](https://opencircuit.club/wiki/lab/arduino-cursor) 에 있습니다.
