1. Presentation
This page describes how to easily build and install STM Bluetooth® LE SIG example application.
Example projects can be found on STM32CubeWBA MCU Package[1], and are available for different platforms.
ST Bluetooth® LE example project directory |
---|
Some of the following information can be retrieved from STM32WBA application note.
2. Requirements
2.1. Software and system requirements
The software required are the following (minimum IDEs version):
- IAR Embedded Workbench for ARM (EWARM) toolchain V9.20.1, plus a patch available in Utilities/PC_Software/EWARMv8_STM32WBAx_V1.2.zip
- RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.37, plus a patch available in Utilities/PC_Software/Keil.STM32WBAx_DFP.1.0.0.zip
- STM32CubeIDE toolchain V1.12.0 [2].
Programmer:
- STM32CubeProgrammer[3] : To flash the board with an already generated binary
2.2. Hardware requirements
NUCLEO-WBA5 [4] is necessary to install the application.
Hardware platforms illustration |
---|
More details about the board and other hardware requirement are available in the Bluetooth® LE SIG and 802.15.4 Nucleo pack user manual[5]. LINK TO UPDATE
3. BLE Stack Libraries compatibilities
Information about the BLE Stack library and the different BLE Stack configurations for STM32WBA projects are available in: Middlewares/ST/STM32_WPAN/ble/stack/doc/STM32WBA_BLE_Stack_User_Manual.html
Different BLE Stack variants are available in STM32WBA package, depending on project requirements:
- stm32wba_ble_stack_full.a: full host stack + ST LL controller, requires LinkLayer_BLE_Full_lib.a to work.
- stm32wba_ble_stack_basic.a: basic host stack + ST LL controller (basic features), requires LinkLayer_BLE_Basic_lib.a to work.
- stm32wba_ble_stack_llo.a: ST LL controller only, requires LinkLayer_BLE_Full_lib.a to work.
- stm32wba_ble_stack_llobasic.a: ST LL controller (basic features) only, requires LinkLayer_BLE_Basic_lib.a to work.
4. Build and install the application
This section describes the build process using IAR and STM32Cube IDE.
4.1. IAR IDE
Select the application you want to build, open the IAR (EWARM) dedicated directory and launch the project.eww IAR file to open the demonstration project on IDE.
IAR project directory |
---|
|
Ensure your project is correctly visible into the Project Explorer view.
Build your project by reproducing the following steps:
IAR: build |
---|
You can build and flash the project on your board by clicking on the button as illustrated below:
IAR: build and flash |
---|
4.2. Cube IDE
Select the application you want to build, open the STM32CubeIDE dedicated directory and launch the Cube IDE .project of the demonstration.
CubeIDE project folder |
---|
|
Ensure your project is correctly visible into the Project Explorer view.
Build you project by reproducing the following steps:
CubdeIDE: build |
---|
Flash it on the board:
CubdeIDE: flash |
---|
4.3. Install the application from STM32CubeProgrammer
It is possible either to flash the previously build binary using STM32CubeProgrammer software[6].
Select your device and connect to it:
CubeProgrammer: platform connection |
---|
Once connected, the device information is displayed on Cube Programmer interface. Click on the programming icon, in the left column, and select the project binary to flash:
- STM32Cube_FW_WBA_V[...]\Projects\[...]\Applications\BLE\BLE_p2pServer\[...]\ BLE_p2pServer.bin
Set the Start address to 0x08000000, For OTA application refer to readme file.
Then, click ok Start Programming button:
CubeProgrammer: flash project |
---|
When the programming is complete the following logs are displayed:
CubeProgrammer: logs |
---|
5. References