STM32 Development Tools for VS Code

一个功能强大的 VS Code 扩展，用于 STM32 微控制器开发，支持 CMake 构建、GCC-ARM 编译和 OpenOCD 调试。

✨ 功能特性

🔧 编译构建

• CMake 集成: 完整的 CMake 项目支持
• GCC-ARM 工具链: 支持 arm-none-eabi-gcc 编译器
• Ninja 构建: 快速并行编译
• 一键编译: 编译、清理、重新编译

🐛 调试下载

• OpenOCD 集成: 支持多种调试器
  • ST-Link V2/V2-1/V3
  • J-Link
  • CMSIS-DAP
• 程序下载: 一键烧录固件到芯片
• 在线调试: 支持断点、单步、查看变量

📟 芯片支持

• STM32F0 系列 (Cortex-M0)
• STM32F1 系列 (Cortex-M3)
• STM32F2 系列 (Cortex-M3)
• STM32F3 系列 (Cortex-M4)
• STM32F4 系列 (Cortex-M4)
• STM32F7 系列 (Cortex-M7)
• STM32G0 系列 (Cortex-M0+)
• STM32G4 系列 (Cortex-M4)
• STM32H7 系列 (Cortex-M7)
• STM32L0/L1/L4/L5 系列
• STM32U5 系列
• STM32WB 系列

🖥️ 状态栏集成

所有功能都可以通过状态栏快速访问：

[芯片型号] [调试器] [构建类型] [编译] [清理] [烧录] [调试]

📦 安装要求

必需工具

1. GCC ARM 工具链

   下载地址: https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm
   

2. OpenOCD

   下载地址: https://github.com/xpack-dev-tools/openocd-xpack/releases
   

3. CMake

   下载地址: https://cmake.org/download/
   

4. Ninja (推荐)

   下载地址: https://github.com/ninja-build/ninja/releases
   

依赖扩展

本扩展依赖以下 VS Code 扩展（会自动安装）：

• Cortex-Debug - ARM 调试支持
• C/C++ - C/C++ 语言支持
• CMake Tools - CMake 扩展

🚀 快速开始

1. 自动检测工具链 ✨

扩展支持自动检测本地安装的工具链：

1. 首次启动时，扩展会询问是否自动查找工具链
2. 或者按 Ctrl+Shift+P，运行 "STM32: 自动检测工具链"
3. 扩展会在以下位置搜索：
   • PATH 环境变量
   • 常见安装目录 (C:, D:, Program Files 等)
   • STM32CubeIDE 内置工具链
   • xPack 工具链目录
   • Scoop 安装目录

自动检测的工具：

• GCC ARM (arm-none-eabi-gcc)
• OpenOCD
• CMake
• Ninja

2. 手动配置工具链路径

如果自动检测失败，可以手动配置。打开设置 (Ctrl+,)，搜索 "STM32"：

{
    "stm32.toolchainPath": "C:/gcc-arm-none-eabi/bin",
    "stm32.openocdPath": "C:/openocd/bin/openocd.exe",
    "stm32.openocdScriptsPath": "C:/openocd/share/openocd/scripts"
}

3. 选择芯片型号

1. 点击状态栏的芯片图标，或按 Ctrl+Shift+P
2. 输入 "STM32: 选择芯片型号"
3. 先选择芯片系列，再选择具体型号

4. 编译项目

1. 确保项目根目录有 CMakeLists.txt
2. 点击状态栏的 编译 按钮
3. 或按 Ctrl+Shift+P，选择 "STM32: 编译项目"

5. 下载程序

1. 连接调试器（如 ST-Link）
2. 点击状态栏的 烧录 按钮
3. 或按 Ctrl+Shift+P，选择 "STM32: 下载程序到芯片"

6. 开始调试

1. 点击状态栏的 调试 按钮
2. 或按 F5 开始调试

⚙️ 配置选项

📋 命令列表

📁 项目结构示例

my-stm32-project/
├── CMakeLists.txt          # CMake 配置文件
├── CMakePresets.json       # CMake 预设（可选）
├── src/
│   ├── main.c              # 主程序
│   └── stm32f1xx_it.c      # 中断处理
├── inc/
│   └── stm32f1xx_hal_conf.h
├── startup/
│   └── startup_stm32f103xb.s
├── STM32F103C8Tx_FLASH.ld  # 链接脚本
├── .vscode/
│   └── launch.json         # 调试配置（自动生成）
└── build/                  # 构建输出目录

🐞 故障排除

OpenOCD 无法连接

1. 检查调试器是否正确连接
2. 确认驱动程序已安装
3. 检查 OpenOCD 配置文件路径是否正确
4. 尝试降低调试速度：在 launch.json 中添加 "openOCDLaunchCommands": ["adapter speed 1000"]

编译错误

1. 检查工具链路径是否正确
2. 确认 CMakeLists.txt 配置正确
3. 检查芯片型号是否匹配

无法下载程序

1. 确认 ELF 文件已生成
2. 检查芯片是否被锁定
3. 尝试先擦除芯片

找不到工具链

1. 运行 "STM32: 自动检测工具链" 命令
2. 手动在设置中配置路径
3. 确保工具已正确安装

📂 代码架构

src/
├── extension.ts              # 扩展入口
└── utils/
    ├── chipSelector.ts       # 芯片选择器
    ├── chipUtils.ts          # 芯片工具函数
    ├── cmakeBuilder.ts       # CMake 构建管理
    ├── config.ts             # 配置管理
    ├── debugConfigGenerator.ts # 调试配置生成
    ├── openocdManager.ts     # OpenOCD 管理
    ├── projectDetector.ts    # 项目检测
    └── toolchainDetector.ts  # 工具链检测

📄 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！

GitHub: https://github.com/LUXUFENG/stm32-vscode-extension

📮 联系方式

如有问题，请在 GitHub Issues 中反馈。