GD32F3x0固件库用户指南：外设驱动与API详解

5星 · 超过95%的资源需积分: 35 94 浏览量更新于2024-07-17 1 收藏 5.46MB PDF 举报

"GD32F3x0_固件库用户指南_V1.0.pdf" 本文档是GD32F3x0系列基于ARM Cortex-M4的32位微控制器的固件库用户指南，主要介绍了固件库的使用、文件结构以及各外设驱动的详细说明。 1. 引言文档旨在为GD32F3x0系列MCU的开发者提供一个清晰的固件库使用方法，涵盖了固件库的规则、命名规范以及库文件的组织结构。文档中的外设缩写和命名规则对外设的识别和操作至关重要，有助于理解和应用固件库。 2. 固件库概述固件库分为几个主要部分，包括Examples（示例代码）、Firmware（核心库文件）、Template（模板文件）和Utilities（工具文件）。Examples提供了如何使用固件库进行开发的实例；Firmware包含了各种外设驱动的源码；Template则包含项目模板，方便快速建立新工程；Utilities文件夹则提供了辅助工具和实用程序。 3. 外设固件库固件库涵盖了GD32F3x0芯片上的多种外设，如ADC（模数转换器）、CEC（消费电子控制）、CMP（比较器）、CRC（循环冗余校验）、CTC（通用定时器）、DAC（数模转换器）、DBG（调试模块）、DMA（直接存储器访问）、EXTI（外部中断）、FMC（灵活静态存储控制器）、FWDGT（看门狗定时器）、GPIO/AFIO（通用输入输出/复用功能输入输出）、I2C（互连设备总线）等。每个外设都有详细的寄存器描述和库函数说明。 3.1 ADC ADC部分详细描述了ADC的寄存器配置，包括控制寄存器、状态寄存器和转换数据寄存器，并提供了开始转换、读取转换结果等相关库函数的使用说明。 3.2 - 3.14 其他外设如CEC、CMP、CRC、CTC、DAC、DBG、DMA、EXTI、FMC、FWDGT、GPIO/AFIO、I2C等也按照相同的格式，详细阐述了其寄存器结构和库函数，为开发者提供了全面的接口和操作指导。这些章节不仅提供了外设的操作方法，还包含了一系列的库函数，如初始化、配置、读写寄存器、启动和停止外设功能等，帮助开发者更高效地进行软件开发，减少对硬件底层细节的关注。总结，GD32F3x0固件库用户指南为开发者提供了完整的GD32F3x0系列MCU外设驱动的使用指南，通过这个文档，开发者可以迅速上手并实现对MCU外设的有效控制，提升开发效率和代码质量。

GD32F3x0 固件库用户指南

表 3-435. 函数 i2s_init ................................................................................................................................... 285

表 3-436. 函数 i2s_psc_config ..................................................................................................................... 287

表 3-437. 函数 i2s_enable ............................................................................................................................. 288

表 3-438. 函数 i2s_disable ............................................................................................................................ 288

表 3-439. 函数 spi_nss_output_enable ...................................................................................................... 289

表 3-440. 函数 spi_nss_output_disable ..................................................................................................... 289

表 3-441. 函数 spi_nss_internal_high ........................................................................................................ 290

表 3-442. 函数 spi_nss_internal_low .......................................................................................................... 290

表 3-443. 函数 spi_dma_enable .................................................................................................................. 291

表 3-444. 函数 spi_dma_disable ................................................................................................................. 292

表 3-445. 函数 spi_i2s_data_frame_format_config ................................................................................. 292

表 3-446. 函数 spi_i2s_data_transmit ........................................................................................................ 293

表 3-447. 函数 spi_i2s_data_receive .......................................................................................................... 293

表 3-448. 函数 spi_bidirectional_transfer_config .................................................................................... 294

表 3-449. 函数 spi_crc_polynomial_set ..................................................................................................... 295

表 3-450. 函数 spi_crc_polynomial_get ..................................................................................................... 295

表 3-451. 函数 spi_crc_on ............................................................................................................................ 296

表 3-452. 函数 spi_crc_off ............................................................................................................................ 296

表 3-453. 函数 spi_crc_next ......................................................................................................................... 297

表 3-454. 函数 spi_crc_get ........................................................................................................................... 297

表 3-455. 函数 spi_ti_mode_enable ............................................................................................................ 298

表 3-456. 函数 spi_ti_mode_disable ........................................................................................................... 298

表 3-457. 函数 spi_nssp_mode_enable ..................................................................................................... 299

表 3-458. 函数 spi_nssp_mode_disable .................................................................................................... 299

表 3-459. 函数 qspi_enable .......................................................................................................................... 300

表 3-460. 函数 qspi_disable ......................................................................................................................... 300

表 3-461. 函数 qspi_write_enable ............................................................................................................... 301

表 3-462. 函数 qspi_read_enable ................................................................................................................ 301

表 3-463. 函数 qspi_io23_output_enable .................................................................................................. 302

表 3-464. 函数 qspi_io23_output_disable ................................................................................................. 302

表 3-465. 函数 spi_i2s_interrupt_enable ................................................................................................... 303

表 3-466. 函数 spi_i2s_interrupt_disable .................................................................................................. 304

表 3-467. 函数 spi_i2s_interrupt_flag_get ................................................................................................. 304

表 3-468. 函数 spi_i2s_flag_get................................................................................................................... 305

表 3-469. 函数 spi_crc_error_clear ............................................................................................................. 306

表 3-470. SYSCFG 寄存器 ............................................................................................................................. 307

表 3-471. SYSCFG 库函数 ............................................................................................................................. 307

表 3-472. 函数 syscfg_deinit ........................................................................................................................ 308

表 3-473. 函数 syscfg_dma_remap_enable............................................................................................... 308

表 3-474. 函数 syscfg_dma_remap_disable ............................................................................................. 309

表 3-475. 函数 syscfg_high_current_enable ............................................................................................. 309

表 3-476. 函数 syscfg_high_current_disable ............................................................................................ 310

表 3-477. 函数 syscfg_exti_line_config ..................................................................................................... 310

表 3-478. 函数 syscfg_lock_config ............................................................................................................. 311

GD32F3x0 固件库用户指南

表 3-479. 函数 syscfg_flag_get ................................................................................................................... 312

表 3-480. 函数 syscfg_flag_clear ................................................................................................................ 312

表 3-481. 函数 syscfg_compensation_config ........................................................................................... 313

表 3-482. 函数 syscfg_cps_rdy_flag_get ................................................................................................... 313

表 3-483. TIMER 寄存器 ................................................................................................................................. 314

表 3-484. TIMER 库函数 ................................................................................................................................. 315

表 3-485. 结构体类型 timer_parameter_struct .......................................................................................... 317

表 3-486. 结构体类型 timer_break_parameter_struct .............................................................................. 317

表 3-487. 结构体类型 timer_oc_parameter_struct .................................................................................... 318

表 3-488. 结构体类型 timer_ic_parameter_struct ..................................................................................... 318

表 3-489. 函数 timer_deinit........................................................................................................................... 318

表 3-490. 函数 timer_struct_para_init ....................................................................................................... 319

表 3-491. 函数 timer_init ............................................................................................................................... 319

表 3-492. 函数 timer_enable ......................................................................................................................... 320

表 3-493. 函数 timer_disable ........................................................................................................................ 321

表 3-494. 函数 timer_auto_reload_shadow_enable ................................................................................. 321

表 3-495. 函数 timer_auto_reload_shadow_disable ................................................................................ 322

表 3-496. 函数 timer_update_event_enable .............................................................................................. 322

表 3-497. 函数 timer_update_event_disable ............................................................................................. 323

表 3-498. 函数 timer_counter_alignment ................................................................................................... 323

表 3-499. 函数 timer_counter_up_direction .............................................................................................. 324

表 3-500. 函数 timer_counter_down_direction ......................................................................................... 325

表 3-501. 函数 timer_prescaler_config ...................................................................................................... 325

表 3-502. 函数 timer_repetition_value_config .......................................................................................... 326

表 3-503. 函数 timer_autoreload_value_config ........................................................................................ 327

表 3-504. 函数 timer_counter_value_config ............................................................................................. 327

表 3-505. 函数 timer_counter_read ............................................................................................................. 328

表 3-506. 函数 timer_prescaler_read .......................................................................................................... 328

表 3-507. 函数 timer_single_pulse_mode_config .................................................................................... 329

表 3-508. 函数 timer_update_source_config ............................................................................................ 329

表 3-509. 函数 timer_ocpre_clear_source_config ................................................................................... 330

表 3-510. 函数 timer_interrupt_enable ....................................................................................................... 331

表 3-511. 函数 timer_interrupt_disable ...................................................................................................... 332

表 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 ................................................................................................................... 335

表 3-516. 函数 timer_dma_enable ............................................................................................................... 336

表 3-517. 函数 timer_dma_disable .............................................................................................................. 337

表 3-518. 函数 timer_channel_dma_request_source_select ................................................................. 338

表 3-519. 函数 timer_dma_transfer_config ............................................................................................... 339

表 3-520. 函数 timer_event_software_generate ....................................................................................... 340

表 3-521. 函数 timer_break_struct_para_init ............................................................................................ 341

表 3-522. 函数 timer_break_config ............................................................................................................. 342

GD32F3x0 固件库用户指南

表 3-523. 函数 timer_break_enable ............................................................................................................ 343

表 3-524. 函数 timer_break_disable ........................................................................................................... 343

表 3-525. 函数 timer_automatic_output_enable ....................................................................................... 344

表 3-526. 函数 timer_automatic_output_disable ...................................................................................... 344

表 3-527. 函数 timer_primary_output_config ........................................................................................... 345

表 3-528. 函数 timer_channel_control_shadow_config .......................................................................... 345

表 3-529. 函数 timer_channel_control_shadow_update_config ........................................................... 346

表 3-530. 函数 timer_channel_output_struct_para_init .......................................................................... 347

表 3-531. 函数 timer_channel_output_config ........................................................................................... 347

表 3-532. 函数 timer_channel_output_mode_config ............................................................................... 348

表 3-533. 函数 timer_channel_output_pulse_value_config ................................................................... 349

表 3-534. 函数 timer_channel_output_shadow_config ........................................................................... 350

表 3-535. 函数 timer_channel_output_fast_config .................................................................................. 351

表 3-536. 函数 timer_channel_output_clear_config ................................................................................ 352

表 3-537. 函数 timer_channel_output_polarity_config ........................................................................... 352

表 3-538. 函数 timer_channel_complementary_output_polarity_config ............................................. 353

表 3-539. 函数 timer_channel_output_state_config ................................................................................ 354

表 3-540. 函数 timer_channel_complementary_output_state_config .................................................. 355

表 3-541. 函数 timer_channel_input_struct_para_init ............................................................................ 356

表 3-542. 函数 timer_input_capture_config .............................................................................................. 356

表 3-543. 函数 timer_channel_input_capture_prescaler_config ........................................................... 357

表 3-544. 函数 timer_channel_capture_value_register_read ................................................................. 358

表 3-545. 函数 timer_input_pwm_capture_config ................................................................................... 359

表 3-546. 函数 timer_hall_mode_config .................................................................................................... 359

表 3-547. 函数 timer_input_trigger_source_select .................................................................................. 360

表 3-548. 函数 timer_master_output_trigger_source_select ................................................................. 361

表 3-549. 函数 timer_slave_mode_select .................................................................................................. 362

表 3-550. 函数 timer_master_slave_mode_config ................................................................................... 363

表 3-551. 函数 timer_external_trigger_config........................................................................................... 364

表 3-552. 函数 timer_quadrature_decoder_mode_config ...................................................................... 365

表 3-553. 函数 timer_internal_clock_config .............................................................................................. 366

表 3-554. 函数 timer_internal_trigger_as_external_clock_config ......................................................... 366

表 3-555. 函数 timer_external_trigger_as_external_clock_config ........................................................ 367

表 3-556. 函数 timer_external_clock_mode0_config .............................................................................. 368

表 3-557. 函数 timer_external_clock_mode1_config .............................................................................. 369

表 3-558. 函数 timer_external_clock_mode1_disable ............................................................................. 370

表 3-559. 函数 timer_channel_remap_config ........................................................................................... 370

表 3-560. 函数 timer_write_chxval_register_config ................................................................................ 371

表 3-561. 函数 timer_output_value_selection_config ............................................................................. 372

表 3-562. TSI 寄存器 ....................................................................................................................................... 373

表 3-563. TSI 库函数 ....................................................................................................................................... 373

表 3-564. 函数 tsi_deinit ............................................................................................................................... 374

表 3-565. 函数 tsi_init .................................................................................................................................... 375

表 3-566. 函数 cec_enable ............................................................................................................................ 376

GD32F3x0 固件库用户指南

表 3-567. 函数 tsi_disable ............................................................................................................................ 377

表 3-568. 函数 tsi_sample_pin_enable ...................................................................................................... 377

表 3-569. 函数 tsi_sample_pin_disable ..................................................................................................... 378

表 3-570. 函数 tsi_channel_pin_enable ..................................................................................................... 378

表 3-571. 函数 tsi_channel_pin_disable .................................................................................................... 379

表 3-572. 函数 tsi_sofeware_mode_config ............................................................................................... 379

表 3-573. 函数 tsi_software_start ................................................................................................................ 380

表 3-574. 函数 tsi_software_stop ................................................................................................................ 380

表 3-575. 函数 tsi_hardware_mode_config ............................................................................................... 381

表 3-576. 函数 tsi_pin_mode_config .......................................................................................................... 381

表 3-577. 函数 tsi_extend_charge_config ................................................................................................. 382

表 3-578. 函数 tsi_plus_config .................................................................................................................... 383

表 3-579. 函数 tsi_max_number_config .................................................................................................... 384

表 3-580. 函数 tsi_hysteresis_on ................................................................................................................ 385

表 3-581. 函数 tsi_hysteresis_off ................................................................................................................ 385

表 3-582. 函数 tsi_analog_on....................................................................................................................... 386

表 3-583. 函数 tsi_analog_off ...................................................................................................................... 386

表 3-584. 函数 tsi_interrupt_enable ............................................................................................................ 387

表 3-585. 函数 tsi_interrupt_disable ........................................................................................................... 387

表 3-586. 函数 tsi_interrupt_flag_clear ...................................................................................................... 388

表 3-587. 函数 tsi_interrupt_flag_get ......................................................................................................... 388

表 3-588. 函数 tsi_flag_clear ........................................................................................................................ 389

表 3-589. 函数 tsi_flag_get ........................................................................................................................... 389

表 3-590. 函数 tsi_group_enable ................................................................................................................. 390

表 3-591. 函数 tsi_group_disable ................................................................................................................ 391

表 3-592. 函数 tsi_group_status_get .......................................................................................................... 391

表 3-593. 函数 tsi_group0_cycle_get ......................................................................................................... 392

表 3-594. 函数 tsi_group1_cycle_get ......................................................................................................... 392

表 3-595. 函数 tsi_group2_cycle_get ......................................................................................................... 393

表 3-596. 函数 tsi_group3_cycle_get ......................................................................................................... 393

表 3-597. 函数 tsi_group4_cycle_get ......................................................................................................... 394

表 3-598. 函数 tsi_group5_cycle_get ......................................................................................................... 394

表 3-599. USART 寄存器 ................................................................................................................................ 395

表 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 ............................................................................................................. 400

表 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 固件库用户指南

表 3-611. 函数 usart_disable ........................................................................................................................ 403

表 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....................................................................................................... 407

表 3-618. 函数 usart_oversample_config .................................................................................................. 407

表 3-619. 函数 usart_sample_bit_config ................................................................................................... 408

表 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 ................................................................................. 412

表 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 ...................................................................................................... 416

表 3-634. 函数 usart_lin_mode_disable ..................................................................................................... 416

表 3-635. 函数 usart_lin_break_dection_length_config ......................................................................... 417

表 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 ........................................................................................ 421

表 3-643. 函数 usart_smartcard_mode_disable ....................................................................................... 421

表 3-644. 函数 usart_smartcard_mode_nack_enable ............................................................................. 422

表 3-645. 函数 usart_smartcard_mode_nack_disable ............................................................................ 422

表 3-646. 函数 usart_smartcard_mode_early_nack_enable .................................................................. 423

表 3-647. 函数 usart_smartcard_mode_early_nack_disable ................................................................. 423

表 3-648. 函数 usart_smartcard_autoretry_config .................................................................................. 424

表 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

剩余450页未读，继续阅读

weixin_38744375

粉丝: 372
资源: 2万+

GD32F3x0固件库用户指南：外设驱动与API详解

GD32E23x_Demo_Suites_V1.0.1.rar

GD32全系列硬件开发指南

GD32F3x0_Firmware_Library_V2.0.2-1.rar

GD32F3x0_固件库1.0.pdf

GD32VF103_固件库用户指南_V1.0.pdf

GD32F30x_固件库用户指南_V1.0.pdf

GD32_USBFS_USBHS_固件库用户指南_V1.0.pdf

GD32E23x_固件库用户手册_Rev1.0.pdf

GD32F3x0_Demo_Suites_V2.0.0_GD32F3x0_Demo_gd32f3x0_DEMO_dojpp_

GD32F3x0系列MCU固件库GD32F3x0_Firmware_Library_V2.2.0+文档.zip

最新资源