下面以 YTM32B1HA01 开发板 + DAP-Link（SWD） 为例，演示从烧录到在 VS Code 里单步调试的完整流程，文中截图均为实板操作。

一、下载

• 工具包：openocd-ytmicro-20261024.zip（Windows 64 位，约 5.4 MB）
  openocd-ytmicro-20261024.zip

解压即可使用，无需安装，也不依赖其他运行库。可以放在任意目录，下文假设解压到 D:\tools\openocd：

D:\tools\openocd\
├── openocd.exe
├── YTMicro\          <- 各系列芯片的下载算法和器件信息
├── interface\        <- cmsis-dap.cfg、jlink.cfg、stlink.cfg
└── target\           <- ytmicro.cfg（所有云途芯片通用）

二、支持的芯片和调试器

芯片（DEVICE 取下面任意一个名字，不区分大小写）：

PFlash 和 DFlash 都会自动识别，可直接烧录。

调试器（接口均为 SWD）：

提示：J-Link 切换为 WinUSB 后，SEGGER 官方软件（J-Flash、Ozone 等）就无法识别它了，需要时再在设备管理器中改回来。日常使用 OpenOCD 更推荐 DAP-Link。

三、命令行烧录（一条命令搞定）

打开 cmd，进入工程目录（固件路径相对于当前目录），执行：

D:\tools\openocd\openocd.exe -f interface/cmsis-dap.cfg -c "set DEVICE YTM32B1HA01" -f target/ytmicro.cfg -c "program build/HA0_Adc_Demo.elf verify reset exit"

参数说明：

• -f interface/cmsis-dap.cfg：使用的调试器，换成 jlink.cfg / stlink.cfg 即可切换；
• -c "set DEVICE YTM32B1HA01"：芯片型号，必须写在 target/ytmicro.cfg 前面；
• -f target/ytmicro.cfg：云途芯片通用配置，所有型号都用这一个；
• program ... verify reset exit：烧录 → 校验 → 复位运行 → 退出。

实板运行结果（HA01 + DAP-Link，ADC Demo 约 14 KB，烧录 + 校验约 1 秒）：

看到 ** Programming Finished ** 和 ** Verified OK ** 就表示烧录成功。

常用操作

rem 烧录 hex / elf（自带地址）
openocd.exe -f interface/cmsis-dap.cfg -c "set DEVICE YTM32B1HA01" -f target/ytmicro.cfg -c "program app.hex verify reset exit"

rem 烧录 bin 文件，需要指定起始地址（HA0 PFlash 起始地址为 0x02000000，其他系列请查手册存储器映射）
openocd.exe -f interface/cmsis-dap.cfg -c "set DEVICE YTM32B1HA01" -f target/ytmicro.cfg -c "program app.bin 0x02000000 verify reset exit"

rem 擦除第一个 flash bank（PFlash）
openocd.exe -f interface/cmsis-dap.cfg -c "set DEVICE YTM32B1HA01" -f target/ytmicro.cfg -c "init; reset halt; flash erase_sector 0 0 last; exit"

rem 调低 SWD 速率（线较长或连接不稳定时），单位 kHz，默认 4000
openocd.exe -f interface/cmsis-dap.cfg -c "set DEVICE YTM32B1HA01" -c "set ADAPTER_SPEED 1000" -f target/ytmicro.cfg -c "program app.elf verify reset exit"

四、在 VS Code 中调试（Cortex-Debug）

1. 准备

• VS Code 安装扩展 Cortex-Debug（marus25.cortex-debug）；
• 安装 ARM GCC 工具链（需要其中的 arm-none-eabi-gdb.exe）。用云途 YCT 配置工具生成过 GCC 工程的话，工具链已经自带了；
• 工程能正常编译出 .elf。

2. 配置 .vscode/launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "HA0_Adc_Demo Debug",
            "type": "cortex-debug",
            "request": "launch",
            "cwd": "${workspaceFolder}",
            "executable": "${workspaceFolder}/build/HA0_Adc_Demo.elf",
            "servertype": "openocd",
            "device": "YTM32B1HA01",
            "serverpath": "D:/tools/openocd/openocd.exe",
            "configFiles": [
                "interface/cmsis-dap.cfg",
                "target/ytmicro.cfg"
            ],
            "openOCDPreConfigLaunchCommands": [
                "set DEVICE YTM32B1HA01"
            ],
            "svdFile": "${workspaceFolder}/.vscode/chip.svd",
            "runToEntryPoint": "main",
            "liveWatch": {
                "enabled": true,
                "samplesPerSecond": 4
            }
        }
    ]
}

需要按自己的情况修改的地方：

3. 开始调试

按 F5（或点击 运行和调试 → 开始调试）。Cortex-Debug 会自动启动 OpenOCD、下载程序，并停在 main()。之后就可以正常设置断点、单步、查看变量：

上图在 ADC 采样循环中设置了断点，左侧 Variables 中可以看到实时读到的 voltage 值。

配置了 svdFile 后，在 XPeripherals 面板中可以按位域查看外设寄存器，例如 ADC0 的 CFG0：

五、注意事项

1. set DEVICE 一定要在 target/ytmicro.cfg 之前。命令行中放在 -f target/ytmicro.cfg 前面；VS Code 中写在 openOCDPreConfigLaunchCommands 里。
2. 烧录会占用一段 SRAM 作为工作区，烧录完成后不会恢复其中的内容。正常的"烧录 → 复位运行"流程没有影响；如果在调试过程中写 flash 后不复位直接继续运行，需要注意这一点。
3. 芯片处于低功耗模式、或 SWD 引脚被复用时，可能连不上，可以在复位状态下连接（按住复位键再启动 OpenOCD）。

六、常见问题

七、性能参考

YTM32B1ME05，1 MB PFlash，DAP-Link SWD 4 MHz：

• 整片擦除：约 0.1 s
• 写入速度：约 160 KB/s
• 1 MB 完整镜像烧录 + 校验：约 9 s

使用中遇到问题，欢迎在本帖回复，附上芯片型号、调试器型号和 OpenOCD 的完整输出，方便我们定位。