STM32开发之 VS Code + gcc环境编译

最新推荐文章于 2025-03-06 10:45:46 发布

夏沫の浅雨

最新推荐文章于 2025-03-06 10:45:46 发布

阅读量3.2k

点赞数 1

分类专栏： STM32 文章标签： stm32 hal库 shell vscode gcc

本文链接：https://blog.csdn.net/qq_42992084/article/details/108892169

版权

STM32 专栏收录该内容

26 篇文章

订阅专栏

写在前面：
本文章旨在总结备份、方便以后查询，由于是个人总结，如有不对，欢迎指正；另外，内容大部分来自网络、书籍、和各类手册，如若侵权请告知，马上删帖致歉。

一、程序安装

1、VSCode：https://code.visualstudio.com/Download

好用到爆的文本编辑器，配合强大的插件，使你的开发效率大大提高。

2、Java：https://www.java.com/zh-CN/download/

STM32CubeMX的安装需要 JAVA运行环境（jre）。

3、STM32CubeMX：https://my.st.com/content/my_st_com/en/products/development-tools/software-development-tools/stm32-software-development-tools/stm32-configurators-and-code-generators/stm32cubemx.html

支持最新的 HAL库及 LL库，工程代码配置与生成工具，支持生成 IAR、Keil、STM32CubeIDE、Makefile等工程，这里使用其生成的 Makefile工程。

4、MinGW-w64：https://sourceforge.net/projects/mingw-w64/files/mingw-w64/mingw-w64-release/

一个强大并实用的 C/C++ 编译器。安装完成后需要添加系统环境变量，可以利用 cmd命令：gcc -v测试。

5、arm-none-eabi-gcc：https://launchpad.net/gcc-arm-embedded/+download

GUN的 arm的通用交叉编译链工具，基本上常用的 arm处理器均支持。同样的，安装完成后需要添加系统环境变量，可以利用 cmd命令：arm-none-eabi-gcc -v测试。

二、CubeMX工程生成

目前 STM32现在主推的库是 HAL库，当然还有个 LL库用于操作底层寄存器；对于 HAL库，官方专门推出了图形化软件 CubeMX来简化 HAL库下 STM32的初始化代码；我们只需要配置好相应的外设功能以及时钟树，点击生成代码，CubeMX便会生成相应工程文件，并且还支持多种 IDE工具，实乃居家旅行出门必备啊。咳，偏题！

首先，选择你的目标芯片，启动工程配置，这里就简单的弄个 LED控制跟 DEBUG配置。

串口配置就像下图那样，像我们平常一样，异步通讯，Baud rate:115200、8Bit、1Stop Bit

在这里插入图片描述

接着就配置 LED IO引脚，直接点击对应引脚进行配置，如下图所示：

在这里插入图片描述

这软件怎么用在这里就不多赘述了，还有就是稍微注意一下：

如果要使用 STLink等在线调试器，那么需要在下图的指示处选择你所需要调试方式：

在这里插入图片描述

对于时钟树，像我们一般是有使用 HSE高速外部晶振，那么你就需要在 RCC那里打开相应的配置：

在这里插入图片描述

接着在时钟配置那里配置相应的外设时钟：

在这里插入图片描述

最后，由于我们是想要在 VSCode上开发，就直接选择生成 Makefile就可以了。需要特别说明的是，这一步并不是必须的，完全可以不用 CubeMX，自己写 Makefile也是可以的。然后输出生成工程文件。

在这里插入图片描述

三、VSCode环境部署

1、插件安装

插件	功能
Chinese (Simplified) Language Pack for Visual Studio Code	中文（简体）语言包
Comment Translate	VSCode 注释翻译
C/C++	C / C ++的语言支持,语法智能感知、加亮及调试功能，当然需要系统安装 arm-none-eabi-gcc编译器
Cortex Debug	提供 jlink、stlink等调试接口功能
ARM	arm汇编语言支持
vscode-icons	文件图标，可快速查看文件类型

2、配置 VS Code

首先，把从 STM32CubeMX创建出来的工程导入到 VS Code里面，得到：

在这里插入图片描述

默认情况下，工程中是不含 .vscode 的文件夹的，通过操作以下三种方式时会自动创建：

打开命令窗口进行编辑配置（Ctrl+Shitf+P > Edit Configurations(JSON)）

在这里插入图片描述

或点击窗口栏的终端 -> 配置任务 -> 使用模板创建 task.json -> Other

在这里插入图片描述

或修改工作区里的 settings.json文件（窗口File–Preferences–Settings–Features–Terminal 的 Terminal > Integrated > Automation Shell: Windows栏中进行编辑）

在这里插入图片描述

这三个创建出来的效果如下：

在这里插入图片描述

先说前面两个文件：

c_cpp_properties.json

主要有添加 include路径，编译器路径，宏定义等；设置好后，索引、编译就跟 keil一样方便。然后，它的配置修改如下：

{
    "configurations": [
        {
            "name": "STM32",		// 创建一个名为"STM32"的配置
            "includePath": [		// 声明这个工作区的 C/C++工程包含了哪些头文件目录
                "${workspaceFolder}/**",
                "${workspaceFolder}/Drivers/CMSIS/Device/ST/STM32L1xx/Include",
                "${workspaceFolder}/Drivers/CMSIS/Include",
                "${workspaceFolder}/Drivers/STM32L1xx_HAL_Driver/Inc",
                "${workspaceFolder}/Drivers/STM32L1xx_HAL_Driver/Inc/Legacy",
                "${workspaceFolder}/Core/Inc"
            ],
            "defines": [			// 全局的预处理宏定义
                "STM32L151xB",
                "USE_HAL_DRIVER"
            ],
            "compilerPath": "gcc.exe",		// 如果添加了环境变量，可以像这样表示；否则就得加绝对路径，如：C:\\Program Files\\mingw64\\bin\\gcc.exe
            "cStandard": "c11",				// 使用的 C标准
            "cppStandard": "c++17",			// 使用的 C++标准
            "intelliSenseMode": "gcc-x64"	// 语言风格
        }
    ],
    "version": 4
}

注意：这个 json不允许有注释，所以，如果是像复制到你的文件里，记得把注释删了。

tasks.json

这个文件下 tasks 数组里的每一个对象都代表着一个任务。

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
          "label": "Build",			// 标签名
          "type": "shell",			// 终端（shell）型的任务
          "command": "make",		// *执行的命令
          "args": [					// 命令的参数
            "-j6"					// 表示六线程同时编译
          ],
          "problemMatcher": ["$gcc"],	// 表示如果出现了编译报错，问题面板会显示 gcc类型的错误
          "group": {
            "kind": "build",
            "isDefault": true
          }
        }
      ]
}

注意：上面的 "command"选项中填的是 “make”；实际上，在我们下载的 MinGW-w64编译器中，执行的是 mingw32-make.exe；但是，这里可以看到 mingw32-make.exe 文件名太长，并且不好记，因此我们可以将其复制并重命名为 make.exe 这样就与 Linux下的 make命令保持一致了；如果没有像前面说的那样复制出 make.exe，那么，在 "command"选项中填则是 “mingw32-make”，同样的在执行编译操作时，键入的命令则是 mingw32-make。

settings.json

这个留着后面结合实例来说。

四、工程编译

当你配置完成上面的操作后，最最最好就是先保存所有文件，然后关闭 VS Code，再重新打开工程。

编译有两种：

1、点击窗口栏的终端 -> 运行生成任务（快捷键 Ctrl+Shitf+B）

在这里插入图片描述

2、点击窗口栏的终端 -> 新终端，选择 cmd

在这里插入图片描述

没有的话，那就点击一下它，然后点 “选择默认 Shell”，再点击旁边的垃圾桶，再重新打开一下。

键入 make，最后按回车键。当编译完成后就会像下图这样显示编译文件大小：

在这里插入图片描述

五、编译清除

编译文件清除，只需要在终端命令台里键入 make clean就可以了，但是，但是，如果使用的是 cmd的shell，你会发现：

在这里插入图片描述

并没有清除掉编译出来的文件。这是为什么呢？可以在这里得到答案：https://github.com/STAT545-UBC/Discussion/issues/55

根据里面的描述可以总结为：

解决方法1：使用 Windows版本的 rm是 del，因此可以简单地用 rm替换成 del。但是要注意，这样做意味着您将无法使用 Git Bash shell，因为它不支持 del命令程序；

解决方案2：假设你已安装 Git Bash（没有那就安装 Git呗，都 0202了，不会还有人不用 Git吧，实在实在不想用 Git，那么就找个支持 rm的终端命令台，例如：msys2），那么你可以把终端命令台切换到 Bash上面

第一个就简单了，在 makefile里把 rm替换成 del，如下图所示：

在这里插入图片描述

第二个，就像上面那样重新点击 “选择默认 Shell”，然后选择 Git bash
在这里插入图片描述

在这里插入图片描述

然后，用这种操作去修改终端 Sell，不同项目对于选择不同的终端，有时候需要经常切换，不方便；那么就有了工作区 settings.json文件配置的作用了。

在 settings.json文件中，我们只需要配置如下操作：

{
	/* 终端在Windows上使用的shell的路径 */
    "terminal.integrated.shell.windows": "C:\\Program Files\\Git\\bin\\bash.exe",	// 如果添加了环境变量可以去掉路径
    "terminal.external.windowsExec": "C:\\Program Files\\Git\\bin\\bash.exe"		// 与上面同理
}