Browse Source

updated docs a bit.

git-svn-id: svn:// b42882b7-edfa-0310-969c-e2dbd0fdcd60
oharboe 15 years ago
2 changed files with 28 additions and 3 deletions
  1. +26
  2. +2

+ 26
- 2
doc/openocd.texi View File

@@ -51,6 +51,7 @@ This manual documents edition @value{EDITION} of the Open On-Chip Debugger
* Target library:: Target library
* Commands:: OpenOCD Commands
* Sample Scripts:: Sample Target Scripts
* GDB and OpenOCD:: Using GDB and OpenOCD
* TCL and OpenOCD:: Using TCL and OpenOCD
* TCL scripting API:: Tcl scripting API
@@ -936,11 +937,18 @@ These commands allow accesses of a specific size to the memory system:
@item @b{fast_load_image} <@var{file}> <@var{address}> [@option{bin}|@option{ihex}|@option{elf}]
@cindex fast_load_image
@*Same functionality and arguments as load_image, but image is stored in memory
@*Normally you should be using @b{load_image} or GDB load. However, for
testing purposes or when IO overhead is significant(OpenOCD running on embedded
host), then storing the image in memory and uploading the image to the target
can be a way to upload e.g. multiple debug sessions when the binary does not change.
Arguments as @b{load_image}, but image is stored in OpenOCD host
memory, i.e. does not affect target. This approach is also useful when profiling
target programming performance as IO and target programming can easily be profiled
@item @b{fast_load}
@cindex fast_image
@*Load active fast load image to current target
@*Loads image stored in memory by @b{fast_load_image} to current target. Must be preceeded by fast_load_image.
@item @b{dump_image} <@var{file}> <@var{address}> <@var{size}>
@cindex dump_image
@@ -1809,6 +1817,22 @@ See libdcc in the contrib dir for more details.
@*Enable/disable target debugmsgs requests. debugmsgs enable messages to be sent to the debugger while the target is running.
@end itemize

@node TFTP
@chapter TFTP
@cindex TFTP
If OpenOCD runs on an embedded host(as ZY1000 does), then tftp can
be used to access files on PCs(either developer PC or some other PC).

The way this works is to prefix a filename by "/tftp/ip/" and append
the tftp path on the tftp server(tftpd). E.g. "load_image /tftp/\temp\abc.elf"
will load c:\temp\abc.elf from the developer pc ( into memory as
if the file was hosted on the embedded host.

In order to achieve decent performance, you must choose a tftp server
that supports a packet size bigger than the default packet size(512 bytes). There
are numerous tftp servers out there(free and commercial) and you will have to do
a bit of googling to find something that fits your requirements.

@node Sample Scripts
@chapter Sample Scripts
@cindex scripts

+ 2
- 1
src/ecosboard.c View File

@@ -266,7 +266,8 @@ int handle_fast_load_image_command(struct command_context_s *cmd_ctx, char *cmd,
duration_stop_measure(&duration, &duration_text);
if (retval==ERROR_OK)
command_print(cmd_ctx, "downloaded %u byte in %s", image_size, duration_text);
command_print(cmd_ctx, "Loaded %u bytes in %s", image_size, duration_text);
command_print(cmd_ctx, "NB!!! image has not been loaded to target, issue a subsequent 'fast_load' to do so.");