← 포럼 · STM32
STM32
STM32CubeProgrammer를 활용한 펌웨어 바이너리(.bin, .hex) 업로드
STM32 칩셋 기반 장치를 개발할 때 통합 개발 환경(IDE) 없이 완성된 바이너리 파일(.bin 또는 .hex)을 보드에 펌웨어로 업로드해야 하는 상황이 자주 발생합니다. STMicroelectronics에서 제공하는 STM32CubeProgrammer를 활용하면 ST-LINK 인터페이스나 시리얼 통신을 통해 안전하게 펌웨어를 기록할 수 있습니다. 이 글에서는 툴을 활용해 펌웨어 바이너리를 타깃 장치에 올리는 전체 과정과 연결 문제 해결법을 다룹니다.
펌웨어 바이너리 파일 유형과 연결 방식
- .hex 파일: 메모리 주소 정보가 포함된 텍스트 형식입니다. 주소 정보가 저장되어 있어 칩의 특정 메모리 영역에 정확히 배치하기 쉽습니다.
- .bin 파일: 순수한 바이너리 데이터 덩어리입니다. 업로드 시 시작 주소(예: 0x08000000)를 사용자가 직접 지정해야 합니다.
- 연결 인터페이스: 주로 ST-LINK(SWD 방식)를 사용하며, 디바이스 상태에 따라 UART 시리얼이나 USB DFU 방식으로도 연결할 수 있습니다.
STM32CubeProgrammer를 통한 펌웨어 업로드 단계
- 디바이스 연결: 타깃 보드와 ST-LINK를 연결(SWDIO, SWCLK, GND, 3.3 V)한 뒤 프로그램 우측 상단에서 ST-LINK를 선택하고 Connect 버튼을 누릅니다.
- 바이너리 파일 불러오기: 왼쪽 탭에서 Erasing & Programming 메뉴를 선택한 뒤 업로드할 파일 경로를 지정합니다.
- 시작 주소 설정:
.bin파일인 경우 Start address 항목에 기본 플래시 시작 주소인0x08000000을 입력합니다. (.hex파일은 주소가 자동으로 채워집니다.) - 쓰기 및 검증: Verify programming 항목을 체크한 뒤 Start Programming을 눌러 업로드를 진행합니다.
명령줄 인터페이스(CLI)를 사용하면 빌드 자동화 스크립트에 펌웨어 업로드 과정을 쉽게 통합할 수 있습니다.
# ST-LINK를 사용하여 0x08000000 주소에 firmware.bin 파일 업로드 및 검증 수행 후 리셋
STM32_Programmer_CLI -c port=SWD -w firmware.bin 0x08000000 -v -rst자주 겪는 문제
- 증상: ST-LINK 연결 시 타깃 MCU를 인식하지 못하고 연결 실패 오류가 발생합니다.
- 원인: MCU의 BOOT0 핀 설정이 잘못되었거나 이전 펌웨어가 SWD 핀을 일반 입출력(GPIO) 기능으로 재정의하여 통신이 차단되었을 수 있습니다.
- 해결: BOOT0 핀을 1(3.3 V)로 설정하여 부트로더 모드로 진입시킨 후 보드를 리셋합니다. 프로그램에서 연결을 시도하여 성공하면 전체 칩 소거(Full Chip Erase)를 수행합니다. 소거 완료 후 BOOT0 핀을 다시 0(GND)으로 변경하고 리셋하여 정상 연결을 확인합니다.
- 증상:
.bin파일 업로드 후 보드가 정상적으로 동작하지 않습니다. - 원인: 시작 주소(Start Address)를 잘못 지정하여 펌웨어가 플래시 메모리의 잘못된 위치에 기록되었습니다.
- 해결: 대상 MCU의 데이터시트에서 제공하는 플래시 메모리 시작 주소(예:
0x08000000)를 확인하고 올바르게 지정하여 다시 업로드합니다. - 증상: 펌웨어 업로드 도중 통신 오류가 발생하며 멈춥니다.
- 원인: 전원 공급이 불안정하거나 저가형 ST-LINK 모듈의 통신 신호 인식이 불완전한 상태일 수 있습니다.
- 해결: 타깃 보드에 외부 전원을 안정적으로 공급하고 통신 배선 길이를 줄여 신호 품질을 확보합니다.
정리
STM32CubeProgrammer는 GUI와 CLI 환경 모두에서 .bin 및 .hex 바이너리 펌웨어를 안전하게 기록할 수 있는 공식 도구입니다.
.bin 파일 업로드 시 시작 주소(0x08000000) 설정을 확인하고, 연결 장애 발생 시 BOOT0 핀 조절과 칩 전체 소거 과정을 통해 복구할 수 있습니다.
자동화가 필요한 개발 환경에서는 CLI 명령어를 활용하여 펌웨어 배치 작업을 효율화할 수 있습니다.
참고 자료
- stlink v2 clone and "blue pill" board - blue/red LED meaning and problems getting started — Stack Exchange stackoverflow · CC BY-SA
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.