on - edited on by
Laurids_PETERSE
Summary
This article shows how to integrate a library, in the form of an achieve file (*.a) in your project, so you can use the functions of the library with a simple header file.
Introduction
A library can be defined as a set of nonvolatile resources that are used by computer programs. This means avoiding the need to write specific codes from scratch. These resources could be functions, documentation, configuration data, objects, subroutines, and many other functionalities. When a program invokes a library, all the functioning processes happen inside that library and not in the program itself.
In many programming environments, there is already a standard library used for the compiled language containing the system services most needed. Even so, since library code is used by different noncorrelated programs, there is also the possibility to use external libraries.
This article has the goal to instruct on adding external libraries to the STM32CubeIDE interface. This is demonstrated by using the X-CUBE-CRYPTOLIB as an example.
1. Prerequisites
To follow this article’s proposal, the STM32CubeIDE version 1.10.0 or later software and the desirable external library is required.
2. Steps
The following steps show how to add the library on the STM32CubeIDE. For this demonstration, the external library X-CUBE-CRYPTOLIB is used. X-CUBE-CRYPTOLIB can be downloaded from st.com, clicking this link will redirect you to the site.
After creating a project for any chosen board, go to Project > Properties > C/C++ Build > Settings > Tool Settings > MCU GCC Linker > Libraries.
After following these steps, it is possible to add the library and its respective path like in the image below. When including the library name for statics libraries.a, it cannot contain the “lib” prefix and the extension “.a”. For the library added in this example “libSTM32Cryptographic_CM0_CM0PLUS.a" the library name at STM32CubeIDE is “STM32Cryptographic_CM0_CM0PLUS.”
Now that the external library is linked to the project, the header file can be included by doing the following: Navigate to Project -> Properties -> C/C++ Build -> Settings -> Tool Settings -> MCU GCC Compiler. Include paths, and then add the path to the header file.
Conclusion
In conclusion, adding external libraries to STM32CubeIDE can greatly enhance the functionality of your project. With the steps outlined in this article, it can be done easily. By integrating the X-CUBE-CRYPTOLIB library, users can quickly access its functions with a simple header file. The same can be obtained for any custom library as well.
Related links
STM32CubeIDE quick start guide - User manual
Databrief - STM32CubeIDE - Integrated development environment for STM32 products
