esp-idf

ESP-IDF(에스프레시프 IoT 개발 프레임워크)는 Windows, Linux, macOS에서 지원되는 Espressif SoC용 공식 개발 프레임워크입니다. Espressif 칩을 대상으로 하며, 2016년 이전에 출시된 SoC(ESP8266 및 ESP8285)는 별도의 RTOS SDK에서 지원됩니다. 이 저장소는 릴리스 지원 일정, 수명 종료 공지, ESP-IDF 릴리스와 칩 개정판 간의 호환성을 문서화합니다. 각 SoC 시리즈와 각 ESP-IDF 릴리스에는 자체 문서가 있으며, README는 온라인 문서의 Versions 섹션을 가리켜 문서를 찾고 특정 릴리스를 체크아웃할 수 있도록 합니다. 시작하려면 호스트 빌드 종속성을 설치하고 설치 스크립트(Windows에서는 install.bat 또는 install.ps1, Unix 셸에서는 install.sh 또는 install.fish)를 실행한 다음, ESP-IDF를 사용하기 전에 각 셸에서 환경을 내보내야 합니다(Windows에서는 export.bat, Unix에서는 source export.sh). 템플릿 프로젝트(esp-idf-template)와 examples 디렉터리의 예제 프로젝트 세트가 제공됩니다. 예제에서 새 프로젝트를 시작하려면 예제 디렉터리를 ESP-IDF 트리 밖으로 복사합니다. 기본 워크플로는 idf.py 명령줄 도구를 사용합니다. `idf.py set-target <chip_name>`은 대상 칩을 선택하고, `idf.py menuconfig`는 텍스트 기반 구성 메뉴를 엽니다. `idf.py build`는 애플리케이션과 부트로더를 컴파일하고 구성에서 파티션 테이블을 생성합니다. 플래싱은 `idf.py -p PORT flash`로 수행되며, 새 칩에 앱, 부트로더 및 파티션 테이블을 쓰고 필요한 항목을 자동으로 다시 빌드합니다. 포트 옵션을 생략하면 사용 가능한 첫 번째 직렬 포트를 시도합니다. 직렬 출력은 `idf.py monitor`로 확인하며, esp-idf-monitor 도구를 사용하여 충돌 출력을 디코딩하고 장치와 상호 작용할 수 있습니다. Ctrl-]로 종료합니다. `idf.py flash monitor`는 빌드, 플래시, 모니터를 한 번에 결합합니다. 반복 작업의 경우 `idf.py app`은 앱만 빌드하고 `idf.py app-flash`는 앱만 플래시하며 소스가 변경되면 자동으로 다시 빌드합니다. `idf.py erase-flash`는 전체 플래시를 지우며 파티션 테이블 변경이나 OTA 업데이트에 유용하고 다른 대상과 결합할 수 있습니다. GitHub가 아닌 포크의 경우 README는 서브모듈 URL이 상대적이며 GitHub에 연결된다고 설명합니다. tools/set-submodules-to-github.sh 스크립트는 절대 URL을 설정하여 `git submodule update --init --recursive`가 완료될 수 있게 합니다. GitHub에서 클론할 때는 이 단계가 필요하지 않습니다. 리소스에는 docs 디렉터리에서 빌드된 온라인 문서, 초보자 가이드 비디오, 질문과 커뮤니티 리소스를 위한 esp32.com 포럼, 버그 및 기능 요청을 위한 GitHub Issues 섹션, 기여 가이드가 포함됩니다.