Linux Mint下STM32黑药丸板连接CubeIDE/CubeProgrammer报错求助

一、优先排查USB权限问题 #

Linux默认普通用户无USB设备读写权限，这是最常见诱因：

• 检查当前用户所属组：

  groups $USER
  

• 若未包含dialout和plugdev组，执行添加命令：

  sudo usermod -aG dialout,plugdev $USER
  

• 注销后重新登录，使权限生效。

二、确认调试器驱动安装 #

黑药丸常用调试芯片为ST-Link V2克隆版或CH340/CH341，对应驱动处理如下：

针对ST-Link： #

1. 安装工具包：

   sudo apt install stlink-tools
   

2. 插入板子后验证识别：

   lsusb | grep ST-Link
   

   正常会显示STMicroelectronics ST-Link/V2类条目。

针对CH340/CH341： #

1. 安装驱动依赖：

   sudo apt install linux-modules-extra-$(uname -r)
   sudo modprobe ch341
   

2. 验证设备识别：

   lsusb | grep QinHeng
   

三、CubeIDE调试配置修正 #

针对「启动序列最终阶段错误」与连接超时：

1. 打开调试配置（Run > Debug Configurations），选中对应STM32调试项；
2. 切换至「Debugger」标签页，确认调试器类型为ST-Link Debugger；
3. 点击「Configure」，确认连接方式为SWD（黑药丸默认用SWD而非JTAG）；
4. 取消勾选「Run to main()」，先完成设备连接再执行程序，避免超时；
5. 重启CubeIDE后重试连接。

四、CubeProgrammer连接排查 #

针对「No STM32 target found」：

1. 打开CubeProgrammer，选择连接方式为ST-Link、接口为SWD；
2. 若为克隆ST-Link，进入「Settings」>「ST-Link」，勾选「Connect under reset」后再点击「Connect」；
3. 用命令行验证ST-Link识别能力：

   st-info --probe
   

   正常会输出STM32芯片型号、ID等信息，无输出则说明硬件或驱动存在问题。

五、硬件层面检查 #

• 确认BOOT引脚状态：BOOT0、BOOT1均接GND（正常运行模式），BOOT0接VCC会进入串口下载模式，导致调试器无法识别；
• 更换USB端口（优先选USB 2.0端口，部分USB 3.0兼容性较差）或USB线；
• 检查板子供电是否正常，劣质USB线可能导致供电不足。

内容的提问来源于stack exchange，提问作者Женя Сукман