Getting to Blinky

  • Open the PIO home page selection Project Examples

  • Select arduino blink Click Import Import sample program (first need to download the schema file and import tool, It may take long time to download)
  • You can see the sample project after the import is successful.

Project configuration file

  • We first need to edit the configuration file works platformio.ini according to their own development board model, delete the other development board environmen.

Configuration example

[env:sipeed-longan-nano]
platform = gd32v          ;Platform, choose gd32v
framework = arduino       ;Optional gd32vf103-sdk or arduino
board = sipeed-longan-nano ; Development board
monitor_speed = 115200     ; Serial monitor baudrate
upload_protocol = serial       ; Download tool Default serial port, optional jlink, gd-link, dfu, etc.
debug_tool = jlink         ; Debugging tool default jlink, optional sipeed-rv-debugger, etc.

PIO can implement setting macro definitions in the configuration file, control custom functions such as compilation process, etc. For advanced usage, please refer to PIO official documentation.

One-click compilation

Click on the lower left corner Build to build the project

Connect to the development board

Serial ISP download

  • Prepare the USB to serial downloader
  • Connect development board and downloader
  • Modify the platformio.ini file and add the following line:
    upload_protocol = serial
    
  • Development board hold down the BOOT key, then press the RESET button to restart development board and then release the BOOT button to enter download mode development board.

JTAG download

  • Prepare J-link or Sipeed RV Debugger
  • Connection development board
  • Modify the platformio.ini file, add the following line:
    upload_protocol = jlink
    
    or
    upload_protocol = sipeed-rv-debugger
    

USB DFU download

  • If using it for the first time then you need to install libusb driver, please refer to this guide using Zaidig install the driver.
  • Prepare the USB Type-C cable
  • Use a data cable to connect development board to your computer.
  • Modify the platformio.ini file, add the following line:
    upload_protocol = dfu
    
  • Development board hold down the BOOT key, then press the RESET button to restart development board and then release the BOOT button to enter DFU mode.

One click download

After selecting the download method according to the above steps, you can use the PIO built-in tool to download it with one click.

Click on the lower left corner Upload to upload the program to the development board.

Install drivers using Zadig

PIO has a built-in dfu-util download tool. To use this tool, you need to install the libusb driver for the development board. (Note: different from GD official driver)

It is recommended to install the winusb driver via Zadig. download link

Open Zadig after successful download

Select GD32V in the drop-down bar, replace the driver with WinUSB, click the Replace button, and the replacement will succeed.

USB DFU download

Download the DFU tool:http://dl.sipeed.com/LONGAN/Nano/Tools/GD32_MCU_Dfu_Tool_V3.8.1.5784_1.rar

Unzip two folders:

GD32 MCU Dfu Drivers_v1.0.1.2316 and GD32 MCU Dfu Tool_v3.8.1.5784

First enter the driver folder, install the corresponding driver file, pay attention to run with administrator privileges

Run GD32 MCU Dfu Tool.exe Insert Longan Nano into the computer, press and hold the Boot0 key, short press the Reset key, then release the Boot0 key, you can see that the GD32VF chip is recognized in the DFU tool.

Select the corresponding firmware file, and check the checksum after burning. Click OK to burn.

After the burning is completed, it will not be reset automatically. You need to manually press the reset button to check the running effect.