1# AT32F415 AT-START 开发板 BSP 说明
2
3## 简介
4
5AT32F415 AT-START是雅特力推出的一款AT32F415系列的评估板，其搭载的MCU主要资源参数如下：
6
7| 硬件      | 描述          |
8| --------- | ------------- |
9| 芯片型号  | AT32F415RCT7  |
10| CPU       | ARM Cortex M4 |
11| 主频      | 150M          |
12| 片内SRAM  | 32K           |
13| 片内FLASH | 256K          |
14
15## 编译说明
16
17AT32F415-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：AT32F415RCT7，主频 150MHz，256KB FLASH ，32KB RAM
29- 常用外设
30  - LED：3个，（红色PC2、白色PC3、绿色PC5）
31  - 按键：1个，KEY_USER（兼具唤醒功能，PA0)
32- 常用接口：插针串口J8
33- 调试接口，JLINK、板载的 AT-LINK SWD 下载
34
35## 外设支持
36
37本 BSP 目前对外设驱动的支持情况如下：
38
39| 驱动      | 支持情况 |            备注            |
40| --------- | -------- | :------------------------: |
41| UART      | 支持     | USART1/2/3                 |
42| GPIO      | 支持     | PA0...PF5                  |
43| IIC       | 支持     | GPIO模拟I2C                |
44| HWIIC     | 支持     | I2C1/2                     |
45| SPI       | 支持     | SPI1/2                     |
46| ADC       | 支持     | ADC1                       |
47| PWM       | 支持     | TMR1/2                     |
48| HWTIMER   | 支持     | TMR3/4/5                   |
49| SDIO      | 支持     | SDIO1                      |
50| CAN       | 支持     | CAN1                       |
51| WDT       | 支持     |                            |
52| RTC       | 支持     |                            |
53| FLASH     | 支持     |                            |
54| USB       | 支持     |                            |
55
56### IO在板级支持包中的映射情况
57
58| IO号 | 板级包中的定义 |
59| ---- | -------------- |
60| PC2  | LED2           |
61| PC3  | LED3           |
62| PC5  | LED4           |
63| PA9  | USART1_TX      |
64| PA10 | USART1_RX      |
65| PA2  | USART2_TX      |
66| PA3  | USART2_RX      |
67| PB10 | USART3_TX      |
68| PB11 | USART3_RX      |
69| PA4  | SPI1_NSS       |
70| PA5  | SPI1_SCK       |
71| PA6  | SPI1_MISO      |
72| PA7  | SPI1_MOSI      |
73| PB12 | SPI2_NSS       |
74| PB13 | SPI2_SCK       |
75| PB14 | SPI2_MISO      |
76| PB15 | SPI2_MOSI      |
77| PB6  | I2C1_SCL       |
78| PB7  | I2C1_SDA       |
79| PC8  | SDIO1_D0       |
80| PC9  | SDIO1_D1       |
81| PC10 | SDIO1_D2       |
82| PC11 | SDIO1_D3       |
83| PC12 | SDIO1_CK       |
84| PD2  | SDIO1_CMD      |
85| PA8  | PWM_TMR1_CH1   |
86| PA11 | PWM_TMR1_CH4   |
87| PA0  | PWM_TMR2_CH1   |
88| PA1  | PWM_TMR2_CH2   |
89| PC0  | ADC1_IN10      |
90| PC1  | ADC1_IN11      |
91| PC2  | ADC1_IN12      |
92| PC3  | ADC1_IN13      |
93| PC4  | ADC1_IN14      |
94| PC5  | ADC1_IN15      |
95| PB8  | CAN1_RX        |
96| PB9  | CAN1_TX        |
97| PA11 | USB_DM         |
98| PA12 | USB_DP         |
99
100## 使用说明
101
102    本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
103
104### 快速上手
105
106本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程，并且支持 GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
107
108#### 硬件连接
109
110使用数据线连接开发板到 PC，打开电源开关。
111
112#### 编译下载
113
114首先需抓取 HAL-SDK，并生成对应工程，步骤如下：
115
1161. 在 bsp 下打开 env 工具。
117
1182. 输入`menuconfig`命令配置工程，配置好之后保存退出。
119
1203. 输入`pkgs --update`命令更新软件包。
121
1224. 输入`scons --target=mdk4/mdk5/iar` 命令重新生成工程。
123
124打开工程文件，如 MDK5 工程 project.uvprojx 文件，，编译并下载程序到开发板。
125
126> 工程默认配置使用AT-LINK SWD下载程序，在通过AT-LINK SWD连接开发板的基础上，点击下载按钮即可下载程序到开发板
127
128#### 运行结果
129
130下载程序成功之后，系统会自动运行，观察开发板上 LED 的运行效果，LED2/3/4 会周期性闪烁。
131
132连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，在串口上可以看到 RT-Thread 的输出信息:
133
134```bash
135 \ | /
136- RT -     Thread Operating System
137 / | \     4.1.0 build May 11 2022
138 2006 - 2022 Copyright by RT-Thread team
139msh />
140```
141
142## 注意事项
143
144可在雅特力官方网站进行所需资料下载，如Keil_v5/Keil_v4/IAR等pack安装包和AT-START开发板原理图等（www.arterytek.com）
145
146## 联系人信息
147
148维护人:
149
150- [sheltonyu]