GD32E10x固件库用户手册-中文版

GD32

5星 · 超过95%的资源需积分: 47 135 浏览量更新于2024-07-18 5 收藏 9.61MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

"GD32固件库用户指南-中文版本" 该资源是GigaDevice Semiconductor Inc.为GD32E10x系列基于ARM Cortex-M4的32位微控制器提供的固件库用户指南，主要介绍了如何使用和理解GD32E10x的固件库。固件库是为了简化和加速开发过程，提供了预编译的驱动程序和例程，方便开发者进行嵌入式系统设计。在文档中，1.0版本（2017年12月发布）首先介绍了文档和固件库的一般规则，包括对外设缩写的定义和命名规则的说明。这有助于读者更好地理解和查找相关的外设功能。固件库的概述部分详细描述了文件组织结构，包括以下几个关键部分： 1. Examples文件夹：包含示例代码，供开发者参考和学习如何使用固件库。 2. Firmware文件夹：存放固件库的核心代码，包括各个外设的驱动程序。 3. Project文件夹：可能包含了针对不同IDE和调试环境的项目配置文件。 4. Template文件夹：提供了一些模板文件，用于快速创建新项目。 5. Utilities文件夹：包含辅助工具和实用程序，帮助开发者进行开发工作。文档接着详细介绍了各个外设的固件库，如ADC（模拟数字转换器）、BKP（备份寄存器）、CAN（控制器局域网络）、CRC（循环冗余校验）、CTC（通用定时器）、DAC（数字模拟转换器）、DBG（调试模块）、DMA（直接存储器访问）、EXMC（外部存储器控制器）、EXTI（外部中断）、FMC（灵活静态内存控制器）、FWDGT（看门狗定时器）等。每个外设章节都包含了其寄存器描述和对应的库函数说明，这使得开发者能够了解如何通过库函数操作这些外设的硬件寄存器，从而实现特定的功能。例如，ADC章节中，详细阐述了ADC的外设寄存器，如控制和状态寄存器，以及库函数如何进行初始化、配置转换参数、启动转换、读取转换结果等操作。同样，其他外设如CAN、DMA等也有类似的介绍，涵盖了从基本设置到高级特性的全面指导。这个用户指南是GD32E10x系列开发者的重要参考资料，它不仅提供了详尽的外设操作指南，还通过实例和代码片段帮助开发者快速上手。对于任何使用GD32E10x系列微控制器进行嵌入式系统开发的人来说，这个中文版的固件库用户指南都是一个宝贵的工具。

资源详情

资源推荐

GD32E10x 固件库用户指南

表 3-435. 函数 i2s_enable ............................................................................................................................. 374

表 3-436. 函数 i2s_disable ............................................................................................................................ 374

表 3-437. 函数 spi_nss_output_enable ...................................................................................................... 375

表 3-438. 函数 spi_nss_output_disable ..................................................................................................... 376

表 3-439. 函数 spi_nss_internal_high ........................................................................................................ 376

表 3-440. 函数 spi_nss_internal_low .......................................................................................................... 377

表 3-441. 函数 spi_dma_enable .................................................................................................................. 377

表 3-442. 函数 spi_dma_disable ................................................................................................................. 378

表 3-443. 函数 spi_i2s_data_frame_format_config ................................................................................. 379

表 3-444. 函数 spi_i2s_data_transmit ........................................................................................................ 380

表 3-445. 函数 spi_i2s_data_receive .......................................................................................................... 381

表 3-446. 函数 spi_bidirectional_transfer_config .................................................................................... 381

表 3-447. 函数 spi_crc_polynomial_set ..................................................................................................... 382

表 3-448. 函数 spi_crc_polynomial_get ..................................................................................................... 383

表 3-449. 函数 spi_crc_on ............................................................................................................................ 384

表 3-450. 函数 spi_crc_off ............................................................................................................................ 384

表 3-451. 函数 spi_crc_next ......................................................................................................................... 385

表 3-452. 函数 spi_crc_get ........................................................................................................................... 386

表 3-453. 函数 spi_ti_mode_enable ............................................................................................................ 386

表 3-454. 函数 spi_ti_mode_disable ........................................................................................................... 387

表 3-455. 函数 spi_nssp_mode_enable ..................................................................................................... 388

表 3-456. 函数 spi_nssp_mode_disable .................................................................................................... 388

表 3-457. 函数 qspi_enable .......................................................................................................................... 389

表 3-458. 函数 qspi_disable ......................................................................................................................... 390

表 3-459. 函数 qspi_write_enable ............................................................................................................... 390

表 3-460. 函数 qspi_read_enable ................................................................................................................ 391

表 3-461. 函数 qspi_io23_output_enable .................................................................................................. 392

表 3-462. 函数 qspi_io23_output_disable ................................................................................................. 392

表 3-463. 函数 spi_i2s_interrupt_enable ................................................................................................... 393

表 3-464. 函数 spi_i2s_interrupt_disable .................................................................................................. 394

表 3-465. 函数 spi_i2s_interrupt_flag_get ................................................................................................. 394

表 3-466. 函数 spi_i2s_flag_get................................................................................................................... 396

表 3-467. 函数 spi_crc_error_clear ............................................................................................................. 397

表 3-468.TIMER 寄存器 .................................................................................................................................. 398

表 3-469. TIMER 库函数 ................................................................................................................................. 399

表 3-470. 结构体 timer_parameter_struct .................................................................................................. 402

表 3-471. 结构体 timer_break_parameter_struct ...................................................................................... 402

表 3-472. 结构体 timer_oc_parameter_struct ........................................................................................... 403

表 3-473. 结构体 timer_ic_parameter_struct ............................................................................................. 403

表 3-474. 函数 timer_deinit........................................................................................................................... 403

表 3-475. Function timer_struct_para_init ................................................................................................. 404

表 3-476. 函数 timer_init ............................................................................................................................... 405

表 3-477. 函数 timer_enable ......................................................................................................................... 406

表 3-478. 函数 timer_disable ........................................................................................................................ 406

GD32E10x 固件库用户指南

表 3-479. 函数 timer_auto_reload_shadow_enable ................................................................................. 407

表 3-480. 函数 timer_auto_reload_shadow_disable ................................................................................ 408

表 3-481. 函数 timer_update_event_enable .............................................................................................. 408

表 3-482. 函数 timer_update_event_disable ............................................................................................. 409

表 3-483. 函数 timer_counter_alignment ................................................................................................... 410

表 3-484. 函数 timer_counter_up_direction .............................................................................................. 411

表 3-485. 函数 timer_counter_down_direction ......................................................................................... 411

表 3-486. 函数 timer_prescaler_config ...................................................................................................... 412

表 3-487. 函数 timer_repetition_value_config .......................................................................................... 413

表 3-488. 函数 timer_autoreload_value_config ........................................................................................ 414

表 3-489. 函数 timer_counter_value_config ............................................................................................. 414

表 3-490. 函数 timer_counter_read ............................................................................................................. 415

表 3-491. 函数 timer_prescaler_read .......................................................................................................... 416

表 3-492. 函数 timer_single_pulse_mode_config .................................................................................... 416

表 3-493. 函数 timer_update_source_config ............................................................................................ 417

表 3-494. 函数 timer_dma_enable ............................................................................................................... 418

表 3-495. 函数 timer_dma_disable .............................................................................................................. 419

表 3-496. 函数 timer_channel_dma_request_source_select ................................................................. 420

表 3-497. 函数 timer_dma_transfer_config ............................................................................................... 421

表 3-498. 函数 timer_event_software_generate ....................................................................................... 423

表 3-499. 函数 timer_break_struct_para_init ............................................................................................ 425

表 3-500. 函数 timer_break_config ............................................................................................................. 425

表 3-501. 函数 timer_break_enable ............................................................................................................ 426

表 3-502. 函数 timer_break_disable ........................................................................................................... 427

表 3-503. 函数 timer_automatic_output_enable ....................................................................................... 428

表 3-504. 函数 timer_automatic_output_disable ...................................................................................... 428

表 3-505. 函数 timer_primary_output_config ........................................................................................... 429

表 3-506. 函数 timer_channel_control_shadow_config .......................................................................... 430

表 3-507. 函数 timer_channel_control_shadow_update_config ........................................................... 431

表 3-508. 函数 timer_channel_output_struct_para_init .......................................................................... 431

表 3-509. 函数 timer_channel_output_config ........................................................................................... 432

表 3-510. 函数 timer_channel_output_mode_config ............................................................................... 433

表 3-511. 函数 timer_channel_output_pulse_value_config ................................................................... 435

表 3-512. 函数 timer_channel_output_shadow_config ........................................................................... 436

表 3-513. 函数 timer_channel_output_fast_config .................................................................................. 437

表 3-514. 函数 timer_channel_output_clear_config ................................................................................ 438

表 3-515. 函数 timer_channel_output_polarity_config ........................................................................... 439

表 3-516. 函数 timer_channel_complementary_output_polarity_config ............................................. 440

表 3-517. 函数 timer_channel_output_state_config ................................................................................ 441

表 3-518. 函数 timer_channel_complementary_output_state_config .................................................. 442

表 3-519. 函数 timer_channel_input_struct_para_init ............................................................................ 443

表 3-520. 函数 timer_input_capture_config .............................................................................................. 444

表 3-521. 函数 timer_channel_input_capture_prescaler_config ........................................................... 445

表 3-522. 函数 timer_channel_capture_value_register_read ................................................................. 446

GD32E10x 固件库用户指南

表 3-523. 函数 timer_input_pwm_capture_config ................................................................................... 447

表 3-524. 函数 timer_hall_mode_config .................................................................................................... 448

表 3-525. 函数 timer_input_trigger_source_select .................................................................................. 449

表 3-526. 函数 timer_master_output_trigger_source_select ................................................................. 450

表 3-527. 函数 timer_slave_mode_select .................................................................................................. 451

表 3-528. 函数 timer_master_slave_mode_config ................................................................................... 453

表 3-529. 函数 timer_external_trigger_config........................................................................................... 454

表 3-530. 函数 timer_quadrature_decoder_mode_config ...................................................................... 455

表 3-531. 函数 timer_internal_clock_config .............................................................................................. 456

表 3-532. 函数 timer_internal_trigger_as_external_clock_config ......................................................... 457

表 3-533. 函数 timer_external_trigger_as_external_clock_config ........................................................ 458

表 3-534. 函数 timer_external_clock_mode0_config .............................................................................. 459

表 3-535. 函数 timer_external_clock_mode1_config .............................................................................. 460

表 3-536. 函数 timer_external_clock_mode1_disable ............................................................................. 462

表 3-537. 函数 timer_write_chxval_register_config ................................................................................ 462

表 3-538. 函数 timer_output_value_selection_config ............................................................................. 463

表 3-539. 函数 timer_interrupt_enable ....................................................................................................... 464

表 3-540. 函数 timer_interrupt_disable ...................................................................................................... 465

表 3-541. 函数 timer_interrupt_flag_get .................................................................................................... 466

表 3-542. 函数 timer_interrupt_flag_clear ................................................................................................. 467

表 3-543. 函数 timer_flag_get ...................................................................................................................... 468

表 3-544. 函数 timer_flag_clear ................................................................................................................... 470

表 3-545. USART 寄存器 ................................................................................................................................ 471

表 3-546. USART 库函数 ................................................................................................................................ 472

表 3-547. 函数 usart_deinit........................................................................................................................... 474

表 3-548. 函数 usart_baudrate_set ............................................................................................................. 474

表 3-549. 函数 usart_parity_config ............................................................................................................. 475

表 3-550. 函数 usart_word_length_set....................................................................................................... 476

表 3-551. 函数 usart_stop_bit_set .............................................................................................................. 477

表 3-552. 函数 usart_enable ......................................................................................................................... 478

表 3-553. 函数 usart_disable ........................................................................................................................ 478

表 3-554. 函数 usart_transmit_config ........................................................................................................ 479

表 3-555. 函数 usart_receive_config .......................................................................................................... 480

表 3-556. 函数 usart_data_first_config ...................................................................................................... 481

表 3-557. 函数 usart_invert_config ............................................................................................................. 482

表 3-558. 函数 usart_receiver_timeout_enable ........................................................................................ 483

表 3-559. 函数 usart_receiver_timeout_disable ....................................................................................... 483

表 3-560. 函数 usart_receiver_timeout_threshold_config ..................................................................... 484

表 3-561. 函数 usart_data_transmit ............................................................................................................ 485

表 3-562. 函数 usart_data_receive .............................................................................................................. 486

表 3-563. 函数 usart_address_config ......................................................................................................... 486

表 3-564. 函数 usart_mute_mode_enable ................................................................................................. 487

表 3-565. 函数 usart_mute_mode_disable ................................................................................................ 488

表 3-566. 函数 usart_mute_mode_wakeup_config .................................................................................. 488

GD32E10x 固件库用户指南

表 3-567. 函数 usart_lin_mode_enable ...................................................................................................... 489

表 3-568. 函数 usart_lin_mode_disable ..................................................................................................... 490

表 3-569. 函数 usart_lin_break_dection_length_config ......................................................................... 491

表 3-570. 函数 usart_send_break................................................................................................................ 492

表 3-571. 函数 usart_halfduplex_enable .................................................................................................... 492

表 3-572. 函数 usart_halfduplex_disable................................................................................................... 493

表 3-573. 函数 usart_synchronous_clock_enable ................................................................................... 494

表 3-574. 函数 usart_synchronous_clock_disable .................................................................................. 494

表 3-575. 函数 usart_synchronous_clock_config .................................................................................... 495

表 3-576. 函数 usart_guard_time_config ................................................................................................... 496

表 3-577. 函数 usart_smartcard_mode_enable ........................................................................................ 497

表 3-578. 函数 usart_smartcard_mode_disable ....................................................................................... 497

表 3-579. 函数 usart_smartcard_mode_nack_enable ............................................................................. 498

表 3-580. 函数 usart_smartcard_mode_nack_disable ............................................................................ 499

表 3-581. 函数 usart_smartcard_autoretry_config .................................................................................. 499

表 3-582. 函数 usart_block_length_config ................................................................................................ 500

表 3-583. 函数 usart_irda_mode_enable ................................................................................................... 501

表 3-584. 函数 usart_irda_mode_disable .................................................................................................. 502

表 3-585. 函数 usart_prescaler_config ...................................................................................................... 502

表 3-586. 函数 usart_irda_lowpower_config ............................................................................................. 503

表 3-587. 函数 usart_hardware_flow_rts_config ...................................................................................... 504

表 3-588. 函数 usart_hardware_flow_cts_config ..................................................................................... 505

表 3-589. 函数 usart_dma_receive_config ................................................................................................ 506

表 3-590. 函数 usart_dma_transmit_config .............................................................................................. 506

表 3-591. 函数 usart_hardware_flow_coherence_config........................................................................ 507

表 3-592. 函数 usart_flag_get ...................................................................................................................... 508

表 3-593. 函数 usart_flag_clear ................................................................................................................... 510

表 3-594. 函数 usart_interrupt_enable ....................................................................................................... 511

表 3-595. 函数 usart_interrupt_disable ...................................................................................................... 512

表 3-596. 函数 usart_interrupt_flag_get .................................................................................................... 513

表 3-597. 函数 usart_interrupt_flag_clear ................................................................................................. 515

表 3-598. WWDGT 寄存器 .............................................................................................................................. 516

表 3-599. WWDGT 库函数 .............................................................................................................................. 516

表 3-600. 函数 wwdgt_deinit ........................................................................................................................ 517

表 3-601. 函数 wwdgt_enable ...................................................................................................................... 517

表 3-602. 函数 wwdgt_counter_update ...................................................................................................... 518

表 3-603. 函数 wwdgt_config ....................................................................................................................... 518

表 3-604. 函数 wwdgt_interrupt_enable .................................................................................................... 519

表 3-605. 函数 wwdgt_flag_get .................................................................................................................... 520

表 3-606. 函数 wwdgt_flag_clear ................................................................................................................ 521

表 4-1. 版本历史 .............................................................................................................................................. 522