[add] 添加vscode环境下调试烧录固件的方法

Author: MuChenger

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

@@ -124,16 +124,55 @@ msh >
  BSP 默认只开启了 GPIO 和 串口0的功能，如果需使用高级功能，需要利用 ENV 工具对BSP 进行配置，步骤如下：
 
 1. 在 bsp 下打开 env 工具。
-
 2. 输入`menuconfig`命令配置工程，配置好之后保存退出。
-
 3. 输入`pkgs --update`命令更新软件包。
-
 4. 输入`scons `命令重新编译工程。
 
-## 3 注意事项
+## 3 调试下载（VSCode）
+
+首先在BSP根目录下执行下述命令，生成VSCode工程所需文件。
+
+> scons --target=vs
+
+在VSCode安装扩展插件Cortex-Debug，版本v1.4.4。
+
+完成上述工作后，点击运行和调试选项，创建一个launch.json配置文件，配置文件示例如下：
+
+```json
+{
+    "version": "0.2.0",
+    "configurations": 
+    [
+        {
+            "name": "Cortex Debug",
+            "cwd": "${workspaceFolder}",
+            "executable": "${workspaceFolder}/rtthread.elf",
+            "request": "launch",
+            "type": "cortex-debug",
+            "servertype": "openocd",
+            "serverpath": "E:/GD32/GD32VW5/Tools/GD32EmbeddedBuilder_v1.5.2.30854/Tools/OpenOCD/xpack-openocd-0.11.0-3/bin/openocd",
+            "configFiles": 
+            [
+                "${workspaceFolder}/openocd_gdlink.cfg"
+            ],
+            "runToEntryPoint": "main", 
+            "showDevDebugOutput": "raw", 
+            "toolchainPrefix": "E:/GD32/GD32VW5/Tools/GD32EmbeddedBuilder_v1.5.2.30854/Tools/RISC-V Embedded GCC/8.2.0-2.2-20190521-0004/bin/riscv-none-embed"
+        }
+    ]
+}
+```
+
+上述文件中的部分字段需要根据用户环境进行修改，格式需与示例一致：
+
+- "serverpath”：该字段需要改为用户的openocd所在路径，openocd工具位于GD32EmbeddedBuilder工具包中。
+- "toolchainPrefix"：该字段需修改为用户的工具链所在路径，工具链位于GD32EmbeddedBuilder工具包中。
+
+完成上述配置后即可点击调试选项进行调试，调试时boot管脚均置为低电平即可，调试时同样会进行固件下载。
+
+## 4 注意事项
 
-暂无
+- Cortex-Debug插件优先选用v1.4.4版本，高版本可能会出现与GDB版本不匹配的问题。
 
 ## 联系人信息
 

bsp/gd32/risc-v/gd32vw553h-eval/openocd_gdlink.cfg

@@ -0,0 +1,42 @@
+#
+# GigaDevice GD32VW55x target
+#
+adapter driver cmsis-dap
+
+adapter speed     8000000
+reset_config trst_only
+adapter srst pulse_width 100
+
+transport select jtag
+
+set _CHIPNAME riscv
+jtag newtap $_CHIPNAME cpu -irlen 5 -expected-id 0x10307a6d
+
+set _TARGETNAME $_CHIPNAME.cpu
+target create $_TARGETNAME riscv -chain-position $_TARGETNAME
+$_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size 20480 -work-area-backup 0
+
+
+# Work-area is a space in RAM used for flash programming
+if { [info exists WORKAREASIZE] } {
+   set _WORKAREASIZE $WORKAREASIZE
+} else {
+   set _WORKAREASIZE 0x5000
+}
+
+# Allow overriding the Flash bank size
+if { [info exists FLASH_SIZE] } {
+    set _FLASH_SIZE $FLASH_SIZE
+} else {
+    # autodetect size
+    set _FLASH_SIZE 0
+}
+
+# flash size will be probed
+set _FLASHNAME $_CHIPNAME.flash
+
+flash bank $_FLASHNAME gd32vw55x 0x08000000 0x400000 0 0 $_TARGETNAME
+riscv set_reset_timeout_sec 1
+init
+
+halt