GD32F3x0 ARM Cortex-M43固件库1.0：详细外设功能与函数指南

需积分: 5 134 浏览量更新于2024-06-28 收藏 5.46MB PDF 举报

GD32F3x0是一款由GigaDeviceSemiconductor公司设计的基于ARM Cortex-M43架构的24位微控制器固件库用户指南。该文档针对GD32F3x0系列的固件库提供了详细的介绍和使用说明，适用于1.0版本，发布于2019年6月。主要内容包括： 1. **文档与固件库规则**： - 文档遵循特定的命名规则，如外设名称采用简洁且一致的缩写。 - 提供了外设寄存器描述和外设库函数说明，以帮助开发者理解和使用这些功能。 2. **文件组织结构**： - 固件库文件结构清晰，分为Examples（示例程序）、Firmware（核心固件代码）、Template（模板代码）和Utilities（实用工具）四个部分。 - Examples文件夹包含可运行的应用程序示例，供开发者参考学习。 - Firmware文件夹存储核心库函数，支持各个外设的功能实现。 - Template文件夹可能包含一些预定义的代码框架或配置文件。 - Utilities文件夹可能包含调试工具、配置工具等实用工具。 3. **外设固件库**： - 提供了对ADC（模拟到数字转换器）、CEC55、CMP（比较器）、CRC（循环冗余校验）、CTC（周期计数器）、DAC（数字模拟转换器）、DBG（调试接口）、DMA（直接内存访问）、EXTI（外部中断）、FMC（灵活记忆体控制器）、FWDGT（分频定时器）、GPIO/AFIO（通用输入/输出和高级功能接口）、I2C（串行总线接口）等多种外设的库函数支持。对每个外设，文档首先阐述了外设寄存器的描述，接着详细列出了相应的库函数，这些函数涵盖了初始化、配置、数据读写、中断处理等操作。 4. **详细章节**： - ADC、CEC55、CMP、CRC、CTC、DAC、DBG、DMA、EXTI、FMC、FWDGT、GPIO/AFIO和I2C的具体章节分别介绍了各自外设的寄存器功能、编程接口和常用功能示例。通过阅读这份用户指南，开发人员可以快速熟悉GD32F3x0的硬件特性和固件库的使用方法，从而更高效地进行项目开发和硬件编程。这份文档是开发GD32F3x0应用系统时的重要参考资料。

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页未读，继续阅读

承让@

粉丝: 8
资源: 380

GD32F3x0 ARM Cortex-M43固件库1.0：详细外设功能与函数指南

GD32F3x0 固件库

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

GD32F3x0固件库使用指南

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

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

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

GigaDevice.GD32F3x0_DFP.2.0.0.rar(兆易创新GD32F3x0系列官方固件库驱动库板级支持包for Keil MDK5)直接运行

GigaDevice.GD32F3x0_DFP.1.0.1.rar

GigaDevice.GD32F3x0_DFP.2.0.0.pack

GigaDevice.GD32F3x0_DFP.1.0.0.pack

最新资源