CMake手册 CMake入门

C

CMake手册 for STM板

CMake构建工具简化了开发项目的构建过程。它自动生成构建系统，如Makefiles和Visual Studio项目文件。

CMake是一个第三方工具，拥有其自己的文档。本主题描述了如何在使用CMake为STM板开发应用程序时使用CMake。

QUL_ROOT和QUL_TOOLS在下面的命令行示例中被用作环境变量的设置。例如：

export QUL_ROOT=$HOME/Qt/QtMCUs/2.8.0
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.8.0
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

命令行设置

要从命令行开始，需要将以下更改应用于系统路径。

  • 如果STM32CubeProg未安装在默认位置，则将其安装目录添加到系统路径。
  • 将ST-LINK_gdbserver.exe目录添加到您的系统路径
    <STM32_CUBE_IDE_INSTALL_PATH>\stm32cubeide_1.3.0\plugins\com.st.stm32cube.ide.mcu.externaltools.stlink-gdb-server.win32_1.3.0.202002181050\tools\bin

    其中，<STM32_CUBE_IDE_INSTALL_PATH>是Cube IDE的安装路径。

    注意：STM32CubeIDE是可选的，仅在片上调试时需要。

构建配置

在为STM板开发应用程序时，以下CMake变量需要配置。

变量值
Qul_ROOT将Qul_ROOT设置为Qt for MCUs SDK的安装路径。
-DQul_ROOT=%QUL_ROOT%

注意：此CMake变量故意混合大小写，因为它需要与包名匹配。

QUL_PLATFORM平台名称必须指明要针对的板和操作系统。它是所选板的名称和要针对的操作系统组合在一起。以下示例中的平台名称表明目标是裸机上的STM32F469I发现。
-DQUL_PLATFORM=stm32f469i-discovery-baremetal

注意：如果您要针对其他板或操作系统，请参阅支持的平台了解更多信息。

FREERTOS_DIRFreeRTOS源目录的绝对路径。仅对FreeRTOS目标需要。有关FreeRTOS板上信息，请参阅FreeRTOS平台。
-DFREERTOS_DIR=< FreeRTOS directory path >
CMAKE_TOOLCHAIN_FILE例如，将其设置为Arm GCC工具链配置文件。
-DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake
-DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake
QUL_TARGET_TOOLCHAIN_DIR需要使用QUL_TARGET_TOOLCHAIN_DIR CMake缓存条目来提供所使用的工具链的位置。
-DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain
QUL_BOARD_SDK_DIR例如，将其设置为STM32F769I SDK的安装路径
-DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\STM\STM32Cube_FW_F7_<version>
QUL_COLOR_DEPTH您所选择平台的颜色深度支持。例如，设置为16位。
-DQUL_COLOR_DEPTH=16

注意： 如果未设置此变量，则在配置平台时将使用默认颜色深度。

注意： 在Qt Quick Ultralite项目中，默认将CMAKE_BUILD_TYPE设置为MinSizeRel。MinSizeRel是Qt Quick Ultralite附带预构建平台库使用的构建类型。要更改构建类型（例如将其更改为Release），可以使用带有-DCMAKE_BUILD_TYPE=Release选项的CMake。有关更多信息，请参阅CMAKE_BUILD_TYPE。

CMake手册 使用CMake入门

适用于某些Qt许可证。
了解更多信息。