1. Manuals
  2. Brands
  3. GigaDevice Semiconductor Manuals
  4. Motherboard
  5. GD32VW553
  6. Development manual

GigaDevice Semiconductor GD32VW553 Development Manual

Hide thumbs Also See for GD32VW553:
Table of Contents

Advertisement

Quick Links

Download this manual
GigaDevice Semiconductor Inc.
GD32VW553 Quick Development Guide
Application Note
AN154
Revision 1.2
(July 2024)

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GD32VW553 and is the answer not in the manual?

Questions and answers

Related Manuals for GigaDevice Semiconductor GD32VW553

Summary of Contents for GigaDevice Semiconductor GD32VW553

  • Page 1 GigaDevice Semiconductor Inc. GD32VW553 Quick Development Guide Application Note AN154 Revision 1.2 (July 2024)

  • Page 2: Table Of Contents

    AN154 GD32VW553 Quick Development Guide Table of Contents Table of Contents ......................2 List of Figures ........................ 4 List of Tables ........................6 Introduction to development board ..............7 1.1. Picture of real development board ................7 1.1.1. The START development board ..................7 1.1.2.
  • Page 3 AN154 GD32VW553 Quick Development Guide 5.1. Open projects ......................26 5.2. Compilation ........................ 27 5.3. Download firmware....................29 5.4. Debugging ........................30 FAQ ........................32 6.1. No image error ......................32 6.2. Code running in SRAM ....................32 Revision history ....................33...

  • Page 4: List Of Figures

    AN154 GD32VW553 Quick Development Guide List of Figures Figure 1-1. The picture of the START development board ..............7 Figure 1-2. The picture of the EVAL development board ................ 8 Figure 1-3. Development Board Type Configuration ................9 Figure 1-4. List of devices and drivers ....................10 Figure 1-5.
  • Page 5 AN154 GD32VW553 Quick Development Guide Figure 5-9. Images output ......................... 29 Fogure 5-10 SES IDE image download ....................30 Figure 5-11. MSDK SES Project Configuration Interface ............... 31 Figure 5-12. SES IDE Debug Interface ..................... 31...

  • Page 6: List Of Tables

    AN154 GD32VW553 Quick Development Guide List of Tables Table 1-1. Boot mode........................... 9 Table 7-1. Revision history ........................33...

  • Page 7: Introduction To Development Board

    AN154 GD32VW553 Quick Development Guide Introduction to development board 1.1. Picture of real development board 1.1.1. The START development board The START development board consists of a baseboard and a module equipped with the GD32VW55x Wi-Fi+BLE chip. Figure 1-1. The picture of the START development board Mainly focus on the following parts of the development board, which have been marked in the Figure 1-1.

  • Page 8: The Eval Development Board

    AN154 GD32VW553 Quick Development Guide 1.1.2. The EVAL development board The EVAL development board consists of a baseboard and a module equipped with the GD32VW55x Wi-Fi+BLE chip. The baseboard lead out many peripheral test ports, such as I2C, IFRP, ADC and so on.

  • Page 9: Boot Mode

    AN154 GD32VW553 Quick Development Guide Figure 1-3. Development Board Type Configuration 1.2. Boot mode GD32VW55x can boot from ROM, FLASH, or SRAM. The level selection of the two pins BOOT0 and BOOT1 in the BOOT SWD box of the development board determines the boot mode. See Table 1-1.

  • Page 10: Download Interface

    AN154 GD32VW553 Quick Development Guide 1.4. Download interface For START development board, in addition to the firmware download through the debugger mentioned in the previous section, if debugging is not required and only the firmware needs to be downloaded, it can also be downloaded by dragging it into the USB disk. Connect the development board to the computer through a USB cable, and the GigaDevice disk as shown Figure 1-4.

  • Page 11: Building Development Environment

    AN154 GD32VW553 Quick Development Guide Building development environment Build a development environment before compiling and downloading the firmware. The development tool currently used is GD32 Embedded Builder and SEGGER Embedded Studio IDE. 2.1. Installation of GD32 Embedded Builder ◼ GD32...

  • Page 12: Figure 2-2 Download Toolchain

    AN154 GD32VW553 Quick Development Guide The directory structure of the downloaded Nuclei RISC-V Toolchain after unpacking is shown Figure 2-3 Nuclei Toolchain Catalog Structure Figure 2-2 Download Toolchain Figure 2-3 Nuclei Toolchain Catalog Structure...

  • Page 13: What Developers Must Know

    AN154 GD32VW553 Quick Development Guide What developers must know Before getting started with development, first understand the members of the SDK execution program group, how to correctly configure the SDK. 3.1. SDK execution program group SDK will finally generate two main execution programs: MBL (Main Bootloader) and MSDK (Main SDK), which will eventually be downloaded to FLASH to run.

  • Page 14: Sram Layout

    AN154 GD32VW553 Quick Development Guide 3.2.2. SRAM layout The configuration file is GD32VW55x_RELEASE\config\config_gdm32.h. Modify the following macro definition (as Figure 3-3. SRAM layout shows) values to plan the SRAM space occupied by the executable program segments MBL and IMG. These values are offset addresses, and the base address is defined at the beginning of the file.

  • Page 15: App Configuration

    AN154 GD32VW553 Quick Development Guide macro definition values showed in Figure 3-5. Firmware version No. to specify the version No. In addition, the macro RE_IMG_VERSION is used in Securt Boot to determine the firmware version. MBL only supports local upgrade, while IMG supports online upgrade. The version No.
  • Page 16 AN154 GD32VW553 Quick Development Guide Figure 3-6. Project boot information...

  • Page 17: Gd32 Embedded Builder Ide Project

    AN154 GD32VW553 Quick Development Guide GD32 Embedded Builder IDE project This chapter introduces how to compile and debug the SDK under GD32 Embedded Builder IDE. The project group consists of two projects: MBL/MSDK. MSDK includes Wi-Fi protocol stack, BLE protocol stack, peripheral drivers, applications, etc. The MBL is mainly responsible for selecting the correct MSDK firmware from the two (current firmware and OTA firmware) to run.

  • Page 18: Figure 4-3. Open Projects From File System

    AN154 GD32VW553 Quick Development Guide Figure 4-3. Open Projects from file System Select the project path GD32VW55x_RELEASE\MBL\project\eclipse, as shown in Figure 4-4. Selecting MBL project path, and click Finish. Figure 4-4. Selecting MBL project path...

  • Page 19: Figure 4-5. Mbl Project Interface

    AN154 GD32VW553 Quick Development Guide Close the welcome interface, and the MBL project is shown as Figure 4-5. MBL project interface shows. Figure 4-5. MBL project interface ◼ Import the MSDK project In the File menu, click Open Projects from file System, Select the project path GD32VW55x_RELEASE\MSDK\projects\eclipse\msdk, as shown in Figure 4-6.

  • Page 20: Compilation

    AN154 GD32VW553 Quick Development Guide Figure 4-7. MSDK and MBL project interfaces 4.2. Compilation ◼ Check the configuration of the project compilation tool Right-click on the project, click on properties, select C/C++ Build -> Settings in order, and on the tab click on toolchain settings., as shown in Figure 4-8.

  • Page 21: Figure 4-9. Compiling The Mbl Project

    AN154 GD32VW553 Quick Development Guide Figure 4-9. Compiling the MBL project The compilation result is as shown in Figure 4-10. MBL compilation result. Figure 4-10. MBL compilation result After the compilation is complete, the script MBL\project\mbl_afterbuild.bat will be automatically called to generate mbl.bin and copied to the directory \scripts\images.

  • Page 22: Figure 4-11. Target Configuration Selection

    AN154 GD32VW553 Quick Development Guide ◼ Compile the MSDK project Right-click the project, and click Build Configurations—>Set Active—><target configuration> in order. as shown in Figure 4-11. target configuration selection, the default target project is msdk. Figure 4-11. target configuration selection Right-click the project again, and click Build Project, The compilation result is as shown in Figure 4-12.

  • Page 23: Download Firmware

    AN154 GD32VW553 Quick Development Guide image-ota.bin is the bin file generated by MSDK project, which can be used for OTA upgrade. image-all.bin is the combination of MBL(mbl.bin) and MSDK(image-ota.bin), the firmware can be used for production, download into FLASH and run.

  • Page 24: Figure 4-15. Msdk Debug Configuration

    AN154 GD32VW553 Quick Development Guide Double-click GDB General Debugging to open the interface shown in Figure 4-15. MSDK debug configuration, the c/c++ application has automatically selected msdk\MSDK.elf, you can browse to select different configurations corresponding to elf file, for example, msdk_ffd generated elf The file is located at GD32VW55x_RELEASE\MSDK\projects\eclipse\msdk\ msdk_ffd\MSDK.elf.

  • Page 25: Figure 4-16. Msdk Debugging Configuration Interface With Openocd

    AN154 GD32VW553 Quick Development Guide Figure 4-16. MSDK Debugging Configuration Interface with openocd Figure 4-17. MSDK debug interface...

  • Page 26: Segger Embedded Studio Ide Project

    AN154 GD32VW553 Quick Development Guide SEGGER Embedded Studio IDE project This chapter introduces how to compile and debug the SDK under SEGGER Embedded Studio IDE. 5.1. Open projects ◼ Open MBL project Open directory: GD32VW55x_RELEASE\MBL\project\segger, double click MBL.emProject to open the MBL SES project. The opened project is shown in Figure 5-1.

  • Page 27: Compilation

    AN154 GD32VW553 Quick Development Guide Figure 5-2. MSDK SES Project Interface 5.2. Compilation ◼ Nuclei Toolchain configuration Please put the directory of Toolchain downloaded in subsection 2.3Toolchain download nuclei_riscv_newlibc_prebuilt_win32_2022.04\gcc\bin into the path of environment variable of windows. ◼ SES build tool configuration SES compiles the GD32VW55x project using the riscv32-none-elf toolchain by default.

  • Page 28: Figure 5-4. Compiling The Mbl Project

    AN154 GD32VW553 Quick Development Guide Figure 5-4. Compiling the MBL project The compilation result is as shown in Figure 5-5. MBL compilation result. Figure 5-5. MBL compilation result After the compilation is complete, the script MBL\project\mbl_afterbuild.bat will be automatically called to generate mbl.bin and copied to the directory \scripts\images.

  • Page 29: Download Firmware

    AN154 GD32VW553 Quick Development Guide Figure 5-7 MSDK Project Configuration Options After selecting the corresponding configuration, right-click the project and click Build, the compilation result is shown in Figure 5-8 MSDK compilation result. Figure 5-8 MSDK compilation result Image generated by SDK ◼...

  • Page 30: Debugging

    AN154 GD32VW553 Quick Development Guide all.bin to the Gigadevice disc to download it. Or download it by clicking Target->Download MSDK in the menu bar, as shown in Fogure 5-10 SES IDE image download. Fogure 5-10 SES IDE image download 5.4.

  • Page 31: Figure 5-11. Msdk Ses Project Configuration Interface

    AN154 GD32VW553 Quick Development Guide Figure 5-11. MSDK SES Project Configuration Interface ◼ Start Debugging Click Debug->GO in the menu bar to debug, click and wait for the image downloading to complete and enter the interface shown in Figure 5-12. SES IDE Debug Interface.

  • Page 32: Faq

    AN154 GD32VW553 Quick Development Guide 6.1. No image error Print ERR: No image to boot (ret = -5). Reason: An error occurs during the previous boot of WIFI_IOT, and the MBL records operation exception of the IMAGE. If another IMAGE is not downloaded or also has a boot exception, this message will be printed.

  • Page 33: Revision History

    AN154 GD32VW553 Quick Development Guide Revision history Table 7-1. Revision history Revision No. Description Date Initial release Nov.24.2023 Chapter 2 revision Jan.26.2024 SES IDE project added, GD32 Eclipse IDE updated to GD32 July.17. 2024 Embedded Builder...
  • Page 34 Important Notice This document is the property of GigaDevice Semiconductor Inc. and its subsidiaries （the "Company"). This document, including any product of the Company described in this document （the “Product”), is owned by the Company under the intellectual property laws and treaties of the People’s Republic of China and other jurisdictions worldwide.

Table of Contents