STM32 Cube CMake VSCode 项目教程

1. 项目目录结构及介绍

stm32-cube-cmake-vscode/
├── cube-ide-cmake-demo-proj/
├── docs/
│   └── images/
├── script-projects/
├── templates/
│   ├── CMakePresets.json
│   ├── vscode/
│   │   ├── c_cpp_properties.json
│   │   ├── launch.json
│   │   └── tasks.json
├── cmake/
│   └── gcc-arm-none-eabi.cmake
├── .gitignore
├── LICENSE
├── README.md
└── stm32-cube-cmake-vscode.py

目录结构介绍

• cube-ide-cmake-demo-proj/: 包含示例项目的文件，用于演示如何在VSCode中使用CMake进行STM32开发。
• docs/: 包含项目文档的图片资源。
• script-projects/: 包含用于生成CMakeLists.txt文件的脚本项目。
• templates/: 包含VSCode配置文件模板，如CMakePresets.json、c_cpp_properties.json、launch.json和tasks.json。
• cmake/: 包含CMake工具链文件gcc-arm-none-eabi.cmake。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• stm32-cube-cmake-vscode.py: 用于自动生成CMakeLists.txt文件的Python脚本。

2. 项目启动文件介绍

2.1 stm32-cube-cmake-vscode.py

该脚本用于自动生成CMakeLists.txt文件，适用于从STM32CubeIDE生成的项目。脚本的主要功能包括：

• 解析STM32CubeIDE项目的.cproject和.project文件。
• 生成CMakeLists.txt文件，包含源文件、包含路径、编译选项等。
• 支持C、C++和汇编文件的编译。
• 自动检测Cortex-M系列处理器并设置相应的编译选项。

2.2 README.md

项目说明文件，包含项目的介绍、使用方法、依赖工具的安装步骤等。

3. 项目配置文件介绍

3.1 CMakeLists.txt

CMakeLists.txt是CMake项目的主配置文件，定义了项目的构建规则。主要内容包括：

• 工具链信息，如GCC配置和编译标志。
• 项目名称和源文件列表。
• 包含路径和编译定义。
• 链接脚本路径和编译选项。

3.2 CMakePresets.json

CMakePresets.json文件定义了CMake的预设配置，允许开发者快速切换不同的构建配置（如Debug、Release等）。

3.3 vscode/c_cpp_properties.json

该文件用于配置VSCode的C/C++扩展，主要用于IntelliSense功能，确保编辑器能够正确解析项目的包含路径和预处理器定义。

3.4 vscode/launch.json

launch.json文件用于配置VSCode的调试功能，特别是使用Cortex-Debug扩展进行STM32的调试。配置内容包括：

• 调试器类型（如STLink）。
• 目标设备（如STM32H735IG）。
• 调试接口（如SWD）。
• 调试文件路径（如生成的.elf文件）。

3.5 vscode/tasks.json

tasks.json文件定义了VSCode的任务配置，用于快速执行常见的构建和调试任务，如构建项目、清理项目、重新构建项目、烧录固件等。

通过以上配置文件，开发者可以在VSCode中高效地进行STM32项目的开发、构建和调试。