ESP32 30핀 확장보드 핀 역할표
USB 포트를 위쪽으로 두고 보드를 정면에서 봤을 때의 일반적인 ESP32 DevKit V1 30핀 배열입니다. 제조사마다 실크 인쇄가 조금 다를 수 있으므로 실제 보드에 적힌 핀 이름을 최우선으로 확인하세요.
마이크로파이썬 개발 환경 구축
0단계: 웹 브라우저로 펌웨어 설치 (가장 쉬운 방법)
크롬(Chrome)이나 엣지(Edge) 브라우저를 사용하면 복잡한 프로그램 설치 없이 웹에서 바로 ESP32에 MicroPython 펌웨어를 올릴 수 있습니다.
- MicroPython 공식 사이트에서 ESP32용 .bin 펌웨어 파일을 다운로드합니다.
- Adafruit WebSerial ESPTool 사이트에 접속합니다.
- 우측 상단의 Connect를 누르고 ESP32가 연결된 포트를 선택합니다. (보드에 따라 연결 시 BOOT 버튼을 누르고 있어야 할 수 있습니다)
- 파일 선택 창에 다운로드한 .bin 파일을 넣고, Offset 주소를
0x1000으로 설정한 뒤 Program 버튼을 클릭하여 설치를 완료합니다.
1단계 (초보자용): Thonny IDE 코딩
- 파이썬 코딩을 위해 Thonny IDE를 다운로드하고 설치합니다.
- 우측 하단의 인터프리터 설정에서 MicroPython (ESP32)와 연결된 포트(COM)를 선택합니다.
- 코드를 작성하고 상단의 재생(Run) 버튼을 눌러 보드에서 바로 실행합니다.
PRO
고수용: VS Code + mpremote + Type Stub
플러그인의 잦은 연결 오류가 싫고 가벼운 툴을 원한다면,
마이크로파이썬 공식 CLI 툴인 mpremote와
자동 완성용 스텁(Stub) 파일을 함께 쓰는 방법입니다. 확장 프로그램의 동작과 관계없이 ESP32 전용 내부 함수(machine, network 등)의 자동 완성을 지원합니다.
구축 및 사용 방법
-
PC 터미널 도구 설치:
pip install mpremote micropython-stubber
-
VS Code 터미널 명령어 활용:
- $
mpremote run main.py# 보드에서 즉시 실행 - $
mpremote cp main.py :main.py# 보드로 파일 복사
- $
micropython-stubber를 통해 빨간 줄(에러 표시)을 줄이고 자동 완성을 사용해 보세요.