1# AT32F421 AT-START 开发板 BSP 说明
2
3## 简介
4
5AT32F421 AT-START是雅特力推出的一款AT32F421系列的评估板，其搭载的MCU主要资源参数如下：
6
7| 硬件      | 描述          |
8| --------- | ------------- |
9| 芯片型号  | AT32F421C8T7  |
10| CPU       | ARM Cortex M4 |
11| 主频      | 120M          |
12| 片内SRAM  | 16K           |
13| 片内FLASH | 64K           |
14
15## 编译说明
16
17AT32F421-START板级包支持MDK4﹑MDK5﹑IAR开发环境和GCC编译器，以下是具体版本信息：
18
19| IDE/编译器 | 已测试版本                   |
20| ---------- | ---------------------------- |
21| MDK4       | MDK4.74                      |
22| MDK5       | MDK531                       |
23| IAR        | IAR8.20                      |
24| GCC        | GCC 5.4.1 20160919 (release) |
25
26## 板载资源
27
28- MCU：AT32F421C8T7，主频 120MHz，64KB FLASH ，16KB RAM
29- 常用外设
30  - LED：3个，（红色PF6、黄色PF7、绿色PB11）
31  - 按键：1个，KEY_USER（兼具唤醒功能，PA0)
32- 常用接口：插针串口J8
33- 调试接口，JLINK、板载的 AT-LINK SWD 下载
34
35## 外设支持
36
37本 BSP 目前对外设驱动的支持情况如下：
38
39| 驱动      | 支持情况 |            备注            |
40| --------- | -------- | :------------------------: |
41| UART      | 支持     | USART1/2                   |
42| GPIO      | 支持     | PA0...PF7                  |
43| IIC       | 支持     | GPIO模拟I2C                |
44| HWIIC     | 支持     | I2C1/2                     |
45| SPI       | 支持     | SPI1/2                     |
46| ADC       | 支持     | ADC1                       |
47| PWM       | 支持     | TMR1                       |
48| HWTIMER   | 支持     | TMR3                       |
49| WDT       | 支持     |                            |
50| RTC       | 支持     |                            |
51| FLASH     | 支持     |                            |
52
53### IO在板级支持包中的映射情况
54
55| IO号 | 板级包中的定义 |
56| ---- | -------------- |
57| PF6  | LED2           |
58| PF7  | LED3           |
59| PB11 | LED4           |
60| PA9  | USART1_TX      |
61| PA10 | USART1_RX      |
62| PA2  | USART2_TX      |
63| PA3  | USART2_RX      |
64| PA4  | SPI1_NSS       |
65| PA5  | SPI1_SCK       |
66| PA6  | SPI1_MISO      |
67| PA7  | SPI1_MOSI      |
68| PB12 | SPI2_NSS       |
69| PB13 | SPI2_SCK       |
70| PB14 | SPI2_MISO      |
71| PB15 | SPI2_MOSI      |
72| PB6  | I2C1_SCL       |
73| PB7  | I2C1_SDA       |
74| PA8  | PWM_TMR1_CH1   |
75| PA11 | PWM_TMR1_CH4   |
76| PA0  | ADC1_IN0       |
77| PA1  | ADC1_IN1       |
78| PA4  | ADC1_IN4       |
79| PA5  | ADC1_IN5       |
80| PA6  | ADC1_IN6       |
81
82## 使用说明
83
84    本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
85
86### 快速上手
87
88本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程，并且支持 GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
89
90#### 硬件连接
91
92使用数据线连接开发板到 PC，打开电源开关。
93
94#### 编译下载
95
96首先需抓取 HAL-SDK，并生成对应工程，步骤如下：
97
981. 在 bsp 下打开 env 工具。
99
1002. 输入`menuconfig`命令配置工程，配置好之后保存退出。
101
1023. 输入`pkgs --update`命令更新软件包。
103
1044. 输入`scons --target=mdk4/mdk5/iar` 命令重新生成工程。
105
106打开工程文件，如 MDK5 工程 project.uvprojx 文件，，编译并下载程序到开发板。
107
108> 工程默认配置使用AT-LINK SWD下载程序，在通过AT-LINK SWD连接开发板的基础上，点击下载按钮即可下载程序到开发板
109
110#### 运行结果
111
112下载程序成功之后，系统会自动运行，观察开发板上 LED 的运行效果，LED2/3/4 会周期性闪烁。
113
114连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，在串口上可以看到 RT-Thread 的输出信息:
115
116```bash
117 \ | /
118- RT -     Thread Operating System
119 / | \     5.0.0 build Jan 18 2023 09:19:32
120 2006 - 2022 Copyright by RT-Thread team
121msh />
122```
123
124## 注意事项
125
126可在雅特力官方网站进行所需资料下载，如Keil_v5/Keil_v4/IAR等pack安装包和AT-START开发板原理图等（www.arterytek.com）
127
128## 联系人信息
129
130维护人:
131
132- [sheltonyu]