GD32E10x 固件库使用指南
1
GigaDevice Semiconductor Inc.
GD32E10x
ARM
®
Cortex
™
-M4 32-bit MCU
固件库
使用指南
1.2 版本
(2020 年 12 月)
GD32E10x 固件库使用指南
2
目录
目录 ....................................................................................................................................... 2
图索引 ................................................................................................................................... 5
表索引 ................................................................................................................................... 6
1. 介绍 .............................................................................................................................. 20
1.1. 文档和固件库规则 ............................................................................................................ 20
1.1.1. 外设缩写 ............................................................................................................................................. 20
1.1.2. 命名规则 ............................................................................................................................................. 21
2. 固件库概述 ................................................................................................................... 22
2.1. 文件组织结构 .................................................................................................................... 22
2.1.1. Examples 文件夹 .............................................................................................................................. 23
2.1.2. Firmware 文件夹 ............................................................................................................................... 23
2.1.3. Template 文件夹 ................................................................................................................................ 23
2.1.4. Utilities 文件夹 ................................................................................................................................... 26
2.2. 固件库文件描述 ................................................................................................................ 27
3. 外设固件库 ................................................................................................................... 28
3.1. 外设固件库概述 ................................................................................................................ 28
3.2. ADC ................................................................................................................................... 28
3.2.1. 外设寄存器描述 ................................................................................................................................. 28
3.2.2. 外设库函数说明 ................................................................................................................................. 29
3.3. BKP .................................................................................................................................... 66
3.3.1. 外设寄存器说明 ................................................................................................................................. 66
3.3.2. 外设库函数说明 ................................................................................................................................. 66
3.4. CRC .................................................................................................................................... 81
3.4.1. 外设寄存器说明 ................................................................................................................................. 81
3.4.2. 外设库函数说明 ................................................................................................................................. 81
3.5. CTC .................................................................................................................................... 86
3.5.1. 外设寄存器说明 ................................................................................................................................. 86
3.5.2. 外设库函数说明 ................................................................................................................................. 86
3.6. DAC ................................................................................................................................. 103
3.6.1. 外设寄存器说明 ............................................................................................................................... 103
3.6.2. 外设库函数说明 ............................................................................................................................... 104
3.7. DBG ................................................................................................................................. 123
3.7.1. 外设寄存器说明 ............................................................................................................................... 123
3.7.2. 外设库函数说明 ............................................................................................................................... 123
GD32E10x 固件库使用指南
3
3.8. DMA ................................................................................................................................ 130
3.8.1. 外设寄存器说明 ............................................................................................................................... 131
3.8.2. 外设库函数说明 ............................................................................................................................... 131
3.9. EXMC ............................................................................................................................... 157
3.9.1. 外设寄存器说明 ............................................................................................................................... 157
3.9.2. 外设库函数说明 ............................................................................................................................... 157
3.10. EXTI .............................................................................................................................. 164
3.10.1. 外设寄存器说明 ............................................................................................................................... 164
3.10.2. 外设库函数说明 ............................................................................................................................... 164
3.11. FMC ............................................................................................................................. 173
3.11.1. 外设寄存器说明 ............................................................................................................................... 173
3.11.2. 外设库函数说明 ............................................................................................................................... 174
3.12. FWDGT ......................................................................................................................... 201
3.12.1. 外设寄存器说明 ............................................................................................................................... 201
3.12.2. 外设库函数说明 ............................................................................................................................... 201
3.13. GPIO ............................................................................................................................ 206
3.13.1. 外设寄存器说明 ............................................................................................................................... 206
3.13.2. 外设库函数说明 ............................................................................................................................... 207
3.14. I2C ............................................................................................................................... 224
3.14.1. 外设寄存器说明 ............................................................................................................................... 224
3.14.2. 外设库函数说明 ............................................................................................................................... 225
3.15. MISC ............................................................................................................................ 256
3.15.1. 外设寄存器说明 ............................................................................................................................... 256
3.15.2. 外设库函数说明 ............................................................................................................................... 258
3.16. PMU ............................................................................................................................. 266
3.16.1. 外设寄存器说明 ............................................................................................................................... 266
3.16.2. 外设库函数说明 ............................................................................................................................... 266
3.17. RCU .............................................................................................................................. 276
3.17.1. 外设寄存器说明 ............................................................................................................................... 276
3.17.2. 外设库函数说明 ............................................................................................................................... 277
3.18. RTC .............................................................................................................................. 316
3.18.1. 外设寄存器描述 ............................................................................................................................... 316
3.18.2. 外设库函数描述 ............................................................................................................................... 316
3.19. SPI................................................................................................................................ 328
3.19.1. 外设寄存器说明 ............................................................................................................................... 328
3.19.2. 外设库函数说明 ............................................................................................................................... 329
3.20. TIMER .......................................................................................................................... 361
3.20.1. 外设寄存器说明 ............................................................................................................................... 362
3.20.2. 外设库函数说明 ............................................................................................................................... 363
GD32E10x 固件库使用指南
4
3.21. USART .......................................................................................................................... 435
3.21.1. 外设寄存器说明 ............................................................................................................................... 435
寄存器描述 ................................................................................................................................ 435
3.21.2. 外设库函数说明 ............................................................................................................................... 436
3.22. WWDGT ....................................................................................................................... 480
3.22.1. 外设寄存器说明 ............................................................................................................................... 480
3.22.2. 外设库函数说明 ............................................................................................................................... 480
3.23. USBFS ........................................................................................................................... 485
4. 版本历史 ..................................................................................................................... 486
GD32E10x 固件库使用指南
5
图索引
图 2-1. GD32E10x 固件库文件组织结构 .......................................................................................................... 22
图 2-2. 选择外设例程文件 ................................................................................................................................ 24
图 2-3. 拷贝外设例程文件 ................................................................................................................................ 25
图 2-4. 打开工程文件 ........................................................................................................................................ 25
图 2-5. 配置工程文件 ........................................................................................................................................ 26
图 2-6. 编译调试下载 ........................................................................................................................................ 26