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 项目。
————————————————
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
原文链接:https://blog.csdn.net/gitblog_00269/article/details/141244650
|