8 Daemon Configuration

The commands here are commonly found in the openocd.cfg file and are used to specify what TCP/IP ports are used, and how GDB should be supported.

8.1 init

This command terminates the configuration stage and enters the normal command mode. This can be useful to add commands to the startup scripts and commands such as resetting the target, programming flash, etc. To reset the CPU upon startup, add "init" and "reset" at the end of the config script or at the end of the OpenOCD command line using the -c command line switch.

If this command does not appear in any startup/configuration file OpenOCD executes the command for you after processing all configuration files and/or command line options.

NOTE: This command normally occurs at or near the end of your openocd.cfg file to force OpenOCD to “initialize” and make the targets ready. For example: If your openocd.cfg file needs to read/write memory on your target - the init command must occur before the memory read/write commands.

8.2 TCP/IP Ports

• telnet_port <number>
  Intended for a human. Port on which to listen for incoming telnet connections.
• tcl_port <number>
  Intended as a machine interface. Port on which to listen for incoming TCL syntax. This port is intended as a simplified RPC connection that can be used by clients to issue commands and get the output from the TCL engine.
• gdb_port <number>
  First port on which to listen for incoming GDB connections. The GDB port for the first target will be gdb_port, the second target will listen on gdb_port + 1, and so on.

8.3 GDB Items

• gdb_breakpoint_override <hard|soft|disabled>
  Force breakpoint type for gdb 'break' commands. The raison d'etre for this option is to support GDB GUI's without a hard/soft breakpoint concept where the default OpenOCD and GDB behaviour is not sufficient. Note that GDB will use hardware breakpoints if the memory map has been set up for flash regions.

  This option replaces older arm7_9 target commands that addressed the same issue.

• gdb_detach <resume|reset|halt|nothing>
  Configures what OpenOCD will do when gdb detaches from the daeman. Default behaviour is <resume>
• gdb_memory_map <enable|disable>
  Set to <enable> to cause OpenOCD to send the memory configuration to gdb when requested. gdb will then know when to set hardware breakpoints, and program flash using the gdb load command. gdb_flash_program enable will also need enabling for flash programming to work. Default behaviour is <enable> See gdb_flash_program.
• gdb_flash_program <enable|disable>
  Set to <enable> to cause OpenOCD to program the flash memory when a vFlash packet is received. Default behaviour is <enable>