platformio stlink

### 如何在 PlatformIO 中配置和使用 STLink

#### 配置 `platformio.ini` 文件

为了能够在 PlatformIO 中使用 STLink 进行调试和编程，需要正确设置项目中的 `platformio.ini` 文件。具体来说，在 `[env:]` 下指定 `upload_protocol` 和其他必要的参数。

对于基于 STM32 的平台，通常会这样定义环境变量：

[env:stm32f103c8]
platform = ststm32
board = bluepill_f103c8
framework = arduino
upload_protocol = stlink
debug_tool = stlink

上述配置指定了使用的开发板型号、框架以及上传协议为 `stlink`[^1]。

#### 安装驱动程序和支持包

确保已经安装了适用于操作系统的 STLink 驱动程序。这一步骤对于 Windows 用户尤为重要；Linux 和 macOS 可能不需要额外的驱动安装，因为这些操作系统自带支持。

另外，通过命令行工具或图形界面更新PlatformIO IDE内的库文件至最新版本也很重要，以获得最佳兼容性和功能特性。

#### 使用命令行进行烧录

如果希望直接利用命令行完成固件烧写，则可以在终端执行如下指令：

pio run -t upload --environment stm32f103c8

这条语句将会编译代码并将其发送到连接着电脑并通过 USB 接口识别为目标设备的硬件上。

#### 调试模式启动

当想要进入调试模式时，可以通过修改 `platformio.ini` 来启用 SWD 或 JTAG 方式的在线调试，并运行相应的任务来开启 GDB Server:

[env:stm32f103c8]
...
debug_mode = swd ; or "jtag"

之后可使用以下命令启动GDB server用于远程调试目的：

pio debug --interface gdb --port :3333 --target reset-halt

此过程允许开发者借助外部IDE（如 VSCode）附带的强大插件来进行断点设置、单步执行等高级操作。