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.

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.