Introduction
ST provides several X-CUBE source packages for STM32 on st.com with STM32CubeIDE project files. To open the projects in STM32CubeIDE, there are several ways.
Note: some X-CUBE packages are also provided in STM32CubeMX as installable "packs". They are visible in STM32CubeMX in the "Software packs" menu. If the software you are looking for is not in the list, it may be because it is not packaged as a "CMSIS pack". It may be available as a .zip file on st.com. See the instructions below to get and open it in the STM32CubeIDE workspace.
1. Project installation
On the st.com web site, use the search function to find your X-CUBE software package.
The downloaded file is a .zip file. Unzip it. If you are using a Windows operating system, unzip it at a location near the root of your file system. Some projects have long paths for sources and it may cause problems during compilation.
Next, there are two different ways explained below to open the project in STM32CubeIDE.
2. Open from your file explorer
One way to open a STM32CubeIDE project is to double-click on STM32CubeIDE project files to launch STM32CubeIDE and open them.
The STM32CubeIDE project files are named ".project" and ".cproject". They are usually located in the STM32CubeIDE\ folder.
In your operating system file explorer, find the .project and .cproject files and double-click on one of them. If STM32CubeIDE was correctly installed, the file extensions are associated with STM32CubeIDE and cause the software to launch.
When launched, STM32CubeIDE asks for workspace location. It is a directory where STM32CubeIDE stores internal configuration files. Preferably choose a workspace location different than the project location.
2.1 Open from STM32CubeIDE
Another way to open a STM32CubeIDE project is to use the "File -> Import" menu.
- Start STM32CubeIDE
- Choose a workspace location (preferably different from your project location)
- Open STM32CubeIDE menu "File -> Import..."
- In the "Import" window, select "General -> Existing Projects into Workspace". Click on Next.
- At line "Select root directory", click on "Browse..."
- Navigate to the directory of the project's .project and .cproject files. Click on "Select folder".
- STM32CubeIDE displays what project was found. Select the project you want to import. Click on "Finish."
