RT-Thread-vscode 全系列调试RT-Thread问答社区

这里介绍了 RTT 常见的几个 bsp 的调试方法，其他的都是类似的形式，照着写即可

前置条件

软件环境
- vscode
- vscode Cortex Debug 插件
选择性下载的软件
- gdb-multiarch
- gcc-arm-none-eabi
- pyocd
- openocd

launch.json 配置文件

这里先贴一下配置文件，给那些只需要配置文件的小伙伴准备的

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "qemu-vexpress-a9",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceRoot}/bsp/qemu-vexpress-a9/rtthread.elf",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${workspaceRoot}/bsp/qemu-vexpress-a9",
            "environment": [],
            "externalConsole": true,
            "miDebuggerServerAddress": "localhost:1234",
            "serverLaunchTimeout": 2000,
            "targetArchitecture": "ARM",
            "MIMode": "gdb",
            "miDebuggerPath": "gdb-multiarch",
            "setupCommands": [
                {
                    "text": "set backtrace limit 16"
                }
            ],
            "customLaunchSetupCommands": [],
            "launchCompleteCommand": "exec-run",
        },
        {
            "name": "qemu-virt64-riscv",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceRoot}/bsp/qemu-virt64-riscv/rtthread.elf",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${workspaceRoot}/bsp/qemu-virt64-riscv",
            "environment": [],
            "externalConsole": true,
            "miDebuggerServerAddress": "localhost:1234",
            "serverLaunchTimeout": 2000,
            "targetArchitecture": "ARM",
            "MIMode": "gdb",
            "miDebuggerPath": "gdb-multiarch",
            "setupCommands": [
                {
                    "text": "set backtrace limit 16"
                }
            ],
            "customLaunchSetupCommands": [],
            "launchCompleteCommand": "exec-run",
        },
        {
            "name": "qemu-virt64-aarch64",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceRoot}/bsp/qemu-virt64-aarch64/rtthread.elf",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${workspaceRoot}/bsp/qemu-virt64-aarch64",
            "environment": [],
            "externalConsole": true,
            "miDebuggerServerAddress": "localhost:1234",
            "serverLaunchTimeout": 2000,
            "targetArchitecture": "ARM",
            "MIMode": "gdb",
            "miDebuggerPath": "gdb-multiarch",
            "setupCommands": [
                {
                    "text": "set backtrace limit 16"
                }
            ],
            "customLaunchSetupCommands": [],
            "launchCompleteCommand": "exec-run",
        },
        {
            "name": "rt-spark-pyocd",
            "cwd": "/opt/rt-thread/tools/pyocd/bin/",
            "executable": "${workspaceRoot}/bsp/stm32/stm32f407-rt-spark/rt-thread.elf",
            "request": "launch",
            "type": "cortex-debug",
            "runToEntryPoint": "main",
            "targetId": "STM32F407ZG",
            "servertype": "pyocd",
            "serverpath": "/opt/rt-thread/tools/pyocd/bin/pyocd",
            "armToolchainPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/",
            "gdbPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/arm-none-eabi-gdb",
        },
        {
            "name": "rt-spark-openocd",
            "executable": "${workspaceRoot}/bsp/stm32/stm32f407-rt-spark/rt-thread.elf",
            "request": "launch",
            "type": "cortex-debug",
            "runToEntryPoint": "main",
            "targetId": "STM32F407ZG",
            "servertype": "openocd",
            "configFiles": [
                "interface/stlink-v2.cfg",
                "target/stm32f4x.cfg"
            ],
            "armToolchainPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/",
            "gdbPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/arm-none-eabi-gdb",
        },
        {
            "name": "hmi-board-pyocd",
            "cwd": "/opt/pyocd/bin/",
            "executable": "${workspaceRoot}/bsp/renesas/ra6m3-hmi-board/rtthread.elf",
            "request": "launch",
            "type": "cortex-debug",
            "runToEntryPoint": "main",
            "targetId": "R7FA6M3AH",
            "servertype": "pyocd",
            "serverpath": "/opt/pyocd/bin/pyocd",
            "armToolchainPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/",
            "gdbPath": "/opt/rt-thread/tools/gnu_gcc/gcc-arm-none-eabi/bin/arm-none-eabi-gdb",
        }
    ]
}

launch.json 配置文件注意事项

这里是以 rt-thread 源码为路径的，如果不对应的话请修改 launch.json 文件中的 executable 值，其中 ${workspaceRoot} 表示的是 vscode 工程的路径
除了 qemu 相关外，其他的 name 值都是使用的开发版名称加调试类型（这里没特殊要求，个人习惯而已，方便调试开发板时选择特定的工程及调试工具）
调试 qemu 时记得安装 gdb-multiarch 工具（archlinux 推荐使用 aur 工具输入 yay -S gdb-multiarch），如果安装了之后还有以下错误，miDebuggerPath 值请使用全路径
使用 openocd 调试时请安装 openocd 工具（archlinux 推荐使用 aur 工具输入 yay -S openocd）
使用 pyocd 调试时请安装 pyocd 工具（archlinux 推荐使用 aur 工具输入 yay -S rt-pyocd-git）（目前无法一条命令配置成功，并且有自己更改的部分，非 archlinux 用户不建议使用，硬要使用也可以下面有具体教程）
使用 gcc-arm-none-eabi 调试时请安装 gcc-arm-none-eabi 工具（archlinux 推荐使用 aur 工具输入 yay -S rt-gcc-arm-none-eabi）非 archlinux 用户请修改 armToolchainPath 和 gdbPath 到 gcc-arm-none-eabi 对应路径，archlinux 用户不用修改路径即可正常使用

pyocd 安装

pyocd 仓库 https://github.com/RT-Thread-Studio/sdk-debugger-pyocd.git
国内 gitee 镜像仓库 https://gitee.com/RT-Thread-Studio-Mirror/sdk-debugger-pyocd.git

Windows

git clone https://github.com/RT-Thread-Studio/sdk-debugger-pyocd.git

安装之后请修改 launch.json 中的 cwd 和 serverpath 值

linux

git clone https://github.com/RT-Thread-Studio/sdk-debugger-pyocd.git
python -m venv /opt/pyocd
/opt/pyocd/bin/pip install pyocd
cp -r sdk-debugger-pyocd/packs /opt/pyocd/bin
rm -rf sdk-debugger-pyocd
cd /opt/pyocd/bin/packs && python ./update_yaml.py
cd -