STM32CubeMX 项目
CLion 与 STM32CubeMX 集成,用于目标为 STM32 开发板的嵌入式项目。 在 IDE 中使用这些项目之前,您需要安装 STM32CubeMX 和 STM32CubeCLT。 然后,您可以打开现有的 STM32CubeMX 项目或创建一个新项目。
CLion 还支持 Cube CLI,这是 ST 提供的捆绑包管理器。 它让您只下载所需的工具,例如 CMake、ST-LINK GDB 服务器或 GNU 工具,并在 IDE 中管理开发捆绑包(详情请参阅下面的章节)。 要使用 Cube CLI,请确保您的计算机上安装了 cube。
使用 STM32CubeMX 项目
打开项目
启动 CLion 时,点击 打开 在 欢迎 屏幕上。

然后,导航到您的项目文件夹,选择它,并点击 打开。 CLion 将以 CMake 项目的形式打开您的项目。
您还可以在项目文件夹中选择 .ioc 文件,然后点击 作为项目打开。 确保 .ioc 文件的名称不包含空格、非拉丁字符或其他特殊字符。
如果 CLion 已在运行,请导航到 并打开项目文件夹或 .ioc 文件。
创建新项目
在 CLion 中,导航到 并选择 STM32CubeMX 作为您的项目类型:

然后,您可以按照 新项目 屏幕上显示的步骤或以下更详细的说明进行操作。
启动 STM32CubeMX。 在打开的窗口中,点击 访问 MCU 选择器。 您还可以选择 访问开发板选择器。

在列表中找到您的 MCU 或开发板,然后点击右上角的 启动项目:

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

点击 项目管理器 选项卡。
从 工具链 / IDE 下拉菜单中,选择 CMake:

在 项目名称 字段中,输入您的项目名称:

在右上角,点击 生成代码。
生成完成后,关闭 代码生成 窗口:

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

切换回 CLion 新建项目 窗口。 在此对话框顶部的 位置 字段中输入您复制的路径,然后点击 继续:

您的 STM32CubeMX 项目将被创建:

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

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

调试项目
请确保已配置适当的运行/调试配置和 ST-LINK 调试服务器。 如果这是一个新的 STM32CubeMX 项目,可以使用 CLion 预配置的默认设置。
在源代码中设置断点,然后点击主工具栏上的
按钮:

如果一切正常,将在调试器的 选项卡中看到消息:
Debugger connected to ST-LINK。程序暂停后,可以执行各种操作,例如:
查看 寄存器和外设 ,其定义于 .svd 文件中。 对于 STM32 MCU,这些文件位于 STM32CubeCLT 安装目录内的 STMicroelectronics_CMSIS_SVD 目录中。
使用 实时监视 实时监控全局变量。
调试 反汇编代码。
查看正在运行的进程的 原始内存。

编辑源代码
在编辑由 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 文件中。
使用 Cube CLI 管理捆绑包
Cube CLI 将开发工具作为 捆绑包 分发:CMake、编译器、ST-LINK GDB 服务器、GNU 工具和其他组件。 在 Cube 项目中,捆绑包及其版本会锁定在项目文件中,以便构建该项目的每个环境都使用同一套工具。
配置 Cube CLI
将项目转换为 Cube 项目
当项目尚不是 Cube 项目时, 包含两个操作: 转换为 STM32 Cube 项目 和 打开 STM32 Cube CLI 终端。 对于终端操作,请参阅 运行 Cube CLI 命令。
转到 。

CLion 会初始化 Cube 项目,并锁定该项目已使用的工具,例如 CMake 和编译器。 锁定的工具存储在项目根目录中的 .settings/bundles.store.json 和 .settings/bundles-lock.store.json 中。
安装项目捆绑包
在 Cube 项目中, 中还会提供另外两个操作:
- 安装项目捆绑包
安装由 Cube CLI 锁定但您的计算机上缺失的捆绑包。
- 将项目捆绑包安装到所有环境
在项目使用的每台计算机上安装缺失的捆绑包。 当 CMake 配置文件以不同机器为目标时,例如本地工具链和远程工具链,会显示此操作。
缺失的捆绑包不一定会导致 CMake 重新加载中断:Cube CLI 会查找等效工具并改用它。 在这种情况下,CMake 重新加载终端会显示一个警告,其中包含用于安装所需捆绑包的快速修复。
运行 Cube CLI 命令
要管理现有项目的捆绑包,请使用 Cube CLI 命令。 转到 以打开一个终端,其中 cube 可用于所选 CMake 配置文件的环境。 也可以从 终端 工具窗口中的标签页下拉菜单打开它。
- cube bundle 在线列出
列出可供下载的捆绑包及其版本。
- cube bundle 显示
cube bundle show <bundle>显示捆绑包的详细信息:它设置的环境变量、它在PATH变量中的条目,以及它提供的命令。- cube bundle 初始化
cube bundle init --project <bundles>会将当前项目转换为 Cube 项目,并在其中锁定指定的捆绑包。- cube bundle 安装
cube bundle install --project <bundles>会安装指定的捆绑包并将其锁定在项目中。 省略--project可全局安装捆绑包。- cube bundle 移除
cube bundle remove --project <bundles>会从项目中锁定的工具中移除指定的捆绑包。 省略--project可全局卸载捆绑包。
在这些命令中, <bundles> 使用 bundle_name@version 格式。 例如, gnu-tools-for-stm32@14.3.1+st.2。
