Windows下环境配置
一、VSCode安装
VSCode是微软开发的代码编辑器软件,可免费下载和使用,登录VSCode官网即可下载安装文件,注意在windows环境下需要下载对应的版本。
下载安装后打开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文件,在末尾添加如下两行:
注:交叉编译工具链和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芯片库文件;
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文件如下红框内容需根据实际型号进行修改
图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修改