fix(vscode): match HDMI hardware-reset tasks

README.md

@@ -299,18 +299,28 @@ OpenOCD 的 cfg 文件由工程自己的 `.vscode/settings.json` 指定，环境
 
 cfg 必须可以直接启动完整会话，包含调试器 interface 和目标芯片配置；只有 `target/gd32e23x.cfg` 这种 target-only 文件不能单独启动调试会话。
 
-例如 CMSIS-DAP 的 wrapper cfg 可以写成：
+例如 CMSIS-DAP 的 wrapper cfg 可以写成（使用下述硬件复位任务时，还需追加后面的 RST 配置）：
 
 ```tcl
 source [find interface/cmsis-dap.cfg]
 source [find target/gd32e23x.cfg]
 ```
 
-模板同时提供 `Flash MCU (Connect Under Reset)`、`Reset MCU (Connect Under Reset)` 和
-`Mass Erase MCU (Connect Under Reset)` 三个可选任务，用于固件复用 SWD 引脚后普通方式无法连接的场景。
-这些任务会在启动 OpenOCD 时临时设置 `connect_assert_srst`，不需要修改工具链目录中的 cfg 文件。
-使用前必须将调试器的 RST 线连接到 MCU 的 NRST；若固件会复用 SWD 引脚，还应在松开复位后保留至少
-2 秒的调试挂接窗口。未连接 RST 线时继续使用不带 `Connect Under Reset` 后缀的普通任务。
+模板的 `Flash MCU`、`Reset MCU` 和 `Mass Erase MCU` 任务默认使用 RST 硬件复位：OpenOCD
+连接时保持复位，连接后松开 RST，并等待 200 ms 后执行烧录、复位或擦除操作。每台开发机需要满足以下条件：
+
+- 调试器的 RST 线连接到 MCU 的 NRST。
+- `gd32.openocd.targetConfig` 指定的 cfg 包含以下配置：
+
+  ```tcl
+  adapter srst delay 100
+  reset_config srst_only srst_nogate connect_assert_srst
+  ```
+
+- 若固件会复用 SWD 引脚，松开复位后应保留至少 2 秒的调试挂接窗口。
+
+cfg 位于 `GD32_OPENOCD_SCRIPTS` 指向的工具目录中，不随工程仓库分发；更换电脑或 OpenOCD
+版本后需要再次确认上述配置。未连接 RST 线的硬件应改用软复位配置。
 
 每台开发电脑配置一次用户环境变量（路径按本机实际位置填写）：
 
@@ -381,11 +391,10 @@ cmake --build Build/Release
 
 ### 烧录
 
-通过 VSCode 任务栏运行 `Flash MCU` 任务。若固件运行后会复用 SWD 引脚，且调试器的 RST 已连接到
-MCU 的 NRST，则改用 `Build and Flash (Connect Under Reset)`。普通模式也可通过命令行烧录：
+通过 VSCode 任务栏运行 `Flash MCU` 任务，或使用同样的硬件复位时序从命令行烧录：
 
-```bash
-openocd -f interface/cmsis-dap.cfg -f target/gd32e23x.cfg -c "program Build/Debug/Application/Application.elf verify reset exit"
+```powershell
+& "$env:GD32_OPENOCD_BIN\openocd.exe" -s "$env:GD32_OPENOCD_SCRIPTS" -f "target/openocd_gdlink_gd32e23x.cfg" -c "init; adapter deassert srst; sleep 200; catch {reset halt}; reset halt; flash write_image erase Build/Debug/Application/Application.elf; reset; exit"
 ```
 
 ### 产物