STM32CubeIDE i CubeMX - konfiguracja projektu krok po kroku

5 listopada 2026

Widok pinout w STM32CubeIDE, pokazujący układ wyprowadzeń mikrokontrolera STM32U385RGTXQ.

Masz płytkę Nucleo na biurku, ale po uruchomieniu STM32CubeIDE nie widzisz znanego widoku pinów? W nowszym wydaniu konfigurację mikrokontrolera nadal zrobisz narzędziami ST, choć STM32CubeMX działa osobno, a to zmienia kolejność pracy.

Konfiguracja projektu w STM Cube IDE: nazwa projektu, lokalizacja, ustawienia sterty i stosu, wybór narzędzi (Toolchain/IDE) oraz pakietu firmware.

Najważniejsza zmiana dotyczy konfiguracji projektu

  • STM32CubeIDE służy do edycji, kompilacji i debugowania kodu dla mikrokontrolerów i procesorów STM32.
  • STM32CubeMX pobiera się i uruchamia oddzielnie, aby skonfigurować układy peryferyjne oraz wygenerować kod.
  • Projekt utworzony w CubeMX trzeba wygenerować z docelowym narzędziem STM32CubeIDE, a potem zaimportować do IDE.
  • Gdy potrzebujesz gotowego przepływu od konfiguracji po debugowanie, CubeIDE jest dobrym startem; przy własnym systemie budowania sprawdź obsługę CMake.

STM32CubeIDE prowadzi od kodu C do debugowania na płytce

Podłączenie ST-LINK i napisanie pierwszej funkcji to dopiero początek. STM32CubeIDE łączy edytor C/C++, kompilator, narzędzia budowania projektu i debugger, więc możesz przejść od źródeł do uruchomienia programu na układzie STM32 w jednym środowisku. To narzędzie dla rodzin STM32, nie uniwersalny IDE do dowolnego mikrokontrolera.

W praktyce kompilator tworzy plik wynikowy, a debugger pozwala zatrzymać program na breakpointcie, sprawdzić wartości zmiennych i prześledzić wykonanie. ST opisuje środowisko w instrukcji STM32CubeIDE jako platformę dla oprogramowania STM32, opartą między innymi na Eclipse CDT i łańcuchach narzędzi GCC oraz LLVM.

Uważam, że największą zaletą IDE jest spięcie kompilacji z debugowaniem, a nie sam edytor. Przy prostym programie migającym diodą oszczędza to przełączania między narzędziami; przy bardziej rozbudowanym projekcie pozwala szybciej namierzyć, czy błąd leży w kodzie, konfiguracji czy komunikacji z płytką.

STM32CubeMX konfiguruje układ poza IDE

Brak widoku pinów w CubeIDE może wyglądać jak błąd instalacji, szczególnie gdy korzystasz ze starszego poradnika. Od wersji 2.0 STM32CubeMX jest osobnym programem: tam wybierasz mikrokontroler lub płytkę, ustawiasz piny i peryferia, a następnie generujesz projekt dla STM32CubeIDE. Zmianę opisuje komunikat ST o wydaniu STM32CubeIDE 2.0.0.

Wygenerowany projekt przenosisz do IDE przez import istniejącego projektu. To rozdzielenie może być wygodne, jeśli chcesz niezależnie aktualizować CubeMX i środowisko programistyczne. Ma też koszt: trzeba zainstalować dwa narzędzia, a stary tutorial pokazujący konfigurację bezpośrednio w IDE nie musi pasować do nowszego przepływu.

Jeśli po imporcie projekt nie ma poprawnych opcji budowania, sprawdź ustawienie docelowego narzędzia w CubeMX. Dla projektu przeznaczonego do STM32CubeIDE wybierz STM32CubeIDE jako Toolchain/IDE, wygeneruj pliki ponownie i zaimportuj katalog zawierający pliki projektu Eclipse.

Wybór wersji zależy od rodziny układu i sposobu budowania

Przy instalacji łatwo skupić się na numerze wydania, a przeoczyć obsługę konkretnego układu. W oficjalnej dokumentacji wydania STM32CubeIDE 2.2.0 ST wymienia między innymi wsparcie dla STM32V8 oraz nowych układów z rodzin STM32H5 i STM32U3. Są tam również aktualizacje platformy Eclipse CDT, CMake i obsługi debugowania. Szczegóły publikuje nota wydania STM32CubeIDE 2.2.0.

Nie wynika z tego, że każda nowa wersja jest automatycznie najlepsza dla każdego projektu. Najpierw sprawdź dokładny symbol mikrokontrolera na liście obsługiwanych urządzeń, a potem porównaj wersję z narzędziami i bibliotekami, które już wykorzystuje projekt. W przypadku projektu zespołowego aktualizacja IDE może zmienić konfigurację budowania lub wymagać uzgodnienia wersji z resztą zespołu.

Twoja sytuacja Co może być przyczyną Co zrobić
Nie ma widoku pinów ani konfiguracji peryferiów Oczekujesz funkcji CubeMX wewnątrz IDE Uruchom osobny STM32CubeMX i skonfiguruj układ tam.
Projekt po imporcie nie ma poprawnych opcji budowania Pliki wygenerowano dla innego toolchainu albo importujesz niewłaściwy katalog Ustaw STM32CubeIDE jako Toolchain/IDE w CubeMX, wygeneruj projekt ponownie i zaimportuj katalog projektu.
Nie możesz wybrać swojego mikrokontrolera Wersja IDE może nie zawierać jego obsługi Sprawdź listę wspieranych układów w informacjach o wydaniu i dobierz wersję do symbolu MCU.
Kompilacja przechodzi, ale program nie startuje na płytce Problem może dotyczyć konfiguracji debuggera, połączenia ST-LINK albo ustawień projektu Sprawdź wybraną konfigurację debugowania i połączenie z płytką, a potem uruchom debugowanie z breakpointem.

CMake albo gotowy projekt Eclipse: wybierz pod swój przepływ

Jeśli uczysz się STM32 na płytce Nucleo, łatwiej zacząć od projektu generowanego dla STM32CubeIDE. Dostajesz znany przepływ dla IDE i debugowanie bez ręcznego składania całego środowiska. Przy istniejącym projekcie CMake decyzja wygląda inaczej: sprawdź, czy da się go włączyć do CubeIDE bez przebudowy systemu kompilacji.

W wydaniu 2.2.0 ST wymienia obsługę presetów CMake oraz szablon biblioteki statycznej. To przydatne, gdy kod ma być budowany także poza interfejsem IDE, na przykład w procesie ciągłej integracji. Jeśli projekt opiera się na własnych skryptach lub narzędziach zespołu, sprawdź ich zgodność przed migracją.

Jeśli zaczynasz od pojedynczej płytki i potrzebujesz konfiguracji oraz debugowania, wybierz STM32CubeIDE wraz z CubeMX. Gdy najważniejszy jest przenośny projekt CMake albo praca w innym edytorze, najpierw sprawdź dostępne narzędzia ST dla tego przepływu. Taki wybór lepiej wynika z budowania i debugowania projektu niż z samego wyglądu edytora.

Pierwszy udany build zaczyna się od zgodnego projektu

Gdy stary poradnik nie zgadza się z ekranem, który widzisz, nie zakładaj od razu, że instalacja jest uszkodzona. Sprawdź wersję CubeIDE, otwórz CubeMX osobno i potwierdź docelowy toolchain przed generowaniem kodu. W wielu przypadkach właśnie ten rozdział narzędzi wyjaśnia, dlaczego menu lub widok projektu wygląda inaczej.

Do pierwszej próby wybierz znaną płytkę, wygeneruj kod, zaimportuj projekt i uruchom debugowanie z podłączonym ST-LINK. Gdy kompilacja się powiedzie, ale program nie ruszy, przechodź po kolei przez konfigurację debuggera i połączenie sprzętowe, zamiast od razu przebudowywać cały projekt.

FAQ - Najczęstsze pytania

Od wersji 2.0 STM32CubeMX działa jako osobny program. Wybierz w nim mikrokontroler lub płytkę, skonfiguruj piny i peryferia, a następnie wygeneruj projekt dla STM32CubeIDE.

W STM32CubeMX ustaw STM32CubeIDE jako Toolchain/IDE i wygeneruj pliki ponownie. Następnie zaimportuj do IDE katalog projektu zawierający pliki Eclipse.

STM32CubeIDE pozwala edytować kod C/C++, kompilować go i debugować na układzie STM32. Debugger umożliwia między innymi zatrzymanie programu na breakpointcie, sprawdzenie wartości zmiennych i prześledzenie wykonania.

Projekt generowany dla STM32CubeIDE to prosty start, gdy pracujesz na płytce i chcesz korzystać z konfiguracji oraz debugowania w IDE. Jeśli projekt ma już własny system budowania CMake lub ma być budowany poza IDE, sprawdź zgodność narzędzi przed migracją; STM32CubeIDE 2.2.0 wymienia obsługę presetów CMake.
Oceń artykuł

Średnia: 0.0 / 5 · 0 ocen

Tagi

stm32cubeide cmake st-link debugowanie stm32cubemx

Udostępnij artykuł

Komentarze (0)
Dodaj komentarz