GigaDevice Semiconductor Inc.
GD32F3x0
Arm
®
Cortex
®
-M4 32-bit MCU
固件库
使用指南
1.4 版本
(2023 年 12 月)
GD32F3x0 固件库用户指南
2
目录
目录 ....................................................................................................................................... 2
图索引 ................................................................................................................................... 5
表索引 ................................................................................................................................... 6
1. 介绍 .............................................................................................................................. 22
1.1. 文档和固件库规则 ............................................................................................................ 22
1.1.1. 外设缩写 ............................................................................................................................................. 22
1.1.2. 命名规则 ............................................................................................................................................. 23
2. 固件库概述 ................................................................................................................... 24
2.1. 文件组织结构 .................................................................................................................... 24
2.1.1. Examples 文件夹 .............................................................................................................................. 25
2.1.2. Firmware 文件夹 ............................................................................................................................... 25
2.1.3. Template 文件夹 ................................................................................................................................ 25
2.1.4. Utilities 文件夹 ................................................................................................................................... 29
2.2. 固件库文件描述 ................................................................................................................ 29
3. 外设固件库 ................................................................................................................... 30
3.1. 外设固件库概述 ................................................................................................................ 30
3.2. ADC ................................................................................................................................... 30
3.2.1. 外设寄存器描述 ................................................................................................................................. 30
3.2.2. 外设库函数说明 ................................................................................................................................. 31
3.3. CEC .................................................................................................................................... 55
3.3.1. 外设寄存器描述 ................................................................................................................................. 55
3.3.2. 外设库函数说明 ................................................................................................................................. 56
3.4. CMP ................................................................................................................................... 73
3.4.1. 外设寄存器说明 ................................................................................................................................. 73
3.4.2. 外设库函数说明 ................................................................................................................................. 73
3.5. CRC .................................................................................................................................... 81
3.5.1. 外设寄存器说明 ................................................................................................................................. 81
3.5.2. 外设库函数说明 ................................................................................................................................. 81
3.6. CTC .................................................................................................................................... 89
3.6.1. 外设寄存器描述 ................................................................................................................................. 89
3.6.2. 外设库函数说明 ................................................................................................................................. 89
3.7. DAC ................................................................................................................................. 102
3.7.1. 外设寄存器说明 ............................................................................................................................... 102
3.7.2. 外设库函数说明 ............................................................................................................................... 102
GD32F3x0 固件库用户指南
3
3.8. DBG ................................................................................................................................. 117
3.8.1. 外设寄存器说明 ............................................................................................................................... 117
3.8.2. 外设库函数说明 ............................................................................................................................... 117
3.9. DMA ................................................................................................................................ 121
3.9.1. 外设寄存器说明 ............................................................................................................................... 121
3.9.2. 外设库函数说明 ............................................................................................................................... 122
3.10. EXTI .............................................................................................................................. 139
3.10.1. 外设寄存器说明 ............................................................................................................................... 139
3.10.2. 外设库函数说明 ............................................................................................................................... 140
3.11. FMC ............................................................................................................................. 147
3.11.1. 外设寄存器说明 ............................................................................................................................... 147
3.11.2. 外设库函数说明 ............................................................................................................................... 148
3.12. FWDGT ......................................................................................................................... 166
3.12.1. 外设寄存器说明 ............................................................................................................................... 166
3.12.2. 外设库函数说明 ............................................................................................................................... 166
3.13. GPIO ............................................................................................................................ 172
3.13.1. 外设寄存器说明 ............................................................................................................................... 172
3.13.2. 外设库函数说明 ............................................................................................................................... 172
3.14. I2C ............................................................................................................................... 183
3.14.1. 外设寄存器说明 ............................................................................................................................... 183
3.14.2. 外设库函数说明 ............................................................................................................................... 183
3.15. MISC ............................................................................................................................ 206
3.15.1. 外设寄存器说明 ............................................................................................................................... 206
3.15.2. 外设库函数说明 ............................................................................................................................... 207
3.16. PMU ............................................................................................................................. 213
3.16.1. 外设寄存器说明 ............................................................................................................................... 213
3.16.2. 外设库函数说明 ............................................................................................................................... 213
3.17. RCU .............................................................................................................................. 225
3.17.1. 外设寄存器说明 ............................................................................................................................... 225
3.17.2. 外设库函数说明 ............................................................................................................................... 226
3.18. RTC .............................................................................................................................. 255
3.18.1. 外设寄存器描述 ............................................................................................................................... 256
3.18.2. 外设库函数描述 ............................................................................................................................... 256
3.19. SPI/I2S ......................................................................................................................... 276
3.19.1. 外设寄存器说明 ............................................................................................................................... 276
3.19.2. 外设库函数说明 ............................................................................................................................... 276
3.20. SYSCFG ......................................................................................................................... 303
3.20.1. 外设寄存器说明 ............................................................................................................................... 303
3.20.2. 外设库函数说明 ............................................................................................................................... 303
GD32F3x0 固件库用户指南
4
3.21. TIMER .......................................................................................................................... 310
3.21.1. 外设寄存器说明 ............................................................................................................................... 310
3.21.2. 外设库函数说明 ............................................................................................................................... 311
3.22. TSI ................................................................................................................................ 369
3.22.1. 外设寄存器描述 ............................................................................................................................... 369
3.22.2. 外设库函数说明 ............................................................................................................................... 369
3.23. USART .......................................................................................................................... 391
3.23.1. 外设寄存器说明 ............................................................................................................................... 391
3.23.2. 外设库函数说明 ............................................................................................................................... 391
3.24. WWDGT ....................................................................................................................... 436
3.24.1. 外设寄存器说明 ............................................................................................................................... 436
3.24.2. 外设库函数说明 ............................................................................................................................... 437
3.25. USBFS ........................................................................................................................... 441
4. 版本历史 ..................................................................................................................... 442
GD32F3x0 固件库用户指南
5
图索引
图 2-1. GD32F3x0 固件库文件组织结构 ........................................................................................................... 24
图 2-2. 选择外设例程文件 ................................................................................................................................. 26
图 2-3. 拷贝外设例程文件 ................................................................................................................................. 27
图 2-4. 打开工程文件 ......................................................................................................................................... 28
图 2-5. 配置工程文件 ......................................................................................................................................... 28
图 2-6. 编译调试下载 ......................................................................................................................................... 29
