当前位置：首页 > news >正文

VSCode下EIDE插件开发STM32

news 来源：原创 2025/6/8 13:29:31

VSCode下STM32开发环境搭建

本STM32教程使用vscode的EIDE插件的开发环境，完全免费，有管理代码文件的界面，不需要其它IDE。
视频教程见本人的

VSCode+EIDE开发STM32

安装EIDE插件

Embedded IDE 嵌入式IDE

这个插件可以帮我们管理代码文件，配置工具链（什么是工具链见下文）等。

这里先安装此插件，此插件使用，工具链安装等，后面配合示例工程讲解。
在这里插入图片描述

EIDE网站，可以查看此插件的更新日志。

这是什么？ | Embedded IDE For VSCode

什么是工具链

简单的说就是把源文件（也就是xx.c xxx.cpp等）变成可执行文件的东西。

在这里插入图片描述

开发不同的东西需要不同的工具链，

比如在windows上，源文件最后会变成.exe
用Visual Studio写.cpp用的就是MSVC 编译器工具集（也称为工具链或“生成工具”）
用VSCode写.cpp，教程都会让你下载mingw

而开发单片机，也需要对应其内核的工具链。

stm32是arm的内核，所以需要arm相关的工具链。
keil就是armcc v5 v6的工具链（收费）。
本教程使用的是免费的gnu arm embedded toolchain即GNU Arm 嵌入式工具链。

这是它的网址Arm GNU Toolchain Downloads – Arm Developer，如果你想可以去下载最新版，我这里用EIDE安装。
在这里插入图片描述

使用EIDE安装gcc工具链

点击安装实用工具，安装gcc_arm工具链

在这里插入图片描述

它会开始下载安装工具链

在这里插入图片描述

如果使用EIDE安装工具链，它的安装路径如下
C:\Users\用户名.eide\tools
在这里插入图片描述

假如你本来就有，可以直接设置安装位置。

比如你自己下载了工具链，或者安装了stm32的工具包（STM32 VS Code Extension 插件让你安装的那个），或者安装了STM32CubeIDE，就直接找到gcc_arm工具链填入其路径就行。

点击设置工具链，设置 GNU Arm Embedded Toolchain
在这里插入图片描述

示例工程

创建一个示例工程，进一步说明。

示例工程实现LED闪烁。

用CubeMX生成工程代码

打开stm32cubeMX，打开选择器，选择你开发板对应的芯片型号。
进入配置界面，设置LED对应引脚为输出模式，通常是PC13因为这个引脚没有太多其它功能。
顺便设置个标签，LED0，便于后面写代码。
工程名称就叫demo1吧。
只复制必要的库文件，为每个外设生成一对‘.c/.h’文件初始化外设等不再赘述。
在这里插入图片描述

工具链/IDE选择
这里的STM32CubeIDE CMake Makefile 使用的都是arm-gcc的工具链！
不过CMake Makefile产生的工程需要自己配置项目资源，CubeIDE产生的工程导入即可。
这里先选择CMake或者Makefile自己配置一下项目，STM32CubeIDE导入的教程见下文。

在这里插入图片描述

生成的工程文件夹
在这里插入图片描述

EIDE插件的使用

新建空项目

在这里插入图片描述

STM32选择Cortex-M项目，项目名称建议和之前的工程名称保持一致。

在这里插入图片描述

项目保存位置为工程文件夹的位置（而不是工程文件夹内）

在这里插入图片描述

项目文件夹已经存在的警告选是

在这里插入图片描述

切换至工作区
在这里插入图片描述

VSCode切换到了工作区

在这里插入图片描述

编译工程

添加项目资源

添加.c文件

添加普通文件夹，它具有递归查找能力，能往下查找到你的代码文件。

在这里插入图片描述

添加包含.c代码的文件夹。

在这里插入图片描述
.c文件添加完毕

添加启动文件startup.s

项目资源添加一个虚拟文件夹
在这里插入图片描述

添加启动文件startup.s，选择文件的时候选择any就可以看到所有文件。
在这里插入图片描述

启动文件.s添加完毕

顺便说一下
普通文件夹要在工程文件夹下面添加。
当然如果你愿意，可以全部使用虚拟文件夹去添加所有源文件。
只要将工程涉及到源文件全部添加了就可以。

构建配置

选择CPU类型

选择CPU类型，根据你的单片机选择，STM32F4选M4,F1选M3

在这里插入图片描述

设置链接脚本路径

设置链接脚本路径，就是CubeMX生成的flash.ld文件。
在这里插入图片描述

它就在工程文件夹那层里，把它文件名填上去就行
在这里插入图片描述

项目属性

就是，头文件路径、库文件路径、要预处理的宏定义这些。

如果搞不清楚CubeMX生成的代码的相关配置，可以查看CubeMX生成的CMake或makefile。

在这里插入图片描述

这里说一下，并没有使用CMake，打开它只是为了确认要填入的信息。

添加头文件目录

就是所有.h所在的目录。
在这里插入图片描述
包含目录添加完毕

添加预处理宏定义

代码文件里有类似这样的代码，这些编译预处理命令需要添加预处理宏定义配合编译。

#if defined (USE_HAL_DRIVER)//如果定义了它
//...
//做什么什么
//...
#endif /* USE_HAL_DRIVER */

在这里插入图片描述
预处理宏定义添加完毕

当然，如果你自己建立了代码文件夹也需要添加相关的配置。

编译

都配置好了，然后就能编译了

随便打开一个代码文件，右上角既可以找到编译。
在这里插入图片描述

编译完毕，没有错误没有警告。

在这里插入图片描述

生成的可执行文件（待下载到单片机上）
在这里插入图片描述

如何烧录（下载）

安装下载器对应的工具。

一般大家搞stm32都是用stlink因为便宜，如果是jlink就下载jlink的。

在这里插入图片描述

安装后它也会安装STLINk的驱动等。
在这里插入图片描述

烧录配置，选择烧录工具

在这里插入图片描述

添加工程代码

添加让LED0闪烁的代码，并重新编译。

    HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_SET);HAL_Delay(500);HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET);HAL_Delay(500);

烧录

点击右上角的下载按钮即可下载。

在这里插入图片描述

提示：请正确连接你的下载器和开发板。

烧录完毕

在这里插入图片描述

LED0已经开始闪烁。

在这里插入图片描述

调试

安装调试用的插件和工具

安装Cortex Debug

安装VSCode插件 Cortex Debug，调试需要。

在这里插入图片描述

安装OpenOCD

OpenOCD是一个免费的开源软件，用于调试和编程嵌入式设备。

可以直接在EIDE这里下载。

在这里插入图片描述

假如你有OpenOCD就不用重新下载了，之后写路径的时候改一下就行。
比如你自己下载了OpenOCD，或者安装了stm32的工具包（STM32 VS Code Extension 插件让你安装的那个），就直接找到填入其路径就行。
在这里插入图片描述

如果使用EIED安装OpenOCD,它的安装位置如下，安装位置之后要用。
C:\Users\用户名.eide\tools
在这里插入图片描述

创建launch.json文件

launch.json 是 Visual Studio Code 中用于配置调试器的文件。

launch.json的创建

切换到代码文件，点运行和调试。创建launch.json文件，在工程中。
在这里插入图片描述
调试器选择Cortex Debug

自动生成代码的时候选择OpenOCD

这是自动生成的launch.json还需要修改
在这里插入图片描述

填写可执行文件路径

调试要用到可执行文件.elf，它在build/Debug下。
executable 这里填入

            //elf文件看当前工程名称或是看build文件夹下的elf文件名称"executable": "build/Debug/demo1.elf",

在这里插入图片描述

填写配置文件路径

找到你OpenOCD的安装位置
configFiles这里如下填写

"configFiles": [//使用ST-LINK，路径根据你的openOCD的安装位置修改，stlink版本根据你的下载器修改"C:/Users/CaiYunWei/.eide/tools/openocd_7a1adfbec_mingw32/share/openocd/scripts/interface/stlink-v2-1.cfg",//使用stm32f?，路径根据你的openOCD的安装位置修改，stm32f?根据你的芯片修改"C:/Users/CaiYunWei/.eide/tools/openocd_7a1adfbec_mingw32/share/openocd/scripts/target/stm32f4x.cfg"],

stlink .cfg文件路径如下，使用哪个根据你的下载器修改。
C:\Users\你的用户名.eide\tools\openocd_7a1adfbec_mingw32\share\openocd\scripts\interface
在这里插入图片描述
stm32 .cfg文件路径如下，使用哪个根据你的芯片修改。
C:\Users\你的用户名.eide\tools\openocd_7a1adfbec_mingw32\share\openocd\scripts\interface\target

参考的launch.json文件

{// 使用 IntelliSense 了解相关属性。 // 悬停以查看现有属性的描述。// 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387"version": "0.2.0","configurations": [{"cwd": "${workspaceRoot}",//.elf可执行文件路径"executable": "build/Debug/demo1.elf","name": "Debug with OpenOCD","request": "launch","type": "cortex-debug","servertype": "openocd","configFiles": [//使用ST-LINK，路径根据你的openOCD的安装位置修改，stlink版本根据你的下载器修改"C:/Users/CaiYunWei/.eide/tools/openocd_7a1adfbec_mingw32/share/openocd/scripts/interface/stlink-v2-1.cfg",//使用stm32f?，路径根据你的openOCD的安装位置修改，stm32f?根据你的芯片修改"C:/Users/CaiYunWei/.eide/tools/openocd_7a1adfbec_mingw32/share/openocd/scripts/target/stm32f4x.cfg"],"searchDir": [],"runToEntryPoint": "main","showDevDebugOutput": "none"}]
}

生成的jlink相关代码用不到，可以删掉。

开始调试

搞好之后保存launch.json文件，选择设置好的启动项Debug with OpenOCD，加入断点，即可开始调试

在这里插入图片描述

成功
在这里插入图片描述
可以在左面查看变量，添加监视等。

导入CubeIDE工程

CubeIDE实际上也是用的arm-gcc的工具链。

我这里用cubeMX生成一个来说明。

创建一个CubeIDE工程

在这里插入图片描述

导入

导入空的嵌入式gcc项目
在这里插入图片描述

项目资源，项目属性等已经自动添加好了。

构建配置仍需手动修改。

在这里插入图片描述

注意生成的flash.ld文件中

  .ARM.extab (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */{. = ALIGN(4);*(.ARM.extab* .gnu.linkonce.armextab.*). = ALIGN(4);} >FLASH

它有个关键词需要gcc11以上的版本，目前（2025年1月20日）EIDE下载到的是10！可以删除相关内容，或者手动更新工具链。

之后即可正常编译。
在这里插入图片描述

烧录、调试等完全一致，见上文。

后记

使用VSCode EIDE开发，不需要其它IDE。
使用arm-gcc完全免费

没有这个EIDE插件确实能开发，但是要手动配置工具链，每次编译代码都需要在命令窗口中输入相应的指令，很麻烦。

按理说，找到对应内核的工具链就能开发相应的单片机。
EIDE这个插件能设置的工具链挺多的。
在这里插入图片描述

CMake现在在C/C++的项目中用的越来越多，建议了解一下。
STM32 VS Code Extension 插件用的是CMake。但它没有图形化的配置界面，比如加个文件，得自己写路径，比较麻烦。

参考资料

抛弃keil？VScode开发stm32完整教程_哔哩哔哩_bilibili

VSCode+EIDE开发CH32V系列RISC-V MCU - Wahahahehehe - 博客园

这是什么？ | Embedded IDE For VSCode

cortex-debug 用法 - Blog - Embedded IDE Forum
ension 插件用的就是CMake。但它没有图形化的配置界面，比如加个文件，得自己写路径，比较麻烦。

VSCode下STM32开发环境搭建

安装EIDE插件

什么是工具链

使用EIDE安装gcc工具链

示例工程

用CubeMX生成工程代码

EIDE插件的使用

编译工程

添加项目资源

添加.c文件

添加启动文件startup.s

构建配置

选择CPU类型

设置链接脚本路径

项目属性

添加头文件目录

添加预处理宏定义

编译

如何烧录（下载）

安装下载器对应的工具。

烧录配置，选择烧录工具

添加工程代码

烧录

调试

安装调试用的插件和工具

安装Cortex Debug

安装OpenOCD

创建launch.json文件

launch.json的创建

填写可执行文件路径

填写配置文件路径

参考的launch.json文件

开始调试

导入CubeIDE工程

创建一个CubeIDE工程

导入

后记

参考资料

相关文章：