ESP32 + ESP-IDF 개발환경 구축 및 Hello World 실행기

ESP-IDF는 아두이노 같은 추상화된 환경이 아니라, ESP32의 모든 기능을 직접 제어할 수 있는 공식 저수준 개발 프레임워크입니다.
본 포스팅은 Windows + VSCode 기준으로 ESP-IDF 설치 → 예제 빌드 → 보드에 Hello World 플래시까지의 흐름을 정리한 기록입니다.

---

사전 준비

설치 항목

• ESP32 보드 (DevKit v1 또는 기타 보드)
• USB 케이블
• VSCode
• Python (ESP-IDF 설치 중 자동 설치됨)
• USB 드라이버 (CH340, CP210x 등 보드에 따라 설치)

---

ESP-IDF 설치

1. VSCode 실행 → Espressif IDF 확장 설치

좌측 Extensions에서 ESP-IDF 검색 → 설치

2. 확장 설치 후 → 자동 실행되는 ESP-IDF Setup Wizard 사용

• 설치 방식: Express Setup (권장) 또는 Custom
• 설치 경로 예시: C:\Espressif\frameworks\esp-idf-v5.x
• 자동으로 Python, CMake, Ninja, 툴체인 설치됨
• 설치 완료 후 ESP-IDF Doctor로 정상 설치 확인 가능

---

예제 프로젝트 실행 (Hello World)

1. VSCode 명령팔레트 실행 (Ctrl+Shift+P)

→ ESP-IDF: Show Examples Projects 검색

2. get-started/hello_world 예제 선택

→ 원하는 폴더에 프로젝트 복사됨

3. 프로젝트 폴더 열기 (File → Open Folder)

→ hello_world 폴더 열기

---

포트 설정

좌측 ESP-IDF: EXPLORER 메뉴에서

• Select port to use: 보드가 연결된 COM 포트 선택
• Select monitor port: 동일 포트로 지정

(포트는 장치관리자 → "포트 (COM & LPT)"에서 확인 가능)

---

빌드 → 플래시 → 모니터

단계	설명	명령어/버튼
Build	프로젝트 컴파일	Build Project
Flash	ESP32에 업로드	Flash Device
Monitor	UART 로그 보기	Monitor Device

업로드 후 UART 콘솔에 다음 메시지가 뜨면 성공:

Hello world!
This is ESP32 chip with xx cores, WiFi/BT/BLE, silicon revision x

---

기본 .gitignore

# ESP-IDF build files
build/
*.bin
*.elf
*.map
*.log

# SDK configuration
sdkconfig
sdkconfig.old

# Editor files
.vscode/
.idea/

# Python cache
__pycache__/
*.pyc

# CMake cache
CMakeFiles/
CMakeCache.txt
Makefile
cmake_install.cmake