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. armToolchainPath
     2. 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"
               }
           ]
       }
   },