mirror of
git://git.code.sf.net/p/openocd/code
synced 2025-07-24 05:59:49 +10:00
Avoid annoying "deprecated" messages while running the scripts distributed with OpenOCD code. Change automatically created with commands sed -i 's/adapter_khz/adapter speed/g' $(find tcl/ -type f) sed -i 's/adapter_nsrst_delay/adapter srst delay/g' $(find tcl/ -type f) sed -i 's/adapter_nsrst_assert_width/adapter srst pulse_width/g' $(find tcl/ -type f) Minor indentation issue fixed manually in tcl/board/at91sam9g20-ek.cfg tcl/target/at91sam9260_ext_RAM_ext_flash.cfg Change-Id: I425fd56c0c88cd6b06124621306eeb89166dfe71 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: http://openocd.zylin.com/5284 Tested-by: jenkins Reviewed-by: Oleksij Rempel <linux@rempel-privat.de>
42 lines
1.5 KiB
Plaintext
42 lines
1.5 KiB
Plaintext
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 speed 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 speed in interface/xxx.cfg will be overridden by
|
|
target/xxx.cfg. adapter speed 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.
|
|
|