VSCode调试单片机

一、不同系统中单片机的调试方式

一般情况下我们都使用Windows平台下的编译器编译和调试单片机用的比较多，到了Linux下使用的编译器通常会是gcc，对应的调试工具是gdb。

但是使用这两者需要对相应的命令和选项比较熟许，入手难度相比图形化界面更高，如果进行调试还需要繁琐的输入一些重复的指令，这个时候即使是比较熟练的人也会觉得繁琐。

在VSCode中有安装相应的插件可以使用界面来进行调试，同时还提供了对应的命令输入端口，在必要的时候输入相应的调试指令可以得到期望的结果。

下面首先来看一下Windows中的Keil是如何进行调试：

再来看一下Linux中的GDB是如何进行调试：

Windows中Keil就相当于gdb的服务器和客户端，通过图形界面作为前端进行操作。
VSCode中实现交互的方式也和Keil类型，通过Cortex-Debug插件把gdb服务器和客户端连接在了一起。

二、软件安装

2.1 交叉编译器

Ubuntu安装交叉编译器（和调试无关，但是如果需要编译源码可以用到）

sudo apt-get install gcc-arm-none-eabi

2.2 gdb客户端

通过源码源码安装arm-none-eabi-gdb调试器（客户端）

2.3 gdb服务器

安装gdb server，这里的gdb服务器有很多种，和具体使用的JTAG调试器有关系，有如下几种：

JLink GDBServer
Openocd 
PEGDBServer
Pyocd
ST-LINK_gdbserver
Stutil

我使用的是st-util，在Ubuntu中可以通过命令安装:

sudo apt-get install stlink-tools

除此之外也可以通过github源码仓库进行编译安装。

2.4 Cortex-Debug

这个比较容易，直接在VSCode中进行搜索就可以

三、Cortex-Debug配置

3.1 配置Cortex-Debug中工具链路径

右键点击Cortex-Debug中的扩展设置

我们需要配置的选项有三个，分别是armToolchainPath，gdbPath，stutilPath，最后一个是根据所使用的硬件调试器进行设置的，可以which查看可执行文件路径

{
    "security.workspace.trust.untrustedFiles": "open",
    "C_Cpp.updateChannel": "Insiders",
    "http.proxySupport": "off",
    "cortex-debug.armToolchainPath.osx": "/opt/homebrew/bin",
    "cortex-debug.armToolchainPath": "/opt/homebrew/bin",
    "cortex-debug.gdbPath.osx": "/opt/homebrew/bin/arm-none-eabi-gdb",
    "cortex-debug.gdbPath": "/opt/homebrew/bin/arm-none-eabi-gdb",
    "cortex-debug.stutilPath": "/opt/homebrew/bin/st-util",
    "cortex-debug.stutilPath.osx": "/opt/homebrew/bin/st-util"
}

3.2 配置运行和调试

在运行和调试中选择添加配置，选择对应的调试类型（例如我使用的是{ } Cortex Dbug:ST-Util）：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Cortex Debug",
            "cwd": "${workspaceRoot}",
            "executable": "./build/TFTLCD.elf",
            "request": "launch",
            "type": "cortex-debug",
            "servertype": "stutil"
        }
    ]
}

添加完成后会出现对应的一个按钮，后续点击按钮便可以启动调试器

四、调试目标代码

4.1 连接开发板和调试器

4.2 设置断点

4.3 启动调试

下面是终端中显示的内容，服务器启动识别到开发板，监听端口50000，等待客户端连接，同时将需要调试的程序烧录到开发板中，终端不需要我们做任何操作，调试结束后会自动关闭

在调试控制台中显示的是gdb的连接信息，前面设置的断点生效后程序停止在对应位置，最下面>的位置是命令输入端口，可以通过命令和gdb进行交互

除此之外左侧可以显示断点信息，局部变量，全局变量，栈信息，上方正中心的位置可以暂停，单步调试，单步跳过，单步跳出，重启和停止