【亲测免费】 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 项目。