ESP-IDF VScode Window 개발환경 구축

ESP-IDF 다운로드

https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/windows-setup.html

Standard Setup of Toolchain for Windows - ESP32 - — ESP-IDF Programming Guide latest documentation

인스톨러를 다운받아 실행시키면 된다.

 

VScode 설정

터미널에 명령어를 직접 칠 것이므로 ESP 확장은 설치하지 않아도 된다.

 F1 -> settting json 입력(키워드 검색) -> Open User setting 선택 후 아래 코드 붙여넣기

	"terminal.integrated.profiles.windows": {
		"ESP_IDF_CMD": {
			"path": [
				"${env:windir}\\Sysnative\\cmd.exe",
				"${env:windir}\\System32\\cmd.exe"
			],
			"args": ["/k", "C:/Espressif/frameworks/esp-idf-v5.1-rc1/export.bat"],
			"icon": "terminal-cmd"
		}
	}

*여기서 args에 /k 옵션 뒤 따라오는 경로는 자신에게 맞게 수정

*cmd를 열때 args가 순서대로 모두 입력되서 실행된다. ex) cmd.exe /k C:/Espressif/frameworks/esp-idf-v5.1-rc1/export.bat

export.bat는 idf.py에 필요한 환경변수를 추가해주는 역할을 함

 

idf 사용법

1.프로젝트 생성
원하는 폴더에 VScode를 연 다음 IDF CMD에서 

idf.py create-project -p . <name>

으로 project를 생성

 

F1 -> C/C++:Edit Configuration (JSON)을 검색하여 선택(or 헤더파일의 빨간줄의 전구를 클릭해서 Edit Include Path를 눌러도 c_cpp_properties.json이 생성됨)

c_cpp_properties.json, includePath에
"C:/Espressif/**"
이렇게 idf 경로를 추가해줘야 intelisense가 제대로 작동함(이걸로도 안되면, build후 후술할 compile_command.json을 이용)

 

2.menuconfig

start idf.py menuconfig

(VScode CMD 창에서는 방향키 커서이동이 안됨, start로 별도의 창에서 실행해야함)
componet config 에서 ESP System Setting에 가면 CPU 클럭을 설정할 수 있음
Serial flasher config에서 Flash 사이즈 맞추기(플래시 사이즈가 맞지 않으면 idf.py -p <port> flash monitor했을 때 사이즈가 맞지 않다면서 경고가 뜸)

 

3.build

첫 빌드가 느리고,  compile_command.json을 이용하기 위해 아무것도 없는 상태에서 빌드 한번 진행하는 것을 추천

idf.py build

(첫빌드는 만들어낼 파일을 많아서 느리고 이후로는 빠르게 진행됨, 그리고 menuconfig의 내용이 바뀌어도 build 폴더 내부를 뜯어고친다고 다음 빌드가 오래걸리게 됨)

빌드를 하고 난 다음 VScode 창을 껏다가 다시키면 compile_command.json을 이용하여
InteliSense 구성을 설정하시겠습니까?라고 창이 뜨는데 Yes 해야 includePath 문제없이 제대로 InteliSense가 작동함(반드시는 아님 일부 라이브러리는 이래야지만 빨간줄이 안보임)

 

4.업로드

idf.py -p <port> flash #업로드만
idf.py -p <port> flash monior #업로드 완료후 자동으로 시리얼 모니터가 열림, 디버깅하기 좋음
idf.py -p <port> monitor #시리얼 모니터만 열림
#idf 시리얼 모니터의 종료는 ctrl + ]

 

Serial 입력을 하고 싶다면, VScode에서 주는 시리얼 모니터를 이용하자