← 포럼 · STM32
STM32
STM32CubeIDE 설치 및 첫 번째 프로젝트 생성하기
STM32 마이크로컨트롤러 개발을 처음 시작할 때 툴체인 설정과 라이브러리 구성은 다소 번거로울 수 있습니다. STM32CubeIDE는 코드 생성 도구와 C/C++ 개발 환경을 하나로 통합하여 입문자가 빠르게 개발을 시작할 수 있도록 돕습니다. 이 글에서는 STM32CubeIDE 설치 과정부터 프로젝트 생성, 그리고 간단한 LED 제어 코드 구현까지 다룹니다.
STM32CubeIDE 개요와 특징
STM32는 ARM Cortex-M 코어 등을 기반으로 하는 32비트 마이크로컨트롤러 제품군입니다. STM32CubeIDE는 하드웨어 핀 배치와 시계열 설정을 시각적으로 진행할 수 있는 그래픽 설정 기능과 에디터, 빌더, 디버거를 포함한 통합 개발 환경입니다. 최신 다운로드 정보 및 시스템 요구 사항은 제조사 공식 문서에서 확인하세요.
개발 환경 설치 및 프로젝트 생성
- 공식 웹사이트에서 사용 중인 운영체제에 맞는 STM32CubeIDE 설치 파일을 다운로드하여 설치를 진행합니다.
- 프로그램을 실행한 뒤 작업 파일을 저장할 워크스페이스(Workspace) 경로를 지정합니다.
- 상단 메뉴에서
File->New->STM32 Project를 선택합니다. - Target Selector 창이 나타나면 사용 중인 보드 모델명이나 MCU 칩 품번을 검색해 선택하고
Next를 누릅니다. - 프로젝트 이름을 입력하고 언어(C/C++)를 선택한 후
Finish를 눌러 프로젝트 생성을 완료합니다.
첫 번째 예제: LED 토글 코드 작성
프로젝트가 생성되면 .ioc 확장자를 가진 핀 설정 화면이 열립니다. 보드의 온보드 LED와 연결된 GPIO 핀을 GPIO_Output으로 설정한 뒤 저장하면 기본적인 초기화 코드가 자동으로 생성됩니다.
이후 Core/Src/main.c 파일을 열어 메인 루프 안에 아래 예제 코드를 작성합니다.
/* 메인 루프 시작 */
while (1)
{
/* GPIOA 5번 핀의 출력 상태를 반전시킵니다 (보드 사양에 맞게 포트와 핀 수정) */
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
/* 1000밀리초(1초) 동안 대기합니다 */
HAL_Delay(1000);
}코드를 작성한 후 상단 메뉴의 빌드 버튼을 눌러 컴파일하고, 디버그 버튼을 눌러 타깃 보드에 프로그램을 다운로드하여 작동을 확인합니다.
자주 겪는 문제
- 증상: 디버깅 연결 시 ST-LINK 관련 오류가 발생하며 다운로드가 실패함.
- 원인: ST-LINK 디버거의 USB 연결이 불안정하거나 드라이버 인식 문제, 또는 디버거 하드웨어 불량이 원인일 수 있습니다.
- 해결: USB 케이블을 다시 연결하거나 장치 관리자에서 ST-LINK 드라이버 상태를 확인하고, 다른 디버거 장비로 교체하여 테스트합니다.
- 증상:
.ioc파일에서 핀 설정을 변경했으나 실제 코드에 반영되지 않음. - 원인: 핀 설정 변경 후 코드 생성(Code Generation) 과정을 거치지 않음.
- 해결:
.ioc파일을 저장할 때 나타나는 코드 생성 확인 창에서 'Yes'를 클릭하거나, 메뉴의 Code Generation 아이콘을 눌러 코드를 다시 생성합니다. - 증상: 소스 코드 내부의 한글 주석이 깨져서 출력됨.
- 원인: 개발 환경의 기본 파일 인코딩 설정이 UTF-8과 일치하지 않음.
- 해결:
Window->Preferences메뉴로 이동하여General->Workspace항목의 Text file encoding을 UTF-8로 변경합니다.
정리
- STM32CubeIDE를 사용하면 그래픽 핀 설정과 C/C++ 코드 작성을 하나의 도구에서 처리할 수 있습니다.
- 프로젝트 생성 후
.ioc파일 설정과 HAL 라이브러리 함수를 활용해 기초적인 GPIO 출력을 구현할 수 있습니다. - 디버거 인식이 안 될 때는 연결 상태와 ST-LINK 장비 이상 여부를 우선적으로 점검합니다.
참고 자료
- How to Debug in STMCubeIDE? — Stack Exchange stackoverflow · CC BY-SA
- STM32 — Wikipedia · CC BY-SA
- AskeCarstensen/STM32-Getting-started — GitHub · MIT
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.