← 포럼 · STM32
STM32

STM32CubeIDE 설치 및 첫 번째 프로젝트 생성하기

2026.11.05조회 21댓글 0

STM32 마이크로컨트롤러 개발을 처음 시작할 때 툴체인 설정과 라이브러리 구성은 다소 번거로울 수 있습니다. STM32CubeIDE는 코드 생성 도구와 C/C++ 개발 환경을 하나로 통합하여 입문자가 빠르게 개발을 시작할 수 있도록 돕습니다. 이 글에서는 STM32CubeIDE 설치 과정부터 프로젝트 생성, 그리고 간단한 LED 제어 코드 구현까지 다룹니다.

STM32CubeIDE 개요와 특징

STM32는 ARM Cortex-M 코어 등을 기반으로 하는 32비트 마이크로컨트롤러 제품군입니다. STM32CubeIDE는 하드웨어 핀 배치와 시계열 설정을 시각적으로 진행할 수 있는 그래픽 설정 기능과 에디터, 빌더, 디버거를 포함한 통합 개발 환경입니다. 최신 다운로드 정보 및 시스템 요구 사항은 제조사 공식 문서에서 확인하세요.

개발 환경 설치 및 프로젝트 생성

  1. 공식 웹사이트에서 사용 중인 운영체제에 맞는 STM32CubeIDE 설치 파일을 다운로드하여 설치를 진행합니다.
  2. 프로그램을 실행한 뒤 작업 파일을 저장할 워크스페이스(Workspace) 경로를 지정합니다.
  3. 상단 메뉴에서 File -> New -> STM32 Project를 선택합니다.
  4. Target Selector 창이 나타나면 사용 중인 보드 모델명이나 MCU 칩 품번을 검색해 선택하고 Next를 누릅니다.
  5. 프로젝트 이름을 입력하고 언어(C/C++)를 선택한 후 Finish를 눌러 프로젝트 생성을 완료합니다.

첫 번째 예제: LED 토글 코드 작성

프로젝트가 생성되면 .ioc 확장자를 가진 핀 설정 화면이 열립니다. 보드의 온보드 LED와 연결된 GPIO 핀을 GPIO_Output으로 설정한 뒤 저장하면 기본적인 초기화 코드가 자동으로 생성됩니다.

이후 Core/Src/main.c 파일을 열어 메인 루프 안에 아래 예제 코드를 작성합니다.

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 장비 이상 여부를 우선적으로 점검합니다.

참고 자료

공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.

댓글 · 문의 0

아직 댓글이 없습니다. 첫 질문을 남겨 주세요.

찾으시는 내용이 없다면

만들고 싶은 것이나 막힌 부분을 알려주시면 검토해 드립니다.