| AN0075 应用笔记 |
| AT32基于RT-Thread Studio开发 |
前言
这篇应用笔记描述了AT32系列MCU使用RT-Thread Studio IDE进行开发的注意事项和配置步骤。
支持型号列表：
| 支持型号 | AT32F系列 |
目录
表目录
RT-Thread Studio是睿赛德科技推出的一个免费易用的IDE工具，其开发环境内集成了RT-Thread操作系统的各模块组件，并且将系统裁剪部分的配置工作进行了图形界面优化，使得系统裁剪和组件配置更简单易用。目前，在其新版的RT-Thread Studio中已完善了对AT32系列部分MCU的支持，接下来将对在RT-Thread Studio中进行AT32系列MCU的开发步骤和注意事项作个介绍。
最新版RT-Thread Studio可在RT-Thread的官方网站进行下载，下载页面网址如下：http://www.rt-thread.org/page/download.html#studio 。
当我们下载完成后点击*.exe即可进行安装，默认安装即可，详细步骤就不再累述。
安装完成后初次打开RT-Thread Studio需要联网并进行账号的注册和登录，登录一次后会自动记住账号，后续不再需要再次登录，登录支持第三方账号登录（最好是注册账号进行登录）。
图1. 注册登录界面
在第一次登录后会跳出欢迎界面，然后即可进入RT-Thread Studio的开发界面，开发界面是整个IDE的主体，里面包含着众多的设置选项和配置栏，但这些与其他的IDE工具除了显示上的区别以外，内容和功能上都大同小异，对于刚开始用RT-Thread Studio我们只需关注其特殊的地方即可，
安装芯片支持包可通过在线安装和离线安装两种方式进行，在此主要将RT-Thread安装芯片支持包的方法介绍一下。
在线安装时IDE会通过SDK包管理工具自动进行支持包的下载。步骤如下：1、点击“SDK Manager”-> 2、选择AT32芯片支持包 –> 3、点击“Install Packages”，流程如下图所示：
图2. 在线安装芯片支持包流程
可能图2显示芯片支持包版本信息与实际不一致，点击最新版下载即可。
注：所有下载及安装环境都需要联网支持。
离线安装时需要在PC机上准备好已做好的支持包以供安装时进行使用，其文件名如：sdk-csp-at32f4.zip。步骤如下：1、点击“SDK Manager”-> 2、点击“File” -> 3、点击“Import resource pack” -> 4、点击“Browse”，选择存储于PC上的离线包 -> 5、点击“OK”。流程如下图所示：
图3. 离线安装芯片支持包流程
图4. 选择芯片离线支持包
不管是在线安装还是离线安装，待成功安装后都可以看到芯片支持包状态由“Not installed”转变为“Installed”，如下图所示：
图5. AT32芯片支持包安装成功
当AT32芯片支持包成功安装后，在后续的新建工程中即可进行AT32芯片型号的选择和配置，与AT32芯片相配套的底层驱动文件也会一并导入到新建的工程内，视工程类型（裸机工程、Nano工程、完整版工程）而导入相对应的驱动文件。
采用RT-Thread Studio进行项目开发时与AT32芯片相关的内容主要在工程创建部分，在工程新建的过程中需要对生产厂家、芯片系列和芯片型号等芯片所属信息进行选择，还有就是控制台串口、串口Pin脚、调试适配器等功能参数的配置。
在RT-Thread Studio主界面按如下步骤创建工程：1、点击“File”-> 2、点击“New”-> 3、选择“Project…”，如下图所示：
图6. 新建工程步骤
进入工程选项后，会有三个选项可供选择：1、裸机工程（Bare-Board Project），2、Nano工程（RT-Thread Nano Project），3、完整版工程（RT-Thread Project）。如下图所示：
图7. 项目类型选择
以上三种项目类型的工程创建流程基本一致，接下来就以创建完整版工程（RT-Thread Project）来进行示例说明。在选择“RT-Thread Project”后点击“Next>”，会弹出详细参数的配置界面，如下图所示：
图8. 项目参数配置
此部分主要进行一些项目参数的设置，如：项目名、存储路径、RT-Thread版本和芯片相关的信息。在成功安装AT32芯片支持包后，在这里就可以对AT32所支持的部分MCU型号进行选择。在Vendor栏应选择“ArteryTek”，Series栏选择“AT32F4”，在线安装包Subseries栏目前仅支持AT32F403A和AT32F407系列（后续会增加，以安装的AT32芯片支持包为准），MCU栏对应着详细的芯片型号（按实际情况进行选择），Console UART栏是设置控制台串口及收发Pin脚，Adapter栏是对应调试器的选择及调试接口方式J-Link及DAP-LINK，Port栏是进行调试器接口的选择（JTAG及SWD），因ArteryTek官方提供的AT-START开发板的AT-LINK接口默认是SWD，故此选择框最好选择SWD方式。以上选择完毕之后点击“Next>”或“Finish”即可生成设置好的工程，并在此工程环境上进行开发。
在工程成功创建之后即可对工程进行编译，步骤如下：1、点击选择新建的工程名 -->2、点击编译按钮-->3、编译完成后查看输出信息
图9. 编译步骤
在成功编译完成后即可进行下载和调试。在“Flash Download”按钮的下拉框也可进行下载适配器（J-LINK和DAP-LINK）的选择，如使用AT-START板载的AT-LINK进行下载，请勾择DAP-LINK选项，适配器选好之后点击“Flash Download”按钮即可进行下载。
图10. 下载步骤
需要进行在线Debug时，点击“Debug Launch”按钮可以进行下载和调试，如下图所示，在线调试可以单步或全速运行，也可以实时查看寄存器信息（如下图右侧）
图11. 在线调试
使用RT-Thread Studio进行开发时需注意：
- 在进行AT32系列MCU开发时，首先需要进行芯片支持包的安装。
- 在使用到某些组件包来进行开发时，需联网在线下载。
- 选择DAP-LINK方式进行下载时，因适配原因可能会导致下载错误，请选择Chip erase方式。步骤如下：
图12. 擦除方式设置
- 使用离线安装方式安装的芯片支持包，由于IDE本身原因，在进行在线debug时可能外设寄存器窗口无法查看，可按如下方式进行修改：使用“Local”替换“Extract”，步骤如下：
图13. svd路径设置
- 在确定芯片型号的硬件不支持“FPU”时，如：AT32F415，请在编译选项中关闭硬件FPU的支持，采用软浮点方式进行编译，以避免C库或一些异常的问题，步骤如下：
图14. 编译选项FPU设置
表1. 文档版本历史
| 日期 | 版本 | 变更 |
| 2022.04.25 | 2.0.0 | 最初版本 |
224
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
