on
2024-06-03
05:00 AM
- edited on
2024-06-24
01:36 AM
by
Laurids_PETERSE
Since CMSIS V 5.8.0, the CMSIS-DSP libraries are supplied as an individual package. The advantage is to decouple the release cycles of DSP from the CMSIS-Core stuff. As a side-effect, the DSP libraries structure was changed and the steps described in the article: Configuring DSP libraries on STM32CubeIDE cannot be applied.
For that the aim of this article is to describe step by step: How to integrate this new CMSIS-DSP on an STM32 project.
Before you get started, open the ARM.CMSIS.pdsc file in \STM32Cube_FW_xx_Vx.x.x\Drivers\CMSIS folder with notepad to know which CMSIS version is included in the package.
The versions used in this tutorial are:
The following steps show how to integrate DSP libraries in your project when using STM32CubeIDE toolchain. For this demonstration, an example based on the STM32CubeF4 package version 1.28.0 is used.
1. Create a new project using STM32CubeMX and STM32F429-DISC1 board.
4. Copy these folders in the created folder:
<STM32Cube_Repository>\STM32Cube_FW_F4_V1.28.0\Drivers\CMSIS\DSP\Include
<STM32Cube_Repository>\STM32Cube_FW_F4_V1.28.0\Drivers\CMSIS\DSP\PrivateInclude
<STM32Cube_Repository>\STM32Cube_FW_F4_V1.28.0\Drivers\CMSIS\DSP\Source
5. For this example, only the SupportFunctions are used. For that, open the "Source" folder under "..\Drivers\CMSIS_DSP" and keep only the SupportFunctions (other folders can be removed).
Click on [Add] to include the new paths.
Add the ../Drivers/CMSIS_DSP/Include path and the ../Drivers/CMSIS_DSP/PrivateInclude path
File name |
Source | Comment code lines |
SupportFunctions.c |
Drivers\CMSIS_DSP\Source\ SupportFunctions |
|
SupportFunctionsF16.c |
Drivers\CMSIS_DSP\Source\ SupportFunctions |
|
9. Now, you can use the DSP libraries in your project. For that open main.c and add the required header file "arm_math.h" and declare the used variables:
#include "arm_math.h"
/* USER CODE BEGIN PD */
#define FFT_Length 1024
/* USER CODE END PD */
/* USER CODE BEGIN PV */
float32_t FFT_Input_Q15_f[50];
float32_t aFFT_Input_Q15[50];
/* USER CODE END PV */
10. Let us take the example of using the “arm_float_to_q15” function:
/* USER CODE BEGIN 1 */
arm_float_to_q15((float32_t *)&FFT_Input_Q15_f[0], (q15_t *)&aFFT_Input_Q15[0], FFT_Length*2);
/* USER CODE END 1 */
Note:
In conclusion, after following the steps outlined in this article, you should be able to add DSP libraries to a STM32 project. If you encounter any issues, we suggest that you create a post in the ST community for further assistance.
Hello KDJEM.1,
This works on my STM32U5 chip!
Thanks for the tutorial!
Thanks a lot!
BTW,
There are some mistakes in 7.
The path is wrong(but they're correct in the figure)
Click on [Add] to include the new paths.
Add the ../Drivers/CMSIS/CMSIS_DSP/Include path and the ../Drivers/CMSIS/CMSIS_DSP/PrivateInclude path <- Path here is wrong
Hello @Bruce_nForeTek and welcome to STCommunity 🙂,
Glad to know that this FAQ can help to integrate the DSP library with STM32U5.
Thank you for bringing the step 7 typo to our attention.
The typo is fixed.
Thank you again for the continued feedback; it is much appreciated!
Kaouthar
Hello @KDJEM.1
if I want to add the whole DSP library do I need to go through every folder and comment out every #include "file.c" in every .c file. This solution doesn't really seem that elegant, isn't there a possibility to add it through the CubeIDE just like its possible for FreeRTOS?
Julian