Blink 闪灯程序

  • 打开 PIO 主页 选择 Project Examples

  • 选择 arduino blink 点击 Import 导入示例程序 (初次导入需要下载架构文件及工具,需要等待较长时间)

  • 导入成功后即可见到示例工程

工程配置文件

  • 我们首先需要编辑工程配置文件 platformio.ini 根据自己的开发板型号,删掉其他开发板环境。

配置示例

[env:sipeed-longan-nano]
platform = gd32v          ;平台,选择gd32v
framework = arduino       ;可选 gd32vf103-sdk 或 arduino
board = sipeed-longan-nano ; 开发板
monitor_speed = 115200     ; 串口监视器波特率
upload_protocol = serial   ; 下载工具 默认串口, 可选 dfu、jlink、gd-link 等
debug_tool = jlink         ; 调试工具 默认jlink ,可选 sipeed-rv-debugger 等

PIO 可以在配置文件中实现设置宏定义, 控制编译流程等自定义功能,高级用法请参阅 PIO 官方文档.

一键编译

点击左下角的 Build 即可构建项目

连接开发板

串口 ISP 下载

  • 准备 USB 转 串口下载器
  • 连接开发板与下载器
  • 修改 platformio.ini 文件, 添加下面一行内容:
upload_protocol = serial
  • 开发板按住 BOOT 键,再按 RESET 键重启开发板后再松开 BOOT 键,进入下载模式。

JTAG 下载

  • 准备J-link 或 Sipeed RV 调试器
  • 连接开发板
  • 修改 platformio.ini 文件, 添加下面一行内容:
upload_protocol = jlink

或者

upload_protocol = sipeed-rv-debugger

USB DFU 下载

  • 首次 使用需要安装 libusb 驱动程序, 请参考此步骤 使用 Zaidig 安装驱动.
  • 准备 USB Type-c 数据线
  • 使用数据线连接电脑与开发板
  • 修改 platformio.ini 文件, 添加下面一行内容:
upload_protocol = dfu
  • 开发板按住 BOOT 键,再按 RESET 键重启开发板后再松开 BOOT 键,进入 DFU 模式。

一键下载

按照上面步骤选择好下载方式后,即可使用 PIO 内置工具一键下载。

点击左下角的 Upload 即可向开发板上传程序。

DFU 图形界面下载

下载DFU工具:http://dl.sipeed.com/LONGAN/Nano/Tools/GD32_MCU_Dfu_Tool_V3.8.1.5784_1.rar

解压出两个文件夹:

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

先进入driver文件夹,安装对应的驱动文件,注意使用管理员权限运行

运行 GD32 MCU Dfu Tool.exe
将 Longan Nano 插到电脑,按住 Boot0 键,短按 Reset 键,再松开 Boot0 键,
可以看到 DFU 工具中识别到了 GD32VF 芯片

选择对应的固件文件,并勾选烧录后校验,点击OK,即可进行烧录

烧录完成之后不会自动复位,需要自己手工按下复位按键,查看运行效果

使用Zadig安装驱动

PIO 内置 dfu-util 下载工具,使用此工具需要为开发板安装 libusb 驱动。(注意: 与 GD 官方驱动不同)

建议通过 Zadig 安装 winusb 驱动。下载地址

下载成功后打开 Zadig

在下拉栏中选择 GD32V, 替换驱动选择 WinUSB, 点击替换按钮,即可替换成功。