GigaDevice Semiconductor Inc.
GD32E23x
Arm
®
Cortex
®
-M23 32-bit MCU
固件库
使用指南
1.0 版本
(2020 年 12 月)
GD32E23x 固件库使用指南
1
目录
目录 ....................................................................................................................................... 1
图索引 ................................................................................................................................... 4
表索引 ................................................................................................................................... 5
1. 介绍 .............................................................................................................................. 18
1.1. 文档和固件库规则 ............................................................................................................ 18
1.1.1. 外设缩写 ............................................................................................................................................. 18
1.1.2. 命名规则 ............................................................................................................................................. 19
2. 固件库概述 ................................................................................................................... 20
2.1. 文件组织结构 .................................................................................................................... 20
2.1.1. Examples 文件夹 .............................................................................................................................. 21
2.1.2. Firmware 文件夹 ............................................................................................................................... 21
2.1.3. Template 文件夹 ................................................................................................................................ 21
2.1.4. Utilities 文件夹 ................................................................................................................................... 24
2.2. 固件库文件描述 ................................................................................................................ 24
3. 外设固件库 ................................................................................................................... 25
3.1. 外设固件库概述 ................................................................................................................ 25
3.2. ADC ................................................................................................................................... 25
3.2.1. 外设寄存器描述 ................................................................................................................................. 25
3.2.2. 外设库函数说明 ................................................................................................................................. 26
3.3. CMP ................................................................................................................................... 49
3.3.1. 外设寄存器说明 ................................................................................................................................. 49
3.3.2. 外设库函数说明 ................................................................................................................................. 49
3.4. CRC .................................................................................................................................... 55
3.4.1. 外设寄存器说明 ................................................................................................................................. 55
3.4.2. 外设库函数说明 ................................................................................................................................. 56
3.5. DBG ................................................................................................................................... 63
3.5.1. 外设寄存器说明 ................................................................................................................................. 63
3.5.2. 外设库函数说明 ................................................................................................................................. 63
3.6. DMA .................................................................................................................................. 68
3.6.1. 外设寄存器说明 ................................................................................................................................. 68
3.6.2. 外设库函数说明 ................................................................................................................................. 68
3.7. EXTI ................................................................................................................................... 85
3.7.1. 外设寄存器说明 ................................................................................................................................. 85
GD32E23x 固件库使用指南
2
3.7.2. 外设库函数说明 ................................................................................................................................. 86
3.8. FMC ................................................................................................................................... 94
3.8.1. 外设寄存器说明 ................................................................................................................................. 94
3.8.2. 外设库函数说明 ................................................................................................................................. 94
3.9. FWDGT ............................................................................................................................ 111
3.9.1. 外设寄存器说明 ............................................................................................................................... 111
3.9.2. 外设库函数说明 ............................................................................................................................... 112
3.10. GPIO ............................................................................................................................ 117
3.10.1. 外设寄存器说明 ............................................................................................................................... 117
3.10.2. 外设库函数说明 ............................................................................................................................... 118
3.11. I2C ............................................................................................................................... 128
3.11.1. 外设寄存器说明 ............................................................................................................................... 128
3.11.2. 外设库函数说明 ............................................................................................................................... 129
3.12. MISC ............................................................................................................................ 153
3.12.1. 外设寄存器说明 ............................................................................................................................... 153
3.12.2. 外设库函数说明 ............................................................................................................................... 154
3.13. PMU ............................................................................................................................. 159
3.13.1. 外设寄存器说明 ............................................................................................................................... 159
3.13.2. 外设库函数说明 ............................................................................................................................... 159
3.14. RCU .............................................................................................................................. 167
3.14.1. 外设寄存器说明 ............................................................................................................................... 167
3.14.2. 外设库函数说明 ............................................................................................................................... 168
3.15. RTC .............................................................................................................................. 194
3.15.1. 外设寄存器描述 ............................................................................................................................... 194
3.15.2. 外设库函数描述 ............................................................................................................................... 194
3.16. SPI................................................................................................................................ 215
3.16.1. 外设寄存器说明 ............................................................................................................................... 215
3.16.2. 外设库函数说明 ............................................................................................................................... 215
3.17. SYSCFG ......................................................................................................................... 244
3.17.1. 外设寄存器说明 ............................................................................................................................... 244
3.17.2. 外设库函数说明 ............................................................................................................................... 244
3.18. TIMER .......................................................................................................................... 251
3.18.1. 外设寄存器说明 ............................................................................................................................... 251
3.18.2. 外设库函数说明 ............................................................................................................................... 252
3.19. USART .......................................................................................................................... 310
3.19.1. 外设寄存器说明 ............................................................................................................................... 310
3.19.2. 外设库函数说明 ............................................................................................................................... 311
3.20. WWDGT ....................................................................................................................... 361
3.20.1. 外设寄存器说明 ............................................................................................................................... 361
GD32E23x 固件库使用指南
4
图索引
图 2-1. GD32E23x 固件库文件组织结构...................................................................................................... 20
图 2-2. 选择外设例程文件 ........................................................................................................................... 22
图 2-3. 拷贝外设例程文件 ........................................................................................................................... 22
图 2-4. 打开工程文件 .................................................................................................................................. 23
图 2-5. 配置工程文件 .................................................................................................................................. 23
图 2-6. 编译调试下载 .................................................................................................................................. 24