如何使用STM32 VS Code 扩展 v2.0.0 或更高版本创建工程

摘要

本文说明如何用 STM32 Visual Studio Code 扩展（v2.0.0 或更高），在 VS Code 里做 STM32 MCU 开发。

内容包括：

• 下载更新后的 VS Code 扩展
• 通过内嵌 CubeMX 平台创建新工程
• 编写并调试应用

引言

不少人用 VS Code 写 STM32 应用。意法半导体（ST）从 v2.0.0 起更新了 VS Code 扩展：在 VS Code 里就能完成 STM32 工程创建、构建与调试。下面按步骤上手。

硬件

• NUCLEO-G071RE
• 1 根 Micro-B USB 线缆

软件

• VS Code 应用
• STM32CubeIDE for Visual Studio Code
• STM32CubeMX（须为 v6.11 或更高）
• ST-MCU-FINDER-PC

1.1 安装 STM32 VS Code 扩展

在已联网的 PC 上，通过 VS Code 应用下载 STM32 VS Code 扩展。

1. 在 VS Code 中打开 [Extensions]（Ctrl + Shift + X），搜索 STM32CubeIDE for Visual Studio Code。
2. 安装 [STM32 VS Code Extension]（界面如图所示）。

1.2 使用 STM32CubeMX 创建新工程

建工程有两种方式：空工程，或走 STM32CubeMX。本文用 CubeMX，配置更快。

1. 在 VS Code 的 “STM32Cube Key Actions” 下选择 [Launch STM32CubeMX]，打开 STM32CubeMX。
2. 在 STM32CubeMX 中通过选择 MCU、板或示例启动工程。本文选择板级：点击 [Access to Board Selector]。
3. 在 Board Selector 的 “Commercial Part Number” 中输入 NUCLEO-G071RB。
4. 选中板后，点击 [Start Project]。
5. 提示是否以默认模式初始化外设时，选择 [Yes]。
6. 本文要翻转连到板载 LED 的 PA5；CubeMX 里这脚已配好，不用再动。一般到这一步工程外设就配完了。
7. 配置完成后，打开 “Project Manager” 选项卡，可修改 Project Name，并将 Toolchain 改为 CMake。完成后点击右上角 [Generate Code]。

1.3 在 VS Code 中导入工程

1. 在 VS Code 中选择 File > Open Folder，打开在 CubeMX 中创建的工程目录。
2. 屏幕右下角会弹出是否将发现的 CMake 工程配置为 STM32Cube Project，选择 [Yes]。

也可在 STM32Cube Key Actions 下选择 [Setup STM32Cube project(s)]。

3. 打开 “Project Setup” 选项卡，将 CMake 工程配置为 STM32Cube 工程。在 Board/Device 中输入所用料号；本例可输入 NUCLEO-G071RB。

点击 [Configure] 后，界面应如下所示。

4. 随后选择 launch configuration 的弹窗中，选择 [Debug]。

若看不到下拉菜单，可从 CMake 选项卡设置 “Configure Preset”。

配好后就可以改代码、构建工程。

5. 本文在 main.c 的 while 循环中加入两行，翻转 PA5 上的 LED：

HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);

HAL_Delay(100);

加入后 main.c 应类似文中截图。

6. 点击屏幕左下角 [Build] 构建工程。

7. 构建完成后，按需设置断点，在左侧工具栏的 Run and Debug 中选择 [Run and Debug]。

8. 在下拉菜单中选择调试器；本例选择 [STM32Cube: STLink GDB Server]。

9. 选择后应用开始运行并在初始断点处暂停。可用顶部工具栏继续、暂停、单步进入/跳过，以及终止或重启调试会话。

结论

到这里，已经用 STM32 VS Code 扩展 v2.0.0 或更高版本建好并跑通工程。同一流程可用于其他 STM32 MCU 与 Nucleo 板。之后可继续配外设、加用户代码，做成更完整的自定义应用。

来源：https://community.st.com/stm32-mcus-60/how-to-create-a-project-with-stm32-vs-code-extension-v2-0-0-or-newer-162256

参数以意法半导体官方最新资料为准。