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.txtcmake/ 目录下的各种 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

    物联沃分享整理
    物联沃-IOTWORD物联网 » STM32 CMake项目构建指南

    发表回复