on - edited on by
Laurids_PETERSE
1. Introduction
STMicroelectronics offers BSPs (Board Support Packages) for all STM32 Evaluation and Nucleo boards as well as Discovery Kits. In this article we will see how to add a BSP to your STM32CubeIDE project.
2. Prerequisites
- Hardware:
- Mini USB cable to power and program the board
- STM32L496G-DISCO (rev B)
- Software: STM32CubeIDE
3. Theory
All ST’s STM32 boards include the microcontroller as well as basic components from button switches and LEDs to more advanced devices that include sensors, displays, etc. (check the documentation of the specific board of interest for the details). To help ease the use of the additional components, ST offers specific drivers in the BSPs for each board. These BSPs are included in each STM32 Cube Firmware Library.
In this article we will learn how to add a BSP to an STM32CubeIDE project. We will use the STM32L496G-DISCO kit and will see how to add the BSP, specifically the drivers for the display that is on the board.
We will then develop a short application that will initialize the LCD and display a message on it.
4. Steps
-
Open STM32CubeIDE
-
Create a new project using the STM32L496G-DISCO
-
Give a name to the project
For this article I will call my project “AddBSP”
-
Initialize all peripherals with their default settings:
To do this please click on Yes below:
This will create our template project.
-
Add BSP
During this step we will add the BSPs drivers we need for the STM32L496G-Discovery Kit to be able to have an application using the display in our case.
First open the directory where the project has been created. To find out where the project was created go to File -> Open Projects from File System:
This will open a window that indicates where the project is located, in my case:
“xxxxx” indicates the username in my case.
Now with an explorer open the directory where the project is located. The structure of the project should look like this:
Now go to the “Drivers” directory.
This is where we will be adding the BSP files.
In a second explorer window open the STM32CubeL4 FW Library folder that should be in the following location on your disk:
C:\Users\xxxxxxxxxx\STM32Cube\Repository\STM32Cube_FW_L4_Vx.y.z
Where “xxxxxxxxxx” is your username if you are using Windows and “Vx.y.z” is the version of the STM32Cube Library, in my case I am using the version 1.17.0.
In the STM32CubeL4 directory go to the Drivers directory to find the BSP:
Now copy this directory and paste it into the Drivers folder of your Project in the other window:
Delete the rest of the folder and keep only these ones which are relative to the STM32L496-Discovery Kit.
Now go to the Components directory and keep only the following components:
“Common” includes all the components that are available for any evaluation board. The folder, “mfxstm32l152”, is a companion of the STM32L4 which is required to be included due to dependencies in the drivers and “st7789h2” contains the components for the display on the STM32L496G-Discovery.
In the STM32L496G-Discovery we will keep only these files as we won't use all of the features of the board, we will use the display for this example.
Listed above are the absolute minimum files to have to be able to use the display drivers from the BSP.
We will also add the Utilities folder from the STM3Cube Library to our project because the BSP uses some of the files form this folder. You will find the Utilities folder of the at the root directory of the STM32L4Cube FW Library as shown below:
Copy and paste the folder into your Project directory like this:
Now go back to STM32CubeIDE. The project structure should be like this in the Project Explorer Window:
Now refresh the project by left clicking on the Project Name and selecting Refresh:
This will add the BSP folder and subfolders and all the source files to our project.
-
Project modification
Because of some drivers’ dependencies we need to add the Timer HAL drivers from the HAL Configuration file. Open stm32l4xx_hal_conf.h file located Under Core -> Inc from the Project Explorer and define HAL_TIME_MODULE_ENABLED to include the Timer drivers used by the BSP:
-
Adding code
We are going to add some functions provided by the BSP to use the on-board display. We will initialize the display and then use some of the BSP function to display a sentence on the display.
/* USER CODE BEGIN Includes */
#include "../../../Drivers/BSP/STM32L496G-Discovery/stm32l496g_discovery.h"
#include "../../../Drivers/BSP/STM32L496G-Discovery/stm32l496g_discovery_lcd.h"
/* USER CODE END Includes */
…
/* USER CODE BEGIN 2 */
/* LCD Init */
if (BSP_LCD_InitEx(LCD_ORIENTATION_PORTRAIT) == LCD_ERROR)
{
/* Initialization Error */
Error_Handler();
}
BSP_LCD_DisplayStringAt(0, 240 - 65, (uint8_t *)"BSP Example", CENTER_MODE);
/* USER CODE END 2 */
Note: if you don’t have an SD card inserted in the SD card slot of the Discovery Kit you will need to comment the Init of the SDMMC peripheral (//MX_SDMMC1_SD_Init();):
-
Now build the code, load it, and reset the board to start execution.
After the LCD is initialized, the text, “BSP Example”, will be displayed.
5. Related links
- Datasheet - STM32L496xx - Ultra-low-power Arm® Cortex®-M4 32-bit MCU+FPU, 100 DMIPS, up to 1 MB Flash, 320 KB SRAM, USB OTG FS, audio, external SMPS
- STM32L47xxx, STM32L48xxx, STM32L49xxx and STM32L4Axxx advanced Arm®-based 32-bit MCUs - Reference manual
- STM32CubeIDE - Integrated Development Environment for STM32 - STMicroelectronics
- 32L496GDISCOVERY - Discovery kit with STM32L496AG MCU - STMicroelectronics
- STM32CubeL4 - STM32Cube MCU Package for STM32L4 series and STM32L4 Plus series (HAL, Low-Layer APIs and CMSIS, USB, TouchSensing, File system, RTOS, Graphic - and examples running on ST boards) - STMicroelectronics
Hi Mattias,
Thanks for the ideas. Currently I need the LCD driver on STM32H747I-DISCO board. Once I can add it to a project then I am sure I can add any other BSP feature.
I had a version in which I had only one error: BSP_LCD_Init(0, LCD_ORIENTATION_LANDSCAPE); not defined.
What do I do wrong?
Thanks,
Louis
Did you place the stm32X_discovery.c file in a "source code folder? There is a difference between a "folder" and a "source code folder" in CubeIDE (Eclipse/CDT feature).
Have a look at the project structure in the project explorer view. The Source folder are indicated by the purple/white "c" icon decoration. The build system will only look for source files in this source folders.
You can turn a normal folder into a source folder by right-click on it > Resource configuration > Exclude from build > Deselect All build configurations.
Could this be the root-cause?
Hi Mattias,
I am afraid I can't follow you, more exactly Eclipse/CDT, but here is my project structure (Created by STM32CubeMX)
Thanks for your valuable help!
Louis
Hello @mattias norlander / Hello community members,
I am facing similar issue while adding the BSP to my project. Below is the screenshot of my workspace. I am using STM32h747I-Eval board.
What I did was I copied the BSP folder from "LCD_DSI_CmdMode_DoubleBuffer" example and pasted it on my project's 'drivers' folder. I get too many errors, I added paths to my BSP folder. Still the errors persists. What am I missing?
