VSCode+Cortex-Debug搭建最好用的Stm32开发环境！

VSCode+Cortex-Debug搭建最好用的Stm32开发环境！

参考文档：.Doc/VSCode+Ozone使用方法.md · HNUYueLuRM/basic_framework - Gitee.com
请结合视频观看：BLP英雄电控代码讲解—环境搭建

C语言编译全过程

编译器+链接器会帮你们完成下面三个过程，一般使用GNU GCC

1. 预处理
2. 编译
3. 汇编
4. 链接：生成可以烧录的.bin文件

调试

GDB+GDBServer会帮你完成调试的准备工作

1. 创建调试接口：GDB（调试器）我们使用arm-none-eabi-gdb
2. 映射硬件调试器至接口：GDBServer，作为硬件调试器和GDB软件的连接桥梁，我们使用OpenOCD
3. 硬件调试器：ST-Link（各家有各自的GDBServer）

工具链

你肯定不想自己装编译器+链接器+GDB这么多东西，所以有人帮你装好了

我们使用的是Arm GNU Toolchain工具链，他包含了：

1. 编译器：arm-none-eabi-gcc.exe
2. 链接器：arm-none-eabi-ld.exe
3. 调试器：arm-none-eabi-gdb.exe

各个名词的含义

GCC、GNU到底啥意思？-CSDN博客

GNU（GNU’s Not Unix!）：缺少内核的操作系统

GCC（GNU Compiler Collection）：是GNU的C语言编译器套件

Linux：只是一个操作系统内核，基于GNU完成

GNU/Linux：GNU和Linux内核加在了一起变成了一个完整的操作系统，这才是我们常说的Linux系统

Ubuntu、CentOS：基于GNU/Linux的Linux发行版（加了点其他东西，比如图形化界面）

MinGW（Minimalist GNU For Windows）：并不是单纯的GCC编译器，而是一个GNU工具的集合，可以让Window用户编译

所以我们最后要装

你电脑上要装：

1. MinGW：为了让你在Window下编译
2. Arm GNU Toolchain：帮助你完成编译、链接、调试
3. OpenOCD：和你的ST-Link一起实现硬件调试

你可能觉得要装这么多东西太麻烦，没关系，别人也这么觉得，所以别人做了一个包管理工具（MSYS2）用来一键安装

VSCode中要装的插件：

1. **C/C++**：让你的VSCode实现C语言调试
2. Cortex-Debug：让你的VSCode实现STM32的调试
3. Cortex-Debug: Device Support Pack - STM32F4：让你的VSCode实现STM32F4的调试
4. Makefile tools：用来配置调试指令
5. Better C++ Syntax：让你的C语言代码更好看
6. C/C++ Snippets：帮你自动补全关键字
7. IntelliCode：AI辅助补全

因为我们用的是ST-Link，所以Ozone可视化调试也不用装，因为根本用不了（b溃了

Ozone目前仅支持Jlink和dap-link

配置过程

使用MSYS2安装上述程序

pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-arm-none-eabi-toolchain mingw-w64-x86_64-ccache  mingw-w64-x86_64-openocd

1. 配置MinGW环境变量，使用gcc -v检查

VSCode配置

1. 安装VSCode
2. 安装上述插件
3. 配置终端- 按 ctrl+, 打开Vscode全局setting.json文件添加下方代码"terminal.integrated.defaultProfile.windows":"mysys2-mingw64",// 若希望为默认终端可以加入这一句"terminal.integrated.profiles.windows":{"mysys2-mingw64":{"path":"cmd.exe",// 意思是使用cmd作为父进程启动终端"args":["/c","C:\\msys64\\msys2_shell.cmd -defterm -mingw64 -no-start -here"]// msys2_shell.cmd在msys的安装目录下，这里要改为你自己的目录，如果代码文件在c盘/c可以不加}}
4. 配置Makefile tools（替代手动调用gcc）- 按 ctrl+, 搜索make path，输入mingw32-make（没配置MinGW环境变量请先配置）- 打开一个已经有makefile的项目（用cubeMX初始化），打开终端进行测试，输入：mingw32-make -j24# -j参数表示参与编译的线程数,一般使用-j12- 确认能够编译后，创建task.json，以便快捷调用{// See https://go.microsoft.com/fwlink/?LinkId=733558"version":"2.0.0","tasks":[{"label":"build task",// 任务标签"type":"shell",// 任务类型,因为要调用mingw32-make,是在终端(CMD)里运行的,所以是shell任务"command":"mingw32-make -j24",// 要执行的任务命令"problemMatcher":[],"group":{"kind":"build","isDefault":true}}]}- 点击VSCode上方【终端】按钮，【运行任务】选择build task，进行测试
5. 配置Cortex-debug调试- 按 ctrl+, 依次搜索进行路径配置，路径要你自己的1. armToolchainPath2. openocdPath注意：D:\MSYS2\mingw64\bin目录下的gdb.exe要改名为arm-none-eabi-gdb.exe"cortex-debug.armToolchainPath": "D:\\MSYS2\\mingw64\\bin","cortex-debug.openocdPath": "D:\\MSYS2\\mingw64\\bin\\openocd.exe",如果使用JLink还需配置JLinkGBDServer
6. 配置launch.json因为我们使用的是ST-Link，和跃鹿不一样，配置请添加如下{"name":"STlink","cwd":"${workspaceRoot}/","executable":"${workspaceRoot}\\build\\basic_framework.elf","request":"launch","type":"cortex-debug","servertype":"openocd",//要选择的GDB server"device":"STM32F407IG",//"interface":"swd","configFiles":[// "${workspaceRoot}/openocd.cfg""interface/stlink-v2.cfg","target/stm32f4x.cfg",],"runToEntryPoint":"main","showDevDebugTimestamps":true,"preLaunchTask":"build task",//先运行Build任务编译项目,取消注释即可使用// "svdFile": "${workspaceRoot}/STM32F103.svd","svdFile":"STM32F407.svd","rttConfig":{"enabled":true,"address":"auto","clearSearch":false,"polling_interval":1000,"decoders":[{"label":"","port":0,"type":"console"}]}},