一.前言

本文是基于makefile+Jlink+GDB+VScode插件进行一键编译下载烧录
所以前提条件是需要一个Jink和你的工程是用makefile进行的(当然你不用makefile也行,但是必须得有.bin or .hex or .elf)。为什么一定要Jlink,后面再说。
这里就随便用STM32CUBEMX构建一个工程。
在这里插入图片描述

二.准备工作

2.1 环境搭建

编译、烧录、调试的核心都是利用VScode执行脚本,所以需要手动编写脚本,并导入到VScode的配置中,一键执行。为了使Shell程序能够正确执行命令,我们需要添加环境。

  • Jlink:核心是使用JLinkExe进行烧录,下载地址:https://www.segger.com/downloads/jlink/
    在这里插入图片描述需要通过.deb安装JLink驱动,否则需要自行添加环境。直到在shell环境下运行命令JLinkExe能出现以下界面(得插上Jlink哦):
    在这里插入图片描述
  • arm-gcc:下载地址https://developer.arm.com/downloads/-/gnu-rm下载解压,并在shell里根据喜好添加环境变量,比如/etc/environment
    我就在.bashrc里添加了,具体流程如图:
    在这里插入图片描述
    保存后,在shell里输入:arm-none-eabi-gcc -v,会出现gcc version的版本号, 输入arm-none-eabi-gdb会出现gdb的信息:
    在这里插入图片描述
    在这里插入图片描述
    如果缺少文件,可以试试:sudo apt-get install libncurses5

附上刚才的添加环境的代码:

gedit .bashrc
export PATH=$PATH:/home/kanna/gcc-arm-none-eabi-10.3-2021.10/bin
source .bashrc

2.2 VSCode导入项目

  • 打开VSCode主界面,左上角点击File-Open Folder,选择项目根目录即可:
    在这里插入图片描述

  • 修改代码权限:若以前使用eclipse会导致某些文档需要root权限,而由于VSCode的保护机制,我们并没有这些权限。如果项目存在root权限的文档,需要在根目录使用命令sudo chmod -R 777 ./*,会将所有目录与子目录修改为当前用户的权限。

2.3 安装插件

离线安装,需要在插件商城https://marketplace.visualstudio.com/vscode下载离线包.vsix然后手动选择离线包安装。当然也可以左侧商店栏搜索安装
在这里插入图片描述

必须安装:

  • C/C++ 提供C语言代码编写支持
  • Cortex-Debug 提供可视化调试

离线通过以下方式安装插件:
在这里插入图片描述

三.编译

3.1 编写脚本

在项目的根目录,也就是在Makefile同级目录下创建:flash.sh,写入并赋予权限
在这里插入图片描述

#!/bin/bash

JlinkScript="./flash.jlink"

if [ -f $JlinkScript ]; then
    rm $JlinkScript
fi
touch $JlinkScript
echo h > $JlinkScript
echo loadfile $1 >> $JlinkScript
echo r >> $JlinkScript
echo g >> $JlinkScript
echo exit >> $JlinkScript

JLinkExe -device STM32F103C8 -autoconnect 1 -if SWD -speed 4000 -CommanderScript $JlinkScript
  • 更多的命令可以在https://wiki.segger.com/J-Link_Commander查询
  • 如果不是hex或需要烧写到指定位置需要添加起始位置。
  • 这里的STM32F103C8可以填写Jlink支持的芯片,这就是为什么选Jlink,因为Jlink支持的芯片太多太多辣:
    支持以下芯片:https://www.segger.com/downloads/supported-devices.php

然后修改Makefile
具体什么意思你得去学习makefile的规则才行

flash:all
	@echo "start to flash:"
	@./flash.sh $(BUILD_DIR)/$(TARGET).hex

在这里插入图片描述
脚本添加成功后,在项目目录下用shell使用make flash -j12make flash等命令,均可实现下载:
在这里插入图片描述

3.2 配置脚本

在工程.vscode里添加tasks.json即可使用BuildRun Task..编译、烧录程序,举个最简单的例子:

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build",
            "type": "shell",
            "command": "make all -j12",
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        },
        {
            "label": "Download",
            "type": "shell",
            "command": "make flash -j12",
            "problemMatcher": [],
            "group": {
                "isDefault": false
            }
        },
    ]
}
  • 此时有快捷选项和快捷键的Build只是编译
    在这里插入图片描述

  • Run Task...选项手动选择运行的task,然后选择Download即可烧录
    在这里插入图片描述

  • 因为根据真实情况,通过编译验证代码是否有误的情况最多,所以将有快捷键和默认任务的Build绑定为编译。Download可以手动选择使用,亦或者通过Debug时自动烧录。当然,你也可修改自己的task.json执行自定义任务,毕竟VScode的核心是调用外部脚本。

四.调试

4.1 添加环境

安装Cortex-Debug之后,我们需要为该插件配置armToolchainPathJLinkGDBServerPath两个工具的路径,因为这个配置不在.vscode/下,所以是全局配置

将这两个工具的绝对路径添加到全局设置里(JlinkGDBServer一般就在这):

    "cortex-debug.armToolchainPath": "/home/kanna/gcc-arm-none-eabi-10.3-2021.10/bin",
    "cortex-debug.JLinkGDBServerPath": "/opt/SEGGER/JLink_V766g/JLinkGDBServer",

在这里插入图片描述

在这里插入图片描述

4.2 添加启动脚本

因为每一个项目的配置不一样,所以Debug然后根据项目配置,在.vscode/目录下添加launch.json

修改配置:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "cortex-debug",
            "request": "launch",
            "name": "Debug (J-Link)",
            "cwd": "${workspaceRoot}",
            "executable": "./build/C8T6.elf",
            "servertype": "jlink",
            "device": "STM32F103C8",
            "interface": "swd",
            "preLaunchTask": "Download",
            "runToEntryPoint": "main"
        }
    ]
}

解释一下:

  • preLaunchTask 可以添加我们在task.json里创建的任务,并且在Debug执行前,自动执行这些插件,所以我们可以添加刚才的烧录任务
  • 如果需要开始Debug后自动运行到主函数再暂停,可以将runToEntryPoint修改为true,否则改为false。这样可以更好的跳转到程序入口。
  • 该插件的更多脚本命令查询地址:https://lonesometraveler.github.io/2020/03/27/debug.html,可根据里面提供的项目自行配置。

4.3 使用

点击Start Debugging即可:

在这里插入图片描述

效果预览:

在这里插入图片描述

五.后记

前面.vscode里面的配置和.flash可以自己保存起来,添加到工程里方便。

还有就是使轻量级的编辑器VScode更强大的方式是安装更多的插件,笔者推荐几个:

  • C++ Intellisense:提供代码补全、实时错误检查与改进等功能

  • vscode-icons: 为左侧资源目录提供更好的浏览体验,根据文件不同,显示简明的图标

  • One Dark Pro:一个提供比默认暗色主题代码颜色层次更丰富的主题

  • 如果只使用虚拟机作为一个编译的工具,那么Windows的Linux子系统,Windows Subsystem for Linux(WSL)可能是比虚拟机更好的一个选择。
    在这里插入图片描述

Logo

更多推荐