CLion 2025.2 Help

STM32CubeMX 项目

CLion 与 STM32CubeMX 集成,用于面向 STM32 开发板的嵌入式项目。 在 IDE 中使用这些项目之前,您需要安装 STM32CubeMX 和 STM32CubeCLT。 然后,您可以打开现有的 STM32CubeMX 项目或创建一个新项目。

打开项目

  • 启动 CLion 时,点击 打开欢迎 屏幕上。

    项目对话框

    然后,导航到您的项目文件夹,选择它,并点击 打开。 CLion 将以 CMake 项目的形式打开您的项目。

  • 您还可以在项目文件夹中选择 .ioc 文件,然后点击 作为项目打开(P)。 确保 .ioc 文件的名称不包含空格、非拉丁字符或其他特殊字符。

  • 如果 CLion 已经运行,请导航到 文件(F)| 打开 并打开项目文件夹或 .ioc 文件。

创建新项目

  1. 在 CLion 中,导航到 文件(F) | 新建(N) | 项目 并选择 STM32CubeMX 作为您的项目类型:

    新建 stm32 项目

    然后,您可以按照 新建项目 屏幕上显示的步骤或以下更详细的说明进行操作。

  2. 启动 STM32CubeMX。 在打开的窗口中,点击 访问 MCU 选择器。 您还可以选择 访问开发板选择器

    cubemx 访问 mcu 选择器
  3. 在列表中找到您的 MCU 或开发板,然后点击右上角的 启动项目

    cubemx 启动项目
  4. 引脚与配置 选项卡将打开。 从那里,您可以更改 引脚视图 中显示的默认设置,配置其他参数,或在必要时安装中间件。

    cubemx 引脚视图
  5. 点击 项目管理器 选项卡。

  6. 工具链 / IDE 下拉菜单中,选择 CMake

    cubemx cmake 工具链
  7. 项目名称 字段中,输入您的项目名称:

    cubemx 项目名称
  8. 在右上角,点击 生成代码

  9. 生成完成后,关闭 代码生成 窗口:

    cubemx 代码生成
  10. 工具链文件夹位置 字段中复制路径,使用键盘快捷键:macOS 上为 ^C ,Windows/Linux 上为 Ctrl + C

    cubemx 工具链位置
  11. 切换回 CLion 新建项目 窗口。 在此对话框顶部的 位置(L) 字段中输入您复制的路径,然后点击 继续

    项目位置
  12. 打开项目向导 对话框将打开。 从那里:

    1. 从列表中移除默认的 调试 配置文件。

    2. 选择 调试 - 调试 配置文件。

    3. 在配置文件中,点击 Enable 然后点击 确定(O)

    cmake 配置文件
  13. 您的 STM32CubeMX 项目将被创建:

    新项目已创建

编辑源代码

  • 在编辑由 STM32CubeMX 生成的文件时,请始终将您的代码包含在 /* USER CODE BEGIN ... *//* USER CODE END ... */ 伪注释中。 以下是一个示例:

    /* Infinite loop */ /* USER CODE BEGIN WHILE */ while (1) { HAL_GPIO_TogglePin(LD3_GPIO_Port, LD3_Pin); HAL_Delay(1000); /* USER CODE END WHILE */

    这将保护您的代码在 STM32CubeMX 重新生成代码时不被覆盖。

  • 如果您添加源文件或头文件,请将它们放在 Src 头文件 目录中。 此外,将代码片段提取到单独的 .c .h 文件中。

构建项目

要构建项目,请点击主工具栏上的 按钮:

构建项目

如果一切正常,您将在 消息 窗口中看到 Build finished

构建完成

    调试项目

    1. 请确保已配置合适的运行/调试配置以及 ST-LINK 调试服务器。 如果是新的 STM32CubeMX 项目,您可以使用 CLion 预配置的默认设置。

    2. 在源代码中设置断点,然后点击主工具栏上的 按钮:

      调试项目

      如果一切正常,您将在调试器 控制台 选项卡中看到消息: Debugger connected to ST-LINK

    3. 程序暂停后,您可以执行诸如以下的操作:

      • 查看 寄存器和外设 ,它们定义在 .svd 文件中。 对于 STM32 MCU,这些文件位于 STMicroelectronics_CMSIS_SVD 目录下的 STM32CubeCLT 安装目录中。

      • 使用 实时监视 实时监控全局变量。

      • 调试 反汇编代码

      • 查看正在运行进程的 原始内存

      调试
    最后修改日期: 2025年 9月 26日