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
I had a project working with the CMSIS 5.8.0 but wanted to update it to use CMSIS 5.9.0. I followed your steps, but things are not working as expected. I get an undefined reference to `arm_fir_init_f32' error when I try to compile, which is the first function I try to use from CMSIS-DSP. To be clear, I removed the arm_cortexm4lf_math library that I used to need. I did not comment anything out of any .c files, so all functions should be available. Do you have any idea what the problem might be? Thank you so much for your advice!
Edit: Since I did not put my DSP folder inside Drivers folder, I had to add DSP folder as Source Location. Then the DSP functions were located, but tons of complaints about multiple definitions. Originally I thought you were commenting out stuff in SupportFunctions.c and SupportFunctionsF16.c because you weren't using those bits, but wow those <foldername>.c and <foldername>F16.c files have to be commented out or deleted in every folder a person keeps in their project! So I did all that and my code compiles, but I am still not all the way there. My filter code that worked with the previous CMSIS-DSP setup (with the arm_cortexm4lf_math library and all) now does not work and causes all kinds of strange behaviours. Still wrestling. Will report back if/when I figure it out.
Further edit: Code was fine, but my filter with 101 coefficients that worked fine before now takes too long for my 1024 half DMA buffer. If I reduce to a filter with 81 coefficients, everything is OK. Surprised that the previous setup for CMSIS-DSP would be faster then the new setup. Other interesting note: the output of my code completely dies (even talk-through, no filter) when I set -Ofast flag.
Hello @JvdV,
Which error did you get about "arm_fir_init_f32.c"?
If you encounter any issues, we suggest that you create a post in the ST Community for further assistance.
To check the issue could you please share your project when you create a new thread in the community?
Thank you.
Kaouthar