GD32F3x0固件库详细教程：涵盖所有外设与功能

需积分: 0 139 浏览量更新于2024-07-02 1 收藏 7.06MB PDF 举报

GD32F3x0固件库使用指南是一份详细的文档，专为GigaDeviceSemiconductor Inc.生产的基于Arm Cortex-M43架构的24位微控制器GD32F3x0设计。该指南主要提供了对固件库的全面介绍和使用方法，便于开发人员快速理解和上手。 1. 文档规则：文档中强调了外设缩写和命名规则，这些规则对于理解和定位特定功能至关重要。外设缩写有助于简化代码和减少混乱，而命名规则则确保了函数和变量的一致性，提高代码的可读性和维护性。 2. 文件结构： - Examples 文件夹包含示例程序，供用户参考和实践，以便在实际项目中应用库函数。 - Firmware 文件夹存储了核心固件库文件，这些文件包含了针对不同外设的功能模块。 - Template 文件夹可能包含模板代码或配置文件，用于创建新的项目或定制现有功能。 - Utilities 文件夹则可能包含辅助工具，如调试工具或代码生成工具，以支持开发流程。 3. 外设固件库：文档详述了多种外设的固件库支持，如ADC（模数转换器）、CEC（消费电子控制）、CMP（比较器）、CRC（循环冗余校验）、CTC（计时器）、DAC（数字模拟转换器）、DBG（调试接口）、DMA（直接内存访问）、EXTI（外部中断控制器）、FMC（灵活外设总线控制器）、FWDGT（分频器）、GPIO（通用输入/输出）、以及其他功能。每个外设部分都包括寄存器描述，解释了硬件的工作原理，以及对应的库函数说明，指导用户如何通过编程调用这些功能。 4. 函数说明：每个外设库函数的说明通常包含函数名称、参数、返回值和功能描述，帮助开发者明确知道如何在代码中正确地使用这些函数来控制和操作外设。这份GD32F3x0固件库使用指南为开发人员提供了一个完整的工具集，涵盖了从硬件抽象到实际编程的各个环节，使他们能够高效地利用GD32F3x0的全部潜力。阅读和理解这份指南对于在GD32F3x0平台上进行嵌入式系统开发是必不可少的。

                                                          GD32F3x0 固件库用户指南 
16 
 
表 3-435.  函数 i2s_init .............................................................................................................................. 285 
表 3-436.  函数 i2s_psc_config ................................................................................................................ 286 
表 3-437.  函数 i2s_enable ........................................................................................................................ 287 
表 3-438.  函数 i2s_disable ....................................................................................................................... 288 
表 3-439.  函数 spi_nss_output_enable .................................................................................................. 288 
表 3-440.  函数 spi_nss_output_disable ................................................................................................. 289 
表 3-441.  函数 spi_nss_internal_high .................................................................................................... 289 
表 3-442.  函数 spi_nss_internal_low ..................................................................................................... 290 
表 3-443.  函数 spi_dma_enable .............................................................................................................. 290 
表 3-444.  函数 spi_dma_disable ............................................................................................................. 291 
表 3-445.  函数 spi_i2s_data_frame_format_config .............................................................................. 292 
表 3-446.  函数 spi_i2s_data_transmit .................................................................................................... 292 
表 3-447.  函数 spi_i2s_data_receive ...................................................................................................... 293 
表 3-448.  函数 spi_bidirectional_transfer_config ................................................................................. 293 
表 3-449.  函数 spi_crc_polynomial_set ................................................................................................. 294 
表 3-450.  函数 spi_crc_polynomial_get ................................................................................................. 294 
表 3-451.  函数 spi_crc_on ....................................................................................................................... 295 
表 3-452.  函数 spi_crc_off ....................................................................................................................... 296 
表 3-453.  函数 spi_crc_next .................................................................................................................... 296 
表 3-454.  函数 spi_crc_get ...................................................................................................................... 297 
表 3-455.  函数 spi_ti_mode_enable ....................................................................................................... 297 
表 3-456.  函数 spi_ti_mode_disable ...................................................................................................... 298 
表 3-457.  函数 spi_nssp_mode_enable ................................................................................................. 298 
表 3-458.  函数 spi_nssp_mode_disable ................................................................................................ 299 
表 3-459.  函数 qspi_enable ..................................................................................................................... 299 
表 3-460.  函数 qspi_disable .................................................................................................................... 300 
表 3-461.  函数 qspi_write_enable ........................................................................................................... 300 
表 3-462.  函数 qspi_read_enable ........................................................................................................... 301 
表 3-463.  函数 qspi_io23_output_enable ............................................................................................... 301 
表 3-464.  函数 qspi_io23_output_disable .............................................................................................. 302 
表 3-465.  函数 spi_i2s_interrupt_enable ............................................................................................... 302 
表 3-466.  函数 spi_i2s_interrupt_disable .............................................................................................. 303 
表 3-467.  函数 spi_i2s_interrupt_flag_get ............................................................................................. 303 
表 3-468.  函数 spi_i2s_flag_get .............................................................................................................. 304 
表 3-469.  函数 spi_crc_error_clear ........................................................................................................ 305 
表 3-470. SYSCFG 寄存器 ........................................................................................................................ 306 
表 3-471. SYSCFG 库函数 ........................................................................................................................ 306 
表 3-472.  函数 syscfg_deinit ................................................................................................................... 307 
表 3-473.  函数 syscfg_dma_remap_enable ........................................................................................... 307 
表 3-474.  函数 syscfg_dma_remap_disable .......................................................................................... 308 
表 3-475.  函数 syscfg_high_current_enable ......................................................................................... 309 
表 3-476.  函数 syscfg_high_current_disable ........................................................................................ 309 
表 3-477.  函数 syscfg_exti_line_config ................................................................................................. 310 
表 3-478.  函数 syscfg_lock_config ........................................................................................................ 310 

                                                          GD32F3x0 固件库用户指南 
17 
 
表 3-479.  函数 syscfg_flag_get ................................................................................................................ 311 
表 3-480.  函数 syscfg_flag_clear ............................................................................................................. 311 
表 3-481.  函数 syscfg_compensation_config ....................................................................................... 312 
表 3-482.  函数 syscfg_cps_rdy_flag_get ............................................................................................... 313 
表 3-483. TIMER 寄存器 ............................................................................................................................ 313 
表 3-484. TIMER 库函数 ............................................................................................................................ 314 
表 3-485.  结构体类型 timer_parameter_struct ....................................................................................... 316 
表 3-486.  结构体类型 timer_break_parameter_struct ........................................................................... 317 
表 3-487.  结构体类型 timer_oc_parameter_struct ................................................................................ 317 
表 3-488.  结构体类型 timer_ic_parameter_struct .................................................................................. 317 
表 3-489.  函数 timer_deinit...................................................................................................................... 318 
表 3-490.  函数  timer_struct_para_init ................................................................................................... 318 
表 3-491.  函数 timer_init .......................................................................................................................... 319 
表 3-492.  函数 timer_enable .................................................................................................................... 319 
表 3-493.  函数 timer_disable ................................................................................................................... 320 
表 3-494.  函数 timer_auto_reload_shadow_enable .............................................................................. 321 
表 3-495.  函数 timer_auto_reload_shadow_disable ............................................................................. 321 
表 3-496.  函数 timer_update_event_enable .......................................................................................... 322 
表 3-497.  函数 timer_update_event_disable ......................................................................................... 322 
表 3-498.  函数 timer_counter_alignment ............................................................................................... 323 
表 3-499.  函数 timer_counter_up_direction .......................................................................................... 323 
表 3-500.  函数 timer_counter_down_direction ..................................................................................... 324 
表 3-501.  函数 timer_prescaler_config .................................................................................................. 324 
表 3-502.  函数 timer_repetition_value_config ....................................................................................... 325 
表 3-503.  函数 timer_autoreload_value_config..................................................................................... 326 
表 3-504.  函数 timer_counter_value_config .......................................................................................... 326 
表 3-505.  函数 timer_counter_read ........................................................................................................ 327 
表 3-506.  函数 timer_prescaler_read ..................................................................................................... 327 
表 3-507.  函数 timer_single_pulse_mode_config ................................................................................. 328 
表 3-508.  函数 timer_update_source_config ......................................................................................... 329 
表 3-509.  函数 timer_ocpre_clear_source_config ................................................................................ 329 
表 3-510.  函数 timer_interrupt_enable ................................................................................................... 330 
表 3-511.  函数 timer_interrupt_disable .................................................................................................. 331 
表 3-512.  函数 timer_interrupt_flag_get ................................................................................................ 332 
表 3-513.  函数 timer_interrupt_flag_clear ............................................................................................. 333 
表 3-514.  函数 timer_flag_get ................................................................................................................. 334 
表 3-515.  函数 timer_flag_clear .............................................................................................................. 334 
表 3-516.  函数 timer_dma_enable .......................................................................................................... 335 
表 3-517.  函数 timer_dma_disable ......................................................................................................... 336 
表 3-518.  函数 timer_channel_dma_request_source_select ............................................................... 337 
表 3-519.  函数 timer_dma_transfer_config ........................................................................................... 338 
表 3-520.  函数 timer_event_software_generate .................................................................................... 340 
表 3-521.  函数 timer_break_struct_para_init ........................................................................................ 340 
表 3-522.  函数 timer_break_config ......................................................................................................... 341 

                                                          GD32F3x0 固件库用户指南 
18 
 
表 3-523.  函数 timer_break_enable ........................................................................................................ 342 
表 3-524.  函数 timer_break_disable ....................................................................................................... 342 
表 3-525.  函数 timer_automatic_output_enable ................................................................................... 343 
表 3-526.  函数 timer_automatic_output_disable .................................................................................. 343 
表 3-527.  函数 timer_primary_output_config ........................................................................................ 344 
表 3-528.  函数 timer_channel_control_shadow_config ....................................................................... 345 
表 3-529.  函数 timer_channel_control_shadow_update_config ......................................................... 345 
表 3-530.  函数 timer_channel_output_struct_para_init ....................................................................... 346 
表 3-531.  函数 timer_channel_output_config ....................................................................................... 346 
表 3-532.  函数 timer_channel_output_mode_config ............................................................................ 347 
表 3-533.  函数 timer_channel_output_pulse_value_config ................................................................. 349 
表 3-534.  函数 timer_channel_output_shadow_config ........................................................................ 349 
表 3-535.  函数 timer_channel_output_fast_config ............................................................................... 350 
表 3-536.  函数 timer_channel_output_clear_config ............................................................................. 351 
表 3-537.  函数 timer_channel_output_polarity_config ........................................................................ 352 
表 3-538.  函数 timer_channel_complementary_output_polarity_config ........................................... 353 
表 3-539.  函数 timer_channel_output_state_config ............................................................................. 353 
表 3-540.  函数 timer_channel_complementary_output_state_config ................................................ 354 
表 3-541.  函数 timer_channel_input_struct_para_init ......................................................................... 355 
表 3-542.  函数 timer_input_capture_config .......................................................................................... 356 
表 3-543.  函数 timer_channel_input_capture_prescaler_config ........................................................ 356 
表 3-544.  函数 timer_channel_capture_value_register_read .............................................................. 357 
表 3-545.  函数 timer_input_pwm_capture_config ................................................................................ 358 
表 3-546.  函数 timer_hall_mode_config ................................................................................................ 359 
表 3-547.  函数 timer_input_trigger_source_select ............................................................................... 360 
表 3-548.  函数 timer_master_output_trigger_source_select .............................................................. 360 
表 3-549.  函数 timer_slave_mode_select .............................................................................................. 362 
表 3-550.  函数 timer_master_slave_mode_config ................................................................................ 362 
表 3-551.  函数 timer_external_trigger_config ....................................................................................... 363 
表 3-552.  函数 timer_quadrature_decoder_mode_config .................................................................... 364 
表 3-553.  函数 timer_internal_clock_config .......................................................................................... 365 
表 3-554.  函数 timer_internal_trigger_as_external_clock_config....................................................... 366 
表 3-555.  函数 timer_external_trigger_as_external_clock_config ...................................................... 366 
表 3-556.  函数 timer_external_clock_mode0_config ........................................................................... 367 
表 3-557.  函数 timer_external_clock_mode1_config ........................................................................... 368 
表 3-558.  函数 timer_external_clock_mode1_disable .......................................................................... 369 
表 3-559.  函数 timer_channel_remap_config ........................................................................................ 370 
表 3-560.  函数 timer_write_chxval_register_config ............................................................................. 371 
表 3-561.  函数 timer_output_value_selection_config .......................................................................... 371 
表 3-562. TSI 寄存器 .................................................................................................................................. 372 
表 3-563. TSI 库函数 .................................................................................................................................. 373 
表 3-564.  函数 tsi_deinit .......................................................................................................................... 374 
表 3-565.  函数 tsi_init .............................................................................................................................. 374 
表 3-566.  函数 cec_enable ....................................................................................................................... 376 

                                                          GD32F3x0 固件库用户指南 
19 
 
表 3-567.  函数 tsi_disable ....................................................................................................................... 376 
表 3-568.  函数 tsi_sample_pin_enable .................................................................................................. 377 
表 3-569.  函数 tsi_sample_pin_disable ................................................................................................. 377 
表 3-570.  函数 tsi_channel_pin_enable ................................................................................................. 378 
表 3-571.  函数 tsi_channel_pin_disable ................................................................................................ 378 
表 3-572.  函数 tsi_sofeware_mode_config ............................................................................................ 379 
表 3-573.  函数 tsi_software_start ........................................................................................................... 379 
表 3-574.  函数 tsi_software_stop ........................................................................................................... 380 
表 3-575.  函数 tsi_hardware_mode_config ........................................................................................... 380 
表 3-576.  函数 tsi_pin_mode_config ...................................................................................................... 381 
表 3-577.  函数 tsi_extend_charge_config ............................................................................................. 381 
表 3-578.  函数 tsi_plus_config ............................................................................................................... 382 
表 3-579.  函数 tsi_max_number_config ................................................................................................ 383 
表 3-580.  函数 tsi_hysteresis_on ........................................................................................................... 384 
表 3-581.  函数 tsi_hysteresis_off ........................................................................................................... 385 
表 3-582.  函数 tsi_analog_on .................................................................................................................. 385 
表 3-583.  函数 tsi_analog_off.................................................................................................................. 386 
表 3-584.  函数 tsi_group_enable ............................................................................................................ 386 
表 3-585.  函数 tsi_group_disable ........................................................................................................... 387 
表 3-586.  函数 tsi_group_status_get ..................................................................................................... 387 
表 3-587.  函数 tsi_group0_cycle_get ..................................................................................................... 388 
表 3-588.  函数 tsi_group1_cycle_get ..................................................................................................... 388 
表 3-589.  函数 tsi_group2_cycle_get ..................................................................................................... 389 
表 3-590.  函数 tsi_group3_cycle_get ..................................................................................................... 389 
表 3-591.  函数 tsi_group4_cycle_get ..................................................................................................... 390 
表 3-592.  函数 tsi_group5_cycle_get ..................................................................................................... 390 
表 3-593.  函数 tsi_flag_clear ................................................................................................................... 391 
表 3-594.  函数 tsi_flag_get ...................................................................................................................... 391 
表 3-595.  函数 tsi_interrupt_enable ....................................................................................................... 392 
表 3-596.  函数 tsi_interrupt_disable ...................................................................................................... 392 
表 3-597.  函数 tsi_interrupt_flag_clear .................................................................................................. 393 
表 3-598.  函数 tsi_interrupt_flag_get ..................................................................................................... 394 
表 3-599. USART 寄存器 ........................................................................................................................... 394 
表 3-600. USART 库函数 ........................................................................................................................... 395 
表 3-601.  枚举类型 usart_flag_enum ...................................................................................................... 397 
表 3-602.  枚举类型 usart_interrupt_flag_enum ..................................................................................... 398 
表 3-603.  枚举类型 usart_interrupt_enum ............................................................................................. 398 
表 3-604.  枚举类型 usart_invert_enum .................................................................................................. 399 
表 3-605.  函数 usart_deinit...................................................................................................................... 399 
表 3-606.  函数 usart_baudrate_set ......................................................................................................... 399 
表 3-607.  函数 usart_parity_config ........................................................................................................ 400 
表 3-608.  函数 usart_word_length_set .................................................................................................. 401 
表 3-609.  函数 usart_stop_bit_set .......................................................................................................... 401 
表 3-610.  函数 usart_enable .................................................................................................................... 402 

                                                          GD32F3x0 固件库用户指南 
20 
 
表 3-611.  函数 usart_disable ................................................................................................................... 402 
表 3-612.  函数 usart_transmit_config .................................................................................................... 403 
表 3-613.  函数 usart_receive_config ...................................................................................................... 404 
表 3-614.  函数 usart_data_first_config .................................................................................................. 404 
表 3-615.  函数 usart_invert_config ........................................................................................................ 405 
表 3-616.  函数 usart_ overrun_enable ................................................................................................... 406 
表 3-617.  函数 usart_ overrun_disable .................................................................................................. 406 
表 3-618.  函数 usart_oversample_config .............................................................................................. 407 
表 3-619.  函数 usart_sample_bit_config ............................................................................................... 407 
表 3-620.  函数 usart_ receiver_timeout_enable .................................................................................... 408 
表 3-621.  函数 usart_receiver_timeout_disable .................................................................................... 409 
表 3-622.  函数 usart_receiver_timeout_threshold_config ................................................................... 409 
表 3-623.  函数 usart_data_transmit ....................................................................................................... 410 
表 3-624.  函数 usart_data_receive ......................................................................................................... 410 
表 3-625.  函数 usart_autobaud_detection_enable ................................................................................ 411 
表 3-626.  函数 usart_autobaud_detection_disable ............................................................................... 411 
表 3-627.  函数 usart_autobaud_detection_mode_config .................................................................... 412 
表 3-628.  函数 usart_address_config .................................................................................................... 413 
表 3-629.  函数 usart_address_detection_mode_config ....................................................................... 413 
表 3-630.  函数 usart_mute_mode_enable ............................................................................................. 414 
表 3-631.  函数 usart_mute_mode_disable ............................................................................................ 414 
表 3-632.  函数 usart_mute_mode_wakeup_config ............................................................................... 415 
表 3-633.  函数 usart_lin_mode_enable .................................................................................................. 415 
表 3-634.  函数 usart_lin_mode_disable ................................................................................................. 416 
表 3-635.  函数 usart_lin_break_dection_length_config ....................................................................... 416 
表 3-636.  函数 usart_halfduplex_enable ................................................................................................ 417 
表 3-637.  函数 usart_halfduplex_disable ............................................................................................... 418 
表 3-638.  函数 usart_clock_enable ........................................................................................................ 418 
表 3-639.  函数 usart_clock_disable ....................................................................................................... 419 
表 3-640.  函数 usart_synchronous_clock_config ................................................................................ 419 
表 3-641.  函数 usart_guard_time_config ............................................................................................... 420 
表 3-642.  函数 usart_smartcard_mode_enable..................................................................................... 420 
表 3-643.  函数 usart_smartcard_mode_disable.................................................................................... 421 
表 3-644.  函数 usart_smartcard_mode_nack_enable .......................................................................... 421 
表 3-645.  函数 usart_smartcard_mode_nack_disable ......................................................................... 422 
表 3-646.  函数 usart_smartcard_mode_early_nack_enable ................................................................ 422 
表 3-647.  函数 usart_smartcard_mode_early_nack_disable ............................................................... 423 
表 3-648.  函数 usart_smartcard_autoretry_config ............................................................................... 423 
表 3-649.  函数 usart_block_length_config ............................................................................................ 424 
表 3-650.  函数 usart_irda_mode_enable ............................................................................................... 425 
表 3-651.  函数 usart_irda_mode_disable .............................................................................................. 425 
表 3-652.  函数 usart_prescaler_config .................................................................................................. 426 
表 3-653.  函数 usart_irda_lowpower_config ......................................................................................... 426 
表 3-654.  函数 usart_hardware_flow_rts_config .................................................................................. 427 