OpenOCD commands overview
The available OpenOCD Tcl commands are listed in the following table. You can combine several commands in a single command-line or pass them via a configuration file.
The command can be invoked with the -c command option.
| Command | Description |
|---|---|
| version | Displays a string identifying the OpenOCD version |
| help | With no parameters, prints the help text for all commands |
| shutdown | Closes the OpenOCD server, disconnecting all clients |
| log_output | Redirects logging to the file name; the initial log output channel is stderr |
| debug_level | Displays the debug level |
| reset_config | Displays or modifies the reset configuration of your combination of the board and target |
| adapter speed | Sets the non-zero speed in kHz for the debug adapter |
| adapter serial | Sets the serial_number of the adapter to use |
| transport list | Displays the names of the transports supported by this version of OpenOCD |
| transport select | Selects a supported transport to use in this OpenOCD session |
| targets | Displays a table of all known targets, or sets the current target to a given target with a given name |
| scan_chain | Displays the TAPs in the scan chain configuration and their status |
| md(w)(h)(b) | Displays the contents of the address as 32-bit words (mdw), 16-bit half-words (mdh), or 8-bit bytes (mdb) |
| mw(w)(h)(b) | Writes the specified word (32 bits), half-word (16 bits), or byte (8-bit) value, at the specified address |
| init | Terminates the configuration stage and enters the run stage |
| reset [run] [halt] [init] | Performs as hard a reset as possible, using SRST if possible |
| program | Programs a given programming file in the HEX, SREC, BIN, or ELF formats into flash |
| erase_all | Erases the flash memory |
| flash banks | Prints a one-line summary of each flash bank of the target device |
| flash info | Prints info about the flash bank, a list of protection blocks, and their status |
| flash protect | Enables (on) or disables (off) protection of flash blocks |
| flash erase_sector | Erases sectors in a given bank |
| flash erase_address | Erases sectors starting at a given address |
| flash write_bank | Writes the binary file to a given flash bank |
| flash write_image | Writes the image file to the current target's flash bank(s) |
| flash fill(w)(h)(b) | Fills the flash memory with the specified word (32 bits), half-word (16 bits), or byte |
| flash read_bank | Reads bytes from the flash bank and writes the contents to the binary file |
| flash verify_bank | Compares the contents of the binary file with the contents of the flash |
| flash padded_value | Sets the default value used for padding-any-image sections |
| flash rmw | Can be used to modify flash individual bytes |
| add_verify_range | Allows specifying the memory regions to be compared during the verify operation |
| show_verify_ranges | Displays all active verify ranges for all targets that were added using the add_verify_range command. This command does not take any arguments |
| clear_verify_ranges | Deletes all verify ranges for the specified target that were added using the add_verify_range command |
| verify_image | Verifies a file against the target memory starting at a given address |
| verify_image_checksum | Verifies a file against the target memory starting at a given address |
| load_image | Loads an image from a file to the target memory offset from its load address |
| dump_image | Dumps bytes of the target memory to a binary file |
| kitprog3 acquire_config | Controls device acquisition parameters, and optionally enables acquisition during the early initialization phase |
| kitprog3 acquire_psoc | Performs device acquisition |
| kitprog3 power_config | Controls KitProg3/MiniProg4 internal power supply parameters and optionally enables power |
| kitprog3 led_control | Controls KitProg3/MiniProg4 LEDs |
| kitprog3 get_power | Reports the target voltage in millivolts |
| psoc6/cat1c/traveo2/xmc5xxx sflash_restrictions | Enables or disables writes to dedicated SFlash regions |
| psoc6/cat1c/traveo2/xmc5xxx allow_efuse_program | Allows or disallows writes to the EFuse region |
| psoc6/cat1c/traveo2/xmc5xxx reset_halt | Simulates a broken vector catch on MCU |
| psoc4/cat1c/traveo2/xmc5xxx ecc_error_reporting | Enables or disables the ECC error reporting |
| cat1c/traveo2/xmc5xxx wflash blank_map [first_sector [last_sector | 'last']] | Displays per-word validity map of the given sectors of Fork Flash |
| cat1c/traveo2/xmc5xxx wflash write_image [filename] [offset] | Programs individual 32-bit words from given file to the Work Flash |
| cat1c/traveo2/xmc5xxx wflash write_words [address] [word_1] [word_2] ... [word_N] | Modifies individual 32-bit words in Work Flash |
| psoc6 secure_acquire | Performs acquisition of PSOC™ 64 "Secure Boot" MCUs |
| psoc4 reset_halt | Performs the alternate acquire sequence |
| psoc4 mass_erase | Performs a mass erase operation on the given flash bank |
| psoc4 chip_protect | Changes chip protection mode to PROTECTED |
| psoc4 kill_mode | Changes chip protection mode to KILL |
| source | Reads a file and executes it as a Tcl script |
| find | Finds and returns the full path to a file with the Tcl script |
| set | Creates a Tcl variable |
| add_script_search_dir | Adds a directory to the file/script search path |
| sleep | Waits for a given number of milliseconds before resuming |