OpenOCD 不同仿真器使用操作总结记录
针对不同的仿真器使用 OpenOCD 时候的设置操作总结 ...... 矜辰所致
目录
- 前言
- 一、OpenOCD 环境搭建
- 二、OpenOCD 基本测试
- 三、Makefile 中仿真器配置
-
- 3.1 ST-link
- 3.2 Jlink
- 3.2 CMSIS-DAP（待更新）
- 结语
前言
在使用 GCC 环境开发 ARM 系列芯片的时候，我们往往会配合使用 OpenOCD 来进行仿真调试下载，博主自己在 Windows 下开发常用的 STM32 等芯片的时候也是使用的这套方案。
这个环境的搭建在我曾经的博文：在window下使用 VScode 搭建 ARM 开发环境—— 详细版
中详细说明过，当时好些年前设置好的环境，最近换了新电脑，然后环境重新配置，又因为仿真器又有好几个不一样的，所以得重新配置一下不同的仿真器。
所以就想到写下本文，来汇总记录一下 不同的仿真器的设置使用, 方便以后再次更换环境时候能更快速的搭建好环境，当然本文是以下载为主，以 Windows 下的 GCC 开发环境为说明。
一、OpenOCD 环境搭建
OpenOCD（Open On-Chip Debugger）是开源片上调试器，过多的我们这里就不介绍了，以前也介绍过，环境配置以前也说明过，这里我们简单复习一下。
首先是下载 OpenOCD ：OpenOCD 官方下载地址
下载下来的是压缩文件，可以直接解压，比如我解压的位置如下：
接下来就是配置环境变量，具体操作如下图所示（win10 家庭版）：
最后只需要在我们的 终端中输入openocd -v 有版本信息提示，就表示环境配置成功：
二、OpenOCD 基本测试
我们可以通过 openocd -h 查看帮助选项：
我们接下来就连接上仿真器来说明一下，但是前提是安装好了仿真器驱动：
安装好驱动后：
我们下面直接来做基本的测试，为了方便测试，我们在目录下 D:\Program Files\OpenOCD-20211118-0.11.0\share\openocd\scripts 打开终端，如下图：
在此路径下打开终端进行操作，在后面选择配置文件的时候相对方便一下，因为文件的路径就不用写很多了。
打开后，也是一个终端：
我们先简单的定义一下接口，如下图：
上面为什么使用 interface 选择，我也是参考网上一些说明教程，也可能是 openocd 的早年版本是使用 interface 的，这目前来说不是我们的重点，所有的问题这里都会有提示，我们根据上面的提示进行修改，如下：
最后提示 Error ，这里暂时先不管。
这里重点我们要知道的是，openocd 对于各种仿真器，和用哪种单片机都已经写好了配置文件。基本上我们使用 openocd 我们都不用自己去写，只需要调用现成的配置文件就可以了。
那么好了，配置文件怎么使用，上面我们说到了 -f 是使用配置文件，我们直接按照如下操作进行：
这里实际上我们就可以看到正常的进入的调试模式，直接调用配置文件看来是可以的。
但是我们的目的是什么？是烧录文件，所以我们还要使用 -c 执行 program 命令，我们这里简单总结一下
openocd的操作模式
openocd -f <接口配置文件> -f <目标芯片配置文件> -c <要执行的命令>
我们把需要烧录的 hex 文件拷贝到当前文件夹下（为了测试方便），如下图：
我们使用如下指令进行程序烧录测试：
openocd -f "interface/stlink-v2.cfg" -f "target/stm32f1x.cfg" -c "program test.hex" -c "reset"
因为 test.hex 已经放到当前目录下，所以这里可以直接选择，然后后面的 -c "reset" 是软件复位，就是程序烧录完成以后自动复位运行， "reset" 有没有双引号都可以，上面指令也可以是
openocd -f "interface/stlink-v2.cfg" -f "target/stm32f1x.cfg" -c "program test.hex" -c reset
测试如下图：
上图中最后不会退出的问题，我们可以在指令的最后加上一条指令：-c shutdown 关闭当前的操作（因为烧录结束了不需要操作了）
最后的指令：
openocd -f "interface/stlink-v2.cfg" -f "target/stm32f1x.cfg" -c "program test.hex" -c reset -c shutdown
最后测试的完成现象如下图：
三、Makefile 中仿真器配置
上面我们通过基本的测试，我们已经成功的把 hex 文件烧录到了 STM32 芯片中，但是上面也只是测试，我们在开发 STM32 的时候不可能每次都重复的使用上面的操作进行烧录，那样太繁琐了。
所以我们需要进行一些基本的设置，基于我们是使用 GCC 开发环境，所以我们可以在 Makefile 中进行一些必要的设置，使得能够直接相对 “简单” 的进行烧录。
Makefile 文件我们只需要使用 STM32CubeMX 生成的工程就可以。
3.1 ST-link
上面我们就是使用的 ST-Link 进行的测试，所以只要设置得当，肯定是没有什么问题的。
指令实际上还是和上面的指令一样，只不过在 Makefile 中需要加上绝对路径下面是完成的操作图：
3.2 Jlink
有了上面成功的操作，对于 Jlink 来说按理来说也只需要选择一下对应的配置文件就可以了，但是实际上是有问题的，如下图：
JLink 需要使用指令-c "transport select swd" 选择使用 SWD 模式，对于现在开发来说，基本都是使用的 SWD 模式。
但是最后还是有问题的，这个原因其实以前我已经说过了，详细的情况还是参考博文：在window下使用 VScode 搭建 ARM 开发环境
的 第 7 小节：7、使用 Jlink 烧录问题说明
具体的内容大家自行跳转查看。
其实 JLink 的这部分使用，内容还是比较多的，而且 Jlink 更换驱动以后不仅 Keil 中无法识别的，J-Link 配套的那些软件也是无法识别出来的，虽然可以换来换去，也免不了麻烦，所以要根据自己实际的应用环境确定是否需要更换驱动。
3.2 CMSIS-DAP（待更新）
好吧，本来以为仓库中有个烧录器是 CMSIS-DAP ，想着也可以来记录一下，后来发现还是 ST-link，那么 CMSIS-DAP 今天是更新不了了，等下次有机会用到的时候再来更新把，或许自己什么时候也去做一个。
…（待更新）
结语
本文在 Windows 环境下测试使用了 OpenOCD 的程序烧录，也说明了如何在 STM32CubeMX 生成的工程 Makefile 中如何使用 OpenOCD 进行一键下载。
当然在 Linux 环境下也是一样的，只需要注意一下对应的路径设置。
虽然少了 CMSIS-DAP 的测试，但是从网上很多同学的测试使用情况来看，CMSIS-DAP 也是比较正常的，和 ST-Link 一样的简单，不像 J-LInk 那么不太友好，这一点我后面一定会找机会给补上的。
那么，本文就到这里把，谢谢大家！