【ARM Coresight OpenOCD 系列 1 -- OpenOCD 介绍】

CodingCos2023-11-10 14:07

请阅读【ARM Coresight SoC-400/SoC-600 专栏导读】

文章目录

    • [1.1 OpenOCD 介绍](#1.1 OpenOCD 介绍)
      • [1.1.1 OpenOCD 支持的JTAG 适配器](#1.1.1 OpenOCD 支持的JTAG 适配器)
      • [1.1.2 OpenOCD 支持的调试设备](#1.1.2 OpenOCD 支持的调试设备)
      • [1.1.3 OpenOCD 支持的 Flash 驱动](#1.1.3 OpenOCD 支持的 Flash 驱动)
    • [1.2 OpenOCD 安装与使用](#1.2 OpenOCD 安装与使用)
      • [1.2.1 OpenOCD 代码获取及安装](#1.2.1 OpenOCD 代码获取及安装)
      • [1.2.2 OpenOCD 使用](#1.2.2 OpenOCD 使用)
      • [1.2.3 OpenOCD 启用 GDB](#1.2.3 OpenOCD 启用 GDB)
    • [1.3 OpenOCD 资料](#1.3 OpenOCD 资料)

1.1 OpenOCD 介绍

OpenOCD (Open On-Chip Debugger) 是一个开源的硬件调试器，可以提供调试 、芯片编程和边界扫描 等功能。OpenOCD使用标准的JTAG 接口与芯片进行通信，因此，可以用于各种不同的硬件平台，包括 ARM 和 MIPS等。

OpenOCD最初是为了支持ARM7和ARM9微控制器而开发的，但现在已经支持大量的设备，包括Cortex-M、Cortex-A、Cortex-R、PowerPC和RISC-V等架构的微控制器和处理器。除了JTAG接口，OpenOCD还支持SWD (Serial Wire Debug) 和cJTAG (Compact JTAG) 等接口。

OpenOCD 的主要功能包括：

  • 提供一个GDB服务器，可以使用GDB进行源码级别的调试;
  • 支持Flash编程，可以烧写各种不同类型的闪存设备;
  • 支持边界扫描操作，可以用于硬件验证和测试;
  • 提供一个telnet接口，可以执行各种低级的调试命令;
  • 支持脚本，可以使用Tcl脚本来自定义调试环境。

在嵌入式开发中，OpenOCD是一个非常重要的工具，它可以极大地方便开发人员进行代码的调试和硬件的测试。OpenOCD 的功能需要调试适配器来辅助完成，适配器是一种硬件设备，它允许开发者通过JTAG接口与嵌入式设备进行通信。JTAG 适配器通常用于编程、调试和测试嵌入式系统。

JTAG 适配器通常连接到开发者的电脑和嵌入式设备的 JTAG 接口之间。电脑端通常使用 USB 或以太网接口，而设备端则使用特定的JTAG连接器。一些开发板直接集成了调试仿真器，如小熊派开发板就集成了STLink。

开发者可以通过 JTAG 适配器和配套的软件工具进行各种操作，例如：

  • 读写设备的内存和寄存器
  • 下载和运行代码
  • 设置和清除断点
  • 单步执行和暂停代码
  • 检查和修改设备的状态
  • 执行系统级调试和测试

以下是一些常见的 JTAG 适配器的例子：

  • Segger J-Link：一款广泛使用的 JTAG/SWD 适配器，支持各种不同的设备和开发环境。
  • Lauterbach Power Debug：一款功能强大的 JTAG 适配器，通常配合 Lauterbach 的 Trace32 软件使用。
  • ARM DSTREAM / DSTREAM-ST：ARM 官方的调试和追踪适配器，支持各种 ARM 核心。
  • Xilinx Platform Cable USB：适用于 Xilinx FPGA 和可编程逻辑设备的 JTAG 适配器。
  • ST-LINK/V2：STMicroelectronics 官方的 JTAG/SWD 适配器，适用于 STM32 和 STM8 设备。

以下是使用 OpenOCD 的三个主要步骤的详细介绍：

  • 配置 ：OpenOCD 需要一个配置文件，以知道如何与你的硬件进行交互。配置文件通常包括两个部分：一个是关于调试适配器的配置，另一个是关于目标硬件的配置。这些文件通常有 .cfg 扩展名。
  • 启动 ：一旦配置文件准备好了，你可以通过终端运行 openocd 命令来启动 OpenOCD。例如，如果你的配置文件名为 my_config.cfg，你可以运行 openocd -f my_config.cfg 来启动 OpenOCD。
  • 使用 ：一旦 OpenOCD 启动，它会等待连接到它的 GDB 会话。你可以通过运行 gdb 命令并附加到 OpenOCD 进程来开始调试。

1.1.1 OpenOCD 支持的JTAG 适配器

所支持的 JTAG 适配器有以下：

kotlin 复制代码 
AICE, AM335x, ARM-JTAG-EW, ARM-USB-OCD, ARM-USB-TINY, AT91RM9200, axm0432, BCM2835,
Bus Blaster, Buspirate, Cadence DPI, Cadence vdebug, Chameleon, CMSIS-DAP,
Cortino, Cypress KitProg, DENX, Digilent JTAG-SMT2, DLC 5, DLP-USB1232H,
embedded projects, Espressif USB JTAG Programmer,
eStick, FlashLINK, FlossJTAG, Flyswatter, Flyswatter2,
FTDI FT232R, Gateworks, Hoegl, ICDI, ICEBear, J-Link, JTAG VPI, JTAGkey,
JTAGkey2, JTAG-lock-pick, KT-Link, Linux GPIOD, Lisa/L, LPC1768-Stick,
Mellanox rshim, MiniModule, NGX, Nuvoton Nu-Link, Nu-Link2, NXHX, NXP IMX GPIO,
OOCDLink, Opendous, OpenJTAG, Openmoko, OpenRD, OSBDM, Presto, Redbee,
Remote Bitbang, RLink, SheevaPlug devkit, Stellaris evkits,
ST-LINK (SWO tracing supported), STM32-PerformanceStick, STR9-comStick,
sysfsgpio, Tigard, TI XDS110, TUMPA, Turtelizer, ULINK, USB-A9260, USB-Blaster,
USB-JTAG, USBprog, VPACLink, VSLLink, Wiggler, XDS100v2, Xilinx XVC/PCIe, Xverve.

这里介绍下 FTDI，FTDI 是 Future Technology Devices International 的简称，这是一家专门生产 USB 连接设备和模块的公司。FTDI 的产品广泛应用于各种设备和系统中，其中包括一些 JTAG 适配器。

在 OpenOCD 中，可以使用 FTDI 的设备作为 JTAG 或 SWD 的接口。OpenOCD 通过 D2XX 驱动或 libFTDI 库与 FTDI 设备进行通信。使用 FTDI 设备作为 JTAG 或 SWD 接口，可以方便地在 USB 接口和目标设备之间建立连接，从而实现对目标设备的编程和调试。

OpenOCD 支持的 FTDI 设备包括但不限于：

  • FT2232D：含有两个独立的 UART/FIFO 通道的设备。
  • FT2232H：高速版的 FT2232D，功能相同但速度更快。
  • FT4232H：含有四个独立的 UART/FIFO 通道的设备。

以上设备都可以作为 JTAG 或 SWD 适配器，但是需要正确配置其引脚映射和信号电平。这可以通过编写 OpenOCD 配置文件来实现。

再介绍下 J-Link ，它由 Segger 公司开发的一套专业级的调试探头，广泛应用于各种嵌入式系统的开发和调试。J-Link 支持 JTAG, SWD (Serial Wire Debug), 和 cJTAG (Compact JTAG) 等多种调试协议，并支持各种不同的目标设备，包括 ARM Cortex, Renesas RX, Microchip PIC32 等。

OpenOCD 也支持 J-Link 调试探头。可以通过 OpenOCD 结合 J-Link，在使用时需要在 OpenOCD 的配置文件中指定 J-Link 作为调试接口。以下是一个使用 J-Link 的 OpenOCD 配置文件的例子：

powershell 复制代码 
source [find interface/jlink.cfg] 
transport select swd 
source [find target/stm32f1x.cfg]

在以上配置文件中，interface/jlink.cfg 是 OpenOCD 预定义的 J-Link 接口配置文件，transport select swd 指定使用 SWD 协议，target/stm32f1x.cfg 是目标设备的配置文件，这个例子中是一个 STM32F1x 系列的设备。

除了使用 OpenOCD，Segger 也提供了自家的调试软件，例如 J-Link GDB Server，可以和 GNU Debugger (GDB) 直接集成，提供更加完善的调试功能。

1.1.2 OpenOCD 支持的调试设备

kotlin 复制代码 
ARM: AArch64, ARM11, ARM7, ARM9, Cortex-A/R (v7-A/R), Cortex-M (ARMv{6/7/8}-M),
FA526, Feroceon/Dragonite, XScale.ARCv2, AVR32, DSP563xx, DSP5680xx, EnSilica eSi-RISC, 
EJTAG (MIPS32, MIPS64), ESP32, ESP32-S2, ESP32-S3, Intel Quark, LS102x-SAP, NDS32, 
RISC-V, ST STM8, Xtensa.

1.1.3 OpenOCD 支持的 Flash 驱动

kotlin 复制代码 
ADUC702x, AT91SAM, AT91SAM9 (NAND), ATH79, ATmega128RFA1, Atmel SAM, AVR, CFI,
DSP5680xx, EFM32, EM357, eSi-RISC, eSi-TSMC, EZR32HG, FM3, FM4, Freedom E SPI,
GD32, i.MX31, Kinetis, LPC8xx/LPC1xxx/LPC2xxx/LPC541xx, LPC2900, LPC3180, LPC32xx,
LPCSPIFI, Marvell QSPI, MAX32, Milandr, MXC, NIIET, nRF51, nRF52 , NuMicro,
NUC910, Nuvoton NPCX, onsemi RSL10, Orion/Kirkwood, PIC32mx, PSoC4/5LP/6,
Raspberry RP2040, Renesas RPC HF and SH QSPI,
S3C24xx, S3C6400, SiM3x, SiFive Freedom E, Stellaris, ST BlueNRG, STM32,
STM32 QUAD/OCTO-SPI for Flash/FRAM/EEPROM, STMSMI, STR7x, STR9x, SWM050,
TI CC13xx, TI CC26xx, TI CC32xx, TI MSP432, Winner Micro w600, Xilinx XCF,
XMC1xxx, XMC4xxx.

1.2 OpenOCD 安装与使用

1.2.1 OpenOCD 代码获取及安装

代码获取

  • 通过 git 获取
powershell 复制代码 
 git clone git://git.code.sf.net/p/openocd/code openocd
  • 通过镜像获取
kotlin 复制代码 
http://repo.or.cz/r/openocd.git
git://repo.or.cz/openocd.git

源码编译

运行 $ ./configure 命令，进行OpenOCD配置，可配置的项目可以通过 $ ./configure -h 命令查看帮助信息。 笔者的调试器是 J-Link，所以还要运行如下命令进行使能

shell 复制代码 
$ ./configure --enable-jlink
$ sudo make install

安装完成后，运行 $ openocd -V 命令，查看当前软件版本。

1.2.2 OpenOCD 使用

举例来说，假设你正在使用一个 STM32F4 Discovery 开发板，可以直接使用命令openocd -f board/stm32f4discovery.cfg 启动OpenOCD, vim openocd-0.12.0/tcl/board/stm32f4discovery.cfg 可以看到下面内容：

shell 复制代码 
# my_config.cfg # 适配器配置 
source [find interface/stlink.cfg]

transport select hla_swd

# increase working area to 64KB
set WORKAREASIZE 0x10000

# 目标硬件配置 
source [find target/stm32f4x.cfg]

reset_config srst_only

使用的规则：

  • find 命令和参数FILENAME是放在[]中，命令返回的是该文件的完整路径（文件名不要用'#'，'#'是TCL的关键字）；
  • source 命令使用find到的文件，并以把这个文件作为脚本执行。

如果当前使用的是一个不常见的适配器来debug一些目标设备，就需要source jtag interface 和 target configs。例如：

shell 复制代码 
  openocd -f interface/ftdi/jtagkey2.cfg -c "transport select jtag" \
          -f target/ti_calypso.cfg

  openocd -f interface/stlink.cfg -c "transport select hla_swd" \
          -f target/stm32l0.cfg

1.2.3 OpenOCD 启用 GDB

在另一个终端中，你可以启动 GDB 并连接到 OpenOCD：

kotlin 复制代码 
arm-none-eabi-gdb -ex "target remote localhost:3333"

此时，你就可以使用 GDB 来进行调试了。例如，你可以使用 continue 命令来开始执行程序，或者使用 break 命令来设置断点。

以上就是 OpenOCD 的基本使用方法。在实际使用中，你可能需要根据你的具体硬件和需求来调整配置文件和 GDB 命令。

1.3 OpenOCD 资料

推荐阅读 ：
https://zhuanlan.zhihu.com/p/41517198
https://openocd.org/doc-release/html/TAP-Declaration.html#DAP-subcommand-apreg
https://bbs.huaweicloud.com/blogs/122621

相关推荐
憧憬一下8 小时前
PCIe_Host驱动分析_地址映射
arm开发·嵌入式硬件·嵌入式·linux驱动开发·pci/pcie
楼兰公子9 小时前
相机主要调试参数
arm开发·驱动·camera·v4l2
7yewh21 小时前
嵌入式驱动RK3566 HDMI eDP MIPI 背光 屏幕选型与调试提升篇-eDP屏
linux·arm开发·驱动开发·嵌入式硬件·嵌入式linux·rk·edp
nh75271 天前
（五）FT2232HL高速调试器之--三步实现STM32的VSCODE在线仿真工程搭建
ide·vscode·编辑器·openocd
千千道2 天前
深入理解 Linux 内核启动流程
linux·arm开发·驱动开发
徐某人..3 天前
ARM嵌入式学习--第八天（PWM）
arm开发·学习·arm
aiamia3 天前
CAN配置---波特率中断引脚等---autochips-AC7811-ARM-M3内核
arm开发·单片机·mcu·车载系统·汽车
驯龙高手_追风3 天前
ARM32位MCU开发板调试经验总结
arm开发·单片机·嵌入式硬件
重生之我是数学王子3 天前
ARM原理
arm开发·系统架构
qq762118223 天前
arm Rk3588 更新固件
arm开发
热门推荐
01基于大语言模型（LLM）的合成数据生成、策展和评估的综述02HCIA-datacom数通题库和录播视频资料03玄机平台应急响应—webshell查杀04组基轨迹建模 GBTM的介绍与实现（Stata 或 R）05YOLOv8训练好模型后，追加轮数继续训练、或者提前终止训练，缩减训练轮数06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07VSCode插件 —— Cody AI （免费AI助手！）08校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站09Docker 夺命连环 15 问10SQL 主从数据库实时备份