烧录Zephyr示例到STM32 Nucleo WB55RG时等待目标挂起超时报错

问题根因 #

该报错是OpenOCD调试工具无法在烧录前将目标芯片切换到暂停运行状态，核心诱因包括VirtualBox USB转发不稳定、调试接口被板载现有固件占用、OpenOCD适配参数不匹配三类。

解决方案 #

1. 修正VirtualBox USB配置（优先排查） #

• 关闭虚拟机，打开VirtualBox对应虚拟机的设置页，将USB控制器版本改为USB 2.0 (EHCI)，STLINK V2对USB 3.0转发兼容性极差
• 在USB过滤列表中手动添加STLINK设备，VID填0483、PID填374B，保证设备独占挂载到虚拟机，不会被宿主机抢占
• 启动虚拟机后再插入开发板，在VirtualBox顶部菜单栏「设备-USB」中手动选中STLINK设备挂载，不要开启自动挂载

2. 复位按键辅助烧录（快速验证） #

• 先按住开发板上的RST复位键不要松开
• 终端执行west flash命令
• 当终端输出Info : clock speed 500 kHz日志时立刻松开复位键，即可正常完成烧录

3. 修改OpenOCD配置（一劳永逸） #

• 打开板子对应的OpenOCD配置文件：/home/nikos/zephyrproject/zephyr/boards/arm/nucleo_wb55rg/support/openocd.cfg
• 在文件末尾添加两行配置：

reset_config srst_only srst_nogate
adapter speed 200

• 保存后重新执行west flash即可，调低适配器速度可以规避USB转发不稳定导致的指令超时

4. 升级STLINK固件 #

如果以上方案都无效，可以先在Windows宿主机上用STM32 ST-LINK Utility将STLINK固件升级到最新版本，再回到虚拟机环境下烧录。

内容的提问来源于stack exchange，提问作者gregni