开发工具 之十一 详解 OpenOCD 源码、构建、配合各仿真器使用示例

### 配置 VSCode 进行 STM32 开发并使用 OpenOCD 调试 #### 安装必要的软件包 为了在 VSCode 中配置 STM32 的开发环境，需先安装一系列基础工具。这包括但不限于 VSCode 自身、GCC ARM 嵌入式工具链以及 OpenOCD。 对于 GCC ARM 工具链，在 Ubuntu 上可以通过命令 `sudo apt-get install gcc-arm-none-eabi` 来完成安装[^3]；而针对 Windows 用户，则建议访问官方网站获取最新版本的安装文件[^1]。 至于 OpenOCD，同样可以在 Linux 发行版上利用包管理器快速部署，例如执行 `sudo apt-get install openocd` 即可满足需求。Windows 平台下则推荐通过官方发布的二进制分发包来进行本地化设置。 #### 设置 VSCode 插件支持 接下来要做的就是在 VSCode 内部集成这些外部资源以便更好地服务于项目构建流程。具体来说： - **C/C++ 扩展**：提供 IntelliSense 功能以及其他 C 和 C++ 语言特性； - **CMake Tools 或 Makefile Tools**：用于处理项目的编译过程； - **Native Debug 或 Cortex-Debug**：实现程序断点调试等功能[^2]。 上述插件可通过 VSCode 内建市场轻松找到并一键安装。 #### 创建与初始化项目结构 借助于 ST 提供的图形界面应用程序——STM32CubeMX 可以便捷地生成初始代码框架，并确保其兼容 GNU Make 构建系统。这样不仅简化了前期准备工作还提高了后续维护效率。 当一切就绪之后，记得把由 CubeMX 导出得到的相关源码复制到工作区目录内相应位置处。 #### 编写 launch.json 文件 为了让开发者能够顺利启动基于 GDB 的远程会话连接至目标板上的 JTAG/SWD 接口，需要精心编辑 `.vscode/launch.json` 文件来定义具体的调试参数。下面给出了一段典型的 JSON 片段作为参考： ```json { "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/build/${fileBasenameNoExtension}.elf", "miDebuggerPath": "/usr/bin/arm-none-eabi-gdb", // 根据实际情况调整路径 "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "externalConsole": false, "MIMode": "gdb", "preLaunchTask": "Build Project", "targetArchitecture": "arm" }, { "name": "OpenOCD Connect", "type": "cortex-debug", "request": "launch", "servertype": "openocd", "cwd": "${workspaceRoot}", "executable": "/path/to/openocd", // 替换成实际路径 "configFiles": ["interface/stlink.cfg","target/stm32f4x.cfg"] // 修改为目标设备对应的配置文件名 } ] } ``` 请注意替换其中涉及绝对地址的部分为适合个人电脑的具体数值。 #### 测试整个流程 最后一步就是验证之前所做的全部努力是否有效果啦！尝试编写一段简单的测试代码（比如点亮 LED），然后按照常规方式点击“开始调试”按钮看看能否正常进入单步跟踪模式吧！