用 VS Code 搭建 STM32 开发环境。

article/2025/10/25 6:33:25

众所周知，Keil是一款收费软件，虽然可以Po解使用，但很多公司还是有点害怕，想必有不少读者都收到过**函。

之前，开发单片机项目，可以说 Keil 是最佳选择之一，但VSCode横空问世之后，这种格局被打破。

因为 VSCode 免费且好用，可以安装各种插件，很多工程师逐渐从Keil 转向了 VSCode。而且，VSCode还能实现 Keil 不能实现的一些功能。

16a9aceca9abf4bc81ca480bd1ac039c.png

下面就给大家分享一下 VSCode 搭建 STM32 开发环境的一些常规且使用的功能。

01 


需要的软件和工具

  1. 下载最新版VS Code: 安装好插件，具有良好的代码补全与调试功能。

VS Code下载地址：https://code.visualstudio.com/

  1. 下载 LLVM：用于代码补全，其实可以理解为 Clang。因为VS Code 中“C/C++”插件的自动补全功能不太好用。STM32中好多库函数都补全不出来。记得按照好之后，将路径添加到环境变量里。

LLVM下载地址：http://releases.llvm.org/download.html

  1. 下载安装 Git for Windows: 提供Git支持和MINGW64指令终端。

Git下载地址：https://gitforwindows.org/

  1. 下载安装 arm-none-eabi-gcc：选择gcc-arm\-none-eabi-5\_4-2016q3-20160926-win32.exe (md5)这里是一个2016年的，我目前也是用的这个，好像还有其他的新版的下载，GNU Arm Embedded Toolchain。正常安装后，记得需要将软件的安装目录下的bin文件夹设置进入环境变量PATH中。

arm-none-eabi-gcc下载地址：https://launchpad.net/gcc-arm-embedded/+download

  1. 下载 OpenOCD for Windows：一个开源的片上调试器(Open On-Chip Debugger)。在Windows下自己编译可能有问题 。所以，我们选择编译好的。下载后的文件不是安装包，把程序文件夹放入自己的软件安装目录下，将软件的bin文件夹路径加入用户环境变量PATH中。

OpenOCD下载地址：http://gnutoolchains.com/arm-eabi/openocd/

  1. STM32CubeMX：用于生成带makefile的工程。这样我们就可以不用自己写MakeFile了。套用他的模板，然后修改为自己的目录就可以。

STM32CubeMX链接：http://www.stm32cube.com/

02 


搭建编译环境

1. 用STM32Cube创建工程。

STM32CubeMX生成的是用HAL库开发的项目，具体怎么配置这里就不介绍了，只介绍与主题有关的部分。

（1）STM32CubeMx芯片包（固件库）下载，注意事项：

776f54baf787f37223e09c0f11ce115f.png

需要选择help -> updater settings ->Connection Parameters设置好网络后，才能下载固件包。

（2）生成工程。选择MakeFile选项。

注意： 4.18.0以下的版本是没有Makefile这个选项的。最后下载一个中间版本，因为5.0以上的版本界面很乱。我选择的是 4.27.0.

5927277840e9c6a456e5d5d34d373b78.png

2.配置VS Code

（1）打开工程所在的文件夹。在右键“用VS Code打开工程文件夹”，

f97fda61cf953bf3fc935f9988f1ba48.png

你将会看到这样的目录结构

0b16eee4a9ea3c6732f660590d48a1cd.png


.ioc文件是STM32Cube的工程文件，Inc和Src是供用户修改的源码，Driver里是STM32和ARM CMSIS的库，最好不要修改。

不过，如果你要采用标准库开发的话，就修改为标准库的Driver.

（2）安装VS Code插件，需要这几样：

53afe6ac2a5b1478b65b643b2af1ef41.png74145ec3fe98fd5921f60d3b877c69ba.png

（3）配置VS Code内置终端

这里将我们上面安装的 Git for Windows 设置为VScode 的内置终端。

文件–首选项–设置，搜索terminal，设置内置终端的Shell为Bash（安装VS Code的时候它会推荐你安装Git，里面有这个Bash）。或者打开 Settings.json添加下面两句。

"terminal.integrated.shell.windows": "D:\\Program Files\\Git\\bin\\bash.exe",
"terminal.external.windowsExec": "D:\\Program Files\\Git\\bin\\bash.exe"

然后按Ctrl+` 就可以打开终端，看到Bash了

b3f9333caf200356f2a00a4d9be8fc11.png

（4）配置智能补全、智能感知插件。

前面我们安装了 LLVM 用它来实现智能补全，与纠错，自然就需要一个路径去寻找这些文件。因此我们需要一个。c\_cpp\_properties.json文件的配置文件。

我们在当前目录的.vscode文件夹下创建c\_cpp\_properties.json配置文件，用来告诉VS Code我们定义的宏与文件的路径。

{"configurations": [{"name": "Win32","browse": {"path": ["${workspaceFolder}/","${workspaceFolder}/Drivers/CMSIS","${workspaceFolder}/Drivers/FWlib/inc","${workspaceFolder}/Drivers/CMSIS/startup","${workspaceFolder}/User/inc","${workspaceFolder}/User","${workspaceFolder}/ThirdParty/crclib/include"],"limitSymbolsToIncludedHeaders": true},"includePath": ["${workspaceFolder}/","${workspaceFolder}/","${workspaceFolder}/Drivers/CMSIS","${workspaceFolder}/Drivers/FWlib/inc","${workspaceFolder}/Drivers/CMSIS/startup","${workspaceFolder}/User/inc","${workspaceFolder}/User","${workspaceFolder}/ThirdParty/crclib/include"],"defines": ["_DEBUG","UNICODE","_UNICODE","__CC_ARM","USE_STDPERIPH_DRIVER","STM32F10X_HD"],"compilerPath": "C:\\Program Files\\LLVM\\bin\\clang-format.exe","cStandard": "c11","cppStandard": "c++17","intelliSenseMode": "clang-x64"}],"version": 4
}

注意：如果提示variable “uint32\_t” is not a type name不是一个type类型。

则需要 添加宏定义\_\_CC\_ARM，如果没有该宏定义，则uint32\_t类型会报错。并且结构体中使用了uint32\_t定义的成员，也会补全不了。

(5)编译程序

gcc下编译过程如下图所示：

  • .c文件 经过 arm-none-eabi-gcc 编译成 .o文件

  • .s文件 经过 arm-none-eabi-as 编译成 .o文件

  • .o文件 和 .a文件 经过 arm-none-eabi-ld 链接成 .elf文件

  • .elf文件 经过 arm-none-eabi-objcopy 和 arm-none-eabi-objdump 转换成 hex文件/dis文件

  • arm-none-eabi-gdb 使用 .elf文件 进行debug

c0ed0304ca4f1d38ecf59d542958599f.png

在Terminal下输入make指令，即会开始build程序

34c913383881fd6dce7221a2df95dcff.png

编译完成后，生成的所有文件都会放在Build文件夹下.

ac5c4e5ea76b6b772db93d83c0259524.png


注意： 由于我安装了 Qt. Qt中自带了 mingw32-make.exe。我把这个文件复制了一份，重命名为make.exe。并且添加进了环境变量中。因此我可以直接使用 make。

如果你没有 make 的环境。可以下载一个choco包管理器，它类似于linux下的apt，只不过是windows下使用的。然后用choco安装make即可：

851b0d58ef0422e349fe3ed69032ca57.png

如果改了source code，需要重新编译程序，那就得先执行make clean指令去删除之前build好的所有东西。然后重新执行make指令即可。

03 


布局

搭建调试环境

1.配置openocd。

要运行openocd这个gdb server，需要配置如下几个参数：

  • 用什么仿真器？(J-link, ST-link…)

  • 用什么接口？(JTAG, SWD…)

  • 目标芯片是什么？（STM32F4x, tm4c123g…）

首先我们打开openocd的安装目录，打开share/openocd/scripts，里面有很多提前写好的配置文件。

b1910e705e660008552b7df1fedf67a7.png


target里存放目标芯片的配置文件，例如stm32f4.cfg

interface里存放仿真器相关的配置文件，例如jlink.cfg，stlink.cfg.

当我们启动openocd时，可以用-f参数来指定一个配置文件。例如:

openocd –f interface/stlink.cfg –f target/stm32f4.cfg

【注】配置仿真器的参数必须在配置目标MCU的参数之前，否则将报错。

如果我们不带参数启动，openocd就会自动查找当前目录下有没有名为openocd.cfg的文件，并把它作为配置文件来启动。因此，我们就在当前工程下创建一个名为openocd.cfg的文件。

9512d5ce3f2fa91da026fd93004844ab.png

我们选择使用ST-link，SWD接口，目标芯片为stm32f1x。
(PS：这里注释掉了SWD接口，如果采用Jlink 则需要SWD接口)。

这样，我们连好板子上好电，直接在终端里敲openocd，即可启动。

160c2614f83ee28417608e42ed108419.png

openocd运行时，这个shell终端就被占用了，我们一会要新开一个终端。

2.用gdb连接上openocd

(1)直接启动gdb，参数为编译好的调试文件(.elf)

9d7eb53692028275db5d72ab027ab70f.png


(2)使gdb连接上openocd 前面已经说过openocd留给gdb的TCP/IP端口是3333，因此输入：

target remote localhost:3333

5dc15f56d7bb5b54e45cc91c56697d61.png


注意，在连接openocd的时候，一定需要先运行 openocd 服务才能通信上，否则一直出现 taget remote 错误。

(3)下载代码.

6ffccb804d25a222c01677d92a6ef492.png


后面就和普通的gdb一样操作了，加断点，单步运行什么的，网上可以搜到很多教程。

【注】 最后记得输入q来退出gdb，以免影响后面的配置。

3.配置openocd任务与build任务

为了避免每次都在终端输入 make 和 make clean ，与 openocd 。我们可以在VSCode 中，建立一个 Task 来帮我们完成这个任务，

（1）在当前目录下创建build.py的文件。

489232d60346ded3ce10d132af7b8654.png

（2）在VSCode界面下，单击“任务”，选择“配置任务”

按 F1，选择"配置任务" .vscode目录下就会创建一个tasks.json配置文件.

a7916019a41be9380dfda6e0f7167693.png


打开 tasks.json ,修改内容如下：

b1e80ff4dc4717024de6aa4d8c9ab588.png


注意上面是两个任务，一个是openocd.用于连接st-link调试。一个是 build 用于编译。

它相当于是创建了一个名为build的任务，任务的内容是在shell里面执行 python build.py这个命令。只是不用我们手动输入而已。

4.配置VS Code的调试功能

使用VS Code，肯定是图方便，图好看。所以我肯定不会让大家靠敲命令来调试，这样岂不是开倒车，还不如用keil。因此，这里要配置VS Code的调试功能，相当于对gdb的一个图形化吧。

在VS Code内选择debug（就是左边那个‍‍虫子图标），选择“添加配置”，类型为GDB。就会在.vscode文件夹下生成launch.json配置文件。
按照下面来配置：

{"version": "0.2.0","configurations": [{"name": "ARM Debug","type": "cppdbg","request": "launch","program": "${workspaceFolder}/Build/STM32F103RC_Template.elf","args": [],"stopAtEntry": false,"cwd": "${workspaceFolder}","environment": [],"externalConsole": false, "MIMode": "gdb","miDebuggerPath": "C:\\Program Files (x86)\\GNU Tools ARM Embedded\\5.4 2016q3\\bin\\arm-none-eabi-gdb.exe","targetArchitecture": "arm", "setupCommands": [{"description": "选择调试文件(.elf)到gdb","text": "file E:/VScode/STM32_VSCode/stm32f103_temp/Build/STM32F103RC_Template.elf","ignoreFailures": false},{"description": "连接GDB Server","text": "target remote localhost:3333",                                 "ignoreFailures": false},{"description": "Reset MCU","text": "monitor reset",                                              "ignoreFailures": false},{"description": "Halt","text": "monitor halt",                                                  "ignoreFailures": false},{"description":"下载代码到MCU","text": "load" ,              "ignoreFailures": false                                      }],"preLaunchTask": "build", }]
}

可以看到，setupCommands里面就是我们之前试用gdb时操作过的流程：连接GDB Server——reset——halt——下载代码。

而preLaunchTask中是我们之前在tasks.json中配置的build任务。它可以让我们每次调试时都先编译一遍。

保存后，随便打几个断点，按下F5，就可以快乐调试了。可以看到功能还是很齐全的。

8a4820984802b3c886b030a02aa83cb1.png


【注意】：在进行调试的时候，需要先 按 F1 --> 任务：运行任务里选择 openocd 任务运行。

06c5dee9328c9d8329f8f45191f74963.png


因为调试，需要连接st-link进行调试，而openocd任务是开启st-link的服务。这样客户端才能连接上。


否则会一直出现 target remote localhost:3333 的错误。

看到这里，基本就差不多了，开发STM32完全没问题了。

来源：

https://blog.csdn.net/qq_33559992/article/details/97548915

-END-

往期推荐：点击图片即可跳转阅读

8e16871f562711434559e96a525aa013.jpeg

这么烂的代码，谁写的？！

e486199337695e4b0b5bd4ac792b745d.jpeg

单片机可以人脸识别吗？不行，是Linux

a779ac86fe47c6421f352c01193d2f0c.jpeg

如何画出完美的PCB板子？

47cdfb4b6005146251f5adb65e1a608e.jpeg

单片机 -> RTOS -> Linux


http://chatgpt.dhexx.cn/article/hLGQ3r2T.shtml

相关文章

一、stm32开发环境搭建

一、stm32开发环境搭建

1、MDK软件安装 mdk就是我们所熟知的keil软件，因为我是跟着正点原子后面学习32的，也是买了他们家的板子，正点原子资料很全很多，其中很多软件驱动都可以根据下面连接进行相应的下载。 正点原子资料下载中心 - 正点原子资料下载中…
阅读更多...
STM32开发——简介、开发环境（Keil5、CubeMX）、HAL库

STM32开发——简介、开发环境（Keil5、CubeMX）、HAL库

目录 1.简介-初识STM32 2.开发环境 2.1使用Keil5 2.2使用STM32CubeMX 3.标准库与HAL库区别 4.推挽输出与开漏输出 1.简介-初识STM32 什么是单片机？ 单片机（Single-Chip Microcomputer）是一种集成电路芯片，把具有数据处理能…
阅读更多...
STM32从零开始 - 第一章：开发环境STM32Cube套件

STM32从零开始 - 第一章：开发环境STM32Cube套件

概述 STM32的开发环境并不唯一。 如果你习惯KEIL开发环境，可以用KEIL环境来开发，虽然代码编辑不太方便，但调试跟踪非常方便。 如果你更熟悉gcc/makefile，则可以自己写makefile来搭建自己的脚本编译环境。 代码编辑器个人还是推…
阅读更多...
STM32系列 （一）开发环境的搭建

STM32系列 （一）开发环境的搭建

STM32简介 STM32是意法半导体（ST）推出一款32位的单片机。STM32具有超低的价格、超多的外设、丰富的型号、优异的实时性、极低的开发成本等优势。STM32凭借其产品线的多样化、极高的性价比、简单易用的库开发方式，迅速在众多32位单片机中脱颖而…
阅读更多...
STM32几种流行开发环境的优缺点

STM32几种流行开发环境的优缺点

有很多初学者在问：学习STM32，该用哪款开发工具？ 我首先说一下我的观点： 1.没有最好，只有适不适合，适合自己的才是最好的。 2.开发工具很多，各有各的特点，有优点肯定也有缺点。 今…
阅读更多...
STM32入门指南（0）—配置开发环境

STM32入门指南（0）—配置开发环境

STM32入门指南（0）—配置开发环境 文章目录 STM32入门指南（0）—配置开发环境开发环境介绍STM32CubeMX下载安装安装Java安装STM32CubeMX安装软件开发包 Keil uVision5下载安装解锁更多内容 开发环境介绍 这一系列的教程使用的都是 …
阅读更多...
用html和CSS做个人简历

用html和CSS做个人简历

很多刚学web的同学第一个项目应该都是做一个个人简历，这个是查了多方资料的刚刚写出来的一个简历，所以可能会参考网上的一些代码，兄弟们拿去复制就可以。里面有的注释可能不太对劲，不要太在意，毕竟我也是一个刚学一周的…
阅读更多...
简历模板推荐

简历模板推荐

简历模板推荐 话不多说，直接上干货。 今天给大家推荐几个还不错的简历模板网站。 木及简历（推荐👍） ： 免费MarkDown在线简历-专业简历制作工具-木及简历 。 知页简历：名企精英都在用的专业简历 typorama…
阅读更多...
HTML5,CSS制作个人简历

HTML5,CSS制作个人简历

先建立index页面 <!DOCTYPE html> <html lang"en"> <head> <meta charset"UTF-8"> <meta name"viewport" content"widthdevice-width, initial-scale1.0"> <title>个人简历制作</title> …
阅读更多...
HTML5+CSS——个人在线简历

HTML5+CSS——个人在线简历

期末作品用DW软件结合HTML和css来制作一个在线简历&#xff0c;成果图如下&#xff1a; HTML代码如下&#xff1a;主要使用表格来实现页面布局&#xff0c;页面中使用了文本溢出隐藏效果、点击相应的链接可以跳转到另一个网页等。 <!DOCTYPE html> <html> <hea…
阅读更多...
HTML5个人简历模板制作

HTML5个人简历模板制作

个人简历模板 几个主要属性值 rowspan 跨行数 width 宽度 cellpadding 内容与单元格之间的距离 cellspacing 单元格与单元格之间的距离 align 表格在文档中的对齐方式&#xff08;left center right&#xff09; 实现代码如下 在这里插入代码片 <!DOCTYPE html> <…
阅读更多...
html+css的响应式个人简历

html+css的响应式个人简历

响应式个人简历 文章目录 响应式个人简历目录一、运行截图二、html代码三、CSS代码四、总结 目录 包括主页、关于我、个人技能、联系我四个页面&#xff0c;整个页面可以根据窗口大小调整。 一、运行截图 二、html代码 代码如下&#xff1a; <!DOCTYPE html> <html l…
阅读更多...
个人简历需要写什么内容？简历模板的基本内容有哪些

个人简历需要写什么内容？简历模板的基本内容有哪些

很多人认为&#xff0c;个人简历应该做成形式多样颜色丰富设计十足的&#xff0c;而实际上HR对你感兴趣的并不是你的简历样式&#xff0c;而是你的简历内容。个人简历模板内容要怎么写呢&#xff1f;一份标准的简历表格基本内容有哪些呢&#xff1f;下面脚步网就来给大家介绍一…
阅读更多...
CSS+html制作简历表

CSS+html制作简历表

CSS格式 CSS样式的语法&#xff1a; css选择器{ 样式属性1:属性值&#xff1b; 样式属性2:属性值;. …} css选择器&#xff1a; 用于定位需要施加某些样式的某个或某一些标签&#xff0c;有ID选择器&#xff0c;class选择器&#xff0c;标签选择器等常用选择器可供选择使用。 …
阅读更多...
用HTML和CSS编辑的简历模板

用HTML和CSS编辑的简历模板

1. 工具&#xff1a; sublime或者EditPlus、任意浏览器 2. 代码文件 点击提取 密码: 5ee7 3. 效果
阅读更多...
怎样用HTML做一份精美的简历（html5+css）

怎样用HTML做一份精美的简历（html5+css）

先来看一下效果图&#xff1a; 代码&#xff1a;index.html <!DOCTYPE html> <html> <head><title>简历二</title><meta charset"utf-8"><link rel"stylesheet" type"text/css" href"../css/mysty…
阅读更多...
HTML+CSS实例：简单朴素的个人简历模板（HTML表格使用+css样式渲染）

HTML+CSS实例：简单朴素的个人简历模板（HTML表格使用+css样式渲染）

个人简历模板 丑是丑了点&#xff0c;没有那么花里胡哨。。。 先看展示 代码实现 <!DOCTYPE html> <html lang"en"> <head><meta charset"UTF-8"><meta http-equiv"X-UA-Compatible" content"IEedge"&g…
阅读更多...
html+css个人简历/网页界面

html+css个人简历/网页界面

代码如下&#xff1a; <!DOCTYPE html> <html><head><meta charset"utf-8" /><title>个人简历</title><link rel"stylesheet" href"css/li.css" /></head><body><div class"q&q…
阅读更多...
2022最新简历模板

2022最新简历模板

一份好的简历&#xff0c;要的不是花里胡哨&#xff0c;要的是简洁和内容相结合&#xff0c;这样的简历才是优秀的。 而且在排版设计上要适合HR快速阅读&#xff0c;用词、结构要专业。这样的简历模板&#xff0c;才是你需要的&#xff01; 下面我要分享几个免费高质量简历模…
阅读更多...
设计模式--【模板模式】

设计模式--【模板模式】

在模板模式&#xff08;Template Pattern&#xff09;中&#xff0c;一个抽象类公开定义了执行它的方法的方式/模板。它的子类可以按需要重写方法实现&#xff0c;但调用将以抽象类中定义的方式进行。这种类型的设计模式属于行为型模式。 介绍 意图&#xff1a;定义一个操作中…
阅读更多...
推荐文章

Copyright @ 2022~2023