AT32_IDE_Linux用户手册（附IDE下载地址）

AT32_IDE_Linux工具下载链接：https://www.arterytek.com/download/TOOL/AT32_IDE_V1.0.02_Linux.zip

本手册用于介绍Artery AT32 IDE。AT32 IDE是个跨平台ARM嵌入式系统的软件开发环境。它包含一系列的Eclipse插件和工具。该插件可让用户在AT32 IDE开发环境下创建、建置和调试AT32 MCU。拥有下面这些特色。

l 使用雅特力项目向导创建项目：新项目向导为不同的雅特力目标MCU提供创建模板项目。

l 使用GNU ARM工具链来构建项目：该工具键包含ARM的GCC编译程序。用户可以不受限制地利用它来建置项目。

l 使用GDB来调试项目：用户可暂停、单步、运行和监视目标芯片。存取内存及闪存是允许的。支持设置硬件断点及检测点。此外，用户可以抹除目标芯片和编程用户配置。

支持雅特力型号:

AT32F403xx

AT32F403Axx

AT32F407xx

AT32F413xx

AT32F415xx

AT32F421xx

AT32F425xx

AT32F435xx

AT32F437xx

AT32WB415xx

1 引言

1.1 环境要求

1.2 名词解释

2 安装

2.1 在windows上安装AT32 IDE

2.1.1 运行安装程序，选择安装语言

2.1.2 选择目标位置

2.1.3 选择附件条件

2.1.4 准备安装

2.1.5 安装完成

2.2 在Linux上安装AT32 IDE

2.2.1 解压缩文件

2.2.2 安装GCC

2.2.3 配置udev设备访问权限

2.2.4 安装HIDAPI库

2.2.5 安装ncurses库

2.2.6 运行AT32 IDE

2.3 选择Workspace

3 新建项目

3.1 新项目向导

3.2 目标芯片配置

3.3 调试配置

3.4 GNU工具链配置

3.5 完成项目创建

3.6 构建项目

3.7 项目构建配置

4 调试项目

4.1 调试配置

4.1.1 Main标签页

4.1.2 Debugger标签页

4.2 启动调试

4.3 其他功能介绍

4.3.1 雅特力MCU项目模板插件的升级

4.3.2 切换中英文

4.3.3 打开用户手册

5 常见问题及解决方法

5.1 配置问题

5.2 调试问题

6 文档版本历史

1 引言

1.1 环境要求

软件要求

需要Windows 7及以上操作系统支持。

Linux发行版本支持Ubuntu 18.4及以上、Fedora 34及以上、Centos 7及以上。

使用AT-Link仿真器时，无需安装驱动。

使用J-Link仿真器时，需要安装J-Link仿真器的驱动程序。驱动程序需安裝J-Link v6.20c及其以上版本，安装J-Link v6.20c以下版本将无法使用本软件。

硬件要求

AT-Link仿真器。

J-Link仿真器。

PC/AT兼容机，Pentium或更高CPU。

XVGA(1024*768)颜色显示器。

至少512M RAM。

至少20M磁盘空间。

1.2 名词解释

AT-Link仿真器

AT-Link是Artery公司为支持仿真内核芯片推出的仿真器。

J-Link仿真器

J-Link是SEGGER公司为支持仿真内核芯片推出的仿真器。

2 安装

AT32 IDE提供安装程序，可直接运行安装程序，根据提示完成安装。安装程序包含有JRE运行环境、ARM工具链、GCC Make构建工具，不需要单独安装这些环境。

2.1 在windows上安装AT32 IDE

2.1.1 运行安装程序，选择安装语言

运行安装程序AT32IDE_V1.0.0_Setup.exe，根据需要选择安装语言，这里提供了简体中文和英文。选择安装语言后点确定按钮。

图1. 选择安装语言

2.1.2 选择目标位置

选择AT32 IDE的安装位置，指定安装路径时不要带有空格和中文字符，点击下一步继续安装。如下图所示：

图2. 选择目标位置

2.1.3 选择附件条件

选择是否需要创建桌面快捷方式。然后点下一步继续安装。

图3. 选择附件条件

2.1.4 准备安装

点击安装按钮，将进行AT32 IDE的安装，可以看到当前安装进度，直到安装完成。

图4. 正在安装

2.1.5 安装完成

AT32 IDE安装完成，如下图所示。

图5. 安装完成

2.2 在Linux上安装AT32 IDE

AT32 IDE支持的Linux发行版本目前测试了Ubuntu 18.4及以上、Fedora 34及以上、Centos 7及以上。这里以在Ubuntu 20.4上安装为例。

2.2.1 解压缩文件

将AT32IDE_for_Linux_V1.0.0.tar.gz拷贝到Ubuntu系统中，使用如下命令解压：

$ mkdir AT32IDE
$ tar –xvf AT32IDE.tar.gz –C AT32IDE

图6. 解压缩文件

2.2.2 安装GCC

如已经安装了GCC，则跳过。否则需要安装GCC。可以使用命令“gcc --version”查看是否安装了GCC。

GCC安装命令如下：

Ubuntu:

 $ sudo apt update$ sudo apt install build-essential

Fedora:

 $ sudo yum install gcc$ sudo yum install gcc-c++

Centos:

 $ sudo yum install –y gcc gcc-c++

图7. 安装gcc命令

2.2.3 配置udev设备访问权限

OpenOCD需要root用户才能访问udev设备。将OpenOCD/contrib目录中的60-openocd.rules文件复制到/etc/udev/rules.d目录下，命令取下：

 $ sudo cp AT32IDE/OpenOCD/contrib/60-openocd.rules /etc/udev/rules.d

图8. 配置udev设备访问权限

2.2.4 安装HIDAPI库

CMSIS支持需要HIDAPI库，使用如下命令安装：

Ubuntu:
$ sudo apt install libhidapi-devFedora：
$ sudo dnf install hiadpi-develCentos:
$ sudo yum install epel-release
$ sudo yum install hidapi-devel

图9. 安装HIDAPI库

2.2.5 安装ncurses库

arm-gone-eabi-gdb需要使用ncurses库，可以在终端运行arm-gone-eabi-gdb，查看是否能正常运行，如下图所示，则需要安装ncurses库。

图10. 执行arm-gone-eabi-gdb失败

安装命令：

 Ubuntu:$ sudo apt install libncurses5Fedora:$ sudo dnf install ncurses-compat-libs

Centos:

   $ sudo yum install ncurses-devel

图11. 安装ncurses库

2.2.6 运行AT32 IDE

进入AT32IDE目录，可以在终端中输入：. /AT32IDE运行，也可以直接双击AT32IDE运行。

图12. 运行AT32 IDE

2.3 选择Workspace

当AT32 IDE启动时，我们必须选择一个Workspace，其包含相关项目并构成一个应用程序。此外，AT32 IDE和项目的一些配置设置也存储在这里。对于不同的计算机，配置设置可能会有所不同。我们应该创建自己的Workspace，而不是复制其他用户的Workspace。一次只能有一个工作空间处于活动状态。若要切换Workspace，点选【文件】->【切换工作空间】。

图13. 选择工作空间

3 新建项目

3.1 新项目向导

AT32 ID提供支持雅特力MCU的C语言项目模板，方便用户快速创建项目。菜单栏【File】>【New】>【C Project】。新建项目向导的对话框将出现。在对话框内，输入项目名称，这里以AT32F403AVGT7为例，项目名称也输入AT32F403AVGT7；项目类型选择AT32F403A_407 C Project；工具链默认选择Arm Cross GCC，点击Next按钮继续。

图14. 新项目向导

3.2 目标芯片配置

根据实际目标MCU，选择AT32F403A对应的目标芯片，这里选择AT32F403AVGT7。外部时钟External clock一般默认都是0x8000000；其他配置根据实际选择。

图15. 目标芯片配置

3.3 调试配置

默认，点击Next继续

图16. 调试配置

3.4 GNU工具链配置

GNU工具链配置，默认选择GNU Tools for ARM Embedded Processors (arm-none-eabi-gcc)，工具链路径这里也集成到了AT32 IDE中，不需要单独进行选择。点击Finish创建项目。

如果不能自动选择Toolchain path，可以手动选择，gcc-arm-none-eabi和Build Tools都包含在了IDE的环境中。目录分别为：

gcc-arm-none-eabi的目录：AT32IDE\platform\tools\gcc-arm-none-eabi-10.3-2021.10\bin

Build Tools的目录：AT32IDE\platform\tools\Build Tools\bin。

图17. GNU工具链配置

3.5 完成项目创建

AT32F403AVGT7项目创建完成后，如下图所示：

图18. 完成项目创建

3.6 构建项目

右键单击项目，在弹出菜单中选择“Build Project”，或者选择项目，点击菜单栏的“Build Project”对项目进行构建，生成elf文件。如下图所示：

图19. 工具栏构建项目

图20. 构建项目

构建的项目日志在控制台进行打印。如下图所示：

图21. 构建结果

3.7 项目构建配置

项目创建完成之后，我们也可根据需要对项目构建重新配置。选择菜单【Project】>【Properties】或右键项目选择【Properties】，将出现项目的属性对话框。在C/C++ Build>Settings，我们可以根据实际情况来更改构建配置，点击应用按钮使配置生效。设置完成后，我们可以根据当前的配置重新构建项目。

图22. 构建配置

4 调试项目

4.1 调试配置

在启动程序调试前，必须先进行调试配置，包含所有关于调试所需的信息。

选择菜单【Run】>【Debug Configurations…】打开调试配置对话框。双击GDB AT-Link Debugging，将自动创建AT-Link调试配置，并再右边进行显示。所有的调试配置信息都会自动生成，一般可以不需要进行修改。

4.1.1 Main标签页

Main标签页中，项目应与创建创建的项目名称一致，创建时会自动生成。C/C++程序一般会自动搜索项目中构建的elf文件，这里自动填写Debug\xxxxx.elf。如果没有提前构建项目，找不到elf文件，则自动填写Debug${project_name}.elf，当构建产生以项目名称命名的elf时，这里的配置也可以正常使用。

图23. Main标签页

4.1.2 Debugger标签页

Debugger标签页中的信息创建时也自动进行了配置。OpenOCD的执行程序和脚本文件配置路劲是相对路劲，因为这些工具都已近存放在AT32 IDE的安装文件中。这里自动配置了执行程序路径、SVD文件路径，并根据芯片类型配置了Config options。当然也可以根据实际情况就行修改。如需要使用WinUSB，则需要勾选“WinUSB”，则Config options的信息中将自动配置为“-f ./interface/atlink_dap_v2.cfg”。

如下图所示：

图24. Debugger标签页

4.2 启动调试

选择上一步创建的调试配置“AT42F403AVGT7 Debug”，并点击工具栏“Launch in ‘Debug’ mode”按钮，启动项目调试。如下图所示：

图25. 启动调试

弹出切换透视图对话框，点击“切换”按钮切换到Debugger透视图。如下图所示：

图26. 切换透视图

项目启动调试，并切换到调试透视图。在调试透视图可以进行各种调试功能操作。如查看变量值、表达式值、外围寄存器等。如下图所示：

图27.调试透视图

4.3 其他功能介绍

4.3.1 雅特力MCU项目模板插件的升级

雅特力MCU项目模板会随着BSP的更新，需要对项目模板插件进行升级。雅特力MCU项目模板插件可以在雅特力官网下载。升级方式与Eclipse的插件离线安装方式一致。

选择菜单【Help】>【Install New Software…】打开安装对话框。点击“Add…”按钮打开Add Repository对话框，点击“Archive…”按钮，选择插件压缩包“org.eclipse.embedcdt.repository-6.2.1-SNAPSHOT.zip”，并点击“Add”按钮。如下图所示：

图28.添加插件

AT32 IDE将会自动分析项目模板压缩包里面的所有插件，将在信息列表中显示出来。列表中勾选上所有项目，并取消勾选“Contact all update sites during install to find required software”,点击“Next”按钮。如下图所示：

图29.显示安装插件信息列表

安装细节显示了所有需要安装的插件，点击“Finish”按钮完成。回到AT32 IDE主程序，在右下角有安装进度，可以点击打开“进度视图”查看当前安装的进度。安装完成后，将弹出“Trust”对话框，点击“Select All”，然后勾选“Always trust all content”，在弹出的“Always Trust Everything Configuration”对话框点击“Yes, I Accept the Risk”。回到“Trust”对话框点击下方的“Trust selected”按钮，这时插件更新完成，在弹出的“Software Updates”对话框，点击“Restart Now”按钮重启AT32 IDE。如下图所示：

图30.安装进度

图31.重启

4.3.2 切换中英文

选择菜单【Help】>【Change Language】打开中英文选择对话框。选择需要切换的语言，然后“OK”按钮。在弹出的是否重启对话框中选择“Yes”，重启AT32 IDE，这时语言切换成功。如下图所示：

图32.切换语言

4.3.3 打开用户手册

选择菜单【Help】>【Open User Manul】启动打开AT32 IDE的用户手册。

5 常见问题及解决方法

本章节总结一些使用中经常遇到的问题的解决方法，使用中可以作为参考。

5.1 配置问题

编译时提示如下信息：

“ Cannot run program “make”: Launching failed. Error: Program “make”not found in PATH。”

分析原因及解决方法：这种情况是一般是GCC Make构建工具没有正确配置。ARM工具链、GCC Make构建工具配置路径在AT32 IDE中会默认配置。如果出现这种情况，可能是GCC Make构建工具默认配置没有生效。

如果是Windows系统，配置方法是在菜单栏选择【Windows】，并打开【Preferences】，在MCU配置的Global Build Tools Path中配置路径为“${eclipse_home}/platform/tools/Build Tools/bin”。另外Global Arm Toolchains Path默认配置为
“{eclipse_home}/platform/tools/gcc-arm-none-eabi-10.3-2021.10/bin”。

如果是Linux系统，可能是没有安装GCC，可以参考2.2.2安装GCC。

5.2 调试问题

调试时出现如下错误提示：

“Error: please select the matching algorithm

Error: auto_probe failed

Error: Connect failed. Consider setting up a gdb-attach event for the target to prepare target for GDB connect, or use ‘gdb_memory_map disable’.

Error: attempted ‘gdb’ connection rejected”

分析原因及解决方法：这种情况检查一下是否接了多个AT-Link连接，这样可能出现不能正确找到我们需要调试的MCU。如果只接一个AT-Link，那么需要检查一下MCU是否被锁死或者处于保护状态。

调试时卡住不动，也没有错误提示。

分析原因及解决方法：请检查工程创建时选择的MCU型号与开发板MCU型号不一致。

AT32_IDE_Linux用户手册（附IDE下载地址）相关推荐

收藏！程序员必备的软件开发工具大全！（附高速下载地址）
对于每一位开发者而言,软件开发工具的重要性显然不言而喻.事实上,除了个人能力之外,它们也在团队的效率及实际生产力层面扮演着关键性角色. 今天阿晨就把自己的私货全部掏出来整理在下面! 内附高速下载地址! ...
【教程转载】火狐浏览器实用插件一览（附插件下载地址）
[教程转载] 火狐浏览器实用插件一览(附插件下载地址)简单介绍一下: 火狐浏览器(firefox)最大的优点就是安全.快速.稳定. 有些人抱怨火狐的功能太少,有些网页不能正常浏览. 没关系,这些都不 ...
技术经典图书(附电子版下载地址)
本人大学期间专业是数学与应用数学, 2011年毕业, 做过C开发, 系统运维和测试, 这3年我读了很多书, 电子书和纸质的, 这些书中有很多很经典的图书和资料, 平时也喜欢和同事,朋友分享一些对他们有 ...
Microsoft Edge浏览器最新版已经换成开源Chromium引擎了，附官方下载地址
基于 Chromium 的新版 Microsoft Edge 已于 2020 年 1 月 15 日发布.它与 Windows 和 macOS 的所有受支持版本兼容.下载新版浏览器将替换 Window ...
【干货】31篇关于深度学习必读论文汇总(附论文下载地址)
Kloud Strife在其博客上盘点了最值得关注的有关深度学习的论文,包括架构/模型.生成模型.强化学习.SGD & 优化及理论等各个方面,有些论文名扬四海,有些论文则非常低调.可以根据个人 ...
m3u8.sqlite转mp4(txkt，文末附程序下载地址)
中秋节放假,本想好好休息一下,女朋友说手机里下载了的腾讯课堂的课程能不能够传到电脑上面去,因为手机的空间不够了,我心想这不是很简单吗.. 果然,事情没我想的那么简单,找到了腾讯课堂的视频缓存目录 /A ...
【CTF】记录一次CTF比赛的Writeup（附题目下载地址）
0x00 前言最近因为省赛快来了,因此为实验室的小伙伴准备了这次比赛,总共10道题目,考虑到大多数小伙伴都刚从大一升到大二,因此整体难度不高,当然有几道难度还是有的. 题目大多数都是从网上东找西找的 ...
安装Fedora(附镜像下载地址)
近期又试着装了一遍Fedora,强迫症迫使我写一些简单的教程,方便以后有用先把VM配置好,然后进入Fedora 点击Skip 这几按照提示一步一步来选个人桌面手工分区分区的时候注意下每个区的容 ...
2017年深度学习必读31篇论文（附论文下载地址）
新智元报道来源:kloudstrifeblog.wordpress.com 作者:Kloud Strife 译者:刘光明,费欣欣 2017年即将擦肩而过,Kloud Strife在其博客上盘 ...

AT32_IDE_Linux用户手册（附IDE下载地址）

AT32_IDE_Linux用户手册（附IDE下载地址）相关推荐

最新文章

热门文章