如何使用VSCode开发/编译/下载/调试AT32 MCU

概述

VSCode（全称：Visual Studio Code）是一款由微软开发且跨平台的免费源代码编辑器。该软件支持语法高亮、代码自动补全（又称IntelliSense）、代码重构、查看定义功能，并且内置命令行工具和Git版本控制系统。用户可以更改主题和键盘快捷方式实现个性化设置，也可以通过内置的插件安装功能扩展软件功能。在2019年的Stack Overflow组织的开发者调查中，Visual Studio Code被认为是最受开发者欢迎的开发环境。
VSCode因为其轻量化、丰富的插件以及炫酷的界面等优点，当前成为了开发者热捧的开发工具。AT32提供在VSCode下开发、编译、下载、调试解决方法。只需安装所需要的软件工具并简单配置即可使用。本指南所使用的所有软件，目前都是开源的。

软件安装

Windows下环境配置

一、VSCode安装VSCode是微软开发的代码编辑器软件，可免费下载和使用，登录VSCode官网即可下载安装文件，注意在windows环境下需要下载对应的版本。图1. VSCode官方下载下载安装后打开VSCode界面如下图所示图2. VSCode界面注意安装完成后需要将VSCode安装路径加入到环境变量中，后续使用会更加方便。上图中的红色框内为安装的插件，C/C++和Cortex-debug必须安装，其他可选择性安装即可。

二、交叉编译工具链与MinGW安装

本小节说明如何安装arm交叉编译工具链和MinGW，以及openocd的使用。交叉编译工具链安装为了能使在windows平台下编译的代码在AT32 MCU上运行，需要安装ARM提供的交叉编译工具链。在本文档配套的代码包内可找到此软件(gcc-arm-none-eabi-10.3-2021.10-win32.exe)，然后双击运行安装即可。注意安装完成后需要添加系统环境变量。MinGW安装MinGW是Minimalist GNU for windows的缩写。它是可以自由使用自由发布的windows特定头文件和使用GNU工具集导入库的集合，可在windows平台生成本地的windows程序。其包括GCC编译器，所以本应用所使用的编译器为GCC。在本文档配套的代码包内可找到此软件(mingw-get-setup.exe)，双击运行即可安装。需要注意安装完成后需要添加系统环境变量。图3. MinGW设置到MinGW安装目录下，进入/bin目录，找到其中的mingw32-make.exe并复制一份放到相同目录下，修改命名为make.exe。

三、OpenOCD使用

Openocd可执行文件由雅特力提供，在本文档配套的代码包内可找到。使用时只需将其添加到系统环境变量即可，无需其他安装与配置。

四、环境变量配置

在系统中搜索“环境变量”，进入环境变量配置界面，确保前面所安装的软件都已添加到环境变量中；例如如下所示：图4. 环境变量设置上图为笔者系统下软件安装路径和环境变量配置，可作为参考。需要特别注意，如若环境变量安装路径不对，会导致VSCode编译下载代码等出错。

Linux下环境配置

下面介绍在linux下软件安装与环境配置（ubuntu系统为例）。

一、VSCode安装

下面介绍在ubuntu系统下VSCode的安装方式，只需在命令行输入如下命令即可一键安装VSCode：输入以上命令后耐心等待一会，安装完成会出现提示信息。安装成功之后，在命令行下只需输入code命令即可启动VSCode，如下图所示：图5. Linux下VSCode安装与启动

二、交叉编译工具链与OpenOCD安装

第一步：在arm官方网站下载好交叉编译工具链，也可使用本APPNOTE所提供的工具链，将其放在linux某个目录下；第二步：使用artery提供的OpenOCD软件，将其放在linux某个目录下；第三步：将交叉编译工具链和OpenOCD添加环境变量，例如将其放在/home/artery目录下，打开~/.bashrc文件，在末尾添加如下两行：图6. Linux下环境变量添加注：交叉编译工具链和OpenOCD在附带的software_tool文件夹下有提供，可直接使用。

Template使用

硬件环境

对应AT-START-BOARD搭配AT-Link

工程导入

模板工程分为windows和linux两个版本，在windows环境下使用：SourceCode\at32_vscode\template_for_windows目录下工程，在linux环境下使用：SourceCode\at32_vscode\tamplate_for_linux目录下工程。代码包内模板工程如下：图7. 模板工程如若环境安装正确，下面只需要将本文档配套的代码包内的模板工程文件夹使用VSCode打开即可。打开后工程目录如下所示：图8. 工程目录结构Libraries：主要存放artery芯片库文件；Project：工程相关配置文件以及用户代码；Makefile：编译器需要使用；.vscode：工程配置脚本。

配置修改

由于环境不同，软件安装的路径存在差异，所以需要进行环境适配。只需修改.vscode目录下的3个配置脚本即可。1. c_cpp_properties.json脚本修改图9. c_cpp_properties.json脚本上图中框起来的路径需要根据实际路径进行修改。2. launch.json脚本修改图10. launch.json脚本上图中框起来的路径需要根据实际路径进行修改。3. tasks.json脚本修改图11. tasks.json脚本上图中框起来的路径需要根据实际路径进行修改。

工程使用

通过以上配置，现在可以使用VSCode开发、编译、下载、调试AT32 MCU了。点击VSCode菜单栏TerminalàRun Task会出现如下界面：图12. 编译、下载和清除界面有clean、download code和build，点击这三个按钮分别执行如下操作：Build：编译代码；Clean：删除编译产生的文件；download code：下载代码到目标板。

编译下载代码后，点击VSCode菜单栏RunàStart Debugging即可进入调试状态：

图13. 调试界面进入调试界面后可进行单步执行等操作，也可查看外设寄存器值、变量值等操作。

IC型号修改

Template工程为各系列中单一型号，如果使用到其他型号需要按照如下步骤修改即可。

Makefile 文件修改

Makefile文件修改

Makefile文件如下红框内容需根据实际型号进行修改图14. Makefile修改.ld文件可在artery BSP内获取，路径如下：AT32F435_437_Firmware_Library_V2.x.x\libraries\cmsis\cm4\device_support\startup\gcc\linker理论上修改完makefile文件就可以顺利编译下载调试代码了，但在VSCode上阅读代码时会出现波浪线等警告提示，这是因为VSCode解释代码关系出错，还需要修改一下c_cpp_properties.json脚本

c_cpp_properties.json脚本修改

文件如下红框内容需根据实际型号进行修改：图15. c_cpp_propertie修改