use reset init explicitly before "load".

[fw/openocd] / src / target / target / readme.txt

diff --git a/src/target/target/readme.txt b/src/target/target/readme.txt
index a0fd5031acfcac9ebc58971e0ce9cc6a90433dc0..fade6591357de353ad35c99f023a46051356d96f 100644 (file)
--- a/src/target/target/readme.txt
+++ b/src/target/target/readme.txt
@@ -10,6 +10,9 @@ Rules to follow when writing scripts:
 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).
@@ -22,3 +25,17 @@ assumed that all write-protect mechanisms should be disabled.
 
 flash write_image [file] <parameters>
 verify_image [file] <parameters>
+
+4. jtag_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 jtag_khz in interface/xxx.cfg will be overridden by
+target/xxx.cfg. jtag_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, oscilator speeds differ and having a single
+config file for the default/common settings.
+