GD32VW553-IOT V2开发版【三分钟快速环境搭建教程 VSCode】
一、硬件介绍
1、产品特点
萤火工场基于兆易创新GD32VW553(GD32VW553HMQ7)无线双模MCU研发、RISC-V内核的32位MCU的开源硬件
GD32VW553系列MCU采用了全新的开源指令集架构RISC-V处理器内核，主频可达160MHz。集成了高达4MB Flash及320KB SRAM，另有32KB可配置指令高速缓存(I-Cache)，大幅提升了CPU处理效率，支持2.4GHz Wi-Fi 6及BLE5.2无线连接标准；
性能参数
| 功能 | 参数 |
|---|---|
| FLASH(KB) | 4096 |
| SRAM(KB) | 320 |
| 时钟 | ——————————— |
| General Timer(16-bit) | 2 |
| General Timer(32-bit) | 2 |
| Advanced Timer(16-bit) | 1 |
| Basic Timer(16-bit) | 1 |
| SysTick(64-bit) | 1 |
| Watchdog | 2 |
| RTC | 1 |
| 接口 | ——————————— |
| USART | 1 |
| UART | 2 |
| I2C | 2 |
| SPI | 1 |
| QSPI | 1 |
| Wi-Fi 6 | 1 |
| BLE 5.2 | 1 |
| 12bit ADC Units(Channels) | 1(9) |
2、硬件升级优化
经过一年，对比上一代，硬件布局升级，进行了系统性优化，更加的方便好用了；
Type-C 口升级： 集成串口功能， 简化调试与程序下载流程， 提升开发便捷性；
新增开关： 增设用户可自定义按键及指示灯， 拓展交互控制与状态显示功能；
板面布局优化： 背面增加引脚丝印， 正面仅保留关键器件丝印， 布局清晰及信息聚焦；
FLASH 焊接位： 移至背面， 减少焊接风险， 增加开源二次开发的灵活性；
BOOT 开关优化： 升级为拔码式设计， 简化操作逻辑， 提升切换效率；
稳固性增强： 板厚增至 1mm， 提升了整体结构强度与抗变形能力 ；
实物如下：
GD32VW55x系列 支持 cJTAG 和 JTAG，不支持 SWD 的调试接口
需使用GDLink / JLink 调试器
3、功能引脚示意图 / 原理图
开发板相关手册 / 资料下载
板载LED灯
LED1：电源指示灯 🔴
USR_LED：PB2 🔴
BOOT选择 (SW1切换)
BOOT0：PC8
BOOT1：PB1
按键
KEY1：复位按钮
KEY2：PB11 (USR_KEY)
引脚定义
板载Type-C串口功能： PB15 / PA8 (UART1_TX / RX)
USART0（PB15 和 PA8）， UART1（PA4 和 PA5），UART2（PA6 和 PA7）
| 引脚 | 复用功能 |
|---|---|
| PC8(BOOT0) | TIMER2_CH2, I2C0_SDA, I2C1_SDA, USART0_TX, UART1_TX |
| PB0 | TIMER0_CH1_ON, TIMER0_CH0, TIMER0_CH2, UART1_TX, I2C0_SCL, TIMER2_ETI, TIMER16_CH0, UART2_CTS, TIMER0_BRKIN 附加功能：ADC_IN8 |
| PA9 | SPI_MOSI, TIMER0_CH1, QSPI_SCK, USART0_TX, TIMER15_CH0_ON |
| PA10 | SPI_MISO, TIMER0_CH2, QSPI_CSN, TIMER16_CH0, USART0_RX |
| PA11 | SPI_SCK, TIMER0_CH3, QSPI_IO0, TIMER16_BRKIN, TIMER1_CH3 |
| PA12(WKUP3) | TIMER0_ETI, TIMER0_CH3, QSPI_IO1, SPI_NSS, USART0_CK, TIMER1_CH2, TIMER16_CH0_ON |
| PB13 | TIMER0_CH0_ON, TIMER1_CH3, I2C1_SDA, TIMER15_CH0 |
| PB12 | TIMER0_BRKIN, TIMER0_CH3, TIMER1_CH2, I2C1_SCL |
| PB4(NJTRST) | TIMER1_CH0, TIMER1_ETI, QSPI_IO3, USART0_TX, UART1_TX |
| PB3(JTDO) | TIMER1_CH1, QSPI_IO2, USART0_RX, UART1_RX, TIMER15_BRKIN |
| PA15(JTDI) | TIMER1_CH0, TIMER1_ETI, I2C0_SCL, I2C1_SCL, USART0_RX, UART1_RX 附加功能：ADC_IN8 |
| PA14(JTCK) | I2C1_SMBA, I2C1_SDA, USART0_RTS, UART1_RTS |
| PA13(JTMS) | I2C0_SMBA, I2C1_SCL, USART0_CTS, UART1_CTS |
| PB15(UART1_TX) | RTC_REFIN, TIMER0_CH2_ON, TIMER2_CH0, I2C0_SCL, I2C1_SCL, USART0_TX, IFRP_OUT |
| PA8(UART1_RX) | CK_OUT0, TIMER0_CH0, USART0_RX, I2C0_SDA, I2C1_SDA, USART0_CK, TIMER15_CH0, RTC_OUT, TIMER0_CH2_ON |
| PA7(WAKEUP2) | I2C1_SDA, TIMER0_CH0_ON, TIMER2_CH1, QSPI_IO1, SPI_NSS, SPI_MOSI, TIMER0_CH1_ON, UART2_RX, TIMER1_CH2 附加功能：ADC_IN7 |
| PA6 | TIMER2_CH0, QSPI_IO0, I2C1_SCL, SPI_MISO, SPI_SCK, TIMER0_CH1, TIMER1_CH1, UART2_TX 附加功能：ADC_IN6 |
| PA5 | UART1_RX, TIMER2_ETI, QSPI_CSN, SPI_MISO, SPI_SCK, TIMER0_CH1_ON 附加功能：ADC_IN5 |
| PA4 | UART1_TX, SPI_MOSI, QSPI_SCK, SPI_NSS, TIMER0_CH1 附加功能：ADC_IN4 |
| PA3 | USART0_RTS, TIMER1_CH3, I2C0_SDA, SPI_NSS, TIMER0_CH0_ON, UART1_RX, RTC_OUT 附加功能：ADC_IN3 |
| PA2 | USART0_CTS, TIMER1_CH2, I2C0_SCL, SPI_SCK, TIMER0_CH0, UART1_TX 附加功能：ADC_IN2 |
| PA1 | USART0_RX, TIMER1_CH1, SPI_MISO, UART1_RTS |
| PA0(WAKEUP0) | USART0_TX, TIMER1_CH0, TIMER1_ETI, SPI_MOSI, UART1_CTS, TIMER0_ETI 附加功能：ADC_IN0, RTC_TAMP1 |
| PB1 | TIMER0_CH2_ON, TIMER0_CH0_ON, TIMER2_CH2, UART1_RX, I2C0_SDA, TIMER16_CH0_ON, UART2_RTS 附加功能：BOOT1 |
BOOT 引导模式配置
启动时，使用 BOOT0 和 BOOT1 引脚选择引导存储器地址
选择从 ROM 启动，FLASH 启动或者 SRAM 启动
| BOOT0 | BOOT1 | 引导地址 | 引导区域 |
|---|---|---|---|
| 0 | - | 0x08000000 | SIP Flash |
| 0 | - | 0x0BF46000 | secure boot |
| 1 | 0 | 0x0BF40000 | Bootloader / ROM |
| 1 | 1 | 0x20000000 | SRAM |
| 1 | - | 0x0BF40000 | Bootloader / ROM |
主要原理图：
系统框图
二、环境搭建
开发环境主要有【GD32 Embedded Builder】、【Visual Studio Code】等；
在此，通过使用【Visual Studio Code】完成开发；
VS Code 配合 EIDE 插件进行 MCU 的开发
1、Visual Studio Code下载
VS Code下载地址
2、工具下载
固件库
GD32VW55x_Demo_Suites_V1.4.0
包含Demo例程等
烧录工具
GD32AllInOneProgrammer
串口烧录
3、VS Code 环境配置
1、安装插件
2、创建工程项目
导入下载好的文件，以LED_Demo为例：
...\GD32VW55x_Demo_Suites_V1.4.0\GD32VW553H_EVAL_Demo_Suites\Projects\01_GPIO_Running_LED\eclipse\.cproject
3、安装工具链(RISCV工具链)
4、工具配置
构建器选项设置
修改为与下方对应；
附加选项添加-nostartfiles
使用启动代码
start.S
链接脚本路径设置
将显示的相对路径位置复制到上方：
../../../../GD32VW55x_Firmware_Library/RISCV/env_Eclipse/GD32VW553xM.lds
三、代码编写
实现效果：板载的LED灯按500ms的间隔闪烁（USR_LED：PB2 🔴）
main.c
#include "gd32vw55x.h"
#include "systick.h"
#include <stdio.h>int main(void)
{systick_config();/* enable the LED clock */rcu_periph_clock_enable(RCU_GPIOB);/* configure LED GPIO port */gpio_mode_set(GPIOB, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_PIN_2);/* reset LED GPIO pin */gpio_bit_reset(GPIOB, GPIO_PIN_2);while (1){gpio_bit_set(GPIOB, GPIO_PIN_2);delay_1ms(500);gpio_bit_reset(GPIOB, GPIO_PIN_2);delay_1ms(500);}
}四、程序编译
点击左上方的构建，下方窗口显示编译完成的 .hex 文件路径
五、程序烧录
1、用Type-C数据线连接开发板至电脑上；
2、打开烧录工具GD32AllInOneProgrammer.exe
3、根据图示Type-C口向上，将BOOT0接VCC (向上)，BOOT1接GND (向下)
烧录完成后，需恢复（都向下）
4、连接开发板，按照图示，导入编译好的.hex文件后下载；
六、演示效果
板载的LED灯以500ms的间隔闪烁
