教程：ubuntu 下 vscode 编译下载调试 rt-thread stm32 程序

发布于 2019-08-07 00:25:35 浏览：7697 订阅该版

先上结果：

调试效果预览图.png

步骤一：rt-thread 源码下载及编译

步骤一可跳过，参考下面官方文档链接里更详细的说明

下载 rt-thread 国内镜像源码

git clone https://gitee.com/rtthread/rt-thread.git

sudo apt install scons

sudo apt install libncurses5-dev

解压 gcc-arm-none-eabi 工具链到指定目录:

解压gcc.png

进入 rt-thread/bsp/stm32/stm32f429-atk-apollo 目录，执行命令 scons --dist ,生成一个干净单一的 stm32f429 工程。
将 rt-thread/bsp/stm32/stm32f429-atk-apollo/dist 目录下的 stm32 工程拷贝到你喜欢的地方。

进入刚刚拷贝的 stm32 工程里，编辑 rtconfig.py 文件。

编辑rtconfig.png

将 gcc-arm-none-eabi 工具链的路径填入如下图相应的位置。

编辑rtconfig填入gcc路径.png

在拷贝的工程目录下输入 scons 命令即可编译 rt-thread 源码。

scons编译rt-thread1.png

scons编译rt-thread2.png

步骤二： openOCD 最新源码下载编译及安装

下载 openocd 在 github 上的最新镜像源码

git clone https://github.com/ntfreak/openocd.git

openocd源码下载.png

安装编译 openocd 需要的相关库

sudo apt-get install build-essential pkg-config autoconf automake libtool libusb-dev libusb-1.0-0-dev libhidapi-dev

sudo apt-get install libtool libsysfs-dev

openocd相关库安装.png
openocd相关库安装2.png

编译安装

sudo ./bootstrap

openocd编译安装1.png

sudo ./configure

openocd编译安装2.png

sudo make

openocd编译安装

sudo make install

openocd编译安装

使用测试

openocd --version

openocd编译安装

sudo openocd -f /usr/local/share/openocd/scripts/interface/cmsis-dap.cfg -f /usr/local/share/openocd/scripts/target/stm32f4x.cfg

我使用的仿真器是 DAP ，目标开发板芯片是 STM32F429 。如果你使用的是其他仿真器以及目标芯片，只需将 cmsis-dap.cfg , stm32f4x.cfg 替换即可。

openocd测试

上述步骤开启了 GDB 服务器，此时我们需要使用 telnet 登录到这个服务器，进行一些测试操作。

telnet localhost 4444

输入 halt 命令，芯片停止运行。

halt

输入 reset 命令，芯片复位重启。

reset

openocd测试

如果要烧录 bin 文件到目标芯片，先输入 halt 停止芯片，然后输入

flash write_image erase /home/tang/Desktop/stm32f429-atk-apollo/rtthread.bin 0x8000000

烧录 bin 文件到目标芯片，地址为 0x8000000。如下图所示：

flash write_image erase /home/tang/Desktop/stm32f429-atk-apollo/rtthread.bin 0x8000000

openocd测试

以上步骤是 rt-thread 源码的编译与下载，后面等我整理完接下来的步骤截图，将介绍如何使用 vscode + openocd + gcc-arm-none-eabi-gdb 调试代码。

步骤三： ubuntu 下 vscode 单步调试 rt-thread 程序

效果预览

未完待续。。。。。。

调试效果预览图

36 个回答

来一颗糖 2019-08-07

这家伙很懒，什么也没写！

步骤三： ubuntu 下 vscode 单步调试 rt-thread 程序

进入用户主目录，编辑该目录下的 .profile 文件,将 gcc-arm-none-eabi 工具链的路径添加到环境变量中。

将工具链加入到环境变量中1.png

在 .profile 文件末尾加上

export PATH=/home/tang/toolchain/gcc-arm-none-eabi-8-2019-q3-update/bin:$PATH

将工具链加入到环境变量中2.png

输入命令

soruce ~/.profile

使刚刚配置的环境变量生效。

将工具链加入到环境变量中3.png

进入我们先前拷贝的 stm32 工程目录，输入 scons —target=vsc 命令生成，vscode 的文件索引。

scons --target=vsc -s

生成vscode文件索引.png

输入 code ./ 命令打开 vscode 。

code ./

打开vscode.png

给 vscode 添加任务

vscode任务1.png

编辑 task.json 文件，添加如下三个任务：

1. openocd server：用于开启 openocd GDB 服务器。
1. rebuild：用于重新编译工程。
1. build：用于编译工程。

vscode任务2.png

task.json 文件内容如下：

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "openocd",
            "type": "shell",
            "command": "sudo openocd -f /usr/local/share/openocd/scripts/interface/cmsis-dap.cfg -f /usr/local/share/openocd/scripts/target/stm32f4x.cfg && exit"
        },
        {
            "label": "scons",
            "type": "shell",
            "command": "scons -c && scons -j4 && exit",
            "problemMatcher": []
        },
        {
            "label": "telnet localhost 4444",
            "type": "shell",
            "command": "telnet localhost 4444 && exit"
        }
    ],
}

为 vscode 添加 Debug 配置

vscode添加调试1.png

编辑 launch.json 文件，需要注意修改的地方如下图红框框所示：

vscode添加调试2.png

launch.json 文件内容如下：

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "debug Launch",
            "type": "cppdbg",
            "request": "launch",
            "targetArchitecture": "arm",
            "program": "stm32",
            "args": [""],
            "stopAtEntry": true,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "/home/tang/toolchain/gcc-arm-none-eabi-8-2019-q3-update/bin/arm-none-eabi-gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "launchCompleteCommand": "None",
            "miDebuggerServerAddress": "localhost:3333",
            "customLaunchSetupCommands": [
                {
                    "text": "target remote :3333",
                    "description": "connect to server",
                    "ignoreFailures": false
                },
                {
                    "text": "file /home/tang/workspace/stm32f429-atk-apollo/rt-thread.elf",
                    "description": "load file to gdb",
                    "ignoreFailures": false
                },
                {
                    "text": "load",
                    "description": "download file to MCU",
                    "ignoreFailures": false
                },
                {
                    "text": "monitor reset",
                    "description": "reset MCU",
                    "ignoreFailures": false
                },
                {
                    "text": "b main",
                    "description": "set breakpoints at main",
                    "ignoreFailures": false
                },
            ]
        }
    ]
}