VSCode와 STM32용 Xbuild MCU

Xbuild MCU: STM32 프로젝트 빌드를 위한 VSCode 확장

STM32 개발자들은 종종 STM32CubeIDE 같은 번거로운 Eclipse 기반 IDE에 골머리를 앓습니다. 여기 Xbuild MCU가 등장합니다. 이 VSCode 확장은 프로젝트 자동 생성, Lua 기반 Xmake 빌드, CubeMX 가져오기, Cortex-Debug 통합을 모두 처리해줍니다. 편집, 컴파일, 플래싱까지 하나의 원활한 환경에서 가능—더 이상 앱 전환에 신경 쓸 필요 없습니다.

이 확장은 중급에서 고급 개발자를 타깃으로 합니다. 정확한 기술 용어를 고수하며 GCC/G++, JLink, Git 서브모듈을 지원합니다. 실제 프로젝트에서 검증됐지만 여전히 활발히 발전 중입니다.

초기 프로젝트 생성 및 설정

VSCode에서 빈 폴더를 엽니다. 확장이 누락된 xmake.lua를 감지하고 생성을 제안합니다. MCU 프리셋(예: STM32F103)을 선택하고 경로를 설정하세요:

• JLINK_PATH: JLink.exe 경로 (예: c:/Programs/JLink_V872a/JLink.exe).
• STM32_SDK: STM32CubeIDE의 ARM GCC 경로 (예: c:/ST/STM32CubeIDE_1.19.0/STM32CubeIDE/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.14.3.rel1.win32_1.0.0.202510090749/tools).

MCU 섹션에서 정의와 포함 경로를 추가합니다. "STM32F103 기본값으로 재설정" 버튼으로 시작한 후 프로젝트에 맞게 조정하세요. 값은 CubeIDE에서 직접 가져옵니다.

CubeMX 가져오기: .ioc 파일을 지정하세요. startup 파일, 링커 스크립트, HAL 드라이버를 복사합니다. main.c와 사용자 코드는 그대로 유지—커스텀 설정에 딱입니다.

Git 서브모듈 및 템플릿 관리

VSCode 사용자 설정에서 회사 서브모듈 목록을 등록하세요. 확장이 추가/제거를 위한 원클릭 버튼을 제공합니다.

프로젝트 구조를 위해 루트에 templates 폴더를 배치하세요(최선은 Git 서브모듈). 생성 시 템플릿에서 폴더, 파일, 정의를 만들고 정리합니다.

자동으로 .vscode/launch.json을 생성해 Cortex-Debug를 지원합니다.

빌드, 최적화 및 분석

Debug/Release 구성과 최적화 레벨(-O0, -O1, -Os, -O2, -O3)을 지원합니다. 빌드 후 Flash/RAM 사용량을 퍼센트로 표시—ESP-IDF처럼요.

드롭다운에서 최적화 옵션과 설명:

• -O0: 최적화 없음, 디버깅에 최적.
• -O1: 최소 최적화.
• -O2: 속도 대폭 향상.
• -O3: 최대 속도, 디버깅 어려움.
• -Os: 크기 중심 최적화.

Doxygen 설치됐나요? 프로젝트 문서를 자동 생성합니다.

주요 특징

• xmake.lua와 .vscode/launch.json 자동 생성으로 수동 설정 최소화.
• CubeMX 파일 가져오되 사용자 코드 보존.
• 팀 워크플로를 위한 Git 서브모듈과 템플릿 원활 지원.
• 매 빌드 후 메모리 사용량 분석.
• 문서화를 위한 내장 Doxygen 지원.

모든 상황에 맞는 만능 도구는 아닙니다. 특정 요구에 맞춰 제작됐지만 Lua 스크립트와 템플릿으로 확장 가능합니다. VSCode에서 STM32 개발 시 CubeIDE의 가벼운 대안입니다.

— Editorial Team