[fix] 完善readme

Author: MuChenger

bsp/gd32/risc-v/gd32vw553h-eval/README.md

@@ -1,90 +1,127 @@
-# GD32VF103V_EVAL开发板BSP说明
+# GD32VW553H_EVAL 开发板BSP说明
 
-## 简介
+## 1 简介
 
-GD32VW553H_EVAL是-兆易创新推出的一款GD32VW系列的评估板.
+GD32VW553H_EVAL是-兆易创新推出的一款GD32VW系列的评估板。开发板外观如下图所示：
 
-开发板外观如下图所示：
+![board](figures/board.png)
 
-![board](figures/board.jpg)
+GD32VW553系列双模无线MCU,支持Wi-Fi 6及Bluetooth LE 5.2无线连接，集成了高达4MB Flash及320KB SRAM，另有32KB可配置指令高速缓存(I-Cache)，大幅提升了CPU处理效率。不仅具备出色的无线性能，芯片还配置了丰富的通用有线接口，包含3个U(S)ART、2个I2C、1个SPI以及1个四线制QSPI等, 以及多达29个可编程 GPIO 管脚。内置2个32位通用定时器、2个16位通用定时器、4个16位基本定时器、1个PWM高级定时器和1个12位ADC。供电电压1.8V~3.6V，并提供了85℃~105℃宽温选择，以满足工控互联、照明设备以及插座面板等高温场景应用所需。
 
-该开发板常用 **板载资源** 如下：
+面向实时处理和高效通信需求，GD32VW553系列MCU采用了全新的开源指令集架构RISC-V处理器内核，主频可达160MHz，还配备了高级DSP硬件加速器、双精度浮点单元(FPU)以及指令扩展接口等资源，以出色的微架构设计实现了极佳的能效比，并提供了灵活的可扩展性。
 
-- GD32VF103VBT6 ，主频 108MHz，128KB FLASH ，32KB RAM 
-- 常用外设
-  - LED ：4个，LED1（PC0），LED2（PC2），LED3（PE0），LED4（PE1）
-  - 按键：2个，K1（复位按键），K2（用户五向按键，PA0, PC13, PB14, PC5, PC4)
-  - General TM * 4 、Advanced TM * 1、Basic TM * 2
-  - 系统定时器 * 1
-  - 看门狗 * 2
-  - RTC * 1
-  - USART * 3、UART * 2
-  - I2C * 2、I2S * 2
-  - SPI * 3
-  - CAN2.0B * 2
-  - USB2.0 OTG FS * 1
-  - TFT-LCD
-  - EXMC/SDRAM * 1
-  - ADC * 2
-  - DAC * 2
-  - 最多支持80GPIOs
-- 调试接口：GD-Link/J-link
+## 2 快速上手
 
-## 外设支持
+### 2.1 环境准备
 
-本 BSP 目前对外设的支持情况如下：
+#### 2.1.1 工具链
 
-| **片上外设**  | **支持情况** | **备注**                                |
-|:--------- |:--------:|:------------------------------------- |
-| GPIO      | 支持       | PA0, PA1... ---> PIN: 0, 1...79 |
-| UART      | 支持       | UART0 - UART4                         |
-| I2C       | 支持       | I2C1                                  |
-| SPI       | 支持       | SPI0 - SPI2                           |
-| ADC       | 支持       | ADC0 - ADC2                            |
-| **扩展模块**  | **支持情况** | **备注**                                |
-| 暂无        | 暂不支持     | 暂不支持                                  |
+首先需要准备BSP编译所需的工具链，[工具链下载链接](https://www.gigadevice.com.cn/product/mcu/mcus-product-selector/gd32vw553hmq6)，在该链接下载应用软件选项中的GD32 Embedded Builder。
 
-## 使用说明
+工具链的相对路径如下：
 
-使用说明分为如下两个章节：
+> GD32EmbeddedBuilder_v1.5.2.30854\Tools\RISC-V Embedded GCC\8.2.0-2.2-20190521-0004\bin
 
-- 快速上手
-  
-  本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
+#### 2.1.2 下载工具
 
-- 进阶使用
-  
-  本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。
+GD32VW553可以使用GD官方工具GD32AllInOneProgrammer下载，[GD32AllInOneProgrammer下载链接](https://www.gd32mcu.com/cn/download?kw=GD32+All-In-One+Programmer&lan=cn)，编译出的固件可使用该软件下载。
 
-### 快速上手
+#### 2.1.3 RT-Thread ENV工具
 
-本 BSP 为开发者提供 GCC 工程。下面介绍如何将系统运行起来。
+RT-Thread的BSP可以使用官方env工具编译，env使用请自行学习，[env下载链接](https://www.rt-thread.org/download.html#download-rt-thread-env-tool)。
 
-#### 硬件连接
+#### 2.2 固件编译
 
-使用数据线连接开发板到 PC，使用USB转232连接USART0，打开电源开关。
+使用USB数据线连接板载的GD-Link与串口。
 
-#### 编译下载
+在BSP根路径下使用env工具打开BSP，示例如下：
 
-在工程目录下输入`scons `命令编译工程，使用J-link/GD-Link下载程序到开发板。
+![board](figures/env.png)
 
-#### 运行结果
+然后执行pkgs --update命令添加当前BSP所需要的驱动库，示例如下（如果长时间未使用env，可首先
 
-下载程序成功之后，系统会自动运行，LED 闪烁。
+行pkgs --upgrade更新软件包的链接索引）
 
-连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
+```powershell
+(.venv) RTT@RSH-PC0001 E:\rt-thread\bsp\gd32\risc-v\gd32vw553h-eval
+$ pkgs --upgrade
+Error message:[Errno 2] No such file or directory: 'E:\\env-windows-v2.0.0\\env-windows\\tools\\bin\\..\\..\\tools\\scripts\\cmds\\.config'
+open .config failed
+[Use Github server - auto decision based on IP location]
+Begin to upgrade env packages.
+remote: Enumerating objects: 768, done.
+remote: Counting objects: 100% (374/374), done.
+remote: Compressing objects: 100% (16/16), done.
+Receiving objects:  96% (738/768)
+Receiving objects: 100% (768/768), 142.23 KiB | 5.69 MiB/s, done.
+Resolving deltas: 100% (462/462), completed with 70 local objects.
+From https://github.com/RT-Thread/packages
+ * branch              HEAD       -> FETCH_HEAD
+==============================>  Env packages upgrade done
+(.venv) RTT@RSH-PC0001 E:\rt-thread\bsp\gd32\risc-v\gd32vw553h-eval
+$ pkgs --update
+```
+
+接下来需要设置工具链字段，示例如下（使用时将下述路径调整为自己的工具链路径）：
+
+```powershell
+(.venv) RTT@RSH-PC0001 E:\rt-thread\bsp\gd32\risc-v\gd32vw553h-eval
+$ set RTT_EXEC_PATH=E:\GD32\GD32VW5\GD32EmbeddedBuilder_v1.5.4_Rel\Tools\RISC-V Embedded GCC\8.2.0-2.2-20190521-0004\bin
+```
+
+接下来执行scons -j128命令编译工程，示例如下：
+
+```powershell
+(.venv) RTT@RSH-PC0001 E:\rt-thread\bsp\gd32\risc-v\gd32vw553h-eval
+$ scons -j128
+```
+
+成功编译会输出下述日志，并在BSP根路径生成**rtthread.bin**固件，该固件即下文需要烧录的固件。
+
+```powershell
+LINK rtthread.elf
+Memory region         Used Size  Region Size  %age Used
+           flash:       66388 B         4 MB      1.58%
+             ram:        288 KB       288 KB    100.00%
+riscv-none-embed-objcopy -O binary rtthread.elf rtthread.bin
+riscv-none-embed-size rtthread.elf
+   text    data     bss     dec     hex filename
+  65152    1200    7612   73964   120ec rtthread.elf
+scons: done building targets.
+```
+
+#### 2.3 固件烧录
+
+固件烧录需要使用上述的GD32AllInOneProgrammer软件，烧录说明位于烧录软件下的Doc文件夹，或在线搜索使用方法，下述是烧录的示例：
+
+![board](figures/programmer.png)
 
-```bash
+> 需要注意的是使用上述软件烧录时需要将boot1置为高电平，烧录结束后重新设置为低电平，手动调整板载的boot跳线帽。
+
+#### 2.4 运行结果
+
+烧录完毕后，使用串口连接自己的串口终端软件，即可通过串口与开发板交互，示例如下：
+
+```shell
  \ | /
 - RT -     Thread Operating System
- / | \     4.1.1 build Jun  8 2022 00:49:01
- 2006 - 2022 Copyright by RT-Thread team
+ / | \     5.2.1 build Dec 12 2025 14:51:49
+ 2006 - 2024 Copyright by RT-Thread team
+Hello GD32VW553H
+msh >
+msh >ps
+thread   pri  status      sp     stack size max used left tick   error  tcb addr
+-------- ---  ------- ---------- ----------  ------  ---------- ------- ----------
+tshell    20  running 0x000002d0 0x00001000    31%   0x00000009 OK      0x20002598
+tidle0    31  ready   0x00000220 0x00000400    53%   0x00000019 OK      0x20000654
+timer      4  suspend 0x00000290 0x00000400    64%   0x00000009 EINTRPT 0x20000ba8
+main      10  suspend 0x00000280 0x00001000    17%   0x00000013 EINTRPT 0x200012b8
 msh >
 ```
 
-### 进阶使用
+#### 2.5 配置工程
 
-此 BSP 默认只开启了 GPIO 和 串口0的功能，如果需使用高级功能，需要利用 ENV 工具对BSP 进行配置，步骤如下：
+ BSP 默认只开启了 GPIO 和 串口0的功能，如果需使用高级功能，需要利用 ENV 工具对BSP 进行配置，步骤如下：
 
 1. 在 bsp 下打开 env 工具。
 
@@ -94,12 +131,12 @@ msh >
 
 4. 输入`scons `命令重新编译工程。
 
-## 注意事项
+## 3 注意事项
 
 暂无
 
 ## 联系人信息
 
 维护人:
 
-- [BruceOu](https://github.com/Ouxiaolong/), 邮箱：<[email protected]>
+- [MuChenger](https://github.com/MuChenger), 邮箱：<[email protected]>

bsp/gd32/risc-v/gd32vw553h-eval/figures/board.jpg

@@ -17,7 +17,7 @@
 # EXEC_PATH is the compiler execute path, for example, CodeSourcery, Keil MDK, IAR
 if  CROSS_TOOL == 'gcc':
     PLATFORM    = 'gcc'
-    EXEC_PATH   = r'E:\GD32\GD32VW5\GD32EmbeddedBuilder_v1.5.4_Rel\Tools\RISC-V Embedded GCC\8.2.0-2.2-20190521-0004\bin'
+    EXEC_PATH   = r'C:/Program Files (x86)/GNU Tools RISC-V Embedded/8 2019.08-2/bin'
 else:
     print('Please make sure your toolchains is GNU GCC!')
     exit(0)