debuggers: import openocd-0.7.0
Initial check-in of openocd-0.7.0 as it can be downloaded from http://sourceforge.net/projects/openocd/files/openocd/0.7.0/ Any modifications will follow. Change-Id: I6949beaefd589e046395ea0cb80f4e1ab1654d55
This commit is contained in:
41
debuggers/openocd/tcl/target/readme.txt
Normal file
41
debuggers/openocd/tcl/target/readme.txt
Normal file
@ -0,0 +1,41 @@
|
||||
Prerequisites:
|
||||
The users of OpenOCD as well as computer programs interacting with OpenOCD are expecting that certain commands
|
||||
do the same thing across all the targets.
|
||||
|
||||
Rules to follow when writing scripts:
|
||||
|
||||
1. The configuration script should be defined such as , for example, the following sequences are working:
|
||||
reset
|
||||
flash info <bank>
|
||||
and
|
||||
reset
|
||||
flash erase_address <start> <len>
|
||||
and
|
||||
reset init
|
||||
load
|
||||
|
||||
In most cases this can be accomplished by specifying the default startup mode as reset_init (target command
|
||||
in the configuration file).
|
||||
|
||||
2. If the target is correctly configured, flash must be writable without any other helper commands. It is
|
||||
assumed that all write-protect mechanisms should be disabled.
|
||||
|
||||
3. The configuration scripts should be defined such as the binary that was written to flash verifies
|
||||
(turn off remapping, checksums, etc...)
|
||||
|
||||
flash write_image [file] <parameters>
|
||||
verify_image [file] <parameters>
|
||||
|
||||
4. adapter_khz sets the maximum speed (or alternatively RCLK). If invoked
|
||||
multiple times only the last setting is used.
|
||||
|
||||
interface/xxx.cfg files are always executed *before* target/xxx.cfg
|
||||
files, so any adapter_khz in interface/xxx.cfg will be overridden by
|
||||
target/xxx.cfg. adapter_khz in interface/xxx.cfg would then, effectively,
|
||||
set the default JTAG speed.
|
||||
|
||||
Note that a target/xxx.cfg file can invoke another target/yyy.cfg file,
|
||||
so one can create target subtype configurations where e.g. only
|
||||
amount of DRAM, oscillator speeds differ and having a single
|
||||
config file for the default/common settings.
|
||||
|
||||
Reference in New Issue
Block a user