GPIO特性

• 最大封装（64pin）具有55个多功能双向的I/O口

• 所有I/O口都可以映射到16个外部中断

• 几乎所有I/O口可容忍5V输入信号

• 所有I/O口均为快速I/O，寄存器存取速度最高f_AHB

• I/O引脚的外设功能可以通过一个特定的操作锁定，以避免意外的写入I/O寄存器

• 每个GPIO引脚都可以由软件配置成输出(推挽或开漏)、输入(带或不带上拉或下拉)或复用的外设功能端口

• 可选的每个I/O口的电流推动/吸入能力

• GPIO设置/清除寄存器（GPIOx_SCR）和GPIO清除寄存器（GPIOx_CLR）为GPIOx_ODT寄存器提供位访问能力
  

GPIO

GPIO在复位期间和刚复位后，复用功能未开启，大部分I/O端口被配置成浮空输入模式。当作为输出配置时，写到输出数据寄存器（GPIOx_ODT）上的值会输出到相应的I/O引脚。可以以推挽模式或开漏模式（仅低电平被驱动，高电平表现为高阻）使用输出驱动器。输入数据寄存器（GPIOx_IDT）在每个AHB时钟周期捕捉I/O引脚上的数据。所有GPIO引脚有一个内部弱上拉和弱下拉，它们被激活或断开有赖于GPIOx_PULL寄存器的值。

图1. GPIO基本结构

表1. GPIO配置表

GPIO toggle

AT32F425提供的I/O口均为快速I/O，寄存器存取速度最高为fAHB，所以可以看到GPIO翻转频率能够轻松达到48MHz：

图2. I/O翻转速度

IO引脚的5V or 3.3V容忍

一、标准3.3V容忍引脚（TC）

所有振荡器用到的引脚都是标准3.3V容忍引脚。

• PA9–PA12(TSSOP20封装的PA9/10引脚不具FT 5V电平容忍特性)

• PC14/PC15(LEXT_IN/OUT)

• PF0/PF1(HEXT_IN/OUT)

表2. TC引脚示例

二、带模拟功能5V容忍引脚（FTa）

ADC占用端口为带模拟功能5V容忍引脚。

• PA0–PA7

• PB0–PB2

• PC0–PC5

• FTa引脚设置为输入浮空、输入上拉、或输入下拉时，具有5V电平容忍特性；设置为模拟模式时，不具5V电平容忍特性，此时输入电平必须小于VDD+0.3V

表3. FTa引脚示例

三、带20mA吸入能力5V容忍引脚（FTf）

部分I2C占用端口为带20mA吸入能力的5V容忍引脚，用以支持I2C的增强快速模式。

• PB8–PB9

• PB13–PB14

表4. FTf引脚示例

四、5V容忍引脚（FT）

其余的GPIO都为5V容忍引脚。

表5. FT引脚示例

IOMUX

I/O复用功能输入/输出

• 大多数外设共享同一个GPIO引脚（比如PA0，可作为TMR1_EXT/USART2_CTS/I2C2_SCL/USART4_TX..）

• 而对某个具体的GPIO引脚，在任意时刻只有一个外设能够与之相连

• 某些外设功能还可以重映射到其他引脚，从而使得能同时使用的外设数量更多

选择每个端口线的有效复用功能之一是由两个寄存器来决定的，分别是GPIOx_MUXL和GPIOx_MUXH复用功能寄存器。可根据应用的需求用这两寄存器连接复用功能模块到其他引脚。

表6. 通过GPIOA_MUX寄存器配置端口A的复用功能

表7. 通过GPIOB_MUX寄存器配置端口B的复用功能

表8. 通过GPIOC_MUX寄存器配置端口B的复用功能

表9. 通过GPIOD_MUX寄存器配置端口D的复用功能

表10. 通过GPIOF_MUX寄存器配置端口F的复用功能

特殊I/O

一、调试复用引脚

• 在复位时，和复位后不像其他GPIO一样处于浮空输入状态，而是处于复用模式

• PA13：SWDIO，复用上拉

• PA14：SWCLK，复用下拉

二、振荡器复用引脚

• 振荡器关闭的状态下（复位后的默认状态），相关引脚可用作GPIO

• 振荡器使能状态下，相应引脚的GPIO配置无效

• 振荡器处于bypass模式（使用外部时钟源）时，LEXT_IN/HEXT_IN为振荡器时钟输入引脚，LEXT_OUT/HEXT_OUT可做GPIO使用

三、电池供电域下的引脚

• 电池供电域下的引脚包括PC13、PC14以及PC15，电池供电域由VDD供电。

• PC13可以作为通用I/O口、TAMPER引脚、ERTC校准时钟、ERTC闹钟或秒输出，PC14和PC15可以用于GPIO或LEXT引脚。（PC13至PC15作为I/O口的速度必须限制在2MHz以下，最大负载为30pF，而且这些I/O口绝对不能当作电流源）。
  

GPIO固件驱动程序API

Artery提供的固件驱动程序包含了一系列固件函数来管理GPIO的下列功能：

• 初始化配置

• 读取输入端口或某个输入引脚

• 读取输出端口或某个输出引脚

• 设置或清除某个引脚的输出

• 锁定引脚

• 引脚的复用功能配置

注：所有project都是基于keil5而建立，若用户需要在其他编译环境上使用，请参考AT32xxx_Firmware_Library_V2.x.x\project\at_start_xxx\templates中各种编译环境（例如IAR6/7,keil4/5）进行简单修改即可。

输出模式

GPIO提供了两种不同类型的输出模式分别是，推挽输出以及开漏输出，下面是输出模式的配置示例：

输入模式

GPIO提供了三种不同类型的输入模式分别是，浮空输入、上拉输入以及下拉输入，下面是输入模式的配置示例：

模拟模式

当需要使用ADC通道作为输入时，需要将相应的引脚配置为模拟模式，下面是模拟模式的配置示例：

复用模式

1. 不论使用何种外设模式，都必须将I/O配置为复用功能，之后系统才能正确使用I/O（输入或输出）。

2. I/O引脚通过复用器连接到相应的外设，该复用器一次只允许一个外设的复用功能(MUX)连接到I/O引脚。这样便可确保共用同一个I/O引脚的外设之间不会发生冲突。每个I/O引脚都有一个复用器，该复用器具有16路复用功能输入/输出（MUX0到MUX15），可通过gpio_pin_mux_config()函数对这些引脚进行配置：

• 复位后，所有I/O都会连接到系统的复用功能0(MUX0)

• 通过配置MUX1到MUX7可以映射外设的复用功能

3. 除了这种灵活的I/O复用架构之外，各外设还具有映射到不同I/O引脚的复用功能，这可以针对不同器件封装优化外设I/O功能的数量；例如，可将USART2_TX引脚映射到PA2或PA14引脚上。

4. 配置过程：

• 使用gpio_pin_mux_config()函数将引脚连接到所需的外设复用功能(MUX)，例如配置PA0作为TMR1_EXT输入gpio_pin_mux_config(GPIOA,GPIO_PINS_SOURCE0,GPIO_MUX_4);

• 使用GPIO_Init()函数配置I/O引脚：

- 通过以下方式配置复用功能模式下的所需引脚

gpio_init_struct.gpio_mode=GPIO_MODE_MUX;

- 通过以下成员选择类型、上拉/下拉和驱动力

gpio_out_type、gpio_pull和gpio_drive_strength成员

根据上述配置过程，下面将介绍几种外设的常用配置示例。

一、USART I/O复用模式配置

二、TMR I/O复用模式配置

三、I2C I/O复用模式配置

简介

时钟是芯片正确高效运行的基础，正确的时钟配置是芯片能正确运行的必要条件，其重要性不言而喻。AT32各系列产品的时钟配置部分可能存在细微的差异和需要注意的事项，本文档就着重针对各系列的情况来详细介绍如何结合雅特力提供的V2.x.x的板级支持包（BSP）来配置时钟。

以下介绍时钟配置的方法主要分两种：

1、以手动编写代码调用BSP中提供的驱动函数接口来进行时钟配置。

2、采用时钟工具来配置并生成相应的源码文件。

时钟树

在进行时钟配置之前，应充分了解对应芯片的时钟树结构，这样在进行时钟配置时才会游刃有余。对于系统时钟频率及路径的配置我们需要关注时钟源、倍频及系统时钟部分。类似如下图：

图1. 时钟框图

可由图中得到以下几个关键信息：

1) SCLKSEL：系统时钟可以由HEXT、PLLCLK、HICK三大时钟源提供。

2) HEXT：HEXT是外部高速时钟，其可以外接范围是4~25 MHz的晶振或时钟源。

3) HICK：HICK RC是内部高速振荡器，频率为48 MHz。HICK时钟由内部振荡器给出，但在初始情况下由HICKDIV控制并默认6分频后为8 MHz，亦可配置为不分频，保持48 MHz的频率。

4) PLLCLK：PLL时钟=PLL输入时钟*PLL倍频系数。

5) PLL输入时钟：PLL的输入时钟由PLLRCS及PLLHEXTDIV共同决定，其细分可分为三个来源：HICK 4MHz、HEXT和HEXTDIV，HEXTDIV由HEXT时钟2分频。

代码配置解析

以下将以库函数接口为核心来对时钟配置流程和方法进行说明。

函数接口

各系列产品对应提供的BSP中对硬件的时钟设置部分已封装好接口函数以供调用，以下罗列出时钟配置常用的函数接口，各函数的具体参数及返回值类型等请参考at32f425_crm.c/.h文件。

时钟配置流程

按常规应用来讲解时钟配置流程，其内容可大致分为如下步骤：

图2. 时钟配置流程图

复位（CRM Reset）

首先按规范流程应复位CRM配置参数，其主要是将系统时钟切换到HICK，其余的系统时钟配置寄存器写入默认值，待后续进行新配置参数的写入。函数调用的代码实现如下：

Flash等待周期（Set Flash Wait Cycle）

AT32F425片上采用的是嵌入式Flash，当运行在不同的主频下时需对应设定Flash等待周期。flash等待周期与运行主频关系如下：

函数调用的代码实现如下：

时钟源配置（Clock Source Configuration）

与系统时钟相关的高速时钟源主要包括HEXT和HICK，PLL也是使用以上时钟源来进行倍频。需要在配置使能PLL前将所使用的PLL参考时钟源开启并等待其稳定。

• HEXT

外部高速时钟如采用外接有源时钟的方式时，可开启旁路模式来进行使用，采用晶振时，不能开启旁路模式，旁路模式应在外部高速时钟源使能前进行设定，其默认情况为关闭。旁路模式使能代码实现如下：

使能HEXT时钟源并等待HEXT时钟稳定，代码实现如下：

• HICK

内部高速时钟是由芯片内部振荡器提供，使能HICK时钟源并等待HICK时钟稳定，代码实现如下：

PLL配置（PLL Configuration）

PLL配置主要包括：PLL时钟源、PLL倍频系数、PLL倍频频率范围等的设置。倍频时钟公式为：PLLCLK=PLL输入时钟*PLL倍频系数。

• PLL时钟源

PLL时钟源细分有三个来源：1、HICK（4 MHz），2、HEXT，3、HEXT分频时钟，PLL时钟源应在PLL配置使能前开启并等待稳定。以上PLL时钟源在crm_pll_config函数中对应的参数定义如下：

当选择PLL时钟源为CRM_PLL_SOURCE_HEXT_DIV时，HEXT的分频系数默认为2分频。

• PLL倍频系数

倍频系数为2~64倍可选，但应该注意最高主频限制，以此按实际情况来合适选择倍频系数，如8倍频使用参数CRM_PLL_MULT_8。

当PLL参数设置完成后，即可开启PLL并等待PLL稳定。示例：外部时钟晶振8 MHz，采用HEXT 2分频时钟作为PLL时钟源，PLLCLK倍频到96 MHz的代码实现如下：

总线分频（Set Bus Frequency Division）

总线分频包含SCLK到AHBCLK分频、AHBCLK到APB1CLK分频、AHBCLK到APB2CLK分频。AHB总线1分频、APB1/APB2总线1分频的代码实现如下：

切换系统时钟（Switch System Clock）

系统时钟来源主要有三个：HICK、HEXT、PLLCLK。在切换系统时钟到如上时钟源时应提前确保对应时钟源已稳定。

• HICK系统时钟

内部高速时钟在系统复位重新运行时默认作为系统时钟，后期代码进行设定时，可有两种频率值来进行设定（8 MHz和48 MHz）。如图1所述HICK默认情况下用的是8 MHz，可配置为48 MHz。

HICK 8 MHz用作系统时钟的代码实现如下：

HICK 48 MHz用作系统时钟的代码实现如下：

• HEXT系统时钟

外部高速时钟用作系统时钟时，其系统时钟频率以实际使用的外部时钟频率为准，范围为4~25 MHz。HEXT用作系统时钟的代码实现如下：

• PLLCLK系统时钟

PLLCLK用作系统时钟时，其系统时钟频率以实际的PLL倍频结果为准。其最高频率应满足芯片规格为基础。PLLCLK用作系统时钟的代码实现如下：

更新核心频率（Update Core Frequency）

提供的BSP中，其代码框架内保留了一个表示系统核心频率的参数值system_core_clock，其保存的是CPU核心的运行频率值，应该在每次系统时钟配置完成后来进行更新。为的是在整个代码框架下，各外设驱动的频率配置能很快获取到当前核心运行频率值并使用。代码实现如下：

时钟配置示例

以下将以完整的时钟配置流程来进行说明，示例：由8 MHz外部时钟晶振作为时钟源，其2分频路径经PLL倍频到96 MHz并用做系统时钟，AHB采用1分频，APB1/APB2采用1分频。函数system_clock_config代码实现如下：

时钟工具

时钟配置工具是雅特力科技为方便对AT32系列MCU进行时钟配置而开发的一个图形化配置工具，其主旨是使用户清晰了解时钟路径和配置出期望的时钟频率并生成源码文件。

环境要求

• 软件要求

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

安装

• 软件安装

本软件不需要安装，只需直接运行可执行程序AT32_New_Clock_Configuration.exe。

功能介绍

本章节将介绍此工具的基本操作，其主要的启动界面和配置界面如下所示

图3. 启动界面

图4. 配置界面

菜单栏

菜单栏内容如图所示：

图5. 菜单栏

• “项目”（Project）菜单：

新建：新建时钟配置项目打开：打开已存在的配置项目保存：保存已打开的配置项目

• “语言”（Language）菜单：

English：选择English作为显示语言简体中文：选择简体中文作为显示语言

• “生成代码”（General code）菜单：

当在对应型号的操作配置界面将所期望的时钟路径和时钟频率配置完成之后，可点击“生成代码”菜单来选择源码文件的存储路径并生成相应的源码文件。

• “帮助”（Help）菜单：

新版本下载：联网进行新版本下载版本：查看当前版本

新建配置项目

双击打开时钟配置工具，可看到图示的启动界面，可点击“项目”菜单-->“新建”，进行配置项目的新建，在新建配置项目的过程中需要对芯片的系列所属进行选择，操作方法如下图所示

图6. MCU选择界面

MCU系列的选择，可点击下拉框来进行选择，当选择好MCU后点击“确定”可进入到时钟配置界面。

配置界面的使用

配置界面主要用来进行时钟路径及参数的配置，以下的介绍将以AT32F425系列作为示例来展开进行，其余系列的配置方法与此类似。

整个配置界面主要可以分为四个大块，如下图所示

图7. 配置界面框架

1. 标题部分：用于展示当前配置项目所选择的MCU系列。

2. 配置部分：用于对时钟路径和时钟参数进行选择和配置，以达到期望的应用需求。

3. 输出部分：用于时钟输出（CLKOUT）的配置。

4. 在SCLK栏也可在选中PLL为系统时钟时作为输入框，可输入期望的系统时钟频率来反向自动配置出倍频参数。

5. 结果部分：用于显示当前外设所使用的时钟频率及总线上的外设。

接下来就着重介绍一下配置部分的使用。配置部分的流程界面是对应着MCU时钟树来进行的，各系列MCU的此部分可能存在着差异，但使用方式大同小异。时钟路径的配置可按流程对各开关进行点选来进行选择，配置部分如下图所示，将逐个流程点的功能及其注意事项进行介绍。

图8. 时钟配置框

1. ertc使能：ertc时钟代码配置的使能下拉框。

2. ertcsel：点选框，ertc时钟源选择。当ertc使能开启后，此点选框可配置。

3. lext bypass：外部低速时钟的旁路使能。

4. hext：此为输入框，8 MHz为所采用外部时钟源的默认频率，用户可根据实际使用的外部时钟源频率进行修改。（注：此8 MHz被修改为其他频率值时，对应的BSP中demo目录下的inc/at32f415_conf.h文件内的HEXT_VALUE宏定义也应该一致修改，也可以采用工具生成的at32f415_conf.h文件来进行使用）。

5. hext bypass：高速外部时钟的旁路使能。

6. pllhextdiv：点选框，当HEXT作为PLL时钟源时，可配置输入频率为HEXT分频或HEXT不分频。

7. pllrcs：点选框，可配置PLL时钟源为HEXT或HICK。

8. pll_mode：下拉框，可选择PLL的配置模式（normal或flexible）

9. 倍频系数：选择normal模式时使用PLL_MULT参数进行倍频，计算公式为：PLLCLK=PLL输入时钟*PLL_MULT，选择flexible模式时使用PLL_MS、PLL_NS和PLL_FR参数进行倍频，计算公式为：PLLCLK=PLL输入时钟/PLL_MS*PLL_NS/PLL_FR。为了用户的使用方便，在选定PLL输入时钟源后，结果部分的sclk框中输入目标时钟并按下键盘“Enter”键，会自动计算一组倍频参数以满足用户期望或相近的时钟频率sclk select：点选框，可配置HEXT、PLL或HICK作为系统时钟。

10. sclk select：点选框，可配置HEXT、PLL或HICK作为系统时钟。

11. sclk频率：当采用正向配置时，此作为系统时钟频率的配置结果显示，当将其用作输入框时，输入期望的频率后点击回车键，会根据此输入值反向计算一组合适的或最接近期望值的PLL配置参数。

12. hick to sclk：点选框，当sclk select选择HICK作为系统时钟时，可配置HICK的8 MHz或48MHz到系统时钟（注：当选择48 MHz HICK到系统时钟后，CLKOUT输出HICK时的频率也为48 MHz）。13. usbdiv：下拉框。当PLL时钟被选作为USB的时钟来源时，此处配置PLL时钟到USB时钟的分频系数。

14. USB使能：USB时钟代码配置的使能下拉框。

15. USB时钟频率的显示。此显示栏会实时计算USB时钟的频率并显示，如果配置出来的USB时钟不等于48 MHz时，显示出来的USB时钟频率会标注为红色，而实际应用中没有用到USB时选择disable则不会显示。（注：此部分只针对USB时钟频率的配置，USB外设时钟使能需自行额外打开）

生成代码

当时钟配置完成后，可点击生成代码，然后选择代码生成的路径并确认，最后会在所选目录下生成两个文件夹inc和src，源文件存放在src文件夹下，头文件存放在inc文件夹下。这些文件可结合到BSP_V2.x.x内的工程来进行使用。可以采用新生成的时钟代码文件（at32f4xx_clock.c/at32f4xx_clock.h/at32f4xx_conf.h）将原BSP demo中的对应文件替换，在main函数中进行system_clock_config函数调用即可。

注意事项

外部时钟源(HEXT)修改

因本文档所示例的demo和配置工具都默认采用的8 MHz外部时钟频率，当实际硬件使用的外部时钟源是非8 MHz频率时需注意以下几点。

• 代码修改

1、以实际的外部时钟频率按文中时钟配置流程章节所描述的时钟配置流程及方法来编写相应的代码，配置出期望的时钟配置及时钟路径。

2、修改对应demo工程中at32f4xx_conf.h文件的HEXT_VALUE值，以实际使用的外部时钟源频率值来进行修改。如实际外部高速时钟使用12.288 MHz的晶振或时钟源时，at32f4xx_conf.h文件应修改如下：

• 工具修改

1、在时钟配置工具中的HEXT输入框内填入外部时钟源实际频率值并按“Enter”键确认。

2、配置好所需的时钟路径及时钟频率，生成代码。采用新生成的时钟代码文件（at32f4xx_clock.c/at32f4xx_clock.h/ at32f4xx_conf.h）将原BSP demo中的对应文件替换或取其中函数内容进行替换，在main函数中进行system_clock_config函数调用即可。

工具使用

在使用本时钟配置工具时需注意：

1. 此工具生成的时钟配置源码文件需结合雅特力科技提供的BSP_V2.x.x进行使用。

2. 不同系列所生成的时钟配置源码文件不能型号混用，只能在相对应的工程项目中进行调用。

3. 配置工具中各输入框参数修改后，请以“Enter”键结束。