There may be a newer version of this document available here

.

Scope and purpose​

This user guide provides technical information for the ModusToolbox™ version of the OpenOCD command line tool, including how to use it in stand-alone mode. OpenOCD is an Open Source programmer/debugger software that is installed as part of either the ModusToolbox™ Programming tools package.

Intended audience​

This document is intended for anyone who wants to use the OpenOCD CLI as a stand-alone tool.

Document conventions​

Convention

Explanation

Bold

Emphasizes heading levels, column headings, menus and sub-menus

Italics

Denotes file names and paths.

Monospace

Denotes APIs, functions, interrupt handlers, events, data types, error handlers, file/folder names, directories, command line inputs, code snippets

File > New

Indicates that a cascading sub-menu opens when you select a menu item

Abbreviations and definitions​

The following define the abbreviations and terms used in this document:

  • OpenOCD – Open On-Chip Debugger. An open-source tool that allows programming internal and external flash memories of a wide range of target devices.

  • CLI – Command-line interface.

  • Tcl – Tool command language. A high-level, general-purpose, interpreted, dynamic programming language.

  • MPN – Marketing part number. Associated with each specific device and used to order a device or find information about a device from Infineon. For example, CY8C616FMI-BL603, CY8C616FMI-BL673.

  • NVM – Non-Volatile Memory

  • SWD – Serial wire debug interface.

  • JTAG – Joint Test Action Group. Specifies the use of a dedicated debug port implementing a serial communication interface for low-overhead access without requiring direct external access to the system address and data buses.

  • TAP – JTAG test access port.

  • PSOC™ – A family of microcontroller integrated circuits by Infineon. These chips include a CPU core and mixed-signal arrays of configurable integrated analog and digital peripherals.

  • MCU – Microcontroller unit.

  • AP – Access port register of Arm® Cortex® CPU. Used for programming and debugging, along with the corresponding SWD address bit selections.

  • DP – Debug port register of Arm® Cortex® CPU. Used for programming and debugging, along with the corresponding SWD address bit selections.

  • Region – A logical area within the target device the programmer operates on.

  • WFA – ‘Wait for action’ special inner mechanism of bootloader to execute non-standard actions.

  • mp4/kp3 – MiniProg4/KitProg3 external and on-board Infineon brand probes.

Reference documents​

Refer to the following documents for more information as needed: