VSCode 搭建 STM32 开发环境
Posted 嵌入式up笔记
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了VSCode 搭建 STM32 开发环境相关的知识，希望对你有一定的参考价值。
文章目录
VSCode 搭建 STM32 开发环境
之前开发 STM32 使用的开发环境是 MDK + STM32CubeMX 方法，MDK 是收费软件，并且跨平台性能较差，因为工作以后开发环境集中于 Linux 下，且大概率使用到的 IDE 是 VSCode，或其他基于 elicpise 框架的 IDE，不再使用 MDK，所以学习使用 VSCode 来开发 STM32，本节记录一下 VSCode 搭建 STM32 开发环境的过程，整个开发链如下：VSCode 编辑代码 -> ARM GCC 编译 -> OpenOCD 仿真下载
一、软件工具准备
搭建环境前需要准备一些工具和软件
- VSCode 软件
下载官网：VSCode官网
- STM32CubeMX
下载官网：STM32CubeMX下载
- Git 工具
下载官网：Git下载
- OpenOCD
下载官网：OpenOCD，下载完成后是一个文件夹，不是安装程序，下载后我们找一个固定位置解压，然后将解压目录添加到系统环境
- arm-none-eabi-gcc 编译器下载
下载官网：下载官网，选择后缀 win32.exe 下载安装，安装后将安装路径添加到系统环境变量
二、VSCode 配置
软件准备好后，进一步配置 VSCode 环境，打开软件后，先安装几个重要插件：
ARM用于看汇编代码，C/C++ 方便自动补全，Cortex-Debug 用于调试芯片，插件安装完成，我们用 CubeMX 新建一个 STM32 工程，配置点灯的IO口：
然后设置生成为 makefile 工程：
生成代码后进入到工程目录，打开 VSCode，这里我右击进入 git bash 然后输入 code . 就可以在 VSCode 工程打开该文件夹：
2.1 配置命令行
因为 VSCode 非常依赖命令行，所以第一步先修改命令行为 GitBash，点击左下角的标志进入系统设置
打开设置文件
插入如下配置代码：
"terminal.integrated.profiles.windows":
"GitBash":
"path": "D:\\\\Git\\\\bin\\\\bash.exe",
"args": [],
,
"terminal.integrated.defaultProfile.windows": "GitBash",
"terminal.external.windowsExec": "D:\\\\Git\\\\bin\\\\bash.exe",
将 Git 安装目录下的 bash 路径写入进去，就是代码中的
D:\\\\Git\\\\bin\\\\bash.exe
然后我们使用 ctrl+shift+` 打开命令行，就可以看到默认使用 GitBash 做命令行了
2.2 添加 make 工具
然后我们在命令行输入 make -j4，以4核心编译代码，如果出现找不到make的报错，则前往 ezwinports，下载 make-4.1-2-without-guile-w32-bin.zip，然后将解压内容放到 GIT 安装路径下的 mingw64 文件夹 Git\\mingw64\\，放进去选择重复文件不要覆盖，防止出问题，然后 make 命令就可以正常使用了，make 编译按照 CubeMX 生成的 Makefile 规则进行编译，生成编译文件：
我们可以修改 Makefile 来设置编译生成的文件名称，编译级别等等参数，需要对 makefile 语法有一定的了解
2.3 配置下载
编译完成了，生成的文件在 \\build\\ 下面，生成的文件有 VSCode_Test.elf、VSCode_Test.bin、VSCode_Test.hex，bin 是 2 进制文件，hex 是 16 进制，elf 则在 bin 的基础上包含了许多其他的信息，这里我们下载程序使用 OpenOCD 来下载，下载文件使用 .elf 可执行文件
创建一个 task.json 配置文件，用来创建任务，方便后面快速执行下载指令，创建方式如下：
创建默认格式任务，然后选择 task.json 文件，使用 MSbuild 导出
创建完成后就可以看到 .vscode 文件夹下有一个 task.json 配置文件了，点进去可以看到文件中有一个默认配置任务的格式了
我们在此基础上修改：添加了一个下载任务，
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
"label": "download",
"type": "shell",
"command": "openocd",
"args": [
"-f",
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/interface/stlink-v2.cfg",
"-f",
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/target/stm32f4x.cfg",
"-c",
"program build/VSCode_Test.elf verify reset exit"
],
"group": "build",
"presentation":
// 配置静默输出
"reveal": "silent"
,
// 报错匹配
"problemMatcher": "$gcc"
]
label 是任务名称，type 是执行 shell 脚本，command 是执行的指令，这里是 openocd，arg 包含执行指令的参数，两个关键的参数如下：
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/interface/stlink-v2.cfg"
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/target/stm32f4x.cfg",
stlink-v2.cfg 是下载器的版本，stlink-v2就用 stlink-v2.cfg，jlink 就用 jlink.cfg，这些文件都在 openocd 的解压目录下
stm32f4x.cfg 则是对应芯片的配置文件，也在 openocd 的解压目录下，这两个参数就是两个文件的绝对路径，添加完成后，我们执行下载程序
使用快捷方式 ctrl+shift+b 执行download
然后程序就下载进去了
2.4 配置仿真
上面下载完成了，后面我们配置一下仿真的参数，使用 OpenOCD 来进行仿真，添加仿真运行配置文件
环境选择 Cortex Debug
添加完成后就会有一个仿真运行配置文件：launch.json，打开文件，然后添加配置，选择 OpenOCD，然后就会自动添加一个代码修改模板：
对他的参数进行修改：
// 使用 IntelliSense 了解相关属性。
// 悬停以查看现有属性的描述。
// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
"cwd": "$workspaceRoot",
"executable": "./build/VSCode_Test.elf",
"name": "STM32 Debug",
"request": "launch",
"type": "cortex-debug",
"showDevDebugOutput": true,
"servertype": "openocd",
"device": "STM32F407VE",
"configFiles": [
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/interface/stlink.cfg",
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/target/stm32f4x.cfg",
],
"svdFile": "./STM32F407.svd"
,
]
主要的就是下载文件
"executable": "./build/VSCode_Test.elf",
下载器配置文件
"configFiles": [
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/interface/stlink.cfg",
"D:/VSCode/ARM/ARM_PACK/OpenOCD-20211118-0.11.0/share/openocd/scripts/target/stm32f4x.cfg",
],
以及 stm32 仿真时的片上外设寄存器文件，该文件要从STM32官网下，选择对应型号下载后拷贝到目录下，用于看仿真过程中外设寄存器信息，STM32F4 的下载地址：SVD文件
"svdFile": "./STM32F407.svd"
配置完成后，在 main 函数设置断点，按 F5 执行仿真
仿真完成
2.5 配置 VSCode 写代码环境
上面的仿真和下载都完成了，但我们在写代码时发现，代码许多报错，警告啥的，虽然不会影响程序执行，但很烦，主要是因为 VSCode 没有对整个工程路径建立索引，下一步就是添加索引，消除这些报错、警告，添加 C 和 CPP 环境配置文件，按 ctrl+shift+P 打开 Command Palette，运行 C/Cpp: Edit configurations 生成c_cpp_properties.json 配置文件：
文件如下：
修改为下面的代码：
"configurations": [
"name": "Win32",
"includePath": [
"$workspaceFolder/**",
"$workspaceFolder/Drivers/STM32F4xx_HAL_Driver/Inc",
"$workspaceFolder/Drivers/STM32F4xx_HAL_Driver/Inc/Legacy",
"$workspaceFolder/Drivers/CMSIS/Device/ST/STM32F4xx/Include",
"$workspaceFolder/Drivers/CMSIS/Include",
"$workspaceFolder/Drivers/CMSIS/Include",
"$workspaceFolder/Core/Inc",
"D:/VSCode/ARM/ARM_PACK/ARM_GCC/10 2021.10/arm-none-eabi/include"
],
"defines": [
"_DEBUG",
"UNICODE",
"_UNICODE",
"USE_HAL_DRIVER",
"STM32F407xx"
],
"compilerPath": "D:\\\\VSCode\\\\ARM\\\\ARM_PACK\\\\ARM_GCC\\\\10 2021.10\\\\bin\\\\arm-none-eabi-gcc.exe",
"cStandard": "c11",
"cppStandard": "c++14",
"intelliSenseMode": "windows-gcc-x86"
],
"version": 4
修改保存后，C/CPP 就会按照上面的路径去索引文件，按照设定的编译器补全 C 的语法，不会再出现报错、警告了，开发更舒服！
到此 VSCode 配置 STM32 开发环境就完成了，这些操作的思想不仅仅局限于 STM32 基本上所有芯片都通用，就是看你愿不愿意折腾了。
以上是关于VSCode 搭建 STM32 开发环境的主要内容，如果未能解决你的问题，请参考以下文章