STM32 CMake项目构建指南
STM32 CMake 项目使用指南
stm32-cmakeCMake for stm32 developing.项目地址:https://gitcode.com/gh_mirrors/st/stm32-cmake
1. 项目的目录结构及介绍
STM32 CMake 项目的目录结构如下:
stm32-cmake/
├── cmake/
│ ├── stm32/
│ │ ├── common/
│ │ ├── linker_ld/
│ │ └── ...
│ ├── FindCMSIS.cmake
│ ├── FindHAL.cmake
│ └── ...
├── tests/
├── examples/
│ ├── template/
│ ├── custom-linker-script/
│ └── ...
├── CMakeLists.txt
└── README.md
目录结构介绍
cmake/
: 包含用于配置和构建项目的 CMake 模块和工具链文件。
stm32/
: 包含与 STM32 相关的 CMake 模块,如设备信息、链接器脚本生成等。FindCMSIS.cmake
: 用于查找和配置 CMSIS 库的 CMake 模块。FindHAL.cmake
: 用于查找和配置 STM32 HAL 库的 CMake 模块。tests/
: 包含用于测试 CMake 脚本的项目。examples/
: 包含示例项目,如模板项目和自定义链接器脚本项目。CMakeLists.txt
: 主 CMake 配置文件。README.md
: 项目说明文档。2. 项目的启动文件介绍
STM32 CMake 项目中的启动文件通常位于 examples/
目录下的示例项目中。例如,examples/template
项目中可能包含以下启动文件:
startup_stm32f407xx.s
: 针对 STM32F407xx 系列的启动文件,如果启用了 ASM 语言。启动文件介绍
启动文件主要负责初始化系统,设置堆栈指针,并跳转到主程序入口。在 STM32 项目中,启动文件通常是用汇编语言编写的。
3. 项目的配置文件介绍
STM32 CMake 项目的配置文件主要包括 CMakeLists.txt
和 cmake/
目录下的各种 CMake 模块。
CMakeLists.txt
CMakeLists.txt
是主配置文件,定义了项目的构建规则和依赖关系。例如:
cmake_minimum_required(VERSION 3.14)
project(stm32-template)
add_executable(stm32-template main.c)
target_link_libraries(stm32-template CMSIS::STM32::F407VG)
cmake 模块
cmake/
目录下的模块用于配置各种库和工具链。例如:
FindCMSIS.cmake
: 查找和配置 CMSIS 库。FindHAL.cmake
: 查找和配置 STM32 HAL 库。stm32/common/
: 包含设备信息和命名规则的模块。stm32/linker_ld/
: 生成可调链接器脚本的模块。配置选项
配置选项可以通过以下方式设置:
cmake -D<VAR_NAME>=<value>
CMakeLists.txt
中设置:set(<VAR_NAME> <value>)
<VAR_NAME>
重要的配置选项包括:
STM32_CUBE_<FAMILY>_PATH
: STM32Cube 目录的路径,其中 <FAMILY>
是设备系列,如 C0
, F0
等。通过这些配置文件和选项,可以灵活地配置和构建 STM32 项目。
stm32-cmakeCMake for stm32 developing.项目地址:https://gitcode.com/gh_mirrors/st/stm32-cmake
作者:咎岭娴Homer