|
前言 Eclipse是著名的跨平台的自由集成开发环境(IDE),通过安装不同的插件Eclipse可以支持不同的计算机语言,比如C/C++等,Eclipse本身只是一个框架平台,众多的Eclipse插件使其拥有很高的灵活性,软件可以以Eclipse为架构开发自己的IDE。 这边文档主要描述怎样用现成的Eclipse插件来调试AT32系列芯片。 支持型号列表:AT32全系列 1 概述本文档介绍通过使用Eclipse,ARM-GCC编译工具,GNU-ARM插件,Jlink,ATLink等资源来调试AT32系列芯片。 本文档主要介绍: l Eclipse 调试环境安装 l Eclipse template工程 l Eclipse 编译配置 l Eclipse 调试配置 环境说明:本文档安装说明基于WINDOWS 7 x64系统下实现,使用AT32Fxx_Firmware_Library\project\at_start_xx\templates\eclipse_gcc下的工程进行说明。 本文档所使用的软件都打包在AT32_Eclipse_Packet.zip,直接解压即可安装运行
AT32_Eclipse_Packet.zip包含文件: 2 Eclipse调试环境安装首先要明确需要安装哪些软件,如下是需要安装的软件: l Eclipse IDE for C/C++Developers l GNU ARM Eclipse 插件 l GCC ARM 编译器 l GNU ARM Eclipse BuildTools 安装 (make,rm等工具)
下面将详细介绍软件的安装部分。
2.1 Eclipse IDE for C/C++ Developers 安装Eclipse有多个版本,我们只需下载C/C++的版本,下载最新版本,AT32_Eclipse_Packet.zip包含有一个可以使用的版本eclipse-cpp-2019-06-R-win32-x86_64.zip。
下载完成后直接解压eclipse-cpp-2019-06-R-win32-x86_64.zip,这里我们直接点击eclipse.exe 就可以运行Eclipse,但此时还不能进行代码调试,需要进一步安装一下插件。
2.2 GNU ARM Eclipse插件安装下载最新的GNU ARM Eclipse插件:ilg.gnumcueclipse.repository-4.5.1-201901011632.zip并解压。 AT32_Eclipse_Packet.zip 包含有一个可以使用的版本ilg.gnumcueclipse.repository-4.5.1-201901011632.zip。 开始安装: 1. 打开EclipseHelp->Install New Software. 2. 点击 “Add...” 3. 添加一个本地插件,也可以使用网络路径自动下载安装 4. 选择本地插件解压目录,点击 ”Add” 5. 勾选所有的插件,“Next“ 6. 安装完成 “Next“ 7. “Install anyway” 8. 重启Eclipse 2.3 ARM GCC 编译工具链安装下载最新的编译工具链gcc-arm-none-eabi-8-2019-q3-update-win32-sha2.exe AT32_Eclipse_Packet.zip包含有一个可以使用的版本gcc-arm-none-eabi-8-2019-q3-update-win32-sha2.exe。 开始安装: 1. 选择语言 2. 安装向导,点击“下一步” 3. 许可证协议,点击”我接受“ 4.选择安装位置,安装到默认位置,点击 “安装“,进入安装过程 5.安装完成界面,要将” Add path to environment variable “选项勾上,会自动添加到环境变量之中,否则需要手动添加环境变量。 6.安装完成之后在弹出的命令窗口中输入 arm-none-eabi-gcc –v,会显示一些版本信息,表示安装成功。 2.4 GNU ARM Eclipse Build Tools 安装此部分主要是安装make,rm等命令。 AT32_Eclipse_Packet.zip包含有一个可以使用的版本gnuarmeclipse-build-tools-win64-2.6-201507152002-setup.exe,或者下载其它适用版本。 1. 运行安装包 2. 选择安装路径 3.安装完成 需要重启Eclipse 2.5 安装Jlink需要将AT32 系列芯片拷贝到Jlink目录,目前可使用ICP完成拷贝工作 1. Jlink 安装(略) 此部分按照下载最新的Jlink进行安装即可 2. 算法文件拷贝 为了Jlink能够识别和下载程序到AT32芯片,可以将AT32 芯片的下载算法拷贝到Jlink目录中,这里有个简单的方法是使用最新的ICP,直接运行ICP,ICP会将相应的AT32 算法拷贝的Jlink目录。 3 template工程配置与编译本章介绍如何使用template工程,工程路径:AT32Fxx_Firmware_Library\project\at_start_xx\templates\eclipse_gcc 本章以AT32F437为例说明工程的配置与编译 3.1 打开template工程 1. 选择FileàOpen Projects from File System..2. 在Import source中选择路径,然后点击Finish。AT32F437xx template路径如下,其它系列路径类似xxx\AT32F435_437_Firmware_Library\project\at_start_f437\templates\eclipse_gcc\template 3. 工程打开之后看到一个template的项目工程如下 3.2 编译在编译过程中,需要对头文件的路径,以及一些芯片宏的定义,此部分在template工程有对应都有配置。配置包括如下内容 l 芯片配置 l 头文件路径配置 l 宏定义配置 l 链接脚本文件配置(不同型号之前ld文件会涉及到要修改)
1. 右键选择template工程,选择Build Project 2 编译结束之后会生成template.elf 3. 对于同一系列不同型号的配置,只需要修改ld文件即可,在下图的setting中修改。另外,其它如果要修改的如头文件路径等也是在下图setting中对应选项中修改即可。 4 调试本章分别描述用jlink和atlink调试at32系列芯片。 4.1 Jlink调试本部分主要说明调试的一些配置: l Jlink配置 l GDB配置 l SVD 外设寄存器配置 4.1.1 Debug配置1. “Run” à ” Debug Configurations”à”GDB SEGGER J-Link Debugging”à“New Configuration” 建立一个新的Debug配置,配置JlinkGDBServerCL,Devicename根据需要调试的具体芯片型号填写,例如AT32F437ZMT7,AT32F413RCT7,AT32F415RCT7等 2. 配置GDB,选择GCC 安装目录下的arm-none-eabi-gdb.exe
3. SVD Path选择,用于Debug寄存器的描述,这里可以直接使用keil下的svd文件,当安装了AT32 的keil Packet之后,会自动将svd拷贝到keil 目录下。 4. Debug 配置完成 à “Apply”à”Debug” 进入调试 4.2 ATLink调试本部分主要说明使用OpenOCD + Eclipse + ATLink来调试AT32。关于ATLink的使用说明请参考《AT-Link_User_Manual_SC.pdf》 本节主要说明如下内容: l Eclipse Openocd配置 l GDB配置 l SVD 外设寄存器配置 在解压OpenOCD包文件<<OpenOCD_V2.x.x.zip>> 包含5个目录,bin文件下为可执行exe,scripts目录为配置文件目录 4.2.1 Debug配置1. 配置OpenOCD路径,ProjectàPropertiesàMCUàOpenOCD Path 2. “Run” à ” Debug Configurations” à”GDB OpenOCD Debugging”à“New Configuration” 建立一个新的Debug配置 可配置项如下: openocd的可执行文件路径:D:\OpenOCD\bin\openocd.exe Config options: -s ${openocd_path}\scripts-f ./interface/atlink.cfg -f ./target/at32f437xM.cfg atlink.cfg表示使用atlink调试工具,at32f437xM.cfg表示at32f437 FLASH有4032KB的型号,其它AT32F437的型号可统一使用at32f437xx.cfg。对于不同的系列,如AT32F403A,AT32F415等此处对应的target/xxx.cfg需要做对应的修改。 3. 配置SVD文件
可下载对应型号的SVD文件用于Debug 4. Debug 配置完成 à “Apply”à”Debug” 进入调试
|