1# AT32F437 AT-START 开发板 BSP 说明
2
3## 简介
4
5AT32F437 AT-START是雅特力推出的一款AT32F437系列的评估板，其搭载的MCU主要资源参数如下：
6
7| 硬件      | 描述           |
8| --------- | ---------------|
9| 芯片型号  | AT32F437ZMT7   |
10| CPU       | ARM Cortex M4  |
11| 主频      | 288M           |
12| 片内SRAM  | 384K可扩展512K |
13| 片内FLASH | 4032K          |
14
15## 编译说明
16
17AT32F437-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：AT32F437ZMT7，主频 288MHz，4032K FLASH ，384K可扩展到512K RAM
29- 常用外设
30  - LED：3个，（红色PD13、白色PD14、绿色PD15）
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...PH7                  |
43| IIC       | 支持     | GPIO模拟I2C                |
44| HWIIC     | 支持     | I2C1/2/3                   |
45| SPI       | 支持     | SPI1/2                     |
46| ADC       | 支持     | ADC1/2                     |
47| DAC       | 支持     | DAC1                       |
48| PWM       | 支持     | TMR1/2                     |
49| HWTIMER   | 支持     | TMR3/4/5                   |
50| SDIO      | 支持     | SDIO1                      |
51| CAN       | 支持     | CAN1/2                     |
52| QSPI      | 支持     | QSPI1/2                    |
53| WDT       | 支持     |                            |
54| RTC       | 支持     |                            |
55| FLASH     | 支持     |                            |
56| EMAC      | 支持     |                            |
57| SDRAM     | 支持     |                            |
58| USB       | 支持     |                            |
59
60### IO在板级支持包中的映射情况
61
62| IO号 |   板级包中的定义  |
63| ---- | ----------------- |
64| PD13 | LED2              |
65| PD14 | LED3              |
66| PD15 | LED4              |
67| PA9  | USART1_TX         |
68| PA10 | USART1_RX         |
69| PD5  | USART2_TX         |
70| PD6  | USART2_RX         |
71| PB10 | USART3_TX         |
72| PB11 | USART3_RX         |
73| PA4  | SPI1_NSS          |
74| PA5  | SPI1_SCK          |
75| PA6  | SPI1_MISO         |
76| PA7  | SPI1_MOSI         |
77| PB12 | SPI2_NSS          |
78| PB13 | SPI2_SCK          |
79| PB14 | SPI2_MISO         |
80| PB15 | SPI2_MOSI         |
81| PB6  | I2C1_SCL          |
82| PB7  | I2C1_SDA          |
83| PC8  | SDIO1_D0          |
84| PC9  | SDIO1_D1          |
85| PC10 | SDIO1_D2          |
86| PC11 | SDIO1_D3          |
87| PC12 | SDIO1_CK          |
88| PD2  | SDIO1_CMD         |
89| PA8  | PWM_TMR1_CH1      |
90| PA11 | PWM_TMR1_CH4      |
91| PA0  | PWM_TMR2_CH1      |
92| PA1  | PWM_TMR2_CH2      |
93| PC0  | ADC1/2_IN10       |
94| PC1  | ADC1/2_IN11       |
95| PC2  | ADC1/2_IN12       |
96| PC3  | ADC1/2_IN13       |
97| PC4  | ADC1/2_IN14       |
98| PC5  | ADC1/2_IN15       |
99| PA4  | DAC_OUT1          |
100| PA5  | DAC_OUT2          |
101| PB8  | CAN1_RX           |
102| PB9  | CAN1_TX           |
103| PB5  | CAN2_RX           |
104| PB6  | CAN2_TX           |
105| PB11 | EMAC_RMII_TX_EN   |
106| PB12 | EMAC_RMII_TX0     |
107| PB13 | EMAC_RMII_TX1     |
108| PD8  | EMAC_RMII_RX_DV   |
109| PD9  | EMAC_RMII_RXD0    |
110| PD10 | EMAC_RMII_RXD1    |
111| PA1  | EMAC_RMII_REF_CLK |
112| PF8  | QSPI1_IO0         |
113| PF9  | QSPI1_IO1         |
114| PF7  | QSPI1_IO2         |
115| PF6  | QSPI1_IO3         |
116| PF10 | QSPI1_SCK         |
117| PG6  | QSPI1_CS          |
118| PE7  | QSPI2_IO0         |
119| PE8  | QSPI2_IO1         |
120| PE9  | QSPI2_IO2         |
121| PE10 | QSPI2_IO3         |
122| PG13 | QSPI2_SCK         |
123| PG8  | QSPI2_CS          |
124| PA11 | USB1_DM           |
125| PA12 | USB1_DP           |
126| PB14 | USB2_DM           |
127| PB15 | USB2_DP           |
128
129## 使用说明
130
131    本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
132
133### 快速上手
134
135本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程，并且支持 GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
136
137#### 硬件连接
138
139使用数据线连接开发板到 PC，打开电源开关。
140
141#### 编译下载
142
143首先需抓取 HAL-SDK，并生成对应工程，步骤如下：
144
1451. 在 bsp 下打开 env 工具。
146
1472. 输入`menuconfig`命令配置工程，配置好之后保存退出。
148
1493. 输入`pkgs --update`命令更新软件包。
150
1514. 输入`scons --target=mdk4/mdk5/iar` 命令重新生成工程。
152
153打开工程文件，如 MDK5 工程 project.uvprojx 文件，，编译并下载程序到开发板。
154
155> 工程默认配置使用AT-LINK SWD下载程序，在通过AT-LINK SWD连接开发板的基础上，点击下载按钮即可下载程序到开发板
156
157#### 运行结果
158
159下载程序成功之后，系统会自动运行，观察开发板上 LED 的运行效果，LED2/3/4 会周期性闪烁。
160
161连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，在串口上可以看到 RT-Thread 的输出信息:
162
163```bash
164 \ | /
165- RT -     Thread Operating System
166 / | \     4.1.0 build Apr  7 2022
167 2006 - 2022 Copyright by RT-Thread team
168msh />
169```
170
171## 注意事项
172
173AT32F437使用Ethernet且PHY时钟由CLKOUT(PA8)输出提供时，主频最好采用250Mhz。
174
175可在雅特力官方网站进行所需资料下载，如Keil_v5/Keil_v4/IAR等pack安装包和AT-START开发板原理图等（www.arterytek.com）
176
177## 联系人信息
178
179维护人:
180
181- [sheltonyu]