OpenOCDUser’sGuide资源-CSDN文库

需积分: 9 123 浏览量 2022-08-14 15:50:40 上传评论 2 收藏 977KB PDF 举报

《OpenOCD用户指南》是针对Open On-Chip Debugger（OpenOCD）的详细文档，主要面向的是在嵌入式系统开发中进行调试的工程师。该文档覆盖了OpenOCD的版本0.11.0+dev，日期为2022年6月20日。OpenOCD是一个开源的芯片级调试器，它支持多种CPU和调试接口，用于对硬件进行在线调试和编程。本指南由多个作者共同创作并遵循GNU Free Documentation License，允许自由复制、分发和修改，无任何不变章节、封面文本或背封面文本。用户可以在文档中找到许可证的具体内容。主要内容包括： 1. **关于OpenOCD**：介绍OpenOCD项目的基本信息，它的目标和功能，以及如何参与和贡献到这个开源项目中。 2. **调试适配器硬件**：这部分详细介绍了用于连接目标系统和主机的调试硬件，包括JTAG、SWD等接口，以及如何选择和配置这些硬件。 3. **Jim-Tcl**：Jim-Tcl是OpenOCD中的脚本语言，用于编写自定义命令和自动化流程。用户可以学习如何利用Jim-Tcl扩展OpenOCD的功能。 4. **运行OpenOCD**：这部分提供了启动和运行OpenOCD服务器的步骤，包括如何设置命令行参数、配置文件等。 5. **OpenOCD项目设置**：详述了如何配置和构建OpenOCD环境，以便与特定的CPU和硬件平台配合使用。 6. **配置文件指导**：讨论了配置文件的结构和规则，以及如何编写有效的配置文件来定义OpenOCD的行为。 7. **服务器配置**：涵盖了OpenOCD服务器的配置选项，如通信端口、网络设置和协议选择。 8. **调试适配器配置**：针对不同类型的调试适配器，如JTAG或SWD，提供了具体的配置方法。 9. **复位配置**：讲解如何配置OpenOCD以控制目标系统的复位操作，包括硬件复位和软件复位。 10. **TAP声明**：TAP（Test Access Port）是JTAG标准的一部分，用于访问芯片内部的测试逻辑。这部分解释了如何在OpenOCD中声明和配置TAP。 11. **CPU配置**：详细介绍了如何配置OpenOCD以支持不同的CPU架构，如ARM、MIPS、RISC-V等，以及相关的调试特性。 12. **闪存命令**：这部分介绍了OpenOCD提供的闪存编程命令，包括擦除、编程和验证操作，以及如何处理不同的闪存控制器和存储器。通过阅读《OpenOCD用户指南》，开发者能够掌握OpenOCD的使用方法，从而更高效地进行嵌入式系统调试和固件更新。对于那些需要对硬件进行深入调试和测试的工程师来说，这份文档是不可或缺的参考资料。

资源详情

资源评论

资源推荐

Open On-Chip Debugger:

OpenOCD User’s Guide

for release 0.11.0+dev

20 June 2022

Short Contents

About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

1 OpenOCD Developer Resources . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Debug Adapter Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

3 About Jim-Tcl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4 Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5 OpenOCD Project Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

6 Conﬁg File Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7 Server Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

8 Debug Adapter Conﬁguration. . . . . . . . . . . . . . . . . . . . . . . . . . . 37

9 Reset Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

10 TAP Declaration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

11 CPU Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

12 Flash Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

13 Flash Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

14 PLD/FPGA Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

15 General Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

16 Architecture and Core Commands . . . . . . . . . . . . . . . . . . . . . . 139

17 JTAG Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

18 Boundary Scan Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

19 Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

20 GDB and OpenOCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

21 Tcl Scripting API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

22 FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

23 Tcl Crash Course . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

A The GNU Free Documentation License. . . . . . . . . . . . . . . . . . . 194

OpenOCD Concept Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Command and Driver Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Table of Contents

About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

What is OpenOCD? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

OpenOCD Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Latest User’s Guide: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

OpenOCD User’s Forum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

OpenOCD User’s Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

OpenOCD IRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1 OpenOCD Developer Resources . . . . . . . . . . . . . . . 3

1.1 OpenOCD Git Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Doxygen Developer Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.3 Gerrit Review System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.4 OpenOCD Developer Mailing List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.5 OpenOCD Bug Tracker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Debug Adapter Hardware . . . . . . . . . . . . . . . . . . . . . . 5

2.1 Choosing a Dongle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.2 USB FT2232 Based. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.3 USB-JTAG / Altera USB-Blaster compatibles. . . . . . . . . . . . . . . . . . . 6

2.4 USB J-Link based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.5 USB RLINK based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.6 USB ST-LINK based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.7 USB TI/Stellaris ICDI based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.8 USB Nuvoton Nu-Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.9 USB CMSIS-DAP based . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.10 USB Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.11 IBM PC Parallel Printer Port Based . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.12 Other... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3 About Jim-Tcl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4 Running. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.1 Simple setup, no customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2 What OpenOCD does as it starts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

5 OpenOCD Project Setup . . . . . . . . . . . . . . . . . . . . . . 14

5.1 Hooking up the JTAG Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

5.2 Project Directory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

5.3 Conﬁguration Basics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

5.4 User Conﬁg Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

5.5 Project-Speciﬁc Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

iii

5.6 Target Software Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

5.7 Target Hardware Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6 Conﬁg File Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . 21

6.1 Interface Conﬁg Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

6.2 Board Conﬁg Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

6.2.1 Communication Between Conﬁg ﬁles . . . . . . . . . . . . . . . . . . . . . . 22

6.2.2 Variable Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

6.2.3 The reset-init Event Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

6.2.4 JTAG Clock Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

6.2.5 The init board procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

6.3 Target Conﬁg Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

6.3.1 Default Value Boiler Plate Code . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6.3.2 Adding TAPs to the Scan Chain . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6.3.3 Add CPU targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6.3.4 Deﬁne CPU targets working in SMP . . . . . . . . . . . . . . . . . . . . . . 27

6.3.5 Chip Reset Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

6.3.6 The init targets procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

6.3.7 The init target events procedure . . . . . . . . . . . . . . . . . . . . . . . . . . 30

6.3.8 ARM Core Speciﬁc Hacks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

6.3.9 Internal Flash Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

6.4 Translating Conﬁguration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

7 Server Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

7.1 Conﬁguration Stage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

7.2 Entering the Run Stage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

7.3 TCP/IP Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

7.4 GDB Conﬁguration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

7.5 Event Polling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

8 Debug Adapter Conﬁguration . . . . . . . . . . . . . . . . 37

8.1 Adapter Conﬁguration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

8.2 Interface Drivers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

8.3 Transport Conﬁguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

8.3.1 JTAG Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

8.3.2 SWD Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

8.3.3 SPI Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

8.3.4 SWIM Transport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

8.4 JTAG Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

9 Reset Conﬁguration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

9.1 Types of Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

9.2 SRST and TRST Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

9.3 Commands for Handling Resets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

9.4 Custom Reset Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

剩余218页未读，继续阅读

评论收藏

内容反馈

吾心安处GZYYYYY

粉丝: 18
资源: 6

OpenOCD User’s Guide

评论0

最新资源

OpenOCD User’s Guide

评论0

User Guide

User Guide - FreeMASTER

LMK04832EVM User’s Guide

CDRouter User’s Guide

openocd-2020-12-23.pdf

openocd-20200729_openocd_openocd_

User_Manual_for_Using_OpenOCD_v0.02.doc

openocd-esp32-win32-0.10.0-esp32-20190313.zip

openocd源代码，0.10.0

ArchiMate User Guide

BrightSign User Guide

Arageli User’s Guide

TrueCrypt 7 User Guide

PCIE User Guide

openOCD 0.10 官方源码

openocd-20200729.7z

OpenOCD-20230621-0.12.0-my

openocd-0.10.0-Osprey.zip

Openocd with GUI （win7可用）

IMM User Guide

Cygwin User's Guide

VCS User Guide

Open OCD User's Guide

openocd-0.6.1.zip

openocd-0.10.0.zip

openocd2.0 源码

xpack-openocd-0.11.0-4

最新资源